Submit a Pull Request Report a Bug

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, "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);

?>

参见

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

＋add a note

User Contributed Notes 4 notes

down

w_haigh at yahoo dot com ¶

8 years ago

Here's an easier to follow example, From : http://arguments.callee.info/2010/02/21/multiple-curl-requests-with-php/

// build the individual requests, but do not execute them
$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);
  
// build the multi-curl handle, adding both $ch
$mh = curl_multi_init();
curl_multi_add_handle($mh, $ch_1);
curl_multi_add_handle($mh, $ch_2);
  
// execute all queries simultaneously, and continue when all are complete
  $running = null;
  do {
    curl_multi_exec($mh, $running);
  } while ($running);

//close the handles
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
  
// all of our requests are done, we can now access the results
$response_1 = curl_multi_getcontent($ch_1);
$response_2 = curl_multi_getcontent($ch_2);
echo "$response_1 $response_2"; // output results

down

xxavalanchexx at gmail dot com ¶

9 years ago

According to https://bugs.php.net/bug.php?id=61141:

On Windows setups using libcurl version 7.24 or later (which seems to correspond to PHP 5.3.10 or later), you may find that curl_multi_select() always returns -1, causing the example code in the documentation to timeout. This is, apparently, not strictly a bug: according to the libcurl documentation, you should add your own sleep if curl_multi_select returns -1.

Therefore, in order to work correctly on Windows for PHP 5.3.10+, the second loop in the example code should look something like the following:

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

down

Adam Richardson ¶

5 years ago

One of the URLs used in the first example on this page (lxr.php.net) now gives a proxy error.

If you're using this first script example, replace with a different URL.

down

-13

hushuilong at gmail dot com ¶

12 years ago

Simulate multiple threads request:

<?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',

)));

?>

＋add a note