curl_multi_exec

(PHP 5, PHP 7, PHP 8)

curl_multi_execЗапускает субсоединения текущего cURL-дескриптора

Описание

curl_multi_exec(CurlMultiHandle $multi_handle, int &$still_running): int

Функция обрабатывает каждый дескриптор в стеке. Функцию разрешается вызывать независимо от того, требуется ли дескриптору читать или записывать данные.

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

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

?>

Смотрите также

  • curl_multi_init() - Возвращает новый мультидескриптор модуля cURL
  • curl_multi_select() - Ждёт активности на любом curl_multi соединении
  • curl_exec() - Выполняет запрос cURL