PHP 8.5 中 curl_share_init() 不支持持久化,仅返回普通资源,必须配合 curl_multi_init() 在单次请求内共享 DNS 缓存,cookie 等需手动落盘或额外缓存,且不跨请求存活。

curl_share_init() 在 PHP 8.5 中不支持持久化
PHP 8.5 的 curl_share_init() 返回的是普通资源(resource),不是可复用的持久化句柄。所谓“持久化 curl 共享句柄”在当前版本根本不存在——curl_share_init_persistent() 这个函数压根没进 PHP 官方,也不是 RFC 或已合并的 PR 内容。网上搜到的类似命名,基本是误传、拼写错误,或把 cURL 底层 libcurl 的 CURLSHOPT_SHARE 行为错当成 PHP 层 API。
PHP 里真正能复用的只有 curl_multi_* + curl_share_init()
共享句柄唯一合法用途是配合 curl_multi_init() 多请求场景,让多个 easy handle 共享 cookie、DNS 缓存、连接池等。但每次脚本结束,共享句柄就销毁;下一次请求需重新 curl_share_init() ——它本身不跨请求存活。
-
curl_share_init()必须在curl_multi_add_handle()前调用,否则报CURLOPT_SHARE无效 - 共享句柄必须显式传给每个
curl_setopt($ch, CURLOPT_SHARE, $sh),漏设一个,该句柄就不参与共享 - 只共享 DNS 缓存和 cookie,默认不共享连接(libcurl 默认启用
CURLSHOPT_SHARE的CURL_LOCK_DATA_CONNECT?不,PHP 不暴露这个控制) - 若你在 CLI 模式下用
pcntl_fork()复用句柄,会直接 crash:共享句柄不是线程/进程安全的
想跨请求共享 cookie 或 DNS,得换思路
PHP 层无法靠 curl_share_init() 实现“持久化”,因为 SAPI 生命周期天然隔离。真要复用状态,得自己接管:
- cookie:用
curl_setopt($ch, CURLOPT_COOKIEJAR, '/tmp/cookies.txt')和CURLOPT_COOKIEFILE落盘,下次读取 - DNS 缓存:PHP 不提供接口,但可以封装
gethostbyname()结果 + TTL 缓存(比如用apcu_store()存 30 秒) - 连接复用:靠 HTTP/1.1 keep-alive 或 HTTP/2 多路复用,由 libcurl 自动管理,无需共享句柄干预;关键是别设
CURLOPT_CLOSEPOLICY(PHP 不支持该选项)或手动curl_close()过早 - 注意
curl_setopt_array()里混用CURLOPT_SHARE和CURLOPT_HEADERFUNCTION可能触发 segfault(PHP 8.3+ 已修复,但旧 patch 版本仍有风险)
PHP 8.5 下检查 curl 共享是否生效的最快方法
别信文档描述,用实际行为验证:
立即学习“PHP免费学习笔记(深入)”;
var_dump(curl_share_errno($sh)); // 应为 0
$ch1 = curl_init('https://www.php.cn/link/f1cf07543e16470e35037dad7c698dbc/set?k=v');
curl_setopt($ch1, CURLOPT_SHARE, $sh);
curl_exec($ch1);
curl_close($ch1);
<p>$ch2 = curl_init('<a href="https://www.php.cn/link/f1cf07543e16470e35037dad7c698dbc">https://www.php.cn/link/f1cf07543e16470e35037dad7c698dbc</a>');<br />
curl_setopt($ch2, CURLOPT_SHARE, $sh);<br />
$res = curl_exec($ch2); // 若返回中含 "k": "v",说明 cookie 共享成功<br />
curl_close($ch2);如果 $res 没带 cookie,先确认是否漏了 CURLOPT_COOKIEJAR / CURLOPT_COOKIEFILE;再检查 curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_COOKIE) ——PHP 不支持该函数,所以默认只共享 DNS,不共享 cookie,除非你手动开启(但 PHP 没暴露这个开关)。
也就是说,PHP 的 curl_share_init() 实际上只对 DNS 缓存有效,其他共享项形同虚设。这点很容易被忽略,直到你发现 cookie 总是空才回头翻 libcurl 文档。











