为什么我的共享 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 客户端逻辑，避免“看起来能共享但实际没生效”的陷阱。