curl_multi_setopt

(PHP 5 >= 5.5.0, PHP 7)

curl_multi_setoptУстановить опции для множественного дескриптора cURL

Описание

curl_multi_setopt ( CurlMultiHandle $multi_handle , int $option , mixed $value ) : bool

Внимание

К настоящему времени эта функция еще не была документирована; для ознакомления доступен только список аргументов.

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

multi_handle

option

Одна из констант CURLMOPT_*.

value

Значение, которое необходимол установить для option.

value должно быть типа int для следующих значений параметра option:

Опция Установить value в
CURLMOPT_PIPELINING 1 для включения и 0 для отключения. Разрешает конвейер для множественного дескриптора, что приведет к попытке использовать конвейера HTTP, если это возможно, для передачи с использованием этого дескриптора. Это значит, что если вы добавите второй запрос, который может использовать уже существующее соединение, то он будет передан "по конвейеру" этому соединению. Начиная с cURL 7.43.0 значение является битовой маской и вы можете передать 2 для попытки мультиплицирования новой передачи с помощью существующего соединения HTTP/2, если это возможно. Передача 3 инструктирует cURL запрашивать конвейеризацию и мультиплексирование независимо друг от друга. Начиная с cURL 7.62.0, установка бита конвейера не имеет никакого эффекта. Вместо численных значений вы можете использовать константы CURLPIPE_*, если они доступны.
CURLMOPT_MAXCONNECTS Задает число максимального количества одновременно открытых соединений, которые libcurl может закешировать. По умолчанию это значение задается как число дескрипторов добавленных через curl_multi_add_handle(), умноженное на 4. Когда кеш заполнится, curl закроет самые старые соединения в кеше, предотвращая увеличение количества открытых соединений.
CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE Задает пороговое значение длины пакета для конвейера в байтах.
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE Задает пороговое значение размера для "штрафа" конвейера в байтах.
CURLMOPT_MAX_HOST_CONNECTIONS Величина, определяющая максимальное количество соединений с одним хостом.
CURLMOPT_MAX_PIPELINE_LENGTH Величина, определяющая максимальное количество запросов в конвеере.
CURLMOPT_MAX_TOTAL_CONNECTIONS Величина, определяющая максимальное количество одновременно открытых соединений.
CURLMOPT_PUSHFUNCTION Передает callable, который будет зарегистрирован для обработки пушей от сервера и должен иметь следующую сигнатуру:
pushfunction ( resource $parent_ch , resource $pushed_ch , array $headers ) : int
parent_ch

Родительский обработчик cURL (запрос сделанный клиентом).

pushed_ch

Новый обработчик cURL для обработки пушей.

headers

Заголовки ожидаемого пуша.

Функция должна возвращать CURL_PUSH_OK, если может обработать пуш, или CURL_PUSH_DENY, если отклонит его.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Список изменений

Версия Описание
8.0.0 multi_handle теперь ожидает экземпляр; раньше, ожидался ресурс (resource).
7.1.0 Добавлена константа CURLMOPT_PUSHFUNCTION.
7.0.7 Добавлены константы CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE, CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, CURLMOPT_MAX_HOST_CONNECTIONS, CURLMOPT_MAX_PIPELINE_LENGTH и CURLMOPT_MAX_TOTAL_CONNECTIONS.