curl_multi_init

(PHP 5, PHP 7, PHP 8)

curl_multi_init — 返回一个新的 cURL 多句柄

描述

curl_multi_init(): CurlMultiHandle

允许异步处理多个 cURL 句柄。

参数

此函数没有参数。

返回值

返回一个 cURL 多句柄。

变更日志

版本	描述
8.0.0	成功时，此函数现在返回一个 CurlMultiHandle 实例；以前，返回一个 resource。

示例

示例 #1 curl_multi_init() 示例

此示例将创建两个 cURL 句柄，将它们添加到多句柄中，并异步处理它们。

<?php
// 创建两个 cURL 资源
$ch1 = curl_init();
$ch2 = curl_init();

// 设置 URL 和其他适当的选项
curl_setopt($ch1, CURLOPT_URL, "http://lxr.php.net/");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, "https://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);

?>

参见

curl_init() - 初始化一个 cURL 会话
curl_multi_close() - 关闭一组 cURL 句柄

改进此页面

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

＋添加注释

用户贡献的注释 4 个注释

上

下

w_haigh at yahoo dot com ¶

8 年前

以下是一个更容易理解的示例，来自：http://arguments.callee.info/2010/02/21/multiple-curl-requests-with-php/

// 构建单个请求，但不要执行它们
$ch_1 = curl_init('http://webservice.one.com/');
$ch_2 = curl_init('http://webservice.two.com/');
curl_setopt($ch_1, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch_2, CURLOPT_RETURNTRANSFER, true);
  
// 构建多 curl 句柄，添加两个 $ch
$mh = curl_multi_init();
curl_multi_add_handle($mh, $ch_1);
curl_multi_add_handle($mh, $ch_2);
  
// 同时执行所有查询，并在所有查询完成后继续
$running = null;
do {
curl_multi_exec($mh, $running);
} while ($running);

// 关闭句柄
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
  
// 所有请求都完成了，我们现在可以访问结果
$response_1 = curl_multi_getcontent($ch_1);
$response_2 = curl_multi_getcontent($ch_2);
echo "$response_1 $response_2"; // 输出结果

上

下

xxavalanchexx at gmail dot com ¶

10 年前

根据 https://bugs.php.net/bug.php?id=61141:

在使用 libcurl 版本 7.24 或更高版本的 Windows 设置（似乎对应于 PHP 5.3.10 或更高版本）上，您可能会发现 curl_multi_select() 始终返回 -1，导致文档中的示例代码超时。这显然不是严格的错误：根据 libcurl 文档，如果 curl_multi_select 返回 -1，您应该添加自己的休眠。

因此，为了在 PHP 5.3.10+ 的 Windows 上正常工作，示例代码中的第二个循环应该类似于以下代码

<?php
while ($active && $mrc == CURLM_OK) {
 if (curl_multi_select($mh) == -1) {
 usleep(100);
 }
 do {
 $mrc = curl_multi_exec($mh, $active);
 } while ($mrc == CURLM_CALL_MULTI_PERFORM);
}
?>

上

下

Adam Richardson ¶

6 年前

此页面上第一个示例中使用的 URL 之一（lxr.php.net）现在返回代理错误。

如果您使用的是第一个脚本示例，请替换为其他 URL。

上

下

-16

hushuilong at gmail dot com ¶

13 年前

模拟多个线程请求
<?php 
function multiple_threads_request($nodes){ 
 $mh = curl_multi_init(); 
 $curl_array = array(); 
 foreach($nodes as $i => $url) 
 { 
 $curl_array[$i] = curl_init($url); 
 curl_setopt($curl_array[$i], CURLOPT_RETURNTRANSFER, true); 
 curl_multi_add_handle($mh, $curl_array[$i]); 
 } 
 $running = NULL; 
 do { 
 usleep(10000); 
 curl_multi_exec($mh,$running); 
 } while($running > 0); 
 
 $res = array(); 
 foreach($nodes as $i => $url) 
 { 
 $res[$url] = curl_multi_getcontent($curl_array[$i]); 
 } 
 
 foreach($nodes as $i => $url){ 
 curl_multi_remove_handle($mh, $curl_array[$i]); 
 } 
 curl_multi_close($mh); 
 return $res; 
} 
print_r(muti_thread_request(array( 
 'http://www.example.com', 
 'http://www.example.net', 
))); 
?>

＋添加注释