Опции работы с библиотекой cURL
|
В качестве опций у методов ^curl:options[] и ^curl:load[] можно указывать любую из опций, доступную у установленной на вашей системе библиотеки libcurl (см. документацию). Имена опций нужно писать в нижнем регистре и без префикса CURLOPT_.
Кроме этого поддерживаются следующие опции Parser:
Опция
|
По-умолчанию
|
Значение
|
$.library[/путь/к/libcurl.so]
|
unix - libcurl.so
win32 - libcurl.dll |
Полный дисковый путь к динамической библиотеке libcurl в вашей системе.
|
$.charset[кодировка]
|
берется из заголовка HTTP-ответа
|
Кодировка документов на удаленном сервере. В эту кодировку перекодируется строка запроса, и из неё же перекодируется ответ сервера.
|
$.name[имя файла]
|
NONAME.DAT
|
Имя файла создаваемого объекта класса file.
|
$.mode[text|binary]
|
text
|
Тип создаваемого объекта класса file.
|
$.content-type[CONTENT-TYPE]
|
берется из заголовка HTTP-ответа
|
Поле content-type создаваемого объекта класса file.
|
Поддерживаемые опции libcurl в алфавитном порядке:
Название
|
Тип
|
Аналог в libcurl
|
Описание
|
accept_encoding
|
CURLOPT_ACCEPT_ENCODING
|
Метод упаковки ответа: gzip или deflate. (Старое название параметра - encoding - тоже поддерживается.)
|
|
autoreferer
|
CURLOPT_AUTOREFERER
|
Автоматически создавать заголовок Referer.
|
|
cainfo
|
CURLOPT_CAINFO
|
См. документацию по libcurl.
|
|
capath
|
CURLOPT_CAPATH
|
См. документацию по libcurl.
|
|
connecttimeout
|
CURLOPT_CONNECTTIMEOUT
|
Таймаут ожидания соединения в секундах.
|
|
connecttimeout_ms
|
CURLOPT_CONNECTTIMEOUT_MS
|
Таймаут ожидания соединения в миллисекундах.
|
|
cookie
|
CURLOPT_COOKIE
|
Строка с куками.
|
|
cookielist
|
CURLOPT_COOKIELIST
|
Строка с куками (про отличия от cookie см. в документации по libcurl)
|
|
cookiesession
|
CURLOPT_COOKIESESSION
|
Поставить куки на всю сессию.
|
|
copypostfields
|
CURLOPT_COPYPOSTFIELDS
|
Тело пост-запроса (с копированием).
|
|
crlfile
|
CURLOPT_CRLFILE
|
См. документацию по libcurl.
|
|
customrequest
|
CURLOPT_CUSTOMREQUEST
|
Другой http-метод.
|
|
failonerror
|
CURLOPT_FAILONERROR
|
Выдавать ошибку, если http-статус больше или равен 400.
|
|
followlocation
|
CURLOPT_FOLLOWLOCATION
|
Обрабатывать редиректы в ответе сервера.
|
|
forbid_reuse
|
CURLOPT_FORBID_REUSE
|
См. документацию по libcurl.
|
|
fresh_connect
|
CURLOPT_FRESH_CONNECT
|
Создавать новое соединение при каждом запросе в сессии.
|
|
http_content_decoding
|
CURLOPT_HTTP_CONTENT_DECODING
|
См. документацию по libcurl.
|
|
http_transfer_decoding
|
CURLOPT_HTTP_TRANSFER_DECODING
|
См. документацию по libcurl.
|
|
httpauth
|
CURLOPT_HTTPAUTH
|
Тип http-авторизации (CURLAUTH_NONE = 0, CURLAUTH_BASIC = (1<<0), CURLAUTH_DIGEST = (1<<1), CURLAUTH_GSSNEGOTIATE = (1<<2), CURLAUTH_NTLM = (1<<3), CURLAUTH_DIGEST_IE = (1<<4), CURLAUTH_NTLM_WB = (1<<5), CURLAUTH_ONLY = (1<<31), CURLAUTH_ANY = (~CURLAUTH_DIGEST_IE), CURLAUTH_ANYSAFE = (~(CURLAUTH_BASIC|CURLAUTH_DIGEST_IE))).
|
|
httpget
|
CURLOPT_HTTPGET
|
Передать запрос методом GET.
|
|
httpheader
|
CURLOPT_HTTPHEADER
|
HTTP-заголовки запроса.
|
|
httppost
|
CURLOPT_HTTPPOST
|
Поля post-запроса, заданные аналогично полю form для file::load.
|
|
httpproxytunnel
|
CURLOPT_HTTPPROXYTUNNEL
|
Включить тунелирование запросов через прокси.
|
|
ignore_content_length
|
CURLOPT_IGNORE_CONTENT_LENGTH
|
Игнорировать заголовок Content-Length ответа сервера.
|
|
interface
|
CURLOPT_INTERFACE
|
Имя сетевого интерфейсаю
|
|
issuercert
|
CURLOPT_ISSUERCERT
|
Имя файла с сертификатом CA.
|
|
keypasswd
|
CURLOPT_KEYPASSWD
|
Пароль для ключа (passphrase).
|
localport
|
CURLOPT_LOCALPORT
|
Локальный порт.
|
|
low_speed_limit
|
CURLOPT_LOW_SPEED_LIMIT
|
Минимальная скорость передачи (байт/сек).
|
|
low_speed_time
|
CURLOPT_LOW_SPEED_TIME
|
Максимальное время, когда скорость передачи может быть меньше low_speed_limit.
|
|
maxconnects
|
CURLOPT_MAXCONNECTS
|
Максимальное количество постоянных соединений в рамках сессии.
|
|
maxfilesize
|
CURLOPT_MAXFILESIZE
|
Максимальный размер ответа в байтах.
|
|
maxredirs
|
CURLOPT_MAXREDIRS
|
Максимальное число редиректов.
|
|
nobody
|
CURLOPT_NOBODY
|
Передать запрос методом HEAD.
|
|
password
|
CURLOPT_PASSWORD
|
Пароль.
|
|
port
|
CURLOPT_PORT
|
Порт.
|
|
post
|
CURLOPT_POST
|
Передать запрос методом POST.
|
|
postfields
|
CURLOPT_POSTFIELDS
|
Тело post-запроса.
|
|
postredir
|
CURLOPT_POSTREDIR
|
См. документацию по libcurl.
|
|
proxy
|
CURLOPT_PROXY
|
Адрес прокси-сервера.
|
|
proxyauth
|
CURLOPT_PROXYAUTH
|
Тип авторизации (см. параметр httpauth).
|
|
proxyport
|
CURLOPT_PROXYPORT
|
Порт прокси-сервера.
|
|
proxytype
|
CURLOPT_PROXYTYPE
|
Тип прокси (CURLPROXY_HTTP = 0, CURLPROXY_HTTP_1_0 = 1, CURLPROXY_SOCKS4 = 4, CURLPROXY_SOCKS5 = 5, CURLPROXY_SOCKS4A = 6, CURLPROXY_SOCKS5_HOSTNAME = 7).
|
|
proxyuserpwd
|
CURLOPT_PROXYUSERPWD
|
Имя пользователя и пароль для прокси.
|
|
range
|
CURLOPT_RANGE
|
Вернуть части ответа, находящиеся в указанном диапазоне.
|
|
referer
|
CURLOPT_REFERER
|
Заголовок Referer.
|
|
ssl_cipher_list
|
CURLOPT_SSL_CIPHER_LIST
|
См. документацию по libcurl.
|
|
ssl_sessionid_cache
|
CURLOPT_SSL_SESSIONID_CACHE
|
Включить SSL session-ID кеш.
|
|
ssl_verifyhost
|
CURLOPT_SSL_VERIFYHOST
|
Проверять сертификат хоста.
|
|
ssl_verifypeer
|
CURLOPT_SSL_VERIFYPEER
|
Проверять сертификат пира.
|
|
sslcert
|
CURLOPT_SSLCERT
|
Имя файла с SSL-сертификатом.
|
|
sslcerttype
|
CURLOPT_SSLCERTTYPE
|
Тип ssl-сертификата.
|
|
sslengine
|
CURLOPT_SSLENGINE
|
См. документацию по libcurl.
|
|
sslengine_default
|
CURLOPT_SSLENGINE_DEFAULT
|
См. документацию по libcurl.
|
|
sslkey
|
CURLOPT_SSLKEY
|
Имя файла с SSL-ключом.
|
|
sslkeytype
|
CURLOPT_SSLKEYTYPE
|
Тип ssl-ключа.
|
|
stderr
|
CURLOPT_STDERR
|
Имя файла в который будет переадресован вывод из stderr.
|
|
timeout
|
CURLOPT_TIMEOUT
|
Таймаут с секундах.
|
|
timeout_ms
|
CURLOPT_TIMEOUT_MS
|
Таймаутах в миллисекундах.
|
|
unrestricted_auth
|
CURLOPT_UNRESTRICTED_AUTH
|
Повторно отсылать параметры http-авторизации, если при редиректе сменилось имя сервера.
|
|
url
|
CURLOPT_URL
|
URL-адрес.
|
|
useragent
|
CURLOPT_USERAGENT
|
Заголовок User-Agent.
|
|
username
|
CURLOPT_USERNAME
|
Имя пользователя.
|
|
userpwd
|
CURLOPT_USERPWD
|
Имя пользователя и пароль.
|
|
verbose
|
CURLOPT_VERBOSE
|
Выводить подробную информацию в процессе обработки запроса в stderr.
|