php curlopt_encoding,PHP: curl_setopt - Manual

CURLOPT_ABSTRACT_UNIX_SOCKET

Позволяет использовать абстрактный доменный сокет Unix вместо

установления TCP-соединения с хостом и устанавливает путь

к указанной строке (string). Эта опция использует ту же семантику,

что и CURLOPT_UNIX_SOCKET_PATH. Эти два параметра

совместно используют одно и то же хранилище, поэтому для каждого дескриптора можно установить только

один из них.

Доступно с PHP 7.3.0 и cURL 7.53.0

CURLOPT_CAINFO

Имя файла, содержащего один или более сертификатов, с которыми

будут сверяться узлы. Этот параметр имеет смысл только при

использовании совместно с CURLOPT_SSL_VERIFYPEER.

Может потребоваться абсолютный путь.

CURLOPT_CAPATH

Директория, содержащая несколько CA сертификатов.

Используйте этот параметр совместно с

CURLOPT_SSL_VERIFYPEER.

CURLOPT_COOKIE

Содержимое заголовка "Cookie: ",

используемого в HTTP-запросе.

Обратите внимание, что несколько cookies разделяются

точкой с запятой с последующим пробелом

(например, "fruit=apple; colour=red")

CURLOPT_COOKIEFILE

Имя файла, содержащего cookies. Данный файл должен быть

в формате Netscape или просто заголовками HTTP, записанными

в файл.

Если в качестве имени файла передана пустая строка, то cookies

сохраняться не будут, но их обработка всё ещё будет включена.

CURLOPT_COOKIEJAR

Имя файла, в котором будут сохранены все внутренние cookies

текущей передачи после закрытия дескриптора, например,

после вызова curl_close.

CURLOPT_COOKIELIST

Строка cookie (т.е. одна строка в формате Netscape/Mozilla или обычный заголовок

Set-Cookie в стиле HTTP) добавляет этот единственный cookie во внутреннее хранилище cookie.

"ALL" удаляет все файлы cookie, хранящиеся в памяти.

"SESS" удаляет все файлы cookie сессии, хранящиеся в памяти.

"FLUSH" записывает все известные файлы cookie в файл, указанный в CURLOPT_COOKIEJAR.

"RELOAD" загружает все файлы cookie из файлов, указанных в CURLOPT_COOKIEFILE.

Доступно с PHP 5.5.0 и cURL 7.14.1.

CURLOPT_CUSTOMREQUEST

Собственный метод запроса, используемый вместо

"GET" или "HEAD"

при выполнении HTTP-запроса. Это полезно при запросах

"DELETE" или других, более редких HTTP-запросах.

Корректными значениями будут такие как "GET",

"POST", "CONNECT" и так далее;

т.е. не вводите здесь всю строку с HTTP-запросом. Например,

указание "GET /index.html HTTP/1.0\r\n\r\n"

будет неправильным.Замечание:

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

сервер поддерживает данный тип запроса.

CURLOPT_DEFAULT_PROTOCOL

Протокол по умолчанию, если он отсутствует в схеме URL.

Добавлено в cURL 7.45.0. Доступно с PHP 7.0.7.

CURLOPT_DNS_INTERFACE

Устанавливает имя сетевого интерфейса, к которому привязан DNS.

Это должно быть имя интерфейса, а не адрес.

Добавлено в cURL 7.33.0. Доступно с PHP 7.0.7.

CURLOPT_DNS_LOCAL_IP4

Установить локальный IPv4-адрес, по которому доступне DNS.

Адрес должен быть представлен в виде строки, содержащий одно число.

Добавлено в cURL 7.33.0. Доступно с PHP 7.0.7.

CURLOPT_DNS_LOCAL_IP6

Установить локальный IPv6-адрес, по которому доступне DNS.

Адрес должен быть представлен в виде строки, содержащий одно число.

Добавлено в cURL 7.33.0. Доступно с PHP 7.0.7.

CURLOPT_EGDSOCKET

Наподобие CURLOPT_RANDOM_FILE, за исключением

того, что имя файла устанавливается в сокет Entropy

Gathering Daemon.

CURLOPT_ENCODING

Содержимое заголовка "Accept-Encoding: ".

Это позволяет декодировать запрос. Поддерживаемыми

кодировками являются "identity",

"deflate" и "gzip".

Если передана пустая строка, "",

посылается заголовок, содержащий все поддерживаемые

типы кодировок.

Добавлен в версии cURL 7.10.

CURLOPT_FTPPORT

Значение, которое будет использоваться для определения

IP-адреса для команды "PORT" FTP-протокола. Команда "PORT"

сообщает серверу, с каким IP-адресом он должен устанавливать

соединение. Это может быть IP-адрес, имя хоста, имя сетевого

интерфейса (под Unix) или просто '-' для использования системного

IP-адреса по умолчанию.

CURLOPT_INTERFACE

Имя используемого сетевого интерфейса. Может быть

именем интерфейса, IP адресом или именем хоста.

CURLOPT_KEYPASSWD

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

или CURLOPT_SSH_PRIVATE_KEYFILE.

Добавлено в cURL 7.16.1.

CURLOPT_KRB4LEVEL

Уровень безопасности KRB4 (Kerberos 4). Любое из следующих

значений (в порядке от слабого к самому сильному) корректно:

"clear",

"safe",

"confidential",

"private"..

Если указанная строка отличается от данных значений,

будет использовано значение "private".

Установка этого параметра в null полностью отключит

безопасность KRB4. На данный момент безопасность KRB4

работает только с FTP-транзакциями.

CURLOPT_LOGIN_OPTIONS

Используется для установки специфичных для протокола настроек логина,

таких как предпочитаемый механизм аутентификации "AUTH=NTLM" или "AUTH=*",

и должна использоваться совместно с CURLOPT_USERNAME.

Добавлено в cURL 7.34.0. Доступно с PHP 7.0.7.

CURLOPT_PINNEDPUBLICKEY

Устанавливает зафиксированный открытый ключ.

Строка должны содержать имя файла, в котором лежит ваш зафиксированный

открытый ключ. Ожидается формат файла "PEM" или "DEX".

Строка также может быть числом в формате base64, закодированным sha256 с

префиксом "sha256//" и разделённая точкой с запятой ";".

Добавлено в cURL 7.39.0. Доступно с PHP 7.0.7.

CURLOPT_POSTFIELDS

Все данные, передаваемые в HTTP POST-запросе.

Этот параметр может быть передан

как в качестве url-закодированной строки, наподобие

'para1=val1&para2=val2&...', так и

в виде массива, ключами которого будут имена полей, а значениями

- их содержимое.

Если value является массивом,

заголовок Content-Type будет установлен в

значение multipart/form-data.

Файлы можно отправлять с использованием CURLFile,

в этом случае value должен быть массивом.

CURLOPT_PRIVATE

Любые данные, которые должны связаны с этим дескриптором cURL.

Эти данные могут быть выбраны подзапросом опции

CURLINFO_PRIVATE функции

Добавлено в cURL 7.10.3.

CURLOPT_PRE_PROXY

Задайте строку (string), содержащую имя хоста или

IP-адрес, который будет использоваться в качестве прокси-сервера, к которому подключается curl, прежде чем

он подключится к прокси-серверу HTTP(S), указанному в

опции CURLOPT_PROXY для предстоящего запроса.

Предварительный прокси-сервер может быть только SOCKS-прокси, и перед ним должен стоять префикс

[scheme]://, чтобы указать, какой тип socks используется.

Числовой адрес IPv6 должен быть написан в [скобках].

Установка препрокси в пустую строку явно отключает использование препрокси.

Чтобы указать номер порта в этой строке, добавьте :[port]

в конец имени хоста. Номер порта прокси-сервера может быть дополнительно

указан с помощью отдельной опции CURLOPT_PROXYPORT.

По умолчанию используется порт 1080 для прокси, если порт не указан.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY

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

CURLOPT_PROXY_SERVICE_NAME

Имя сервиса аутентификации прокси.

Добавлено в cURL 7.34.0. Доступно с PHP 7.0.7.

CURLOPT_PROXY_CAINFO

Путь к прокси-серверу центра сертификации. Задайте путь в виде

строки (string) с именем файла, содержащего один или несколько сертификатов

для проверки прокси с помощью HTTPS.

Этот параметр предназначен для подключения к прокси-серверу HTTPS, а не к серверу HTTPS.

По умолчанию задан системный путь, где предполагается хранить пакет cacert libcurl.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_CAPATH

Каталог, содержащий несколько сертификатов центра сертификации для проверки прокси HTTPS.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_CRLFILE

Задайте имя файла с помощью конкатенации CRL (списка отзыва сертификатов)

в формате PEM для использования при проверке сертификата, которая происходит

во время обмена SSL.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_KEYPASSWD

Установите строку, используемую в качестве пароля, необходимого для использования

закрытого ключа CURLOPT_PROXY_SSLKEY. Вам не нужен

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

Этот параметр предназначен для подключения к прокси-серверу HTTPS, а не к серверу HTTPS.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_PINNEDPUBLICKEY

Установите закреплённый открытый ключ для HTTPS-прокси. Строка может быть именем файла

вашего закреплённого открытого ключа. Ожидаемый формат файла: "PEM" или "DER".

Строка также может быть любым количеством закодированных в base64 хешей sha256, которым предшествует

"sha256//" и разделяются ";"

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSLCERT

Имя файла вашего клиентского сертификата, используемого для подключения к прокси HTTPS.

Формат по умолчанию - "P12" в Secure Transport и "PEM" в других движках;

его можно изменить с помощью CURLOPT_PROXY_SSLCERTTYPE.

С NSS или Secure Transport это также может быть псевдоним сертификата,

с которым вы хотите пройти аутентификацию, так как он назван в базе данных безопасности.

Если вы хотите использовать файл из текущего каталога, пожалуйста, добавьте к нему

префикс "./", чтобы избежать путаницы с псевдонимом.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSLCERTTYPE

Формат сертификата вашего клиента, используемый при подключении к 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 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_SSL_CIPHER_LIST

Список шифров, используемых для подключения к прокси HTTPS.

Список должен быть синтаксически правильным, он состоит из одной или нескольких строк шифров,

разделённых двоеточиями. Запятые или пробелы также являются допустимыми разделителями,

но обычно качестве операторов используются двоеточия, !, - и +.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLS13_CIPHERS

Список наборов шифров, которые будут использоваться для подключения TLS 1.3 к прокси.

Список должен быть синтаксически правильным, он состоит из одной или нескольких

строк набора шифров, разделённых двоеточиями. Эта опция в настоящее время используется

только тогда, когда curl собран для использования OpenSSL 1.1.1 или новее.

Если вы используете другой бэкенд SSL, вы можете попытаться установить

наборы шифров TLS 1.3, используя параметр CURLOPT_PROXY_SSL_CIPHER_LIST.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.61.0.

Доступно при сборке с OpenSSL >= 1.1.1.

CURLOPT_PROXY_SSLKEY

Имя файла вашего личного ключа, используемого для подключения к прокси HTTPS.

Формат по умолчанию - "PEM", и его можно изменить с помощью

CURLOPT_PROXY_SSLKEYTYPE.

(Только для iOS и Mac OS X). Этот параметр игнорируется, если curl был создан для Secure Transport.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

Доступно, если включён встроенный TLS.

CURLOPT_PROXY_SSLKEYTYPE

Формат вашего закрытого ключа. Поддерживаемые форматы: "PEM", "DER" и "ENG".

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_PASSWORD

Пароль, используемый для метода аутентификации TLS, указанного

в параметре CURLOPT_PROXY_TLSAUTH_TYPE. Требует, чтобы

также был установлен параметр CURLOPT_PROXY_TLSAUTH_USERNAME.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_TYPE

Метод аутентификации TLS, используемый для соединения HTTPS. Поддерживаемый метод - "SRP".

Замечание:

Аутентификация Secure Remote Password (SRP) для TLS обеспечивает взаимную аутентификацию,

если обе стороны имеют общий секрет. Чтобы использовать TLS-SRP, вы также должны установить

параметры CURLOPT_PROXY_TLSAUTH_USERNAME и

CURLOPT_PROXY_TLSAUTH_PASSWORD.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXY_TLSAUTH_USERNAME

Имя пользователя, которое будет использоваться для метода аутентификации TLS прокси-сервера HTTPS, указанного в параметре

CURLOPT_PROXY_TLSAUTH_TYPE. Требует, чтобы параметр

CURLOPT_PROXY_TLSAUTH_PASSWORD также был установлен.

Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.

CURLOPT_PROXYUSERPWD

Логин и пароль, записанные в виде

"[username]:[password]", используемые при

соединении через прокси.

CURLOPT_RANDOM_FILE

Имя файла, используемого для инициализации генератора

случайных чисел для SSL.

CURLOPT_RANGE

Диапазон данных, которые нужно загрузить, в формате

"X-Y", причём либо X, либо Y могут быть

опущены. Протокол HTTP также поддерживает передачу

нескольких диапазонов, разделённых запятыми, они задаются

в формате "X-Y,N-M".

CURLOPT_REFERER

Содержимое заголовка "Referer: ", который будет

использован в HTTP-запросе.

CURLOPT_SERVICE_NAME

Имя сервиса аутентификации.

Добавлено в cURL 7.43.0. доступно с PHP 7.0.7.

CURLOPT_SSH_HOST_PUBLIC_KEY_MD5

Строка, содержащая 32 шестнадцатеричных цифры. Строка должна являться

контрольной суммой по алгоритму MD5 открытого ключа удалённого компьютера и libcurl будет сбрасывать

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

Эта опция предназначена только для передачи данных с помощью SCP и SFTP.

Добавлено в cURL 7.17.1.

CURLOPT_SSH_PUBLIC_KEYFILE

Имя файла для вашего публичного ключа. Если не задано, то libcurl использует по

умолчанию файл $HOME/.ssh/id_dsa.pub, если переменная окружения HOME установлена и

файл "id_dsa.pub" в текущей директории, если переменная HOME не установлена.

Добавлено в cURL 7.16.1.

CURLOPT_SSH_PRIVATE_KEYFILE

Имя файла для вашего приватного ключа. Если не задано, то libcurl использует по

умолчанию файл $HOME/.ssh/id_dsa, если переменная окружения HOME установлена и

файл "id_dsa" в текущей директории, если переменная HOME не установлена.

Если файл защищён паролем, установите пароль с помощью

CURLOPT_KEYPASSWD.

Добавлено в cURL 7.16.1.

CURLOPT_SSL_CIPHER_LIST

Список шифров, используемый в SSL-передачах. Например,

RC4-SHA и TLSv1 являются

корректными списками шифров.

CURLOPT_SSLCERT

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

CURLOPT_SSLCERTPASSWD

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

CURLOPT_SSLCERT.

CURLOPT_SSLCERTTYPE

Формат сертификата. Поддерживаются форматы

"PEM" (по умолчанию), "DER"

и "ENG".

Начиная с OpenSSL 0.9.3, "P12" (для файлов, закодированных в PKCS#12)

Добавлен в версии cURL 7.9.3.

CURLOPT_SSLENGINE

Идентификатор механизма шифрования для закрытого ключа SSL,

указанного в параметре CURLOPT_SSLKEY.

CURLOPT_SSLENGINE_DEFAULT

Идентификатор механизма шифрования, используемого для

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

CURLOPT_SSLKEY

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

CURLOPT_SSLKEYPASSWD

Тайный пароль, необходимый для использования закрытого

ключа SSL, указанного параметром

CURLOPT_SSLKEY.Замечание:

Так как этот параметр содержит ценный пароль, помните,

что данный PHP-скрипт нужно хранить в безопасном месте.

CURLOPT_SSLKEYTYPE

Тип закрытого ключа SSL, указанного в параметре

CURLOPT_SSLKEY. Поддерживаются следующие

типы ключей:

"PEM" (по умолчанию), "DER"

и "ENG".

CURLOPT_TLS13_CIPHERS

Список комплектов шифров для использования в соединении TLS 1.3. Список должен быть

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

Эта опция в настоящее время используется только тогда, когда curl собран для использования OpenSSL 1.1.1 или новее.

Если вы используете другой бэкенд SSL, вы можете попробовать установить

наборы шифров TLS 1.3, используя параметр CURLOPT_SSL_CIPHER_LIST.

Available since PHP 7.3.0 and libcurl >= cURL 7.61.0. Available when built with OpenSSL >= 1.1.1.

CURLOPT_UNIX_SOCKET_PATH

Разрешает использовать доменные сокеты UNIX в качестве конечной точки для

соединения и устанавливает путь к ним равным заданной строке (string).

Добавлено в cURL 7.40.0. Доступно с PHP 7.0.7.

CURLOPT_URL

Загружаемый URL. Данный параметр может быть также установлен

при инициализации сеанса с помощью

CURLOPT_USERAGENT

Содержимое заголовка "User-Agent: ", посылаемого

в HTTP-запросе.

CURLOPT_USERNAME

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

Добавлено в cURL 7.19.1. Доступно с PHP 5.5.0.

CURLOPT_USERPWD

Логин и пароль, используемые при соединении,

указанные в формате

"[username]:[password]".

CURLOPT_XOAUTH2_BEARER

Задаёт токен доступа OAuth 2.0.

Добавлено в cURL 7.33.0. Доступно с PHP 7.0.7.