curl_multi_remove_handle

(PHP 5, PHP 7, PHP 8)

curl_multi_remove_handle — 移除cURL批处理句柄资源中的某个句柄资源

说明

curl_multi_remove_handle ( resource $mh , resource $ch ) : int

从给定的批处理句柄mh中移除ch句柄。当ch句柄被移除以后，仍然可以合法地用curl_exec()执行这个句柄。如果要移除的句柄正在被使用，则这个句柄涉及的所有传输任务会被中止。

参数

multi_handle: 由 curl_multi_init() 返回的 cURL 多个句柄。
handle: 由 curl_init() 返回的 cURL 句柄。

返回值

成功时返回0，失败时返回CURLM_XXX中的一个。

参见

curl_init() - 初始化 cURL 会话
curl_multi_init() - 返回一个新cURL批处理句柄
curl_multi_add_handle() - 向curl批处理会话中添加单独的curl句柄

User Contributed Notes

mercury at caucasus dot net 23-Jun-2010 02:00


It is always a good idea to use curl_close() on all individual curl handles after executing curl_multi_remove_handle(). This will free up additional memory resources. So, a typical code would look like:





<?php


$ch1 = curl_init();


curl_setopt($ch1, CURLOPT_URL, 'http://www.example.com/');


curl_setopt($ch1, CURLOPT_RETURNTRANSFER, true);





$ch2 = curl_init();


curl_setopt($ch2, CURLOPT_URL, 'http://www.example.net/');


curl_setopt($ch2, CURLOPT_RETURNTRANSFER, true);





$mh = curl_multi_init();





curl_multi_add_handle($mh, $ch1);


curl_multi_add_handle($mh, $ch2);





$active = null;





do {


curl_multi_exec($mh, $active);


}


while($active);





$res1 = curl_multi_getcontent($ch1);


$res2 = curl_multi_getcontent($ch2);





curl_multi_remove_handle($mh, $ch1);


curl_multi_remove_handle($mh, $ch2);





curl_multi_close($mh);





curl_close($ch1);


curl_close($ch2);


?>