Функция curl_multi_info_read в PHP

PHP Calendar 参考手册Справочное руководство по PHP cURL

(PHP 5)

curl_multi_info_read — Получает соответствующую информацию о передаче текущего cURL


Описание

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

Проверяет, есть ли у пакетного дескриптора сообщения или информация, возвращённые отдельными потоками передачи. Сообщения могут содержать отчёты, например коды ошибок, возвращённые отдельными потоками передачи, или просто отчёты о том, завершились ли потоки передачи.

Повторные вызовы этой функции каждый раз возвращают новый результат, пока не останется информации для возврата, после чего в качестве сигнала возвращается FALSE. Целое число, возвращаемое через msgs_in_queue, указывает количество сообщений, которые останутся после вызова этой функции.

Примечание:Данные, на которые указывает возвращённый ресурс, не будут существовать после вызова curl_multi_remove_handle().


Parameters

mh

Мультидескриптор cURL, возвращённый функцией curl_multi_init().

msgs_in_queue

Количество сообщений, всё ещё находящихся в очереди.


Возвращаемые значения

Возвращает массив соответствующей информации в случае успеха или FALSE в случае неудачи.

Содержимое возвращаемого значения (содержимое возвращаемого массива)

Клавиша Значение
msg CURLMSG_DONEКонстанта. Другие возвращаемые значения в настоящее время недоступны.
result CURLE_*Одна из констант. Если всё работает без проблем, будет возвращенаCURLE_OKКонстанта.
handle Тип ресурса cURL, указывающий, к какому дескриптору он относится.

Примеры

<?php

$urls = array(
   "http://www.baidu.com/",
   "http://www.google.com.hk/",
   "http://www.w3cschool.cc/"
);

$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)

История изменений

Version Описание
5.2.0 msgs_in_queueДобавлено.

PHP Calendar 参考手册Справочное руководство по PHP cURL

Другие расширения