PHP curl_multi_info_read 函数 - PHP 5 函数参考手册

PHP curl_multi_info_read() 函数用于获取当前解析的 cURL 的相关传输信息

(PHP >= 5.0.0 )

函数原型

array curl_multi_info_read ( resource $mh [, int &$msgs_in_queue = NULL ] )

查询批处理句柄是否单独的传输线程中有消息或信息返回

消息可能包含诸如从单独的传输线程返回的错误码或者只是传输线程有没有完成之类的报告

重复调用这个函数，它每次都会返回一个新的结果，直到这时没有更多信息返回时，FALSE 被当作一个信号返回

通过 msgs_in_queue 返回的整数指出将会包含当这次函数被调用后，还剩余的消息数

注意: 返回的资源指向的数据调用 curl_multi_remove_handle() 后将不会存在

参数

参数	说明
mh	由 curl_multi_init() 返回的 cURL 多个句柄
msgs_in_queue	仍在队列中的消息数量

返回值

成功时返回相关信息的数组，失败时返回 FALSE

返回值内容（返回数组的内容）

键	值
msg	CURLMSG_DONE常量。其他返回值当前不可用
result	CURLE_*常量之一。如果一切操作没有问题，将会返回CURLE_OK常量
handle	cURL资源类型表明它有关的句柄

范例

<?php

$urls = array(
   "https://www.baidu.com/",
   "https://www.google.com.hk/",
   "https://www.twle.cn/"
);

$mh = curl_multi_init();

foreach ($urls as $i => $url) {
    $conn[$i] = curl_init($url);
    curl_setopt($conn[$i], CURLOPT_RETURNTRANSFER, 1);
    curl_multi_add_handle($mh, $conn[$i]);
}

do {
    $status = curl_multi_exec($mh, $active);
    $info = curl_multi_info_read($mh);
    if (false !== $info) {
        var_dump($info);
    }
} while ($status === CURLM_CALL_MULTI_PERFORM || $active);

foreach ($urls as $i => $url) {
    $res[$i] = curl_multi_getcontent($conn[$i]);
    curl_close($conn[$i]);
}

var_dump(curl_multi_info_read($mh));

运行以上范例，输出结果如下

array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(5) of type (curl)
}
array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(7) of type (curl)
}
array(3) {
  ["msg"]=>
  int(1)
  ["result"]=>
  int(0)
  ["handle"]=>
  resource(6) of type (curl)
}
bool(false)

更新日志

PHP 版本	说明
PHP 5.2.0	msgs_in_queue 被加入