curl_multi_info_read

(PHP 5, PHP 7, PHP 8)

curl_multi_info_read — Повертає інформацію про поточні операції

Опис

curl_multi_info_read(CurlMultiHandle $multi_handle, int &$queued_messages = null): array|false

Запитує набір дескрипторів про наявність повідомлень або інформації від індивідуальних передач. Повідомлення можуть містити таку інформацію як код помилки передачі або просто факт завершення передачі.

Виклики цієї функції, що повторюються, щоразу повертатимуть новий результат, доки не буде повернено false як сигнал закінчення повідомлень. Ціле число, що міститься в queued_messages, вказує кількість повідомлень, що залишилися після виклику цієї функції.

Увага

Дані, на які вказує ресурс, що повертається, будуть затерті викликом curl_multi_remove_handle()

Список параметрів

multi_handle

Мультидескриптор cURL, отриманий з curl_multi_init()

queued_messages

Кількість повідомлень, що залишилися в черзі

Значення, що повертаються

У разі успішного виконання повертає асоціативний масив повідомлень або **false**в случае возникновения ошибки.

Вміст масиву, що повертається

Ключ:Значение:
msgКонстанта**CURLMSG_DONE**. . Інші значення, що повертаються, поки недоступні.
resultОдна из констант**CURLE_***. . Якщо все добре, результатом буде константа CURLE_OK
handleРесурс типу curl, що вказує на дескриптор, до якого належить.

список змін

ВерсияОпис
8.0.0multi_handle тепер чекає екземпляр; раніше, очікувався ресурс (resource).

Приклади

Приклад #1 Приклад використання curl_multi_info_read()****

Loading...

Висновок наведеного прикладу буде схожим на:

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)

Дивіться також