Функция curl_multi_info_read в PHP
Справочное руководство по 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Добавлено. |
Другие расширения