PHP cURL 怎么让多个句柄共享 DNS 缓存

PHP cURL 要实现多个句柄共享DNS缓存，核心方式是借助 cURL 内置的共享句柄机制，把DNS缓存资源统一挂载到公共共享句柄上，再给每一个独立的业务cURL句柄绑定这个共享句柄即可。

你不需要自己额外实现文件或者内存级别的DNS缓存存储，直接用curl_share_init创建共享句柄，开启CURLSHOPT_SHARE的CURL_LOCK_DATA_DNS选项，就能让所有绑定该共享句柄的curl实例自动复用同一份DNS解析结果。

如果 PHP 代码会在同一个进程里创建多个 cURL easy handle，并希望它们复用 DNS 缓存，应先创建一个 curl_share_init() 返回的 share handle，再调用 curl_share_setopt($share, CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS)，最后把同一个 share handle 通过 CURLOPT_SHARE 绑定到每个 easy handle。官方手册入口：https://www.php.net/curl-share-setopt。

关键不在于把 DNS 选项写到某一个 easy handle 上，而在于让多个 easy handle 指向同一个已声明 DNS 共享类型的 CurlShareHandle。share handle 和 easy handle 的关闭顺序也要分开管理。

• 共享对象：只有同一个 share handle 绑定到多个 easy handle，才形成这组共享关系。
• 共享类型：CURL_LOCK_DATA_DNS 只表达 DNS 缓存共享，不等同于 HTTP 连接池复用。
• 错误边界：curl_share_setopt() 与 curl_setopt() 都应检查返回值，不能只看请求是否最终成功。

先把 share handle 和 DNS 共享关系连起来

curl_share_init() 创建的是供多个 cURL handle 使用的共享句柄。它本身不会自动打开所有共享能力；需要用 curl_share_setopt() 指定 CURLSHOPT_SHARE，并把值设为 CURL_LOCK_DATA_DNS。这样声明的范围是 DNS 缓存，不能据此推断 cookie、SSL 会话或连接缓存也会共享。

一个可复用的最小写法如下。示例把配置错误和请求错误分开处理，也让两个 easy handle 明确引用同一个 share handle。

多个句柄为什么仍然看不到共享效果

第一类问题是每次循环都调用 curl_share_init()，结果每个 easy handle 拿到的并不是同一个共享对象。第二类问题是只创建了 share handle，却忘记在每个 easy handle 上设置 CURLOPT_SHARE。第三类问题是配置函数返回了 false，但代码继续执行，最后只能看到一次普通请求失败，无法判断共享配置在哪一步失效。

还要注意句柄的生命周期：share handle 必须至少存活到所有使用它的 easy handle 关闭之后。不要在工厂函数内部创建并立刻关闭 share handle，也不要把一个已经关闭的对象继续分配给新请求。若要在不同请求批次之间复用，应把 share handle 的所有权放在更长生命周期的对象中，同时明确谁负责最终释放。

不要把 DNS 缓存共享误写成连接池复用

CURL_LOCK_DATA_DNS 表示 DNS 缓存数据共享；它解决的是多个 handle 对主机名解析结果的共享边界，并不等于复用已经建立的 HTTP 连接。PHP 手册还指出，使用 cURL multi handle 时，同一个 multi handle 中的句柄默认共享 DNS 缓存，这是另一种组织方式。若代码本来就是 multi handle 调度，不要为了“再共享一次”而混淆两套生命周期。

因此，先回答“我需要共享什么”：只需要 DNS 缓存时，使用 share handle 声明 CURL_LOCK_DATA_DNS；需要讨论连接复用、并发调度或 HTTP 连接池时，应单独设计和衡量，不能用一次 curl_share_setopt() 调用替代。

常见问题

一个 share handle 可以绑定几个 easy handle？

文章中的做法允许多个 easy handle 绑定同一个 share handle。实际数量应由进程生命周期、并发模型和资源上限决定，重点是它们必须引用同一个对象并保持对象仍然有效。

设置了 CURLOPT_SHARE，为什么 DNS 仍然慢？

先检查是否真的声明了 CURL_LOCK_DATA_DNS，再检查每个 easy handle 是否绑定同一个 share handle，以及 share handle 是否在请求前就被关闭。不要仅凭一次请求耗时判断共享是否生效，也不要把 DNS 解析时间与连接建立、TLS 握手时间混为一谈。

可以用 CURLOPT_DNS_USE_GLOBAL_CACHE 代替吗？

不建议把它当成当前方案。PHP 手册说明该选项在 PHP 8.4.0 起不再产生作用；需要让一组 easy handle 共享 DNS 缓存时，应使用 share handle 与 CURL_LOCK_DATA_DNS 表达清晰的共享边界。

收尾清单

最终检查可以压缩为五项：只创建一个共享句柄；明确声明 CURL_LOCK_DATA_DNS；所有 easy handle 都绑定同一对象；逐个检查配置返回值；先关闭 easy handle，最后关闭 share handle。这样既能解决“多个句柄怎么共享 DNS 缓存”的问题，也不会把 DNS 缓存、连接复用和 multi handle 的职责混在一起。