curl_multi_remove_handle()函式—用法及示例

函式名：curl_multi_remove_handle()

概述：curl_multi_remove_handle() 函式用於從多個 cURL 控制代碼中移除一個控制代碼，使其不再參與後續的多個 cURL 操作。

用法：curl_multi_remove_handle(resource $mh, resource $ch) : int

引數說明：

• $mh：一個 cURL 多個控制代碼資源；
• $ch：要從多個控制代碼中移除的控制代碼資源。

返回值：返回一個成功移除控制代碼的標誌，成功返回 CURLM_OK（值為0），失敗返回一個 cURL 錯誤程式碼。

示例程式碼：

// 建立 cURL 多個控制代碼
$mh = curl_multi_init();

// 建立第一個 cURL 控制代碼
$ch1 = curl_init('http://example.com/url1');
curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);

// 建立第二個 cURL 控制代碼
$ch2 = curl_init('http://example.com/url2');
curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);

// 將兩個控制代碼新增到多個控制代碼資源中
curl_multi_add_handle($mh, $ch1);
curl_multi_add_handle($mh, $ch2);

// 執行多個控制代碼，並等待執行完畢
$running = null;
do {
    curl_multi_exec($mh, $running);
} while ($running > 0);

// 移除一個控制代碼
curl_multi_remove_handle($mh, $ch2);

// 關閉多個控制代碼資源
curl_multi_close($mh);

在上述示例中，我們建立了兩個 curl 控制代碼 $ch1 和 $ch2，然後將它們新增到多個控制代碼 $mh 中。然後我們使用 curl_multi_exec() 執行多個控制代碼，直到所有請求執行完畢。

在執行完成後，我們使用 curl_multi_remove_handle() 函式從多個控制代碼中移除一個控制代碼，這裡我們移除了 $ch2。最後透過 curl_multi_close() 函式關閉多個控制代碼資源。

請注意，使用 curl_multi_remove_handle() 函式移除之後，被移除的控制代碼將不再參與後續的多個 cURL 操作。