如何避免因未調用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()釋放資源，並確保共享句柄的生命週期明確、受控。只有這樣，才能在享受共享帶來的性能優勢的同時，避免不必要的資源浪費與潛在風險。