curl_multi_add_handle
(PHP 5)
curl_multi_add_handle — 向curl批处理会话中添加单独的curl句柄
说明
int curl_multi_add_handle
( resource $mh
, resource $ch
)
增加 ch 句柄到批处理会话mh
参数
mh
由 curl_multi_init() 返回的 cURL 多个句柄。
ch
由 curl_init() 返回的 cURL 句柄。
返回值
成功时返回0，失败时返回CURLM_XXX之一的错误码。
范例
Example #1 curl_multi_add_handle() example
这个范例将会创建2个cURL句柄，把它们加到批处理句柄，然后并行地运行它们。
<?php
// 创建一对cURL资源
$ch1 = curl_init();
$ch2 = curl_init();
// 设置URL和相应的选项
curl_setopt($ch1, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/");
curl_setopt($ch2, CURLOPT_HEADER, 0);
// 创建批处理cURL句柄
$mh = curl_multi_init();
// 增加2个句柄
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, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
?>
参见
curl_multi_remove_handle() - 移除curl批处理句柄资源中的某个句柄资源 curl_multi_init() - 返回一个新cURL批处理句柄 curl_init() - 初始化一个cURL会话