curl_upkeep怎麼用？教你在curl_multi_add_handle()之後正確調用curl_upkeep函數

M66 2025-06-23

在PHP中使用cURL庫進行多線程請求時， curl_multi_add_handle()函數是一個關鍵步驟，它允許你將多個cURL句柄添加到一個cURL多路復用句柄中。然而，當你在執行多線程請求時，可能會遇到需要對多路復用句柄進行適當管理和維護的情況。在這種情況下， curl_upkeep()函數非常有用。它可以在你調用curl_multi_add_handle()之後，確保多個並發請求保持活動狀態，並能及時清理無效的請求。

本文將詳細介紹如何在使用curl_multi_add_handle()之後，正確調用curl_upkeep()函數，並確保cURL多線程請求順利執行。

1. 什麼是curl_multi_add_handle()函數？

curl_multi_add_handle()函數是PHP中用於將多個cURL句柄添加到多路復用句柄中的函數。它使得你能夠同時進行多個HTTP請求，而不必為每個請求分別創建新的cURL會話。調用該函數後，你可以通過curl_multi_exec()來執行並等待所有請求完成。

例如，以下是一個簡單的多線程cURL請求的示例：

 $mh = curl_multi_init(); // 初始化一個多路復用句柄

// 創建多個cURL句柄
$ch1 = curl_init('http://m66.net/api/data1');
$ch2 = curl_init('http://m66.net/api/data2');
$ch3 = curl_init('http://m66.net/api/data3');

// 將句柄添加到多路復用句柄中
curl_multi_add_handle($mh, $ch1);
curl_multi_add_handle($mh, $ch2);
curl_multi_add_handle($mh, $ch3);

2. curl_upkeep()的作用

curl_upkeep()函數的作用是確保在多路復用句柄中，所有的請求能夠保持活動狀態，並及時管理不再需要的請求。它幫助我們清理那些已經完成或失敗的請求，確保系統的資源能夠被及時回收，從而避免不必要的內存消耗。

3. 如何在curl_multi_add_handle()之後調用curl_upkeep()

在將多個cURL句柄添加到多路復用句柄後，我們需要周期性地調用curl_upkeep()來管理這些句柄的生命週期。具體步驟如下：

調用curl_multi_exec()來啟動請求。
使用curl_upkeep()來維護cURL會話的活動狀態。
在所有請求完成後，移除已經完成的句柄。

以下是一個具體的例子：

 $mh = curl_multi_init(); // 初始化多路復用句柄

// 創建多個cURL句柄
$ch1 = curl_init('http://m66.net/api/data1');
$ch2 = curl_init('http://m66.net/api/data2');
$ch3 = curl_init('http://m66.net/api/data3');

// 將句柄添加到多路復用句柄中
curl_multi_add_handle($mh, $ch1);
curl_multi_add_handle($mh, $ch2);
curl_multi_add_handle($mh, $ch3);

// 執行請求
$running = null;
do {
    curl_multi_exec($mh, $running);  // 執行請求
    curl_upkeep($mh);  // 維護多路復用句柄
} while ($running);

// 獲取每個請求的結果
$response1 = curl_multi_getcontent($ch1);
$response2 = curl_multi_getcontent($ch2);
$response3 = curl_multi_getcontent($ch3);

// 關閉句柄
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_remove_handle($mh, $ch3);

// 關閉多路復用句柄
curl_multi_close($mh);

4. 為什麼要使用curl_upkeep() ？

在使用curl_multi_exec()執行並發請求時，我們並不能保證所有請求在第一次執行時就能完成。有時候，某些請求可能需要更長的時間。 curl_upkeep()可以定期清理已經完成的請求句柄，防止這些句柄佔用不必要的資源。此外， curl_upkeep()還可以確保即使在繁忙的請求情況下，程序也能保持高效運行。

5. 結論

當你在PHP中使用curl_multi_add_handle()處理多個並發請求時， curl_upkeep()是一個非常重要的工具。它幫助我們管理多路復用句柄，及時清理無效請求，從而確保請求的高效執行和資源的合理利用。通過合理使用curl_upkeep() ，你可以使得PHP中的並發請求更加穩定、可靠。