構建支持curl_share 的中間件攔截器

M66 2025-06-06

在PHP 中， curl_share_init是一個非常有用的函數，它允許多個cURL 請求共享相同的資源，如會話、cookies 或文件等，能夠有效減少重複請求資源的開銷，提高性能。而在實際應用中，我們可能需要對多個請求進行集中管理、配置或是攔截，這時候中間件攔截器就顯得尤為重要。

本文將介紹如何構建一個支持curl_share_init的中間件攔截器，並通過實際示例幫助你更好地理解這一過程。

什麼是中間件攔截器？

中間件攔截器是一個用於攔截請求和響應的組件，可以在請求進入前和響應離開後執行一些特定的操作。通常情況下，它們用於記錄日誌、處理身份驗證、緩存控制、請求頭添加、響應格式化等。

在我們的案例中，攔截器會在cURL 請求發生之前或之後，進行一些額外的處理。對於支持curl_share_init的中間件來說，我們的目標是確保在多次cURL 請求中，能夠共享一個會話資源，從而避免每次都初始化新的cURL 會話。

構建步驟

1. 創建中間件基礎框架

我們可以創建一個中間件類，專門用來處理所有的cURL 請求攔截。這個類會提供一些基本的初始化和資源管理功能。

 class CurlMiddleware
{
    private $shareHandle;

    public function __construct()
    {
        // 初始化共享資源
        $this->shareHandle = curl_share_init();
    }

    public function __destruct()
    {
        // 銷毀共享資源
        if ($this->shareHandle) {
            curl_share_close($this->shareHandle);
        }
    }

    public function handleRequest($url, $options = [])
    {
        // 設定 cURL 共享資源
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_SHARE, $this->shareHandle);

        // 設定其他 cURL 選項
        curl_setopt_array($ch, $options);

        // 執行請求
        $response = curl_exec($ch);

        if (curl_errno($ch)) {
            // 錯誤處理
            echo 'Curl error: ' . curl_error($ch);
        }

        curl_close($ch);

        return $response;
    }
}

2. 添加攔截邏輯

在上面的代碼中，我們已經實現了一個基本的CurlMiddleware類。為了讓它成為一個中間件，我們可以通過添加一些攔截邏輯來控制請求和響應。

我們可以在handleRequest方法中加入前置和後置操作，攔截和修改請求或響應。

 class CurlMiddleware
{
    private $shareHandle;

    public function __construct()
    {
        // 初始化共享資源
        $this->shareHandle = curl_share_init();
    }

    public function __destruct()
    {
        // 銷毀共享資源
        if ($this->shareHandle) {
            curl_share_close($this->shareHandle);
        }
    }

    public function beforeRequest($url, $options)
    {
        // 在發送請求之前執行的操作（例如修改 URL 或設定额外的選項）
        $parsedUrl = parse_url($url);
        $url = 'https://m66.net' . $parsedUrl['path'];  // 替換域名
        return $url;
    }

    public function afterRequest($response)
    {
        // 在請求之後執行的操作（例如日誌記錄、響應格式化）
        // 這裡我們可以對響應做一些修改或者記錄日誌
        return $response;
    }

    public function handleRequest($url, $options = [])
    {
        // 前置操作：修改 URL 或者其他選項
        $url = $this->beforeRequest($url, $options);

        // 設定 cURL 共享資源
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_SHARE, $this->shareHandle);

        // 設定其他 cURL 選項
        curl_setopt_array($ch, $options);

        // 執行請求
        $response = curl_exec($ch);

        if (curl_errno($ch)) {
            // 錯誤處理
            echo 'Curl error: ' . curl_error($ch);
        }

        curl_close($ch);

        // 後置操作：處理響應
        return $this->afterRequest($response);
    }
}

3. 使用中間件

現在， CurlMiddleware類已經可以在每次請求之前和之後執行一些攔截邏輯。在實際使用時，我們只需要創建一個中間件實例，並調用handleRequest方法進行請求。

 $middleware = new CurlMiddleware();
$options = [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true
];

// 請求 URL
$url = 'https://example.com/api/data';

// 发送請求
$response = $middleware->handleRequest($url, $options);

// 打印響應結果
echo $response;

4. 共享資源管理

由於我們使用了curl_share_init ，多個cURL 請求將共享相同的資源（如cookies、會話信息等）。這對於需要跨多個請求共享狀態的情況非常有用。在我們的中間件中，所有的cURL 請求都使用同一個共享句柄，確保它們共享相同的會話數據。

需要注意的是，在某些情況下，可能需要對curl_share_init的行為進行更細緻的配置，尤其是在多個請求之間需要同步訪問共享資源時。

小結

本文展示瞭如何構建一個支持curl_share_init的中間件攔截器。通過這樣的中間件，我們可以在多次發起cURL 請求時，共享會話資源並攔截請求和響應，以便進行日誌記錄、錯誤處理、URL 修改等操作。

curl_share_init