curl_multi_remove_handle

(PHP 5, PHP 7, PHP 8)

curl_multi_remove_handle — 从一组 cURL句柄中移除一个句柄

描述

curl_multi_remove_handle(CurlMultiHandle $multi_handle, CurlHandle $handle): int

从给定的 multi_handle 中移除给定的 handle。移除 handle 后，再次运行 curl_exec() 对这个句柄是完全合法的。在使用过程中移除 handle 将有效地停止涉及该句柄的正在进行的传输。

参数

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

返回值

成功时返回 0，或返回 CURLM_* 错误代码之一。

变更日志

版本	描述
8.0.0	`multi_handle` 现在期望一个 CurlMultiHandle 实例；以前，期望的是一个 resource。
8.0.0	`handle` 现在期望一个 CurlHandle 实例；以前，期望的是一个 resource。

参见

curl_init() - 初始化 cURL 会话
curl_multi_init() - 返回一个新的 cURL 多句柄
curl_multi_add_handle() - 将一个普通的 cURL 句柄添加到 cURL 多句柄

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加备注

用户贡献的注释 1 条注释

上移

下移

mercury at caucasus dot net ¶

14 年前

在执行 curl_multi_remove_handle() 后，始终建议对所有单个 curl 句柄使用 curl_close()。这将释放额外的内存资源。因此，典型的代码如下所示


<?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); 
?>