如何避免因未调用 curl_share_close() 而导致的资源泄露问题，使用 curl_share_init 函数时应注意什么？

M66 2025-06-23

在 PHP 中使用 cURL 共享句柄功能（curl_share_init()）时，若开发者未妥善释放共享资源，极易引发资源泄露问题，进而影响到服务器性能乃至稳定性。本文将围绕 curl_share_init() 与 curl_share_close() 的正确用法展开，帮助开发者规避潜在风险。

1. 什么是 curl_share_init()？

curl_share_init() 是 PHP 提供的函数，用于初始化一个 cURL 共享句柄（cURL share handle）。该句柄可以用于多个 cURL 会话之间共享诸如 DNS 缓存、Cookie 等信息，以提升性能和资源复用率。

使用共享句柄的典型流程如下：

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

该共享句柄随后可通过 curl_setopt() 关联到多个 cURL 请求：

$ch = curl_init('https://www.m66.net/api/data');
curl_setopt($ch, CURLOPT_SHARE, $sh);
curl_exec($ch);
curl_close($ch);

2. 忽略 curl_share_close() 会发生什么？

问题在于，很多开发者在完成共享句柄的使用后，忘记了调用 curl_share_close() 来释放资源。

// 错误示例：未关闭共享句柄
$sh = curl_share_init();
// ... 一系列操作
// 忘记 curl_share_close($sh);

这种疏忽会导致服务器内部的资源（如内存、DNS 缓存等）持续占用，最终可能触发“内存泄露”警告、性能下降，甚至导致 PHP-FPM worker 被操作系统强制终止。

3. 正确的释放方式

应始终在共享句柄使用完毕后，调用 curl_share_close() 来释放资源：

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

// 执行多个请求
foreach ($urls as $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_SHARE, $sh);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $response = curl_exec($ch);
    curl_close($ch);
}

curl_share_close($sh); // 释放共享资源

这与普通的 curl_close() 类似，关键在于开发者不能将共享句柄的释放遗漏。

4. 除了释放，还应注意的事项

a. 共享句柄不可跨线程/进程共享

cURL 共享句柄的设计是面向单一进程的，并不能在多线程或多进程之间共享使用。这意味着在 PHP-FPM 的多进程模型中，每个子进程必须自己管理自己的共享句柄。

b. 设置共享类型前不要复用

共享句柄一旦与某个 cURL 请求建立了关联，就不能再修改其共享选项，否则可能引发内部状态异常。例如：

$sh = curl_share_init();
curl_share_setopt($sh, CURLSHOPT_SHARE, CURL_LOCK_DATA_DNS);
// 在关联之前设置是正确的，之后就不要再修改

c. 使用共享 DNS 缓存需考虑 TTL

共享 DNS 缓存时可能会导致解析结果“陈旧”，应根据实际需求设置合理的 TTL，并定期清理缓存或重新初始化共享句柄。

5. 实战建议

在封装 HTTP 请求类时，引入共享句柄池，并在类析构或 shutdown 函数中统一释放；
结合 register_shutdown_function() 注册清理逻辑；
使用共享前后添加日志或调试信息，确保没有悬挂资源未释放；
对于高并发环境，建议评估共享对性能的提升是否显著，否则使用默认句柄更为简单安全。

总结

curl_share_init() 是提升 cURL 性能的重要工具，但也伴随着资源管理的责任。开发者应始终在使用完成后调用 curl_share_close() 释放资源，并确保共享句柄的生命周期明确、受控。只有这样，才能在享受共享带来的性能优势的同时，避免不必要的资源浪费与潜在风险。