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_XXX 错误代码之一。

变更日志

版本	描述
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); 
?>