curl_multi_add_handle

(PHP 5, PHP 7, PHP 8)

curl_multi_add_handle — 添加普通 cURL 句柄到 cURL 多句柄

说明

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

增加 handle 句柄到多句柄 multi_handle

参数

multi_handle

由 curl_multi_init() 返回的 cURL 多个句柄。

handle

由 curl_init() 返回的 cURL 句柄。

返回值

成功时返回 0，失败时返回 CURLM_XXX 之一的错误码。

更新日志

版本 说明
8.0.0 multi_handle expects a CurlMultiHandle instance now; previously, a resource was expected.
8.0.0 handle 现在接受 CurlHandle 实例；之前接受 resource。

示例

示例 #1 curl_multi_add_handle() 示例

此示例将创建两个 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();

// 新增两个句柄
curl_multi_add_handle($mh,$ch1);
curl_multi_add_handle($mh,$ch2);

// 执行多句柄
do {
$status = curl_multi_exec($mh, $active);
if ($active) {
curl_multi_select($mh);
}
} while ($active && $status == CURLM_OK);

// 关闭全部句柄
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
?>

参见