curl_multi_setopt
(PHP 5 >= 5.5.0, PHP 7)
curl_multi_setopt — Установить опции для множественного дескриптора cURL
Описание
К настоящему времени эта функция еще не была документирована; для ознакомления доступен только список аргументов.
Список параметров
-
multi_handle -
-
option -
Одна из констант
CURLMOPT_*. -
value -
Значение, которое необходимол установить для
option.valueдолжно быть типа int для следующих значений параметраoption:Опция Установить valueвCURLMOPT_PIPELINING1 для включения и 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.
|