為什麼我的共享Cookie 不起作用？

M66 2025-05-22

在PHP 使用cURL執行多個HTTP 請求時，有時我們希望在多個請求之間共享某些數據，比如Cookie、DNS 緩存或SSL 會話。這時可以使用curl_share_init()和相關函數來實現共享。但是，很多開發者在嘗試使用該功能時會遇到一個常見的問題：。本文將詳細分析這個問題的原因及其解決方案。

一、基本用法回顧

首先，讓我們快速回顧一下如何使用curl_share_init來共享Cookie：

 $sh = curl_share_init();
curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE);

$ch1 = curl_init('https://m66.net/login');
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch1, CURLOPT_COOKIEFILE, '');
curl_setopt($ch1, CURLOPT_SHARE, $sh);
// 假設這個請求會設置 Cookie
$response1 = curl_exec($ch1);

$ch2 = curl_init('https://m66.net/profile');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch2, CURLOPT_COOKIEFILE, '');
curl_setopt($ch2, CURLOPT_SHARE, $sh);
// 期望這裡能發送上次請求設置的 Cookie
$response2 = curl_exec($ch2);

curl_close($ch1);
curl_close($ch2);
curl_share_close($sh);

從代碼邏輯上看，我們期望通過curl_share_setopt()的CURL_LOCK_DATA_COOKIE實現Cookie 的共享。但許多開發者反饋：第二次請求並沒有附帶第一次請求返回的Cookie 。

二、為何Cookie 沒有被共享？

1.沒有設置CURLOPT_COOKIEJAR或CURLOPT_COOKIEFILE為有效路徑

雖然我們設置了共享Cookie，但libcurl默認並不會自動保存或寫入Cookie 除非設置了：

CURLOPT_COOKIEFILE ：讀取已有的Cookie 文件
CURLOPT_COOKIEJAR ：請求後寫入Cookie 文件

而設置為'' （空字符串）雖然可以啟用內存中的Cookie 處理，但這種方式在配合curl_share_*時行為可能不穩定。

2. libcurl 與PHP 綁定的實現差異

PHP 的cURL擴展使用的是libcurl庫。在某些平台或版本中， curl_share_*的行為可能和官方文檔描述略有差異，尤其是涉及Cookie 的部分。 CURL_LOCK_DATA_COOKIE更多是設計給低級libcurl使用，而PHP 抽象封裝後的調用方式對其支持不一致。

3. Cookie 路徑或域名不匹配

Cookie 具有路徑（Path）和域名（Domain）限制。如果請求的URL 域名不同（即使是子域名差異），Cookie 就不會被發送。同樣，如果服務器設置的Cookie 只對某一特定路徑有效，而下一次請求的路徑不在其中，Cookie 也不會自動附帶。

三、推薦的解決方案

方法一：使用CURLOPT_COOKIEFILE和CURLOPT_COOKIEJAR

使用臨時Cookie 文件進行顯式管理是最簡單可靠的方式。

 $tmpCookieFile = tempnam(sys_get_temp_dir(), 'cookie');

$ch1 = curl_init('https://m66.net/login');
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch1, CURLOPT_COOKIEJAR, $tmpCookieFile);
curl_setopt($ch1, CURLOPT_COOKIEFILE, $tmpCookieFile);
$response1 = curl_exec($ch1);

$ch2 = curl_init('https://m66.net/profile');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch2, CURLOPT_COOKIEJAR, $tmpCookieFile);
curl_setopt($ch2, CURLOPT_COOKIEFILE, $tmpCookieFile);
$response2 = curl_exec($ch2);

這種方式不依賴curl_share_* ，並且能保證Cookie 能夠被存儲和重新加載，適用於大多數PHP 項目。

方法二：手動管理Cookie 頭部

如果你需要更精細地控制Cookie，比如只選擇特定的鍵值，可以通過CURLOPT_HEADERFUNCTION捕獲響應頭，再通過CURLOPT_COOKIE手動設置：

 $cookies = [];

$ch1 = curl_init('https://m66.net/login');
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch1, CURLOPT_HEADERFUNCTION, function($ch, $header) use (&$cookies) {
    if (preg_match('/^Set-Cookie:\s*(.*?)=([^;]*)/i', $header, $matches)) {
        $cookies[$matches[1]] = $matches[2];
    }
    return strlen($header);
});
curl_exec($ch1);
curl_close($ch1);

$cookieString = '';
foreach ($cookies as $k => $v) {
    $cookieString .= "$k=$v; ";
}

$ch2 = curl_init('https://m66.net/profile');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch2, CURLOPT_COOKIE, $cookieString);
$response2 = curl_exec($ch2);

四、結論

curl_share_init()提供了一個機制來共享Cookie 等數據，但在PHP 中使用它時要特別小心。 Cookie 的共享行為受多種因素影響，包括域名、路徑、PHP 封裝和libcurl 本身的版本。如果你希望在多個請求之間共享Cookie，最安全的方法是使用文件方式顯式管理Cookie ，或者手動提取和設置Cookie，而不是依賴curl_share_init 。

通過理解其底層原理，我們可以更有效地構建穩定的HTTP 客戶端邏輯，避免“看起來能共享但實際沒生效”的陷阱。