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.0 | multi_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)
Дивіться також
- curl_multi_init() - Створює набір cURL-дескрипторів