(PHP 5, PHP 7, PHP 8)
curl_multi_exec — Запускает субсоединения текущего cURL-дескриптора
Функция обрабатывает каждый дескриптор в стеке. Функцию разрешается вызывать независимо от того, требуется ли дескриптору читать или записывать данные.
multi_handle
Мультидескриптор модуля cURL, который вернула функция curl_multi_init().
still_running
Ссылка на флаг, который указывает, выполняются ли ещё операции.
Функция возвращает код состояния как значение предопределённой константы модуля cURL.
Замечание:
Функция возвращает ошибки, которые относятся только к мультистеку. Даже когда функция возвращает код
CURLM_OK
, ошибки при отдельных передачах не исключаются.
Версия | Описание |
---|---|
8.0.0 |
Параметр multi_handle теперь ожидает экземпляр класса CurlMultiHandle;
раньше ожидался ресурс (resource).
|
Пример #1 Пример использования функции curl_multi_exec()
Пример создаст два cURL-дескриптора, добавит их в мультидескриптор и обработает дескрипторы асинхронно.
<?php
// Создаём оба cURL-дескриптора
$ch1 = curl_init();
$ch2 = curl_init();
// Устанавливаем URL-адрес и другие параметры
curl_setopt($ch1, CURLOPT_URL, "http://example.com/");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/");
curl_setopt($ch2, CURLOPT_HEADER, 0);
// Создаём мультидескриптор
$mh = curl_multi_init();
// Добавляем два дескриптора в мультидескриптор
curl_multi_add_handle($mh, $ch1);
curl_multi_add_handle($mh, $ch2);
// Запускаем мультидескриптор
do {
$status = curl_multi_exec($mh, $active);
if ($active) {
// Ждём какое-то время для оживления активности
curl_multi_select($mh);
}
} while ($active && $status == CURLM_OK);
// Закрываем дескрипторы
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
?>