Предопределённые константы

Разрешает соединяться с абстрактным сокетом Unix-домена вместо установления TCP-соединения с хостом и устанавливает путь к заданной строке string. Опция следует той же семантике, что и опция CURLOPT_UNIX_SOCKET_PATH. Обе опции разделяют одно хранилище, поэтому для каждого дескриптора разрешается установить только одну. Константа доступна с PHP 7.3.0 и cURL 7.53.0.

Передаёт название файла модулю cURL, который функция будет использовать как Alt-Svc-файл кеша для чтения существующего содержимого кеша и, возможно, также записи данных обратно в файл после передачи, если только для опции CURLOPT_ALTSVC_CTRL не установили значение CURLALTSVC_READONLYFILE. Константа доступна с 8.2.0 и cURL 7.64.1.

Заполняет битовую маску правильным набором функций, чтобы проинструктировать дескриптор cURL, как обрабатывать файл Alt-Svc при обмене данными через дескриптор. cURL-дескриптор принимает заголовки файла Alt-Svc только по HTTPS-протоколу. Функция выполнит запрос к альтернативному источнику, только если источник правильно работает по HTTPS-протоколу. Установка хотя бы одного бита включит механизм Alt-Svc. Поведение кеша определяет следующий набор опций: CURLALTSVC_H1, CURLALTSVC_H2, CURLALTSVC_H3 и CURLALTSVC_READONLYFILE. Константа доступна с 8.2.0 и cURL 7.64.1.

Значение true автоматически установит значение поля Referer: в HTTP-заголовках запросов, которые следуют по URL-адресу перенаправления в заголовке ответа Location:.

Аутентифицирует запрос к веб-службам компании Amazon по AWS-подписи версии 4 в HTTP- или HTTPS-заголовках. Опция переопределяет другие типы аутентификации, которые установили в опции CURLOPT_HTTPAUTH. Этот метод нельзя комбинировать с другими типами аутентификации. Константа доступна с 8.2.0 и cURL 7.75.0.

Размер буфера, который функция будет использовать при каждом чтении данных. При этом функция не гарантирует, что обработает запрос. Константа доступна с cURL 7.10.

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

Имя PEM-файла, в котором содержится один или набор сертификатов для проверки узла. Опция переопределяет опцию CURLOPT_CAINFO. Константа доступна с 8.2.0 и cURL 7.77.0.

Каталог, который содержит набор сертификатов удостоверяющего центра. Опцию указывают вместе с опцией CURLOPT_SSL_VERIFYPEER.

Константа доступна с 8.3.0 и cURL 7.87.0.

Значение true выводит информацию о SSL-сертификации в поток STDERR при безопасной передаче. Константу добавили в cURL 7.19.1. Константа будет работать, только если включить опцию CURLOPT_VERBOSE.

Количество секунд, которое функция потратит на попытку установить подключение. Значение 0 включит бесконечное ожидание.

Количество миллисекунд, которое функция потратит на попытку установить подключение. Значение 0 включит бесконечное ожидание. Эта часть соединения по-прежнему будет использовать разрешение в целую секунду для пределов времени, у которых минимальное допустимое время ожидания равно одной секунде, если библиотеку libcurl собрали со стандартным резольвером имён системы. Константа доступна с cURL 7.16.2.

Значение true сообщает библиотеке, что требуется аутентифицировать прокси-сервер и настройку соединения, но не передавать данные. Опцию реализовали для работы с протоколами HTTP, SMTP и POP3. Константа доступна с cURL 7.15.2.

Подключается к заданному хосту и порту, а не хосту и порту URL-адреса. Опция принимает массив строк в формате HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. Константа доступна с 7.0.7 и cURL 7.49.0.

Содержимое заголовка "Cookie: ", которое функция будет использовать в HTTP-запросе. Обратите внимание, что блоки данных cookie разделяются точкой с запятой, за которой следует пробел: "fruit=apple; colour=red".

Имя файла, который содержит блоки данных cookies. Блоки cookie записывают в файл в формате Netscape или прямо простыми заголовками в HTTP-стиле, которые сбросили в файл. Функция не будет загружать блоки данных cookies, но обработка cookies останется включённой, если имя файла окажется пустой строкой.

Название файла, в котором будут сохраняться внутренние cookie при вызове деструктора дескриптора.

Строка блока данных cookie (то есть одна строка в формате Netscape/Mozilla или стандартный заголовок Set-Cookie в HTTP-стиле) добавляет единственный блок cookie во внутреннее хранилище блоков данных cookie. Значение "ALL" стирает все cookie, которые хранятся в памяти. Значение "SESS" удаляет из памяти все блоки данных cookie сессии. Значение "FLUSH" записывает все известные блоки данных cookie в файл, который указали в опции CURLOPT_COOKIEJAR. Значение "RELOAD" загружает все блоки данных cookie из файлов, которые указали в опции CURLOPT_COOKIEFILE. Константа доступна с cURL 7.14.1

Значение true помечает этот блок данных как новую «сессию» блоков cookie. Это заставит библиотеку libcurl игнорировать каждый блок данных cookie, который она собирается загрузить и который относится к «сеансовым cookie» предыдущей сессии. По умолчанию библиотека libcurl каждый раз сохраняет и загружает каждый блок данных cookie, независимо от того, принадлежат ли они к сессионным cookies или нет. Сеансовые cookie — cookie без даты истечения срока действия, и они должны быть живыми и существующим только для этой «сессии».

Значение true преобразовывает символ новой строки, который указывают в системах Unix, в последовательность символов CRLF при передаче.

Пользовательский метод запроса, который функция будет использовать вместо "GET" или "HEAD" при отправке HTTP-запроса. Это полезно при запросах "DELETE" или других, более редких HTTP-запросах. Допустимые значения: "GET", "POST", "CONNECT" и так далее; т. е. здесь не нужно вводить всю строку с HTTP-запросом. Например, значение "GET /index.html HTTP/1.0\r\n\r\n" будет неправильным.

Замечание:

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

Протокол по умолчанию, который функция будет использовать, если название схемы отсутствует в URL-адресе. Константа доступна с 7.0.7 и cURL 7.45.0.

Со значением true опция запрещает URL-адреса с именем пользователя. По умолчанию имена пользователей разрешаются — значение по умолчанию равно 0. Константа доступна с 7.3.0 и cURL 7.61.0.

Количество секунд, в течение которых в памяти хранятся DNS-записи. По умолчанию значение опции равно 120 секундам, что эквивалентно 2 минутам.

Устанавливает имя сетевого интерфейса, к которому требуется привязать резольвер DNS-имён. Опция принимает только имена интерфейса, а не адреса. Константа доступна с 7.0.7 и cURL 7.33.0.

Устанавливает локальный IPv4-адрес, к которому требуется привязать резольвер. Опция принимает только аргументы, которые содержат один числовой IPv4-адрес в виде строки. Константа доступна с 7.0.7 и cURL 7.33.0.

Устанавливает локальный IPv6-адрес, к которому требуется привязать резольвер. Опция принимает только аргументы, которые содержат один числовой IPv6-адрес в виде строки. Константа доступна с 7.0.7 и cURL 7.33.0.

Со значением true опция перемешивает адреса, которые вернул DNS-сервер, так, чтобы адреса выбирались в случайном порядке, когда имя разрешилось и DNS сервер вернул больше одного IP-адреса. Иногда из-за этого функция выбирает IPv4-адрес раньше IPv6-адреса и наоборот. Константа доступна с 7.3.0 и cURL 7.60.0.

Опции указывают значение true, чтобы функция разрешала имена через глобальный DNS-кеш. Опция непотокобезопасна. По умолчанию опция условно включена, если PHP собрали не для безопасной работы в потоках (в командной оболочке CLI, через интерфейс FCGI, модуль Apache2-Prefork, который работает на основе процессов, а не потоков, и т. д.).

Проверяет поля имени SSL-сертификата DoH-сервера на соответствие имени хоста. Константа доступна с 8.2.0 и cURL 7.76.0.

Проверяет подлинность SSL-сертификата DoH-сервера. Константа доступна с 8.2.0 и cURL 7.76.0.

Просит дескриптор cURL проверить статус сертификата DoH-сервера через TLS-расширение «Запрос статуса сертификата» (OCSP-сшивание). Константа доступна с 8.2.0 и cURL 7.76.0.

Задаёт URL-адрес, по которому DoH-сервер будет разрешать имена. Константа доступна с 8.1.0 и cURL 7.62.0.

Аналогична опции CURLOPT_RANDOM_FILE, за исключением имени файла сокета демона сбора энтропии (Entropy Gathering Daemon).

Содержимое заголовка "Accept-Encoding: ". Опция помогает декодировать ответ. Опция поддерживает следующие кодировки: "identity", "deflate" и "gzip". При установке пустой строки — "" — отправляется заголовок, который содержит все типы кодировок, которые поддерживает опция. Константа доступна с cURL 7.10.

Время ожидания ответов с заголовком Expect: 100-continue в миллисекундах. Значение по умолчанию равно 1000 миллисекунд. Константа доступна с 7.0.7 и cURL 7.36.0.

Со значением true опция возвращает подробную информацию о сбое, если вернулся HTTP-код ответа, который больше или равен 400. Поведение по умолчанию возвращает страницу, а код игнорирует.

Файл, в который функция запишет результат передачи. По умолчанию функция отправляет вывод в поток STDOUT — окно браузера.

Со значением true функция попытается получить дату изменения удалённого документа. Значение также получают функцией curl_getinfo() с опцией CURLINFO_FILETIME.

Со значением true дескриптор следует перенаправлениям заголовка ответа "Location: ", который сервер отправляет в HTTP-заголовках. Смотрите также описание опции CURLOPT_MAXREDIRS. Константа недоступна, если включили директиву open_basedir.

Значение true принудительно закрывает соединение после завершения обработки, чтобы соединение не попадало в пул открытых соединений и становилось недоступным для повторной передачи.

Значение true принудительно устанавливает новое соединение вместо передачи через кешированное.

Со значением true опция добавляет данные в конец файла на удалённом источнике, а не перезаписывает.

Псевдоним опции CURLOPT_TRANSFERTEXT. Лучше предпочесть оригинальную опцию, а не псевдоним.

Со значением true опция перечисляет только список имён файлов в FTP-каталоге, а не информацию о размерах, датах и т. д.

Значение, которое функция будет использовать, чтобы получить IP-адрес для FTP-команды "PORT". Команда "PORT" просит удалённый сервер подключиться к заданному через опцию IP-адресу. Опция принимает значения в виде простого IP-адреса, имени хоста, имени сетевого интерфейса (в системах Unix) или простого дефиса '-', чтобы использовать системный IP-адрес по умолчанию.

Устанавливает метод FTP-аутентификации (в активном режиме): CURLFTPAUTH_SSL — сначала проверяется SSL-протокол, CURLFTPAUTH_TLS — сначала проверяется TLS-протокол или CURLFTPAUTH_DEFAULT — дескриптор cURL решает сам. Константа доступна с cURL 7.12.2.

Со значением true опция создаёт несуществующие каталоги, если FTP-операция обнаруживает путь, который не существует.

Сообщает, каким методом получать доступ к файлу на FTP- или SFTP-сервере. Опция принимает возможные значения: CURLFTPMETHOD_DEFAULT, CURLFTPMETHOD_MULTICWD, CURLFTPMETHOD_NOCWD м CURLFTPMETHOD_SINGLECWD. Константа доступна с cURL 7.15.1.

Для опции указывают значение true, чтобы функция отправляла EPRT- и LPRT-команды при активных FTP-загрузках. Значение false отключит команды EPRT и LPRT и функция будет передавать только команду PORT.

Со значением true функция сначала пробует команду EPSV для передачи по FTP-протоколу, прежде чем откатиться к команде PASV. Значение false отключает передачу EPSV-команды.

Отдаёт преимущество IPv6-протоколу при подключении по алгоритму Happy Eyeballs. Алгоритм Happy Eyeballs пытается подключиться как к IPv4-адресам, так и к IPv6-адресам хостов с двойным стеком, но сначала на время ожидания в миллисекундах отдаёт преимущество протоколу IPv6. Значение по умолчанию — CURL_HET_DEFAULT, которое составляет 200 миллисекунд. Константа доступна с 7.3.0 и cURL 7.59.0.

Со значением true функция отправляет заголовок протокола HAProxy PROXY v1 в начале соединения. Действие по умолчанию — не отправлять этот заголовок. Константа доступна с 7.3.0 и cURL 7.60.0.

Значение true включает заголовок в вывод.

Callback-функция, которая принимает два аргумента. Первый — cURL-ресурс, второй — строка с данными заголовка, которые требуется записать. Записать данные заголовков требуется этой функцией обратного вызова. Функция возвращает количество байтов, которое она записала.

Отправляет заголовки прокси-серверу и хосту, или отдельно. Опция принимает значения CURLHEADER_UNIFIED и CURLHEADER_SEPARATE. С cURL 7.42.1 значение по умолчанию равно CURLHEADER_SEPARATE, в предыдущих версиях значение по умолчанию равнялось CURLHEADER_UNIFIED. Константа доступна с 7.0.7 и cURL 7.37.0.

Имя файла HSTS-кеша (HTTP Strict Transport Security). Константа доступна с 8.2.0 и cURL 7.74.0.

Управляет поведением механизма HSTS (HTTP Strict Transport Security). Заполните битовую маску правильным набором значений, чтобы проинструктировать дескриптор cURL, как обрабатывать HSTS-хосты при передаче с этим дескриптором. Константа CURLHSTS_ENABLE включает запоминаемый (in-memory) кеш HSTS. Если файл HSTS-кеша определили, установка значения CURLHSTS_READONLYFILE сделает файл доступным только для чтения. Константа доступна с 8.2.0 и cURL 7.74.0.

Определяет, разрешить ли ответы по протоколу HTTP/0.9. Начиная с libcurl 7.66.0 значение по умолчанию равно false; раньше значение по умолчанию равнялось true. Константа доступна с PHP 7.3.15 или 7.4.3 и cURL 7.64.0.

Массив ответов с HTTP-кодом 200, которые будут рассматриваться как действительные ответы, а не как ошибки. Константа доступна с cURL 7.10.3.

Устанавливает метод HTTP-аутентификации. Опция принимает следующие значения: CURLAUTH_BASIC, CURLAUTH_DIGEST, CURLAUTH_GSSNEGOTIATE, CURLAUTH_NTLM, CURLAUTH_AWS_SIGV4, CURLAUTH_ANY и CURLAUTH_ANYSAFE. Побитовый оператор ИЛИ — | — указывают, чтобы объединить больше одного метода. При объединении методов дескриптор cURL опросит сервер, чтобы узнать, какие методы поддерживает сервер, и выберет лучший. Параметр CURLAUTH_ANY устанавливает все биты. Дескриптор cURL автоматически выберет тот, который посчитает самым безопасным. Параметр CURLAUTH_ANYSAFE устанавливает все биты, кроме CURLAUTH_BASIC. дескриптор cURL автоматически выберет тот, который посчитает самым безопасным.

Со значением true опция сбрасывает HTTP-метод запроса на метод GET. Поскольку метод GET — метод по умолчанию, опцию передают, только если метод HTTP-запроса для того же дескриптора изменяли на другой.

Массив полей HTTP-заголовка для установки в формате array('Content-type: text/plain', 'Content-length: 100')

Значение true включает туннелирование каждого запроса через HTTP-прокси.

Со значением false опция возвращает необработанное тело HTTP-ответа. Константа доступна с cURL 7.16.2.

Опция принимает следующие значения: CURL_HTTP_VERSION_NONE (значение по умолчанию; CURL сам решает, какую версию использовать), CURL_HTTP_VERSION_1_0 (принудительно соединяться по протоколу HTTP/1.0), CURL_HTTP_VERSION_1_1 (принудительно соединяться по протоколу HTTP/1.1), CURL_HTTP_VERSION_2_0 (попытаться соединиться по протоколу HTTP/2.0), CURL_HTTP_VERSION_2 (псевдоним параметра CURL_HTTP_VERSION_2_0), CURL_HTTP_VERSION_2TLS (попытаться соединиться только по протоколу HTTP/2.0 по протоколу TLS (HTTPS)) или CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (выполнять HTTP-запросы без TLS по протоколу HTTP/2.0 без отката до протокола HTTP/1.1).

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

Предполагаемый размер файла в байтах при отправке файла на удалённый сайт. Обратите внимание, опция не ограничивает объём данных, которые библиотека libcurl фактически отправляет, поскольку фактический объём передаваемых данных зависит от того, что возвращает callback-функция опции CURLOPT_READFUNCTION.

Название исходящего сетевого интерфейса, который надо использовать. Опция принимает значения в виде имени интерфейса, IP-адреса или имени хоста.

Разрешает приложению выбрать, какие IP-адреса использовать при разрешении имён хостов. Это интересно только для имён хостов, которые разрешают адреса больше чем в одну версию IP-протокола. Опция принимает следующие значения: CURL_IPRESOLVE_WHATEVER, CURL_IPRESOLVE_V4, CURL_IPRESOLVE_V6 и по умолчанию — CURL_IPRESOLVE_WHATEVER.. Константа доступна с cURL 7.10.8.

SSL-сертификат издателя из блока памяти, который содержит двоичные данные сертификата удостоверяющего центра. Константа доступна с 8.1.0 и cURL 7.71.0.

Со значением true опция продолжает отправку тела запроса, если HTTP-код возврата равен или больше 300. Действие по умолчанию остановило бы отправку и закрыло поток или соединение. Опцию указывают при ручной NTLM-аутентификации. Большей части приложений опция не требуется. Константа доступна с 7.3.0 и cURL 7.51.0.

Пароль, который требуется закрытому ключу в опции CURLOPT_SSLKEY или CURLOPT_SSH_PRIVATE_KEYFILE. Константа доступна с cURL 7.16.1.

Уровень безопасности KRB4 (сетевой протокол аутентификации Kerberos 4). Опция принимает следующие значения в порядке от наименее к наиболее сильному: "clear", "safe", "confidential", "private".. Опция будет использовать значение "private", если аргумент опции окажется строкой, которая не совпадает со значениями списка. Опция отключит KRB4-безопасность при установке значения null. Защита KRB4 работает пока только с FTP-транзакциями.

Устанавливает параметры входа в систему для конкретного протокола, например, указывает предпочтительный механизм аутентификации через "AUTH=NTLM" или "AUTH=*", и работает в связке с опцией CURLOPT_USERNAME. Константа доступна с 7.0.7 и cURL 7.34.0.

PHP посчитает скорость передачи чрезмерно низкой и прервёт передачу, если в течение заданного опцией CURLOPT_LOW_SPEED_TIME количества секунд скорость передачи в байтах в секунду будет ниже значения этой опции.

Количество секунд, в течение которых скорость будет ниже значения опции CURLOPT_LOW_SPEED_LIMIT, перед тем как PHP посчитает скорость передачи чрезмерно низкой и прервёт передачу.

При отправке данных больше чем одному получателю cURL по умолчанию прерывает SMTP-диалог, если хотя бы один получатель отправляет ошибку на команду RCPT TO. Эта опция заставляет cURL игнорировать ошибки и продолжать с оставшимися допустимыми получателями. С этим флагом cURL прервёт SMTP-диалог и вернёт ошибку, которую получил от последней команды RCPT TO, если все получатели вызвали ошибку команды RCPT TO. Константа доступна с 8.2.0 и cURL 7.69.0.

Максимальное время простоя, в течение которого модулю разрешается оценивать существующее соединение как доступное для повторной передачи. По умолчанию максимальный срок равен 118 секундам. Константа доступна с 8.2.0 и cURL 7.65.0.

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

Максимальный размер файла в байтах, который модулю разрешается скачивать. Передача не начнётся и вернёт значение константы CURLE_FILESIZE_EXCEEDED, если размер файла, который запросил дескриптор, окажется больше этого значения. Опция не влияет на скачивание файлов, размер которых функция не знает до скачивания, даже если в итоге размер файла превысит предел.

Максимальное время в секундах с момента установки соединения, в течение которого модулю разрешается оценивать существующее соединение как доступное для повторной передачи. Если функция обнаружит в кеше соединение старше этого значения, она закроет просроченное соединение, как только завершит текущие передачи. Значение по умолчанию, которое равно 0 секунд, отключает опцию и делает каждое соединение доступным для повторной передачи. Константа доступна с 8.2.0 и cURL 7.80.0.

Максимальное количество HTTP-перенаправлений, которому разрешается следовать. Опцию указывают вместе с опцией CURLOPT_FOLLOWLOCATION. Значение по умолчанию, которое равно 20, предотвращает бесконечные перенаправления. Установка значения -1 разрешит бесконечные перенаправления, а значение 0 откажет в перенаправлениях.

Если совокупная средняя в течение передачи скорость скачивания превысит это значение в байтах в секунду, то функция приостановит скачивание, чтобы поддерживать среднюю скорость ниже или равной значению опции. По умолчанию скорость не ограничивается. Константа доступна с cURL 7.15.5.

Если совокупная средняя в течение передачи скорость отправки данных превысит это значение в байтах в секунду, то функция приостановит отправку, чтобы поддерживать среднюю скорость ниже или равной значению опции. По умолчанию скорость не ограничивается. Константа доступна с cURL 7.15.5.

Константа доступна с 8.3.0 и cURL 7.81.0.

Со значением true функция отключит сообщения функций модуля cURL. Константу удалили с cURL 7.15.5; вместо неё указывают опцию CURLOPT_RETURNTRANSFER.

Со значением true функция будет сканировать файл ~/.netrc, чтобы найти имя пользователя и пароль удалённого сайта, с которым устанавливается соединение.

Со значением true опция исключает тело ответа из вывода. Затем для HTTP-метода запроса устанавливается значение HEAD. Изменение значения этой опции на false не изменяет метод на GET.

Значение true отключает индикатор прогресса cURL-передачи.

Замечание:

PHP автоматически устанавливает опции значение true. Значение изменяют только в целях отладки.

Со значением true опция игнорирует функции модуля cURL, которые вызывают отправку сигнала PHP-процессу. В многопоточных SAPI-интерфейсах опция включается по умолчанию, поэтому по-прежнему разрешается использовать параметры времени ожидания. Константа доступна с cURL 7.10.

Callback-функция, которая принимает три аргумента. Первым идёт cURL-дескриптор, вторым — строка с запросом пароля, третьим — максимальная длина пароля. Функция обратного вызова должна вернуть строку с паролем. Константу удалили с PHP 7.3.0.

Пароль для аутентификации. Константа доступна с cURL 7.19.1.

Со значением true функция игнорирует обработку последовательностей из двух точек в названиях путей. Константа доступна с 7.0.7 и cURL 7.42.0.

Прикрепляет открытый ключ. Строка содержит или название PEM- или DEX-файла с открытым ключом, который прикрепит опция, sha256-хеши с префиксом "sha256//" в кодировке base64, которые разделили точкой с запятой ";". Константа доступна с 7.0.7 и cURL 7.39.0.

Значение true укажет модулю дождаться соединения, чтобы подтвердить или опровергнуть конвейеризацию или мультиплексирование перед продолжением работы. Константа доступна с 7.0.7 и cURL 7.43.0.

Альтернативный номер порта для подключения.

Со значением true функция выполняет стандартный запрос HTTP-методом POST. Этот вид POST-запроса устанавливает тип тела запроса application/x-www-form-urlencoded, который часто встречается при отправке HTML-форм.

Полные данные для отправки в HTTP-запросе методом POST. Параметр передаёт данные либо как URL-кодированную строку наподобие 'para1=val1&para2=val2&...', либо как массив, в котором названия полей — ключи, а поля с данными — значения. Функция установит для заголовка Content-Type значение multipart/form-data, если значением параметра value окажется массив. Файлы отправляют как объекты классов CURLFile или CURLStringFile, которые присваивают значениям ассоциативного массива, который передают в параметр value.

Массив FTP-команд, которые требуется выполнить на сервере после выполнения FTP-запроса.

Битовая маска из значений 1 (301 Moved Permanently), 2 (302 Found) и 4 (303 See Other), которую устанавливают, когда требуется продолжать обработку HTTP-запроса методом POST при наступлении конкретного типа перенаправления и установленной опции CURLOPT_FOLLOWLOCATION. Константа доступна с cURL 7.19.1.

Устанавливает строку (string), которая содержит название хоста или точечно-числовой IP-адрес, который функция будет использовать как предварительный прокси, к которому библиотека curl подключается перед подключением к HTTP- или HTTPS-прокси, который указали в опции CURLOPT_PROXY для запроса, который предстоит выполнить. В качестве значения предварительного прокси-сервер опция принимает только SOCKS-прокси с префиксом, который указывает тип сокета, например socks4://. Числовой IPv6-адрес требуется записывать внутри квадратных скобок, например socks5://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]. Установка препрокси в виде пустой строки явно отключит подключение через предварительный прокси. Номер порта добавляют в конце строки препрокси после имени хоста через двоеточие, например: socks5://127.0.0.1:1080. Номер порта прокси также указывают отдельно — в опции CURLOPT_PROXYPORT. Значение по умолчанию для порта прокси — 1080, если порт не указали. Константа доступна с 7.3.0 и cURL 7.52.0.

Данные, которые требуется связать с cURL-дескриптором. Эти данные затем будут доступны для извлечения через вызов функции curl_getinfo() с флагом CURLINFO_PRIVATE. cURL-дескриптор ничего не делает с этими данными. При работе с cURL-мультидескриптором эти закрытые данные обычно играют роль уникального ключа для идентификации простого cURL-дескриптора. Константа доступна с cURL 7.10.3.

Callback-функция, которая принимает пять аргументов. Первый — cURL-дескриптор, второй — общее количество байтов, которое, как ожидается, функция скачает в текущей передаче, третий — количество байтов, которые функция уже скачала, четвёртый — общее количество байтов, которое, как ожидается, функция передаст в этой передаче, и пятый — количество байтов, которые функция уже передала.

Замечание:

Callback-функция вызывается, только если для опции CURLOPT_NOPROGRESS установили значение false.

Битовая маска из значений констант семейства CURLPROTO_*. Битовая маска ограничивает протоколы, по которым библиотеке libcurl разрешается передавать данные. Ограничение протоколов помогает настраивать библиотеку libcurl на поддержку широкого диапазона протоколов, но при этом ограничивать отдельные передачи разрешением на работу только с частью протоколов. По умолчанию библиотека libcurl будет принимать все протоколы, которые она поддерживает. Дополнительную информацию даёт описание опции CURLOPT_REDIR_PROTOCOLS. Допустимые опции, которыми устанавливают протоколы: CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_FTP, CURLPROTO_FTPS, CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_TELNET, CURLPROTO_LDAP, CURLPROTO_LDAPS, CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_TFTP, CURLPROTO_MQTT и CURLPROTO_ALL. Константа доступна с cURL 7.19.4.

Константа доступна с 8.3.0 и cURL 7.85.0.

HTTP-прокси для туннелирования запросов.

Метод или методы HTTP-аутентификации для прокси-соединения. Опция принимает те же битовые маски, которые даёт описание опции CURLOPT_HTTPAUTH. Пока для прокси-аутентификации поддерживаются только опции CURLAUTH_BASIC и CURLAUTH_NTLM. Константа доступна с cURL 7.10.7.

Массив пользовательских HTTP-заголовков для передачи прокси. Константа доступна с 7.0.7 и cURL 7.37.0.

Номер порта прокси-сервера, к которому требуется подключиться. Номер порта также устанавливают отдельно — через опцию CURLOPT_PROXY.

Или CURLPROXY_HTTP (по умолчанию), CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A, или CURLPROXY_SOCKS5_HOSTNAME. Константа доступна с cURL 7.10.

Имя пользователя и пароль в формате username:password для подключения к прокси-серверу.

Путь к пакету сертификатов прокси-сервера, которые выдал центр сертификации. Опция принимает строку (string) с названием файла, который содержит один или набор сертификатов для проверки HTTPS-прокси. Назначение параметра — подключение к прокси-серверу по протоколу HTTPS, а не к HTTPS-серверу. По умолчанию опция содержит системный путь хранения, по которому предполагает найти cacert-файл с пакетом сертификатов библиотеки libcurl. Константа доступна с 7.3.0 и cURL 7.52.0.

Имя PEM-файла, который содержит один или набор сертификатов для проверки HTTPS-прокси. Назначение параметра — подключение к прокси-серверу по протоколу HTTPS, а не к HTTPS-серверу. По умолчанию опция содержит системный путь хранения, по которому предполагает найти cacert-файл с пакетом сертификатов библиотеки libcurl. Константа доступна с 8.2.0 и cURL 7.77.0.

Каталог, который содержит набор сертификатов центра сертификации для проверки HTTPS-прокси. Константа доступна с 7.3.0 и cURL 7.52.0.

Устанавливает название файла путём конкатенации списка отзыва сертификатов (англ. Certificate Revocation List, CRL) в формате PEM для проверки сертификата во время SSL-обмена. Константа доступна с 7.3.0 и cURL 7.52.0.

Название файла издателя SSL-сертификата прокси-сервера. Константа доступна с 8.1.0 и cURL 7.71.0.

SSL-сертификат издателя для прокси-сервера, который хранится в блоке памяти, который содержит двоичные данные сертификата удостоверяющего центра. Константа доступна с 8.1.0 и cURL 7.71.0.

Устанавливает строку, которую функция будет использовать как пароль, который требуется для подключения к HTTPS-прокси с закрытым ключом CURLOPT_PROXY_SSLKEY. Парольная фраза не нужна для загрузки сертификата, но она требуется для загрузки закрытого ключа отправителя. Назначение параметра — подключение к прокси-серверу по протоколу HTTPS, а не к HTTPS-серверу. Константа доступна с 7.3.0 и cURL 7.52.0.

Устанавливает закреплённый открытый ключ для HTTPS-прокси. Опция принимает строку с именем файла прикреплённого открытого ключа отправителя. Опция ждёт файл в формате PEM или DER. Опция также принимает строку с sha256-хешами с префиксом "sha256//" в кодировке base64, которые разделили точкой с запятой ";". Константа доступна с 7.3.0 и cURL 7.52.0.

Название службы аутентификации прокси-сервера. Константа доступна с PHP 7.0.7, cURL 7.43.0 (для HTTP-прокси) и cURL 7.49.0 (для SOCKS5-прокси).

Название файла клиентского сертификата отправителя для подключения к прокси-серверу по HTTPS-протоколу. Формат по умолчанию — P12 для защищенного протокола транспортного уровня и PEM для других движков; формат можно изменить опцией CURLOPT_PROXY_SSLCERTTYPE. При работе с библиотекой NSS или по защищённым транспортным протоколам (Secure Transport) опция также принимает псевдоним сертификата, с которым отправитель проходит аутентификацию. Псевдоним указывают так, как он хранится в базе данных безопасности. Перед названием файла — если требуется файл из текущего каталога — добавляют префикс «./», чтобы избежать путаницы с псевдонимом сертификата. Константа доступна с 7.3.0 и cURL 7.52.0.

Формат клиентского сертификата отправителя для подключения к прокси-серверу по HTTPS-протоколу. Опция поддерживает форматы PEM и DER, за исключением подключений к системам с движком на базе защищённых транспортных протоколов (Secure Transport). Механизмы на основе библиотеки OpenSSL (версии 0.9.3 или новее) и защищённых транспортных протоколов Secure Transport (на операционных системах iOS 5 или новее, или OS X 10.7 или новее) поддерживают также формат P12 для PKCS#12-кодированных файлов. Значение по умолчанию равно "PEM". Константа доступна с 7.3.0 и cURL 7.52.0.

Клиентский сертификат SSL-прокси из блока памяти, который содержит двоичные данные сертификата. Константа доступна с 8.1.0 и cURL 7.71.0.

Название файла закрытого ключа отправителя для подключения к HTTPS-прокси. Формат по умолчанию: "PEM"; формат можно изменить опцией CURLOPT_PROXY_SSLKEYTYPE. Следующая часть параграфа относится только к операционным системам iOS и Mac OS X: функция игнорирует опцию, если модуль cURL собрали с поддержкой защищённых протоколов транспортного уровня (Secure Transport). Опция доступна с включённой встроенной поддержкой TLS-протокола. Константа доступна с 7.3.0 и cURL 7.52.0.

Устанавливает формат закрытого ключа отправителя. Опция поддерживает форматы: PEM, DER и ENG. Константа доступна с 7.3.0 и cURL 7.52.0.

Закрытый ключ для сертификата прокси-сервера из блока памяти, который содержит двоичные данные сертификата. Константа доступна с 8.1.0 и cURL 7.71.0.

Константа из следующего списка: CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3, CURL_SSLVERSION_MAX_DEFAULT, CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3, CURL_SSLVERSION_SSLv3 .

Определяет список шифров для подключения к прокси-серверу по HTTPS-протоколу. Опция принимает только синтаксически корректный список, который состоит из одного или нескольких строковых значений с названиями шифров, разделенных двоеточиями. Опция также принимает разделители в виде запятых и пробелов, но чаще пользуются двоеточием, а символы !, - и + указывают как операторы. Константа доступна с 7.3.0 и cURL 7.52.0.

Устанавливает параметры поведения SSL-прокси. Параметры устанавливают как битовую маску из следующих констант: CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_NO_PARTIALCHAIN Константа доступна с 7.3.0 и cURL 7.52.0.

Значение 2 устанавливают, чтобы сверить поля имени сертификата HTTPS-прокси с именем прокси-сервера. Со значением 0 соединение успешно выполняется независимо от имён в сертификате. При работе с опцией соблюдают осторожность! В curl 7.28.0 и более ранних версиях значение 1 рассматривается как опция отладки. С версии curl 7.28.1 до 7.65.3 функция возвращает ошибку CURLE_BAD_FUNCTION_ARGUMENT. Начиная с curl 7.66.0 и далее значения 1 и 2 обрабатываются как одно и то же значение. В производственных средах значение опции требуется оставлять равным 2 (значение по умолчанию). Константа доступна с 7.3.0 и cURL 7.52.0.

Проверяет SSL-сертификат прокси-сервера. Со значением false опция останавливает проверку сертификата однорангового узла. Альтернативные сертификаты для проверки указывают через опцию CURLOPT_CAINFO, а каталог сертификатов указывают через опцию CURLOPT_CAPATH. При установке значения false проверка сертификата однорангового узла завершается успешно независимо от подлинности сертификата. Значение по умолчанию равняется true. Константа доступна с 7.3.0 и cURL 7.52.0.

Список наборов шифров для подключения к прокси по протоколу TLS 1.3. Опция принимает только синтаксически правильный список, который состоит из одного или нескольких строковых значений с названиями наборов шифров, разделённых двоеточиями. Опция будет работать, только если curl собрали для работы с библиотекой OpenSSL 1.1.1 или новее. При работе с другим SSL-бэкендом попробуют установить наборы шифров протокола TLS 1.3 через опцию CURLOPT_PROXY_SSL_CIPHER_LIST. Константа доступна с 7.3.0 и cURL 7.61.0, если модуль собрали с поддержкой OpenSSL >= 1.1.1.

Опция устанавливает пароль для TLS-аутентификации методом, который указали в опции CURLOPT_PROXY_TLSAUTH_TYPE. Для работы опции требуется также установить параметр CURLOPT_PROXY_TLSAUTH_USERNAME. Константа доступна с 7.3.0 и cURL 7.52.0.

Метод аутентификации по протоколу TLS для HTTPS-соединения. Опция поддерживает метод "SRP".

Замечание:

Аутентификация по безопасному удаленному паролю (англ. Secure Remote Password, SRP) по протоколу TLS работает взаимно, только если у обеих сторон есть общий секрет. TLS-SRP-аутентификация будет работать, только если опции CURLOPT_PROXY_TLSAUTH_USERNAME и CURLOPT_PROXY_TLSAUTH_PASSWORD тоже установили.

Имя пользователя для TLS-аутентификации прокси-сервера по протоколу HTTPS для метода, который указали в опции CURLOPT_PROXY_TLSAUTH_TYPE. Для работы опции требуется также установить параметр CURLOPT_PROXY_TLSAUTH_PASSWORD. Константа доступна с 7.3.0 и cURL 7.52.0.

Для опции устанавливают значение true, чтобы отправить файл HTTP-методом PUT. Файл, который требуется разместить на сервере методом PUT, указывают в опции CURLOPT_INFILE, а предполагаемый размер файла указывают через опцию CURLOPT_INFILESIZE.

Константа доступна с 8.3.0 и cURL 7.87.0.

Массив FTP-команд, которые требуется выполнить на сервере перед FTP-запросом.

Название файла — источника случайных данных с начальным числом (seed), которое инициализирует генератор случайных чисел для передач по протоколу SSL.

Диапазон или диапазоны данных в формате "X-Y", которые требуется извлечь, при этом индексы байтов — X или Y — разрешается не указывать. HTTP-передачи также поддерживают набор интервалов с разделением запятыми в формате "X-Y,N-M".

Опция принимает callback-функцию, которая принимает три аргумента. Первый — cURL-дескриптор, второй — ресурс потока, который передали модулю cURL через опцию CURLOPT_INFILE, и третий — максимальный объём данных для чтения. От callback-функции требуется возвращать строку, длина которой равна или меньше количества запрашиваемых данных, которую функция обратного вызова обычно считывает из ресурса потока, который установили во втором параметре. Об окончании данных в источнике — состояние EOF — функция сообщает возвратом пустой строки.

Битовая маска из значений констант семейства CURLPROTO_*, которая ограничивает протоколы, по которым библиотеке libcurl разрешается передавать данные при следовании перенаправлениям при включённой опции CURLOPT_FOLLOWLOCATION. Опция ограничивает отдельные передачи в перенаправлениях только подмножеством протоколов. По умолчанию библиотека libcurl разрешает все протоколы, за исключением URI-схемы FILE и протокола копирования файлов SCP. В версиях до 7.19.4 перенаправление действовало для всех протоколов без исключения. Описание опции CURLOPT_PROTOCOLS приводит список констант со значениями протоколов. Константа доступна с cURL 7.19.4.

Константа доступна с 8.3.0 и cURL 7.85.0.

Содержимое заголовка "Referer: ", который функция передаст в HTTP-запросе.

Константа доступна с 7.3.0 и cURL 7.55.0.

Указывает пользовательский адрес для конкретной пары хоста и порта. Массив строк, которые содержат имя хоста, порт и IP-адрес, и в которых каждый элемент отделили двоеточием. Опция принимает строки в формате: array("example.com:80:127.0.0.1") Константа доступна с cURL 7.21.3.

Опция устанавливает смещение в байтах, с которого требуется возобновить передачу.

Со значением true опция указывает функции curl_exec(), чтобы та вернула результат передачи в виде строки, а не выводила результат в стандартные потоки.

Значение по умолчанию равно true, что отключает поддержку префикса @ при загрузке файлов через опцию CURLOPT_POSTFIELDS, что означает, что значения, которые начинаются с символа @, разрешается безопасно передавать как поля. Альтернативный способ — отправлять файлы как объекты класса CURLFile.

Идентификатор авторизации authzid для передачи. Параметр указывают только при работе с простым механизмом аутентификации PLAIN SASL, в котором это необязательно. Функция отправит на сервер вместе с паролем только идентификатор аутентификации authcid, который указали в имени пользователя, если для опции не указали значение. Сервер получит идентификатор авторизации authzid из идентификатора аутентификации authcid, если идентификатор авторизации не указали, а затем будет использовать идентификатор авторизации внутренне. Константа доступна с 8.2.0 и cURL 7.66.0.

Со значением true опция разрешит отправку первоначального ответа в первом пакете. Константа доступна с 7.0.7 и cURL 7.31.0.

Имя службы аутентификации. Константа доступна с 7.0.7 и cURL 7.43.0.

Опция принимает разделяемый cURL-дескриптор, который возвращает функция curl_share_init(). Разрешает cURL-дескриптору использовать данные из разделяемого дескриптора.

Опция устанавливает метод или методы SOCKS5-аутентификации. Опция принимает значения: CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE. Побитовый оператор ИЛИ (|) объединяет больше одного метода. При установке больше одного метода модуль cURL опросит сервер, чтобы понять, какие методы он поддерживает, и выберет лучший. Метод CURLAUTH_BASIC разрешает аутентификацию по имени пользователя и паролю. Метод CURLAUTH_GSSAPI разрешает аутентификацию через интерфейс GSS-API. Метод CURLAUTH_NONE разрешает передачу без аутентификации. Значение по умолчанию равно объединению методов: CURLAUTH_BASIC|CURLAUTH_GSSAPI. Имя пользователя и пароль устанавливают через опцию CURLOPT_PROXYUSERPWD. Константа доступна с 7.3.0 и cURL 7.55.0.

Опция принимает битовую маску из одного или нескольких значений: CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD. Флаг CURLSSH_AUTH_ANY разрешит библиотеке libcurl выбрать значение. Константа доступна с cURL 7.16.1.

Значение true включает встроенное SSH-сжатие. Это просьба, а не указание; сервер не обязан её выполнять. Константа доступна с 7.3.0 и cURL 7.56.0.

Константа доступна с 8.3.0 и cURL 7.84.0.

Строка, которая содержит 32 шестнадцатеричные цифры. Строку требуется формировать как контрольную сумму открытого ключа удалённого хоста по алгоритму MD5, а библиотека libcurl отклонит соединение с хостом, если контрольные md5-суммы не совпадают. Опция работает только с SCP- и SFTP-передачами. Константа доступна с cURL 7.17.1.

Опция принимает Base64-кодированный SHA256-хеш открытого ключа удалённого хоста. Передача завершится ошибкой, если хеш не соответствует хешу удалённого хоста. Константа доступна с 8.2.0 и cURL 7.80.0.

Название файла закрытого ключа отправителя. Без этой опции библиотека libcurl по умолчанию извлекает закрытый ключ из файла $HOME/.ssh/id_dsa, если переменную окружения HOME установили, и просто файл "id_dsa" в текущем каталоге, если переменную HOME не установили. Пароль для файлов, которые защитили паролем, устанавливают через опцию CURLOPT_KEYPASSWD. Константа доступна с cURL 7.16.1.

Имя файла открытого ключа отправителя. Без этой опции библиотека libcurl по умолчанию извлекает открытый ключ из файла $HOME/.ssh/id_dsa.pub, если переменную окружения HOME установили, и просто файл "id_dsa.pub" в текущем каталоге, если переменную HOME не установили. Константа доступна с cURL 7.16.1.

Имя файла с сертификатом в формате PEM.

Пароль, который требуется для сертификата, который указали в опции CURLOPT_SSLCERT.

Формат сертификата. Опция поддерживает форматы "PEM" (по умолчанию), "DER" и "ENG". С OpenSSL 0.9.3 опция также поддерживает формат "P12" (для PKCS#12-кодированных файлов). Константа доступна с cURL 7.9.3.

SSL-сертификат клиента из области памяти, которая содержит двоичные данные. Константа доступна с 8.1.0 и cURL 7.71.0.

Идентификатор криптографического движка закрытого SSL-ключа, который указали в опции CURLOPT_SSLKEY.

Идентификатор криптографического движка асимметричных операций шифрования.

Имя файла с закрытым SSL-ключом.

Секретный пароль, который требуется для закрытого SSL-ключа, который указали в опции CURLOPT_SSLKEY.

Замечание:

Поскольку опция содержит конфиденциальный пароль, PHP-скрипт с паролем хранят в безопасном месте.

Тип закрытого SSL-ключа, который указали в опции CURLOPT_SSLKEY. Типы ключей, которые поддерживает опция: "PEM" (по умолчанию), "DER" и "ENG".

Закрытый ключ клиентского сертификата из области памяти, которая содержит двоичные данные. Константа доступна с 8.1.0 и cURL 7.71.0.

Опция принимает константы из следующего списка: CURL_SSLVERSION_DEFAULT, CURL_SSLVERSION_TLSv1, CURL_SSLVERSION_SSLv2, CURL_SSLVERSION_SSLv3, CURL_SSLVERSION_TLSv1_0, CURL_SSLVERSION_TLSv1_1, CURL_SSLVERSION_TLSv1_2, CURL_SSLVERSION_TLSv1_3 . Максимальную версию протокола TLS устанавливают константой семейства CURL_SSLVERSION_MAX_*. Опция принимает объединение константы семейства CURL_SSLVERSION_* с константой семейства CURL_SSLVERSION_MAX_* через побитовое ИЛИ. CURL_SSLVERSION_MAX_DEFAULT (максимальная версия, которую поддерживает библиотека), CURL_SSLVERSION_MAX_TLSv1_0, CURL_SSLVERSION_MAX_TLSv1_1, CURL_SSLVERSION_MAX_TLSv1_2, CURL_SSLVERSION_MAX_TLSv1_3 .

Список шифров для передач по протоколу SSL. Например, RC4-SHA и TLSv1 — допустимый список шифров.

Разделённый двоеточиями список алгоритмов эллиптических кривых. Например, X25519:P-521 — допустимый список из двух эллиптических кривых. Опция определят алгоритмы обмена клиентскими ключами во время SSL-рукопожатия, если cURL-дескриптор SSL-бэкенда собрали с поддержкой этой опции. Константа доступна с 8.2.0 и cURL 7.73.0.

Значение false отключает расширение ALPN во время SSL-рукопожатия (если на SSL-бэкенде библиотеку libcurl собрали с поддержкой ALPN-расширения TLS-протокола), которое согласовывает протокол безопасного соединения по протоколу HTTP2. Константа доступна с 7.0.7 и cURL 7.36.0.

Значение false отключает расширение NPN во время SSL-рукопожатия (если на SSL-бэкенде библиотеку libcurl собрали с поддержкой ALPN-расширения TLS-протокола), которое согласовывает протокол безопасного соединения по протоколу HTTP2. Константа доступна с 7.0.7 и cURL 7.36.0.

Значение true включает режим ложного старта во время TLS-рукопожатия. Константа доступна с 7.0.7 и cURL 7.42.0.

Устанавливает параметры SSL-поведения в виде битовой маски из следующих констант: CURLSSLOPT_ALLOW_BEAST, CURLSSLOPT_NO_REVOKE, CURLSSLOPT_AUTO_CLIENT_CERT, CURLSSLOPT_NATIVE_CA, CURLSSLOPT_NO_PARTIALCHAIN, CURLSSLOPT_REVOKE_BEST_EFFORT Константа доступна с 7.0.7. и cURL 7.25.0.

Значение 2 указывают, чтобы убедиться, что поле общего имени (Common Name) или поле альтернативного имени субъекта (Subject Alternate Name) в сертификате однорангового SSL-узла соответствует имени хоста. Значение 0 указывают, чтобы не проверять имена. Значение 1 не следует использовать. В производственных средах значение параметра оставляют равным 2 (значение по умолчанию). Поддержку значения 1 удалили в cURL 7.28.1.

Со значением false опция останавливает проверку сертификата однорангового узла. Альтернативные сертификаты для проверки указывают через опцию CURLOPT_CAINFO, а каталог сертификатов указывают через опцию CURLOPT_CAPATH. С cURL 7.10 значение по умолчанию равно true. Пакет по умолчанию устанавливается начиная с cURL 7.10.

Со значением true опция проверяет статус сертификата. Константа доступна с 7.0.7 и cURL 7.41.0.

Альтернативное место для вывода ошибок, в которое функция будет выводить ошибки вместо стандартного потока STDERR.

Устанавливает вес числового потока. Опция принимает значения от 1 до 256. Константа доступна с 7.0.7 и cURL 7.46.0.

Значение true при включённой опции CURLOPT_HTTPPROXYTUNNEL и запросе CONNECT подавляет заголовки ответов CONNECT прокси-сервера из пользовательских callback-функций, которые указали в опциях CURLOPT_HEADERFUNCTION и CURLOPT_WRITEFUNCTION Константа доступна с 7.3.0 и cURL 7.54.0.

Значение true включает механизм TCP Fast Open. Константа доступна с 7.0.7 и cURL 7.49.0.

Со значением 1 опция будет отправлять пакеты для проверки активности TCP-соединения. Задержкой и частотой проверок управляют через опции CURLOPT_TCP_KEEPIDLE и CURLOPT_TCP_KEEPINTVL, если только операционная система поддерживает эти параметры. Со значением по умолчанию, которое равно 0, модуль не проверяет активность соединения. Константа доступна с cURL 7.25.0.

Устанавливает задержку простоя соединения в секундах, которую операционная система выдержит перед отправкой пакета проверки активности соединения, если опцию CURLOPT_TCP_KEEPALIVE включили. Не каждая операционная система поддерживает эту опцию. Значение по умолчанию равно 60. Константа доступна с cURL 7.25.0.

Устанавливает интервал ожидания в секундах, который операционная система будет выдерживать между отправкой пакетов проверки активности соединения, если опцию CURLOPT_TCP_KEEPALIVE включили. Не каждая операционная система поддерживает эту опцию. Значение по умолчанию равно 60. Константа доступна с cURL 7.25.0.

Значение true отключает алгоритм TCP-протокола Nagle, который пытается минимизировать количество мелких пакетов в сети. Константа доступна с cURL 7.11.2.

Значение true отключает отправку запросов TFTP-параметров. Константа доступна с 7.0.7 и cURL 7.48.0.

Устанавливает способ трактовки опции CURLOPT_TIMEVALUE. Значение CURL_TIMECOND_IFMODSINCE указывают, чтобы функция возвращала страницу, только если она изменилась со времени, которое указали в опции CURLOPT_TIMEVALUE. Функция вернёт заголовок "304 Not Modified", если страница не изменилась и значение опции CURLOPT_HEADER равно true. Значение CURL_TIMECOND_IFUNMODSINCE даёт обратный эффект. Со значением CURL_TIMECOND_NONE опция игнорирует опцию CURLOPT_TIMEVALUE и каждый раз возвращает страницу. Значение по умолчанию — CURL_TIMECOND_NONE. До cURL 7.46.0 значением по умолчанию было значение константы CURL_TIMECOND_IFMODSINCE.

Максимальное время выполнения функций модуля cURL в секундах.

Максимальное время выполнения функций модуля cURL в миллисекундах. Эта часть соединения по-прежнему будет использовать разрешение в целую секунду для времён ожидания с минимальным допустимым временем ожидания в одну секунду, если библиотеку libcurl собрали со стандартным резольвером имён системы. Константа доступна с cURL 7.16.2.

Время в секундах с 1 января 1970 года. Значение использует опция CURLOPT_TIMECONDITION.

Время в секундах с 1 января 1970 года. Значение использует опция CURLOPT_TIMECONDITION. Значение по умолчанию равно 0. Разница между этой опцией и опцией CURLOPT_TIMEVALUE состоит в типе аргумента. В системах, в которых размер структуры данных, которая принадлежит типу 'long', составляет всего 32 бита, для установки дат после 2038 года требуется указывать этот параметр. Константа доступна с 7.3.0 и cURL 7.59.0.

Список наборов шифров для подключения по протоколу TLS 1.3. Опция принимает только синтаксически правильный список, который состоит из одного или нескольких строковых значений с названиями наборов шифров, разделённых двоеточиями. Опция будет работать, только если curl собрали с библиотекой OpenSSL 1.1.1 или новее. При работе с другим SSL-бэкендом попробуют установить наборы шифров протокола TLS 1.3 через опцию CURLOPT_SSL_CIPHER_LIST. Константа доступна с 7.3.0 и cURL 7.61.0, если модуль собрали с поддержкой OpenSSL >= 1.1.1.

Значение true устанавливает ASCII-режим для FTP-передач. При передаче данных по протоколу LDAP данные возвращаются простым текстом вместо HTML-разметки. В системах Windows это не установит стандартный поток вывода STDOUT в бинарный режим.

Разрешает использовать сокеты UNIX-доменов как конечные точки соединения и устанавливает путь к заданной строке (string). Константа доступна с 7.0.7 и cURL 7.40.0.

Со значением true функция продолжает отправку имени пользователя и пароля при следовании по перенаправлениям при включённой опции CURLOPT_FOLLOWLOCATION, даже когда название хоста изменилось.

Отдельные протоколы со встроенным механизмом «поддержки соединения в рабочем состоянии» отправляют небольшой объем трафика через установленные соединения, чтобы держать соединения открытыми. Опция определяет интервал, в течение которого будет поддерживаться соединение. Действующий и единственный протокол с механизмом сохранения соединения — HTTP/2. Когда интервал поддержки соединения истекает, протокол HTTP/2 отправляет в соединение кадр PING. Значение по умолчанию – 60 секунд. Константа доступна с 8.2.0 и cURL 7.62.0.

Для опции указывают значение true, чтобы подготовить файл к отправке на сервер.

Устанавливает размер буфера, с которым cURL-дескриптор будет работать при отправке файла, в байтах. Размер буфера отправки файла по умолчанию — 64 килобайта. Максимальный размер буфера, который разрешается установить, — 2 мегабайта. Минимальный допустимый размер — 16 килобайтов. Константа доступна с 8.2.0 и cURL 7.62.0.

URL-адрес, который требуется получить. Значение также устанавливают при инициализации сеанса функцией curl_init().

Содержимое заголовка "User-Agent: ", которое функция отправит в HTTP-запросе.

Имя пользователя, которое функция отправит при аутентификации. Константа доступна с cURL 7.19.1.

Имя пользователя и пароль в формате "[username]:[password]", которые функция отправит при установке соединения.

Со значением true опция выводит подробную информацию о передаче. Записывает вывод в поток STDERR или в файл, который указали в опции CURLOPT_STDERR.

Callback-функция, которая принимает два аргумента. Первый — cURL-ресурс, второй — строка с данными для записи. Сохранить данные требуется этой функцией обратного вызова. Функция должна вернуть точное количество байтов, которое она записала, или передача прервётся и функция выдаст ошибку.

Файл, в который записываются заголовки передачи.

Константа доступна с 8.3.0 и cURL 7.86.0.

Callback-функция, которая принимает два аргумента. У опции то же назначение, что и у опции CURLOPT_PROGRESSFUNCTION, но более современное, лучше предпочесть эту cURL-опцию. Константа доступна с 8.2.0 и cURL 7.32.0.

Указывает токен доступа для протокола OAuth 2.0. Константа доступна с 7.0.7 и cURL 7.33.0.

Модуль зарегистрирует объект callable, который указали в опции, для обработки пуш-уведомлений сервера. Допускается следующая сигнатура вызываемого объекта:

parent_ch

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

pushed_ch

Новый cURL-дескриптор для отправленного push-запроса.

headers

Заголовки push-обещания.