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

Включает использование абстрактного Unix domain socket вместо установки TCP-соединения с хостом и задаёт путь к указанной строке (string). Эта опция имеет ту же семантику, что и CURLOPT_UNIX_SOCKET_PATH. Эти две опции используют одно и то же хранилище, поэтому для одного обработчика может быть установлена только одна из них. Доступно с PHP 7.3.0 и cURL 7.53.0.

Задаёт строку (string) с содержимым заголовка Accept-Encoding:, отправляемого в HTTP-запросе. Установите в null, чтобы отключить отправку заголовка Accept-Encoding:. По умолчанию null. Доступно с cURL 7.21.6.

Максимальное время ожидания в миллисекундах, пока сервер соединяется обратно с cURL при использовании активного FTP-соединения. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 60000 миллисекунд. Доступно с cURL 7.24.0.

Значение ID области для использования при подключении к адресам IPv6. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 0. Доступно с cURL 7.19.0.

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

Заполняет битовую маску правильным набором функций, чтобы указать cURL, как обрабатывать Alt-Svc для передач, использующих этот обработчик. cURL принимает заголовки Alt-Svc только через HTTPS. Он также завершит запрос к альтернативному источнику, только если этот источник правильно размещён через HTTPS. Установка любого бита включит механизм alt-svc. Установите в любое значение из констант CURLALTSVC_*. По умолчанию обработка Alt-Svc отключена. Доступно с PHP 8.2.0 и cURL 7.64.1.

Установка этой опции в 1 приведёт к тому, что FTP-загрузки будут добавляться в удалённый файл вместо его перезаписи. По умолчанию 0. Доступно с cURL 7.17.0.

true для автоматической установки поля Referer: в запросах, где следует перенаправление Location:. По умолчанию 0. Доступно с cURL 7.1.0.

Обеспечивает аутентификацию с подписью AWS V4 в HTTP(S) заголовке в виде строки (string). Опция переопределяет любые другие типы аутентификации, установленные в CURLOPT_HTTPAUTH. Метод нельзя комбинировать с другими типами аутентификации. Доступно с PHP 8.2.0 и cURL 7.75.0.

Константа больше не используется с PHP 5.5.0. Устарела с PHP 8.4.0.

Размер буфера для каждого чтения. Однако нет гарантии, что этот запрос будет выполнен. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию CURL_MAX_WRITE_SIZE (в настоящее время 16 КБ). Доступно с cURL 7.10.

Строка (string) с именем файла, содержащего один или несколько сертификатов для проверки однорангового узла. Имеет смысл только в сочетании с CURLOPT_SSL_VERIFYPEER. Может потребоваться абсолютный путь. Доступно с cURL 7.4.2.

Строка (string) с именем PEM-файла, содержащего один или несколько сертификатов для проверки однорангового узла. Опция переопределяет CURLOPT_CAINFO. Доступно с PHP 8.2.0 и cURL 7.77.0.

Строка (string) с каталогом, содержащим несколько CA-сертификатов. Используйте эту опцию вместе с CURLOPT_SSL_VERIFYPEER. Доступно с cURL 7.9.8.

Устанавливает максимальное время ожидания в секундах, в течение которого любой кеш CA-сертификатов в памяти может храниться и повторно использоваться для новых соединений. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 86400 (24 часа). Доступно с PHP 8.3.0 и cURL 7.87.0

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

Количество секунд ожидания при попытке подключения. Значение 0 — бесконечное ожидание. Опция принимает значения, которые возможно привести к допустимому целому числу (int). Значение по умолчанию равно 300. Константа доступна с cURL 7.7.0.

Количество миллисекунд ожидания при попытке подключения. Значение 0 — бесконечное ожидание. При сборке модуля cURL для работы со стандартным системным распознавателем имён время ожидания в этой части подключения всё равно разрешается в полную секунду с минимумом допустимого ожидания в одну секунду. Опция принимает значения, которые возможно привести к допустимому целому числу (int). Значение по умолчанию равно 300000. Константа доступна с cURL 7.16.2.

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

Подключиться к определённому хосту и порту вместо хоста и порта из URL. Принимает массив (array) строк (string) в формате HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT. Доступно с PHP 7.0.7 и cURL 7.49.0.

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

Строка (string) с именем файла, содержащего данные cookie. Файл cookie может быть в формате Netscape или просто обычные HTTP-заголовки, сброшенные в файл. Если имя — пустая строка (string), файлы cookie не загружаются, но обработка cookie всё равно включена. Доступно с cURL 7.1.0.

Строка (string) с именем файла для сохранения всех внутренних cookie, когда вызывается деструктор обработчика. Доступно с cURL 7.9.0.

Строка cookie (string) (т.е. одна строка в формате Netscape/Mozilla или обычный заголовок HTTP-style Set-Cookie) добавляет этот отдельный 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 без даты истечения срока действия, и они должны быть живыми и существующим только для этой «сессии». Доступно с cURL 7.9.7.

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

Передайте строку (string) с названием файла с объединением списков отзыва сертификатов (CRL) (в формате PEM) для использования при проверке сертификата во время SSL-обмена. Когда cURL собран для использования GnuTLS, нет возможности повлиять на использование переданного CRL для помощи в процессе проверки. Когда cURL собран с поддержкой OpenSSL, X509_V_FLAG_CRL_CHECK и X509_V_FLAG_CRL_CHECK_ALL устанавливаются оба, требуя проверки CRL для всех элементов цепочки сертификатов, если передан файл CRL. Также обратите внимание, что CURLOPT_CRLFILE подразумевает CURLSSLOPT_NO_PARTIALCHAIN начиная с cURL 7.71.0 из-за ошибки OpenSSL. Доступно с cURL 7.19.0.

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

Замечание:

Не делайте этого, не убедившись предварительно, что сервер поддерживает пользовательский метод запроса.

Строка (string) с протоколом по умолчанию, используемым, если в URL отсутствует название схемы. Доступно с PHP 7.0.7 и cURL 7.45.0.

Установка этой опции в 1 будет иметь различный эффект в зависимости от используемого протокола. URL на основе FTP и SFTP будут отображать только имена файлов в каталоге. POP3 будет отображать одно или несколько почтовых сообщений на POP3-сервере. Для FILE эта опция не имеет эффекта, так как в этом режиме каталоги всегда перечислены. Использование этой опции с CURLOPT_WILDCARDMATCH предотвратит влияние последнего. По умолчанию 0. Доступно с cURL 7.17.0.

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

Количество секунд хранения DNS-записей в памяти. Опция по умолчанию установлена в 120 (2 минуты). Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.9.3.

Установите имя сетевого интерфейса, к которому должен привязываться DNS-резолвер. Должно быть имя интерфейса (не адрес). Опция принимает строку (string) или null. Доступно с PHP 7.0.7 и cURL 7.33.0

Устанавливает локальный IPv4-адрес, к которому должен привязываться резолвер. Аргумент должен содержать один числовой IPv4-адрес. Опция принимает строку (string) или null. Доступно с PHP 7.0.7 и cURL 7.33.0.

Устанавливает локальный IPv6-адрес, к которому должен привязываться резолвер. Аргумент должен содержать один числовой IPv6-адрес. Опция принимает строку (string) или null. Доступно с PHP 7.0.7 и cURL 7.33.0.

Передайте строку (string) с разделённым запятыми списком DNS-серверов, которые будут использоваться вместо системных по умолчанию (например: 192.168.1.100,192.168.1.101:8080). Доступно с cURL 7.24.0.

Значение true для перемешивания порядка всех возвращённых адресов, чтобы они использовались в случайном порядке при разрешении имени и возврате более одного IP-адреса. Может привести к тому, что IPv4 будет использоваться до IPv6 или наоборот. Доступно с PHP 7.3.0 и cURL 7.60.0.

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

Установите 2 для проверки полей имени SSL-сертификата DNS-over-HTTPS сервера в соответствии с именем хоста. Доступно с PHP 8.2.0 и cURL 7.76.0.

Установите 1 для включения и 0 для отключения проверки подлинности SSL-сертификата DNS-over-HTTPS сервера. Доступно с PHP 8.2.0 и cURL 7.76.0.

Установите 1 для включения и 0 для отключения проверки статуса сертификата DNS-over-HTTPS сервера с использованием расширения TLS "Certificate Status Request" (OCSP stapling). Доступно с PHP 8.2.0 и cURL 7.76.0.

Предоставляет URL DNS-over-HTTPS. Опция принимает строку (string) или null. Доступно с PHP 8.1.0 и cURL 7.62.0.

Как CURLOPT_RANDOM_FILE, за исключением имени файла для сокета демона сбора энтропии. Доступно с cURL 7.7.0 и устарела с cURL 7.84.0.

Содержимое заголовка Accept-Encoding: в виде строки (string). Включает декодирование ответа. Поддерживаемые кодировки: identity, deflate, gzip. Если установлена пустая строка (string), отправляется заголовок, содержащий все поддерживаемые типы кодирования. Доступно с cURL 7.10 и устарела с cURL 7.21.6.

Время ожидания для ответов Expect: 100-continue в миллисекундах. По умолчанию 1000 миллисекунд. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с PHP 7.0.7 и cURL 7.36.0.

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

Принимает ресурс файлового дескриптора (resource) в файл, в который должна быть записана передача. По умолчанию STDOUT (окно браузера). Доступно с cURL 7.1.0 и устарела с cURL 7.9.7.

Установите true для попытки получить дату изменения удалённого документа. Значение можно получить с помощью опции CURLINFO_FILETIME функции curl_getinfo(). Доступно с cURL 7.5.0.

Передаёт callback-функцию (callable), которая будет использоваться для сопоставления с шаблоном с подстановочными знаками. Сигнатура callback-функции должна быть:

curlHandle

Обработчик cURL.

pattern

Шаблон с подстановочными знаками.

string

Строка (string), для которой выполняется сопоставление с шаблоном с подстановочными знаками.

Установите true для следования любому заголовку Location:, который сервер отправляет как часть HTTP-заголовка. Смотрите также константу CURLOPT_MAXREDIRS. Константа недоступна, когда включён open_basedir. Доступно с cURL 7.1.0.

Установите true для принудительного явного закрытия соединения после завершения обработки, чтобы оно не помещалось в пул для повторного использования. Доступно с cURL 7.7.0.

Установите true для принудительного использования нового соединения вместо кешированного. Доступно с cURL 7.7.0.

Установите true для добавления в удалённый файл вместо его перезаписи. Доступно с cURL 7.1.0 и устарела с cURL 7.16.4.

Псевдоним опции CURLOPT_TRANSFERTEXT. Лучше предпочесть оригинальную опцию, а не псевдоним. Доступно с cURL 7.1, устарела с cURL 7.11.1 и последний раз доступна в cURL 7.15.5. Удалена с PHP 7.3.0.

Установите true только для перечисления имён FTP-каталога. Доступно с cURL 7.1.0 и устарела с cURL 7.16.4.

Строка (string), которая будет использоваться для получения IP-адреса, используемого для инструкции FTP PORT. Инструкция PORT указывает удалённому серверу подключиться к нашему указанному IP-адресу. Строка (string) может быть простым IP-адресом, именем хоста, именем сетевого интерфейса (в Unix) или просто - для использования системного IP-адреса по умолчанию. Опция принимает строку (string) или null. Доступно с cURL 7.1.0.

Установите метод аутентификации FTP over SSL (если активирован) в любое из значений констант CURLFTPAUTH_*. По умолчанию CURLFTPAUTH_DEFAULT. Доступно с cURL 7.12.2.

Передайте строку (string), которая будет отправлена как информация об учётной записи через FTP (с помощью команды ACCT) после предоставления имени пользователя и пароля серверу. Установите null, чтобы отключить отправку информации об учётной записи. По умолчанию null. Доступно с cURL 7.13.0.

Передайте строку (string), которая будет использоваться для попытки аутентификации через FTP, если переговоры USER/PASS не удались. Доступно с cURL 7.15.5.

Установите true для создания отсутствующих каталогов, когда операция FTP сталкивается с путём, которого в данный момент не существует. Доступно с cURL 7.10.7.

Укажите cURL, какой метод использовать для доступа к файлу на FTP(S) сервере. Возможные значения — любые из констант CURLFTPMETHOD_*. По умолчанию CURLFTPMETHOD_MULTICWD. Доступно с cURL 7.15.1.

Время ожидания в секундах, в течение которого cURL будет ожидать ответа от FTP-сервера. Опция переопределяет CURLOPT_TIMEOUT. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Это имя опции заменено на CURLOPT_SERVER_RESPONSE_TIMEOUT, доступно с PHP 8.4.0. Доступно с cURL 7.10.8 и устарела с cURL 7.85.0.

Если опция установлена в 1, cURL не будет использовать IP-адрес, предложенный сервером в его 227-ответе на команду PASV cURL, а будет использовать IP-адрес, который он использовал для соединения. Номер порта, полученный из 227-ответа, не будет игнорироваться cURL. По умолчанию 1 начиная с cURL 7.74.0 и 0 до этого. Доступно с cURL 7.15.0.

Доступно с cURL 7.11.0 и устарела с cURL 7.16.4.

Опция заставляет cURL использовать CCC (Clear Command Channel), который отключает уровень SSL/TLS после аутентификации, делая остальную часть обмена управляющим каналом незашифрованной. Используйте одну из констант CURLFTPSSL_CCC_*. По умолчанию CURLFTPSSL_CCC_NONE. Доступно с cURL 7.16.1.

Установите true для использования EPRT (и LPRT) при активных FTP-загрузках. Установите false для отключения EPRT и LPRT и использования только PORT. Доступно с cURL 7.10.5.

Установите true для первой попытки команды EPSV для FTP-передач перед возвратом к PASV. Установите false для отключения EPSV. Доступно с cURL 7.9.2.

Установите 1 для отправки команды PRET перед PASV (и EPSV). Не оказывает эффекта при использовании режима активных FTP-передач. По умолчанию 0. Доступно с cURL 7.20.0.

Установите CURLGSSAPI_DELEGATION_FLAG для безусловного делегирования учётных данных GSSAPI. Установите CURLGSSAPI_DELEGATION_POLICY_FLAG для делегирования только если флаг OK-AS-DELEGATE установлен в сервисном билете. По умолчанию CURLGSSAPI_DELEGATION_NONE. Доступно с cURL 7.22.0.

Фора для IPv6 в алгоритме "happy eyeballs". "Happy eyeballs" пытается подключиться как к IPv4, так и к IPv6 адресам для хостов с двойным стеком, предпочитая сначала IPv6 в течение указанного количества миллисекунд времени ожидания. По умолчанию CURL_HET_DEFAULT, который в настоящее время составляет 200 миллисекунд. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с PHP 7.3.0 и cURL 7.59.0

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

Установите true для включения заголовков в вывод, отправляемый callback-функции, определённой CURLOPT_WRITEFUNCTION. Доступно с cURL 7.1.0.

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

headerData

Данные заголовка, которые должны быть записаны callback-функцией.

Отправлять HTTP-заголовки как прокси, так и хосту вместе или раздельно. Возможные значения — любые из констант CURLHEADER_*. По умолчанию CURLHEADER_SEPARATE начиная с cURL 7.42.1 и CURLHEADER_UNIFIED до этого. Доступно с PHP 7.0.7 и cURL 7.37.0.

Строка (string) с именем файла кеша HSTS (HTTP Strict Transport Security) или null, чтобы разрешить HSTS без чтения из или записи в какой-либо файл и очистить список файлов для чтения данных HSTS. Доступно с PHP 8.2.0 и cURL 7.74.0.

Принимает битовую маску функций HSTS (HTTP Strict Transport Security), определённых константами CURLHSTS_*. Доступно с PHP 8.2.0 и cURL 7.74.0.

Разрешать ли ответы HTTP/0.9. По умолчанию false начиная с cURL 7.66.0; ранее по умолчанию было true. Доступно с PHP 7.3.15 и 7.4.3 соответственно и cURL 7.64.0.

Массив (array) 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 автоматически выберет тот, который считает наиболее безопасным. Доступно с cURL 7.10.6.

Установите true для сброса метода HTTP-запроса на GET. Поскольку GET используется по умолчанию, это необходимо только если метод запроса был изменён. Доступно с cURL 7.8.1.

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

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

Значение false для получения сырого тела HTTP-ответа. Доступно с cURL 7.16.2.

Если установлено 0, декодирование передачи отключено. Если установлено 1, декодирование передачи включено. cURL по умолчанию выполняет декодирование передачи по частям, если эта опция не установлена в 0. По умолчанию 1. Доступно с cURL 7.16.2.

Установите одно из значений констант CURL_HTTP_VERSION_*, чтобы cURL использовал указанную версию HTTP. Доступно с cURL 7.9.1.

Если установлено 1, игнорировать заголовок Content-Length HTTP-ответе и игнорировать его запрос или использование для FTP-передач. По умолчанию 0. Доступно с cURL 7.14.1.

Принимает ресурс файлового дескриптора (resource) в файл, из которого должно быть прочитано содержимое при загрузке. Доступно с cURL 7.1.0 и устарела с cURL 7.9.7. Вместо этого используйте CURLOPT_READDATA.

Ожидаемый размер в байтах файла при загрузке файла на удалённый сайт. Обратите внимание, что использование этой опции не остановит cURL от отправки большего количества данных, так как то, что именно отправляется, зависит от CURLOPT_READFUNCTION. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.1.0.

Установите строку (string) с именем исходящего сетевого интерфейса для использования. Может быть имя интерфейса, IP-адрес или имя хоста. Доступно с cURL 7.1.0.

Позволяет приложению выбирать, какие виды IP-адресов использовать при разрешении имён хостов. Это интересно только при использовании имён хостов, которые разрешают адреса с использованием более чем одной версии IP. Установите одно из значений констант CURL_IPRESOLVE_*. По умолчанию CURL_IPRESOLVE_WHATEVER. Доступно с cURL 7.10.8.

Если установлено в строку (string) с именем файла, содержащего сертификат CA в формате PEM, выполняется дополнительная проверка сертификата однорангового узла, чтобы убедиться, что издатель действительно тот, который связан с сертификатом, предоставленным этой опцией. Чтобы результат проверки считался неудачным, эту опцию следует использовать в сочетании с опцией CURLOPT_SSL_VERIFYPEER. Доступно с cURL 7.19.0.

Передаёт строку (string) с двоичными данными SSL-сертификата CA в формате PEM. Если установлено, выполняется дополнительная проверка сертификата однорангового узла, чтобы убедиться, что издатель является тем, который связан с сертификатом, предоставленным этой опцией. Доступно с PHP 8.1.0 и cURL 7.71.0.

Установите true для продолжения отправки тела запроса, если возвращённый HTTP-код больше или равен 300. Действие по умолчанию — остановить отправку и закрыть поток или соединение. Подходит для ручной аутентификации NTLM. Большинству приложений эта опция не нужна. Доступно с PHP 7.3.0 и cURL 7.51.0.

Установите строку (string) с паролем, необходимым для использования закрытого ключа CURLOPT_SSLKEY или CURLOPT_SSH_PRIVATE_KEYFILE. Установка опции в null отключает использование пароля для этих опций. Доступно с cURL 7.17.0.

Уровень безопасности KRB4 (Kerberos 4). Допустимы любые из следующих строковых значений (string) (в порядке от наименее к наиболее мощным): clear, safe, confidential, private. Если строка (string) не соответствует ни одной из них, используется private. Установка этой опции в null отключит безопасность KRB4. В настоящее время безопасность KRB4 работает только с FTP-транзакциями. Доступно с cURL 7.3.0 и устарела с cURL 7.17.0.

Установите уровень безопасности kerberos для FTP, а также включите поддержку kerberos. Должна быть установлена одна из следующих строк (string): clear, safe, confidential, private. Если строка (string) установлена, но не соответствует ни одной из них, используется private. Установка опции в null отключит поддержку kerberos для FTP. По умолчанию null. Доступно с cURL 7.16.4.

Устанавливает локальный номер порта сокета, используемого для соединения. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 0. Доступно с cURL 7.15.2.

Количество попыток, которые cURL делает для поиска рабочего локального номера порта, начиная с установленного с помощью CURLOPT_LOCALPORT. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 1. Доступно с cURL 7.15.2.

Может использоваться для установки протоколо-специфичных опций входа, таких как предпочтительный механизм аутентификации через AUTH=NTLM или AUTH=*, и должен использоваться в сочетании с опцией CURLOPT_USERNAME. Доступно с PHP 7.0.7 и cURL 7.34.0.

Скорость передачи в байтах в секунду, ниже которой передача должна быть в течение подсчёта секунд CURLOPT_LOW_SPEED_TIME, прежде чем PHP сочтёт передачу слишком медленной и прервёт её. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.1.0.

Количество секунд, в течение которых скорость передачи должна быть ниже CURLOPT_LOW_SPEED_LIMIT, прежде чем PHP сочтёт передачу слишком медленной и прервёт её. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.1.0.

Установите строку (string) с адресом аутентификации (идентификатором) отправленного сообщения, которое ретранслируется на другой сервер. Адрес не должен указываться в паре угловых скобок (<>). Если используется пустая строка (string), то cURL отправляет пару скобок, как требуется по RFC 2554. Доступно с cURL 7.25.0.

Установите строку (string) с адресом электронной почты отправителя при отправке почты по SMTP. Адрес электронной почты должен быть указан с угловыми скобками (<>) вокруг него, которые, если не указаны, добавляются автоматически. Если этот параметр не указан, то на SMTP-сервер отправляется пустой адрес, что может привести к отклонению письма. Доступно с cURL 7.20.0.

Установите массив (array) строк (string) с получателями, которые нужно передать серверу в запросе на отправку почты по SMTP. Каждый получатель должен быть указан в паре угловых скобок (<>). Если угловая скобка не используется в качестве первого символа, cURL предполагает, что указан один адрес электронной почты, и заключает этот адрес в скобки. Доступно с cURL 7.20.0.

Установите 1, чтобы разрешить сбой команды RCPT TO для некоторых получателей, что заставляет cURL игнорировать ошибки для отдельных получателей и продолжать работу с оставшимися принятыми получателями. Если все получатели вызывают сбои и этот флаг установлен, cURL прерывает SMTP-сеанс и возвращает ошибку, полученную от последней команды RCPT TO. Заменена на CURLOPT_MAIL_RCPT_ALLOWFAILS начиная с cURL 8.2.0. Доступно с PHP 8.2.0 и cURL 7.69.0. Устарела с cURL 8.2.0.

Максимальное время простоя, разрешённое для существующего соединения, чтобы его можно было рассматривать для повторного использования. Максимальный возраст по умолчанию установлен на 118 секунд. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с PHP 8.2.0 и cURL 7.65.0.

Максимальное количество разрешённых постоянных соединений. Когда лимит достигнут, самое старое соединение в кеше закрывается, чтобы предотвратить увеличение количества открытых соединений. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.7.0.

Устанавливает максимальный принимаемый размер (в байтах) файла для загрузки. Если запрашиваемый файл оказывается больше этого значения, передача прерывается и возвращается CURLE_FILESIZE_EXCEEDED. Передача 0 отключает эту опцию, а передача отрицательного размера возвращает CURLE_BAD_FUNCTION_ARGUMENT. Если размер файла не известен до начала загрузки, эта опция не оказывает эффекта. Для установки ограничения размера выше 2GB следует использовать CURLOPT_MAXFILESIZE_LARGE. Начиная с cURL 8.4.0, эта опция также останавливает текущие передачи, если они достигают этого порога. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). По умолчанию 0. Доступно с cURL 7.10.8.

Максимальный размер файла в байтах, разрешённый для загрузки. Если запрашиваемый файл оказывается больше этого значения, передача не начнётся и будет возвращено CURLE_FILESIZE_EXCEEDED. Размер файла не всегда известен до загрузки, и для таких файлов эта опция не оказывает эффекта, даже если передача файла в итоге оказывается больше данного ограничения. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с PHP 8.2.0 и cURL 7.11.0.

Максимальное время в секундах с момента создания соединения, которое разрешено для существующего соединения, чтобы его можно было рассматривать для повторного использования. Если в кеше найдено соединение старше этого значения, оно будет закрыто после завершения любых текущих передач. По умолчанию 0 секунд, что означает, что опция отключена и все соединения могут быть использованы повторно. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с PHP 8.2.0 и cURL 7.80.0.

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

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

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

Установите битовую маску констант CURLMIMEOPT_*. В настоящее время доступна только одна опция: CURLMIMEOPT_FORMESCAPE. Доступно с PHP 8.3.0 и cURL 7.81.0.

Установите true для полного молчания в отношении функций cURL. Вместо этого используйте CURLOPT_RETURNTRANSFER. Доступно с cURL 7.1.0, устарела с cURL 7.8.0 и последний раз доступна в cURL 7.15.5. Удалена с PHP 7.3.0.

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

Установите строку (string), содержащую полный путь к файлу .netrc. Если эта опция опущена и установлен CURLOPT_NETRC, cURL проверяет наличие файла .netrc в домашнем каталоге текущего пользователя. Доступно с cURL 7.11.0.

Устанавливает значение прав доступа (int), которое устанавливается на вновь созданных каталогах на удалённом сервере. Значение по умолчанию — 0755. Единственные протоколы, которые могут использовать это: sftp://, scp:// и file://. Доступно с cURL 7.16.4.

Устанавливает значение прав доступа (как int), которое устанавливается на вновь созданных файлах на удалённом сервере. Значение по умолчанию — 0644. Единственные протоколы, которые могут использовать это: sftp://, scp:// и file://. Доступно с cURL 7.16.4.

Установите true для исключения тела из вывода. Для HTTP(S) cURL выполняет запрос HEAD. Для большинства других протоколов cURL вообще не запрашивает данные тела. Изменение этого на false приведёт к включению данных тела в вывод. Доступно с cURL 7.1.0.

Установите true для отключения индикатора выполнения для передач cURL.

Замечание:

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

Установите строку (string), состоящую из разделённого запятыми списка имён хостов, для достижения которых не требуется прокси. Каждое имя в этом списке сопоставляется либо как домен, содержащий имя хоста, либо как само имя хоста. Единственный подстановочный знак, доступный в строке (string), — это один символ *, который соответствует всем хостам, фактически отключая прокси. Установка этой опции в пустую строку (string) включает прокси для всех имён хостов. Начиная с cURL 7.86.0, IP-адреса, установленные с этой опцией, могут быть предоставлены с использованием нотации CIDR. Доступно с cURL 7.19.4.

Значение true для игнорирования любых функций cURL, которые вызывают отправку сигнала процессу PHP. Включено по умолчанию в многопоточных SAPI, чтобы опции времени ожидания всё равно можно было использовать. Доступно с cURL 7.10.

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

passwordPrompt

Запрос пароля.

maximumPasswordLength

Максимальная длина пароля.

Установите строку (string) с паролем для использования в аутентификации. Доступно с cURL 7.19.1.

Установите true, чтобы cURL не изменял пути URL перед передачей их серверу. По умолчанию false, что удаляет последовательности /../ или /./, которые могут существовать в части пути URL, которые должны быть удалены в соответствии с разделом 5.2.4 RFC 3986. Доступно с PHP 7.0.7 и cURL 7.42.0.

Установите строку (string) с закреплённым открытым ключом. Строка (string) может быть именем файла закреплённого открытого ключа в формате файла PEM или DER. Строка (string) также может быть любым количеством хешей sha256 в кодировке base64, предварённых sha256// и разделённых ;. Доступно с PHP 7.0.7 и cURL 7.39.0.

Установите true для ожидания подтверждения от существующего соединения о возможности мультиплексирования и его использования, если возможно, перед созданием и использованием нового соединения. Доступно с PHP 7.0.7 и cURL 7.43.0.

Целое число (int) с альтернативным номером порта для подключения вместо указанного в URL или порта по умолчанию для используемого протокола. Доступно с cURL 7.1.0.

Установите true для выполнения HTTP-запроса POST. Этот запрос использует заголовок application/x-www-form-urlencoded. По умолчанию false. Доступно с cURL 7.1.0.

Полные данные для отправки в HTTP-запросе POST. Параметр может быть передан как URL-кодированная строка (string) вида 'para1=val1&para2=val2&...' или как массив (array) с именем поля в качестве ключа и данными поля в качестве значения. Если value является массивом (array), заголовок Content-Type будет установлен в multipart/form-data. Файлы могут быть отправлены с использованием CURLFile или CURLStringFile, и в этом случае value должен быть массивом (array). Доступно с cURL 7.1.0.

Массив (array) строк (string) FTP-команд для выполнения на сервере после выполнения FTP-запроса. Доступно с cURL 7.1.0.

Установите битовую маску из CURL_REDIR_POST_301, CURL_REDIR_POST_302 и CURL_REDIR_POST_303, если метод HTTP POST должен сохраняться при установке CURLOPT_FOLLOWLOCATION и возникновении определённого типа перенаправления. Доступно с cURL 7.19.1.

Установите строку (string), содержащую имя хоста или числовой IP-адрес, разделённый точками, который будет использоваться в качестве предварительного прокси, к которому cURL подключается перед подключением к HTTP(S)-прокси, указанному в опции CURLOPT_PROXY для предстоящего запроса. Предварительный прокси может быть только SOCKS-прокси, и он должен быть предварен [scheme]://, чтобы указать, какой тип socks используется. Числовой IPv6-адрес должен быть записан в [скобках]. Установка предварительного прокси в пустую строку (string) явно отключает использование предварительного прокси. Чтобы указать номер порта в этой строке, добавьте :[port] в конец имени хоста. Номер порта прокси может быть дополнительно указан с отдельной опцией CURLOPT_PROXYPORT. По умолчанию используется порт 1080 для прокси, если порт не указан. Доступно с PHP 7.3.0 и cURL 7.52.0.

Установите массив (array) строк (string) FTP-команд для передачи серверу после установки типа передачи. Команды не выполняются при выполнении листинга каталога, только для передачи файлов. Доступно с cURL 7.9.5.

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

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

bytesToDownload

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

bytesDownloaded

Количество байтов, загруженных на данный момент.

bytesToUpload

Общее количество байтов, ожидаемых для отправки в этой передаче.

bytesUploaded

Количество байтов, отправленных на данный момент.

Замечание:

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

Битовая маска значений CURLPROTO_*. Если используется, эта битовая маска ограничивает, какие протоколы cURL может использовать в передаче. По умолчанию CURLPROTO_ALL, то есть cURL будет принимать все поддерживаемые им протоколы. Смотрите также CURLOPT_REDIR_PROTOCOLS. Доступно с cURL 7.19.4 и устарела с cURL 7.85.0.

Установите строку (string) с разделённым запятыми списком названий протоколов (схем URL) без учёта регистра, разрешённых в передаче. Установите ALL для включения всех протоколов. По умолчанию cURL принимает все протоколы, с поддержкой которых он был собран. Доступные протоколы: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS. Доступно с PHP 8.3.0 и cURL 7.85.0.

Строка (string) с HTTP-прокси для туннелирования запросов. Должно быть имя хоста, числовой IP-адрес, разделённый точками, или числовой IPv6-адрес, записанный в [скобках]. Доступно с cURL 7.1.0.

Битовая маска метода(ов) HTTP-аутентификации (констант CURLAUTH_*) для использования при подключении прокси. Для аутентификации прокси в настоящее время поддерживаются только CURLAUTH_BASIC и CURLAUTH_NTLM. По умолчанию CURLAUTH_BASIC. Доступно с cURL 7.10.7.

Массив (array) пользовательских строк (string) HTTP-заголовков для передачи прокси. Доступно с PHP 7.0.7 и cURL 7.37.0.

Установите строку (string) с паролем для использования при аутентификации с прокси. Доступно с cURL 7.19.1.

Целое число (int) с номером порта прокси для подключения. Номер порта также может быть установлен в CURLOPT_PROXY. Установка значения в ноль заставляет cURL использовать номер порта прокси по умолчанию или номер порта, указанный в строке (string) URL прокси. Доступно с cURL 7.1.0.

Устанавливает тип прокси в одно из значений констант CURLPROXY_*. По умолчанию CURLPROXY_HTTP. Доступно с cURL 7.10.

Установите строку (string) с именем пользователя для использования при аутентификации с прокси. Доступно с cURL 7.19.1.

Строка (string) с именем пользователя и паролем в формате [username]:[password] для использования при подключении к прокси. Доступно с cURL 7.1.0.

Путь к пакету сертификатов прокси Certificate Authority (CA). Установите путь как строку (string), называющую файл, содержащий один или несколько сертификатов для проверки HTTPS-прокси. Опция предназначена для подключения к HTTPS-прокси, а не к HTTPS-серверу. По умолчанию установлен системный путь, где предположительно хранится пакет сертификатов cURL cacert. Доступно с PHP 7.3.0 и cURL 7.52.0.

Строка (string) с именем PEM-файла, содержащего один или несколько сертификатов для проверки HTTPS-прокси. Опция предназначена для подключения к HTTPS-прокси, а не к HTTPS-серверу. По умолчанию установлен системный путь, где предположительно хранится пакет сертификатов cURL cacert. Доступно с PHP 8.2.0 и cURL 7.77.0.

Строка (string) с каталогом, содержащим несколько сертификатов CA для проверки HTTPS-прокси. Доступно с PHP 7.3.0 и cURL 7.52.0.

Установите строку (string) с именем файла с объединением списков отзыва сертификатов (CRL) в формате PEM для использования при проверке сертификата во время SSL-обмена. Доступно с PHP 7.3.0 и cURL 7.52.0.

Имя файла SSL-сертификата издателя прокси в виде строки (string). Доступно с PHP 8.1.0 и cURL 7.71.0.

Строка (string) с SSL-сертификатом издателя прокси. Доступно с PHP 8.1.0 и cURL 7.71.0.

Установите строку (string), используемую в качестве пароля, необходимого для использования закрытого ключа CURLOPT_PROXY_SSLKEY. Пароль не нужен для загрузки сертификата, но нужен для загрузки закрытого ключа. Опция предназначена для подключения к HTTPS-прокси, а не к HTTPS-серверу. Доступно с PHP 7.3.0 и cURL 7.52.0.

Установите закреплённый открытый ключ для HTTPS-прокси. Строка (string) может быть именем файла закреплённого открытого ключа, который ожидается в формате файла PEM или DER. Строка (string) также может быть любым количеством хешей sha256 в кодировке base64, предварённых sha256// и разделённых ;. Доступно с PHP 7.3.0 и cURL 7.52.0.

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

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

Строка (string) с форматом клиентского сертификата, используемого при подключении к HTTPS-прокси. Поддерживаемые форматы: PEM и DER, за исключением Secure Transport. OpenSSL (версии 0.9.3 и выше) и Secure Transport (на iOS 5 или выше, или OS X 10.7 или выше) также поддерживают P12 для файлов, закодированных PKCS#12. По умолчанию PEM. Доступно с PHP 7.3.0 и cURL 7.52.0.

Строка (string) с SSL-клиентским сертификатом прокси. Доступно с PHP 8.1.0 и cURL 7.71.0.

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

Строка (string) с форматом закрытого ключа. Поддерживаемые форматы: PEM, DER, ENG. Доступно с PHP 7.3.0 и cURL 7.52.0.

Строка (string) с закрытым ключом для подключения к HTTPS-прокси. Доступно с PHP 8.1.0 и cURL 7.71.0.

Установите предпочтительную версию TLS для HTTPS-прокси в одно из значений констант CURL_SSLVERSION_*. По умолчанию CURL_SSLVERSION_DEFAULT.

Строка (string) с разделённым двоеточиями списком шифров для использования при подключении к HTTPS-прокси. При использовании с OpenSSL запятые и пробелы также допустимы в качестве разделителей, и !, - и + могут использоваться в качестве операторов. Доступно с PHP 7.3.0 и cURL 7.52.0.

Установите параметры поведения SSL для прокси, которые представляют собой битовую маску констант CURLSSLOPT_*. Доступно с PHP 7.3.0 и cURL 7.52.0.

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

Установите false, чтобы остановить проверку cURL сертификата однорангового узла. Альтернативные сертификаты для проверки могут быть указаны с опцией CURLOPT_CAINFO или каталог сертификатов может быть указан с опцией CURLOPT_CAPATH. Когда установлено false, проверка сертификата однорангового узла проходит успешно независимо. Значение true по умолчанию. Доступно с PHP 7.3.0 и cURL 7.52.0.

Строка (string) с разделённым двоеточиями списком шифров для использования при подключении TLS 1.3 к прокси. Эта опция в настоящее время используется только когда cURL собран для использования OpenSSL 1.1.1 или выше. При использовании другого SSL-бэкенда наборы шифров TLS 1.3 могут быть установлены с опцией CURLOPT_PROXY_SSL_CIPHER_LIST. Доступно с PHP 7.3.0 и cURL 7.61.0.

Строка (string) с паролем для использования метода аутентификации TLS, указанного с опцией CURLOPT_PROXY_TLSAUTH_TYPE. Требует, чтобы опция CURLOPT_PROXY_TLSAUTH_USERNAME также была установлена. Доступно с PHP 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 также была установлена. Доступно с PHP 7.3.0 и cURL 7.52.0.

Установите 1, чтобы установить режим передачи (двоичный или ASCII) для FTP-передач, выполняемых через HTTP-прокси, путём добавления type=a или type=i к URL. Без этой установки или если она установлена в 0, CURLOPT_TRANSFERTEXT не оказывает эффекта при выполнении FTP через прокси. По умолчанию 0. Доступно с cURL 7.18.0.

Значение true для HTTP PUT файла. Файл для PUT должен быть установлен с помощью CURLOPT_READDATA и CURLOPT_INFILESIZE. Доступно с cURL 7.1.0 и устарела с cURL 7.12.1.

Установите true, чтобы cURL пропускал очистку ресурсов при восстановлении после времени ожидания. Позволяет быстро завершить процесс cURL ценой возможной утечки связанных ресурсов. Доступно с PHP 8.3.0 и cURL 7.87.0.

Массив (array) строк (string) FTP-команд для выполнения на сервере перед FTP-запросом. Доступно с cURL 7.1.0.

Строка (string) с именем файла для заполнения генератора случайных чисел для SSL. Доступно с cURL 7.7.0 и устарела с cURL 7.84.0.

Строка (string) с диапазоном данных для получения в формате X-Y, где X или Y являются необязательными. HTTP-передачи также поддерживают несколько интервалов, разделённых запятыми в формате X-Y,N-M. Установите null, чтобы отключить запрос диапазона байтов. Доступно с cURL 7.1.0.

Устанавливает указатель на файл (resource), который будет использоваться функцией чтения файла, установленной с помощью CURLOPT_READFUNCTION. Доступно с cURL 7.9.7.

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

streamResource

Ресурс потока (resource), предоставленный cURL через опцию CURLOPT_READDATA.

maxAmountOfDataToRead

Максимальное количество данных для чтения.

Битовая маска значений CURLPROTO_*, которая ограничивает, какие протоколы cURL может использовать в передаче, которую он следует при перенаправлении, когда включён CURLOPT_FOLLOWLOCATION. Позволяет ограничить определённые передачи, чтобы им разрешалось использовать только подмножество протоколов в перенаправлениях. Начиная с cURL 7.19.4, по умолчанию cURL разрешает все протоколы, кроме FILE и SCP. До cURL 7.19.4 cURL безусловно следовал всем поддерживаемым протоколам. Смотрите также CURLOPT_PROTOCOLS для значений констант протоколов. Доступно с cURL 7.19.4 и устарела с cURL 7.85.0.

Установите строку (string) с разделённым запятыми списком названий протоколов (схем URL) без учёта регистра, разрешённых для следования при перенаправлении, когда включён CURLOPT_FOLLOWLOCATION. Установите ALL для включения всех протоколов. Начиная с cURL 7.65.2 по умолчанию установлено FTP, FTPS, HTTP и HTTPS. С cURL 7.40.0 по 7.65.1 по умолчанию это все протоколы, кроме FILE, SCP, SMB и SMBS. До cURL 7.40.0 по умолчанию это все протоколы, кроме FILE и SCP. Доступные протоколы: DICT, FILE, FTP, FTPS, GOPHER, GOPHERS, HTTP, HTTPS, IMAP, IMAPS, LDAP, LDAPS, MQTT, POP3, POP3S, RTMP, RTMPE, RTMPS, RTMPT, RTMPTE, RTMPTS, RTSP, SCP, SFTP, SMB, SMBS, SMTP, SMTPS, TELNET, TFTP, WS, WSS. Доступно с PHP 8.3.0 и cURL 7.85.0.

Строка (string) с содержимым заголовка Referer: для использования в HTTP-запросе. Доступно с cURL 7.1.0.

Строка (string) для использования в предстоящем запросе вместо пути, извлечённого из URL. Доступно с PHP 7.3.0 и cURL 7.55.0.

Предоставьте массив (array) строк (string), разделённых двоеточиями, с пользовательскими адресами для определённых пар хост-порт в следующем формате: array( "example.com:80:127.0.0.1", "example2.com:443:127.0.0.2", ) Доступно с cURL 7.21.3.

Смещение в байтах для возобновления передачи. Опция принимает любое значение, которое может быть приведено к допустимому целому числу (int). Доступно с cURL 7.1.0.

Значение true для возврата передачи в виде строки (string) из возвращаемого значения curl_exec() вместо её прямого вывода.

Установите целое число (int) с номером CSEQ для выдачи следующего запроса RTSP. Полезно, если приложение возобновляет ранее разорванное соединение. CSEQ увеличивается от этого нового числа в дальнейшем. По умолчанию 0. Доступно с cURL 7.20.0.

Устанавливает вид запроса RTSP для выполнения. Должно быть одним из значений констант CURL_RTSPREQ_*. Доступно с cURL 7.20.0.

Установите целое число (int) с номером CSEQ, который ожидается для следующего запроса от сервера к клиенту RTSP. Функция (прослушивание запросов сервера) не реализована. По умолчанию 0. Доступно с cURL 7.20.0.

Установите строку (string) со значением текущего ID сессии RTSP для обработчика. Как только это значение установлено в любое не-null значение, cURL возвращает CURLE_RTSP_SESSION_ERROR, если ID, полученный от сервера, не совпадает. Если установлено null, cURL автоматически устанавливает ID при первом получении его от сервера в ответе. По умолчанию null Доступно с cURL 7.20.0.

Устанавливает строку (string) с URI потока для работы. Если не установлено, cURL по умолчанию работает с общими опциями сервера, передавая * вместо URI потока RTSP. При работе с RTSP CURLOPT_RTSP_STREAM_URI указывает, какой URL отправлять серверу в заголовке запроса, в то время как CURLOPT_URL указывает, куда подключаться. Доступно с cURL 7.20.0.

Установите заголовок Transport: для этой сессии RTSP. Доступно с cURL 7.20.0.

Всегда true, что отключает поддержку префикса @ для загрузки файлов в CURLOPT_POSTFIELDS, что означает, что значения, начинающиеся с @, могут быть безопасно переданы как поля. Вместо этого для загрузок может использоваться CURLFile.

Строка (string) с идентификатором авторизации (authzid) для передачи. Применима только к механизму аутентификации SASL PLAIN, где она является необязательной. Когда не указана, отправляется только идентификатор аутентификации (authcid), указанный именем пользователя, вместе с паролем. Сервер выведет authzid из authcid, когда он не предоставлен, и затем будет использовать его внутренне. Доступно с PHP 8.2.0 и cURL 7.66.0.

Значение true для включения отправки начального ответа в первом пакете. Доступно с PHP 7.0.7 и cURL 7.31.0.

Строка (string) с названием службы аутентификации. Доступно с PHP 7.0.7 и cURL 7.43.0.

Результат функции curl_share_init(). Заставляет обработчик cURL использовать данные из общего обработчика. Доступно с cURL 7.10.

Метод аутентификации SOCKS5 для использования. Варианты: CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE. Когда установлено более одного метода, cURL опросит сервер, чтобы увидеть, какие методы он поддерживает, и выберет лучший. По умолчанию CURLAUTH_BASIC|CURLAUTH_GSSAPI. Установите фактическое имя пользователя и пароль с опцией CURLOPT_PROXYUSERPWD. Доступно с PHP 7.3.0 и cURL 7.55.0.

Установите 1 для включения и 0 для отключения незащищённого обмена режимом защиты как части переговоров GSSAPI. Доступно с cURL 7.19.4.

Установите строку (string), содержащую название службы SOCKS5. По умолчанию rcmd. Доступно с cURL 7.19.4 и устарела с cURL 7.49.0. Вместо этого используйте CURLOPT_PROXY_SERVICE_NAME.

Битовая маска, состоящая из одной или нескольких следующих констант: CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD, CURLSSH_AUTH_AGENT, CURLSSH_AUTH_ANY. По умолчанию CURLSSH_AUTH_ANY. Доступно с cURL 7.16.1.

Значение true для включения, false для отключения встроенного сжатия SSH. Обратите внимание, что сервер может проигнорировать этот запрос. По умолчанию false. Доступно с PHP 7.3.0 и cURL 7.56.0.

Callback-функция (callable), которая будет вызываться, когда требуется проверка ключа хоста SSH. Она должна иметь следующую сигнатуру:

curlHandle

Обработчик cURL.

keyType

Один из типов ключей CURLKHTYPE_*.

key

Ключ для проверки.

keyLength

Длина ключа в байтах.

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

Строка (string) с хешем SHA256 открытого ключа удалённого хоста в кодировке base64. Передача завершится неудачей, если данный хеш не совпадает с хешем, предоставленным удалённым хостом. Доступно с PHP 8.2.0 и cURL 7.80.0.

Установите в имя файла known_host, который будет использоваться и должен использовать формат файла OpenSSH, поддерживаемый libssh2. Доступно с cURL 7.19.6.

Имя файла для закрытого ключа. Если не используется, cURL по умолчанию использует $HOME/.ssh/id_dsa, если установлена переменная окружения HOME, и просто id_dsa в текущем каталоге, если HOME не установлен. Если файл защищён паролем, установите пароль с помощью CURLOPT_KEYPASSWD. Доступно с cURL 7.16.1.

Имя файла для открытого ключа. Если не используется, cURL по умолчанию использует $HOME/.ssh/id_dsa.pub, если установлена переменная окружения HOME, и просто id_dsa.pub в текущем каталоге, если HOME не установлен. Доступно с cURL 7.16.1.

Имя файла, содержащего сертификат в формате PEM. Доступно с cURL 7.1.0.

Пароль, необходимый для использования сертификата CURLOPT_SSLCERT. Доступно с cURL 7.1.0 и устарела с cURL 7.17.0.

Строка (string) с форматом сертификата. Поддерживаемые форматы: PEM, DER, ENG, P12. P12 (для файлов, закодированных PKCS#12) доступен начиная с OpenSSL 0.9.3. По умолчанию PEM. Доступно с cURL 7.9.3.

Строка (string) с SSL-клиентским сертификатом. Доступно с PHP 8.1.0 и cURL 7.71.0.

Строковый идентификатор (string) криптографического механизма закрытого SSL-ключа, указанного в CURLOPT_SSLKEY. Доступно с cURL 7.9.3.

Строковый идентификатор (string) криптографического механизма, используемого для асимметричных криптографических операций. Доступно с cURL 7.9.3.

Имя файла, содержащего закрытый SSL-ключ. Доступно с cURL 7.9.3.

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

Замечание:

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

Тип ключа закрытого SSL-ключа, указанного в CURLOPT_SSLKEY. Поддерживаемые типы ключей: PEM, DER, ENG. По умолчанию PEM. Доступно с cURL 7.9.3.

Строка (string) с закрытым ключом для клиентского сертификата. Доступно с PHP 8.1.0 и cURL 7.71.0.

Одно из значений констант CURL_SSLVERSION_*.

Строка (string), разделённая двоеточиями, с шифрами для использования при подключении TLS 1.2 (1.1, 1.0). Доступно с cURL 7.9.

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

Значение false для отключения ALPN в SSL-рукопожатии (если SSL-бэкенд, с которым собран cURL, поддерживает это), что может использоваться для согласования http2. Доступно с PHP 7.0.7 и cURL 7.36.0.

Значение false для отключения NPN в SSL-рукопожатии (если SSL-бэкенд, с которым собран cURL, поддерживает это), что может использоваться для согласования http2. Доступно с PHP 7.0.7 и cURL 7.36.0 и устарела с cURL 7.86.0.

Значение true для включения и false для отключения ложного старта TLS, который представляет собой режим, в котором TLS-клиент начинает отправку данных приложения до проверки сообщения Finished сервера. Доступно с PHP 7.0.7 и cURL 7.42.0.

Установите параметры поведения SSL, которые представляют собой битовую маску констант CURLSSLOPT_*. По умолчанию ни один бит не установлен. Доступно с PHP 7.0.7. и cURL 7.25.0.

Установите 0 для отключения и 1 для включения кеширования идентификаторов сессий SSL. По умолчанию все передачи выполняются с включённым кешем. Доступно с cURL 7.16.0.

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

Значение false для остановки проверки cURL сертификата однорангового узла. Альтернативные сертификаты для проверки могут быть указаны с опцией CURLOPT_CAINFO или каталог сертификатов может быть указан с опцией CURLOPT_CAPATH. По умолчанию true начиная с cURL 7.10. Пакет сертификатов CA по умолчанию установлен начиная с cURL 7.10. Доступно с cURL 7.4.2.

Значение true для включения и false для отключения проверки статуса сертификата. Доступно с PHP 7.0.7 и cURL 7.41.0.

Принимает ресурс файлового дескриптора (resource), указывающий на альтернативное местоположение для вывода ошибок вместо STDERR. Доступно с cURL 7.1.0.

Установите числовой вес потока (число между 1 и 256). Доступно с PHP 7.0.7 и cURL 7.46.0.

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

Значение true для включения и false для отключения быстрого открытия TCP. Доступно с PHP 7.0.7 и cURL 7.49.0.

Если установлено 1, будут отправляться пробные пакеты поддержания активности TCP. Задержку и частоту этих проб можно контролировать с помощью опций CURLOPT_TCP_KEEPIDLE и CURLOPT_TCP_KEEPINTVL, при условии, что операционная система поддерживает их. Если установлено 0 (по умолчанию), пробные пакеты поддержания активности отключены. Максимальное количество проб можно установить с помощью опции CURLOPT_TCP_KEEPCNT. Доступно с cURL 7.25.0.

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

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

Устанавливает максимальное количество пробных пакетов поддержания активности TCP. По умолчанию 9. Доступно с PHP 8.4.0 и cURL 8.9.0.

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

Установите массив (array) строк (string) для передачи в переговоры telnet. Переменные должны быть в формате <option=value>. cURL поддерживает опции TTYPE, XDISPLOC и NEW_ENV. Доступно с cURL 7.7.0.

Установите размер блока для передачи данных TFTP. Допустимый диапазон — от 8 до 65464 байт. По умолчанию 512 байт используется, если эта опция не указана. Указанный размер блока используется только если поддерживается удалённым сервером. Если сервер не возвращает подтверждение опции или возвращает подтверждение опции без размера блока, используется значение по умолчанию 512 байт. Доступно с cURL 7.19.4.

Значение true для не отправки запросов опций TFTP. По умолчанию false. Доступно с PHP 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 7.1.0.

Максимальное количество секунд для выполнения функций cURL. По умолчанию 0, что означает, что функции никогда не завершаются по истечению времени ожидания во время передачи. Доступно с cURL 7.1.0.

Максимальное количество миллисекунд для выполнения функций модуля cURL. При сборке модуля cURL для работы со стандартным системным распознавателем имён время ожидания в этой части подключения всё равно разрешается в полную секунду с минимумом допустимого ожидания в одну секунду. Значение по умолчанию равно 0: функции никогда не завершаются по истечении времени ожидания во время передачи. Константа доступна с cURL 7.16.2.

Время в секундах с 1 января 1970 года. Время будет использоваться CURLOPT_TIMECONDITION. По умолчанию 0. Доступно с cURL 7.1.0.

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

Строка (string) с разделённым двоеточиями списком шифров для использования при подключении TLS 1.3. Опция в настоящее время используется только когда cURL собран с поддержкой OpenSSL 1.1.1 или выше. При использовании другого SSL-бэкенда наборы шифров TLS 1.3 могут быть установлены с опцией CURLOPT_SSL_CIPHER_LIST. Доступно с PHP 7.3.0 и cURL 7.61.0.

Установите пароль для использования метода аутентификации TLS, указанного с опцией CURLOPT_TLSAUTH_TYPE. Требует, чтобы опция CURLOPT_TLSAUTH_USERNAME также была установлена. Функция основана на TLS SRP, которая не работает с TLS 1.3. Доступно с cURL 7.21.4.

Установите строку (string) с методом аутентификации TLS. Поддерживаемый метод — SRP (аутентификация TLS Secure Remote Password). Доступно с cURL 7.21.4.

Установите строку (string) с именем пользователя для метода аутентификации TLS, указанного с опцией CURLOPT_TLSAUTH_TYPE. Требует, чтобы опция CURLOPT_TLSAUTH_PASSWORD также была установлена. Функция основана на TLS SRP, которая не работает с TLS 1.3. Доступно с cURL 7.21.4.

Установите 1 для включения и 0 для отключения запроса сжатого Transfer Encoding в исходящем HTTP-запросе. Если сервер отвечает сжатым Transfer Encoding, cURL автоматически распакует его при получении. По умолчанию 0. Доступно с cURL 7.21.6.

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

Включает использование Unix domain sockets в качестве конечной точки соединения и устанавливает путь к указанной строке (string). Установите null для отключения. По умолчанию null. Доступно с PHP 7.0.7 и cURL 7.40.0.

Значение true для продолжения отправки имени пользователя и пароля при следовании по местоположениям (с использованием CURLOPT_FOLLOWLOCATION), даже когда имя хоста изменилось. По умолчанию false. Доступно с cURL 7.10.4.

Некоторые протоколы имеют механизмы "поддержания соединения". Эти механизмы обычно отправляют некоторый трафик на существующие соединения, чтобы поддерживать их активными. Опция определяет интервал поддержания соединения. В настоящее время единственным протоколом с механизмом поддержания соединения является HTTP/2. Когда интервал поддержания соединения превышен, на соединение отправляется кадр HTTP/2 PING. По умолчанию CURL_UPKEEP_INTERVAL_DEFAULT, который в настоящее время составляет 60 секунд. Доступно с PHP 8.2.0 и cURL 7.62.0.

Значение true для подготовки и выполнения загрузки. По умолчанию false. Доступно с cURL 7.1.0.

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

URL для выборки. Также можно установить при инициализации сессии с помощью curl_init(). Доступно с cURL 7.1.0.

Устанавливает желаемый уровень SSL/TLS для передачи при использовании FTP, SMTP, POP3, IMAP и т.д. Это все протоколы, которые начинаются с обычного текста и "повышаются" до SSL с помощью команды STARTTLS. Установите одно из значений констант CURLUSESSL_*. Доступно с cURL 7.17.0.

Содержимое заголовка User-Agent: для использования в HTTP-запросе. Доступно с cURL 7.1.0.

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

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

Значение true для вывода подробной информации. Записывает вывод в STDERR или файл, указанный с помощью CURLOPT_STDERR. По умолчанию false. Доступно с cURL 7.1.0.

Установите 1 для передачи нескольких файлов в соответствии с шаблоном имени файла. Шаблон может быть указан как часть опции CURLOPT_URL, используя шаблон, подобный fnmatch (Shell Pattern Matching), в последней части URL (имя файла). Доступно с cURL 7.21.0.

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

data

Данные для записи.

Принимает ресурс файлового дескриптора (resource) в файл, в который записывается часть заголовка передачи. Доступно с cURL 7.1.0.

Принимает битовую маску, устанавливающую параметры поведения WebSocket. Единственная доступная опция — CURLWS_RAW_MODE. По умолчанию 0. Доступно с PHP 8.3.0 и cURL 7.86.0.

Callback-функция (callable) со следующей сигнатурой:

curlHandle

Обработчик cURL.

bytesToDownload

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

bytesDownloaded

Количество байтов, загруженных на данный момент.

bytesToUpload

Общее количество байтов, ожидаемых для отправки в этой передаче.

bytesUploaded

Количество байтов, отправленных на данный момент.

Время ожидания в секундах, в течение которого cURL будет ожидать ответа от сервера FTP, SFTP, IMAP, SCP, SMTP или POP3. Опция заменяет существующую опцию CURLOPT_FTP_RESPONSE_TIMEOUT, которая устарела в cURL 7.85.0. Доступно с PHP 8.4.0.

Указывает токен доступа OAuth 2.0. Установите null для отключения. По умолчанию null. Доступно с PHP 7.0.7 и cURL 7.33.0.

Callback-функция (callable) со следующей сигнатурой, которая вызывается после установления соединения, но перед отправкой полезной нагрузки запроса (например, GET/POST/DELETE запроса HTTP-соединения) и может быть использована для прерывания или разрешения соединения в зависимости от исходного и целевого IP-адреса и номеров портов:

curlHandle

Обработчик cURL.

destination_ip

Основной IP удалённого сервера, установленного с этим соединением. Для FTP это IP для управляющего соединения. IPv6-адреса представляются без окружающих скобок.

local_ip

Исходный IP для этого соединения. IPv6-адреса представляются без окружающих скобок.

destination_port

Основной номер порта на удалённом сервере, установленного с этим соединением. Для FTP это порт для управляющего соединения. Может быть номер TCP или UDP порта в зависимости от протокола.

local_port

Исходный номер порта для этого соединения. Может быть номер TCP или UDP порта в зависимости от протокола.

Доступно с PHP 8.4.0. Опция требует включения опции CURLOPT_VERBOSE. Callback-функция (callable) для замены стандартного подробного вывода cURL. Эта callback-функция вызывается на различных этапах запроса с подробной отладочной информацией. Callback-функция должна соответствовать следующей сигнатуре:

curlHandle

Обработчик cURL.

type

Одна из следующих констант, указывающая тип значения data:

Константы	Описание
CURLINFO_TEXT (int)	Информационный текст.
CURLINFO_HEADER_IN (int)	Данные заголовка (или подобные заголовку), полученные от однорангового узла.
CURLINFO_HEADER_OUT (int)	Данные заголовка (или подобные заголовку), отправленные одноранговому узлу.
CURLINFO_DATA_IN (int)	Необработанные данные протокола, полученные от однорангового узла. Даже если данные закодированы или сжаты, они не предоставляются декодированными или распакованными для этой callback-функции.
CURLINFO_DATA_OUT (int)	Данные протокола, отправленные одноранговому узлу.
CURLINFO_SSL_DATA_IN (int)	SSL/TLS (двоичные) данные, полученные от однорангового узла.
CURLINFO_SSL_DATA_OUT (int)	SSL/TLS (двоичные) данные, отправленные одноранговому узлу.

data

Подробные отладочные данные типа, указанного параметром type.

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

parent_ch

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

pushed_ch

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

headers

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