Запрос и ответ HTTP (через CURL)

Отладка настроек одиночных заросов CURL (пареметры для curl_setopt(...))
Описание колонок результата
Сделать чтоб работало
Сделать чтоб красиво
Перенести готовое в http
Возможность делать https на ip4+ip6 со своими заголовками (особенно host vs authority)
Скопировано 08.03.2023 отседова https://www.php.net/manual/ru/function.curl-setopt.php
nametypedefaultaboutv_curlv_php
CURLOPT_AUTOREFERERbooltrueдля автоматической установки поля Referer: в запросах, перенаправленных заголовком Location:
CURLOPT_COOKIESESSIONbooltrueдля указания текущему сеансу начать новую "сессию" cookies. Это заставит libcurl проигнорировать все "сессионные" cookies, которые она должна была бы загрузить, полученные из предыдущей сессии. По умолчанию libcurl всегда сохраняет и загружает все cookies, вне зависимости от того, являются ли они "сессионными" или нет. "Сессионные" cookies - это cookies без срока истечения, которые должны существовать только для текущей "сессии"
CURLOPT_CERTINFObooltrueДля вывода информации о сертификате SSL в поток STDERR при безопасных соединениях. Для корректной работы требует включённой опции CURLOPT_VERBOSE7.19.1
CURLOPT_CONNECT_ONLYbooltrueСообщает библиотеке, чтобы она провела необходимые аутентификацию прокси и настройку соединения, но не передавала данные. Эта опция реализована для HTTP, SMTP и POP3.7.15.2
CURLOPT_CRLFbooltrueДля преобразования концов строк Unix в CRLF
CURLOPT_DISALLOW_USERNAME_IN_URLbooltrueДля запрета URL-адресов, содержащих имя пользователя. Имена пользователей по умолчанию разрешены (0).7.61.07.3.0
CURLOPT_DNS_SHUFFLE_ADDRESSESbooltrueДля перетасовки порядка всех возвращённых адресов, чтобы они использовались в случайном порядке, когда имя разрешено и возвращается более одного IP-адреса. Это может привести к тому, что IPv4 будет использоваться до IPv6 или наоборот.7.60.07.3.0
CURLOPT_HAPROXYPROTOCOLbooltrueДля отправки заголовка протокола HAProxy PROXY v1 в начале соединения. Действие по умолчанию - не отправлять заголовок.7.60.0PHP 7.3.0
CURLOPT_SSH_COMPRESSIONbooltrueДля включения встроенного сжатия SSH. Это не запрос, а указание; сервер может это и не выполнить.7.56.07.3.0
CURLOPT_DNS_USE_GLOBAL_CACHEbooltrueДля использования глобального кеша DNS. Этот параметр не является потокобезопасным. Он по умолчанию включён если PHP собран для потоконебезопасного использования (CLI, FCGI, Apache2-Prefork, etc).
CURLOPT_FAILONERRORbooltrueДля подробного отчёта при неудаче, если полученный HTTP-код больше или равен 400. Поведение по умолчанию возвращает страницу как обычно, игнорируя код.
CURLOPT_SSL_FALSESTARTbooltrueДля разрешения ложного старта TLS.7.42.07.0.7
CURLOPT_FILETIMEbooltrueДля попытки получения даты модификации удалённого документа. Это значение может быть получено с помощью параметра CURLINFO_FILETIME из функции curl_getinfo()
CURLOPT_FOLLOWLOCATIONbooltrueДля следования любому заголовку "Location: ", отправленному сервером в своём ответе. Смотрите также CURLOPT_MAXREDIRS.
CURLOPT_FORBID_REUSEbooltrueДля принудительного закрытия соединения после завершения его обработки так, чтобы его нельзя было использовать повторно.
CURLOPT_FRESH_CONNECTbooltrueДля принудительного использования нового соединения вместо закешированного.
CURLOPT_FTP_USE_EPRTbooltrueДля использования EPRT (и LPRT) при активных FTP-загрузках. Используйте false для того, чтобы отключить EPRT и LPRT и использовать только PORT.
CURLOPT_FTP_USE_EPSVbooltrueДля первоначальной пробы команды EPSV при FTP-передачах. Если команда не удалась, будет произведён обратный откат к PASV. Установите в false для отключения EPSV.
CURLOPT_FTP_CREATE_MISSING_DIRSbooltrueДля создания отсутствующих директорий, если FTP-операция обнаруживает несуществующий путь.
CURLOPT_FTPAPPENDbooltrueДля записи в конец удалённого файла, вместо перезаписывания.
CURLOPT_TCP_NODELAYbooltrueДля отключения алгоритма Нейгла, который пытается уменьшить количество мелких пакетов в сети.7.11.2
CURLOPT_FTPASCIIbooltrueПсевдоним CURLOPT_TRANSFERTEXT. Используйте его вместо этого.
CURLOPT_FTPLISTONLYbooltrueДля возврата только списка имён из FTP-директории.
CURLOPT_HEADERbooltrueДля включения заголовков в вывод.
CURLINFO_HEADER_OUTbooltrueДля отслеживания строки запроса дескриптора. Префикс CURLINFO_ используется специально.
CURLOPT_HTTP09_ALLOWEDbooltrueОпределяет разрешить ли ответы HTTP/0.9. По умолчанию false c версии libcurl 7.66.0; ранее по умолчанию было true.7.66.07.3.15
CURLOPT_HTTPGETbooltrueДля сброса метода HTTP-запроса на метод GET. Так как GET используется по умолчанию, этот параметр необходим только в случае, если метод запроса был ранее изменён.
CURLOPT_HTTPPROXYTUNNELbooltrueДля туннелирования через указанный HTTP-прокси.
CURLOPT_HTTP_CONTENT_DECODINGboolfalseДля получения необработанного тела HTTP-ответа. Доступно, если собран с libcurl.7.16.2
CURLOPT_KEEP_SENDING_ON_ERRORbooltrueДля продолжения посылать тело запроса, если возвращаемый HTTP-код равен или больше 300. Действие по умолчанию - остановить отправку и закрыть поток или соединение. Подходит для ручной аутентификации NTLM. Большинству приложений эта опция не нужна.7.51.07.3.0
CURLOPT_MUTEbooltrueДля полного отключения сообщений функций cURL. Удалена в cURL 7.15.5 (Можно использовать опцию CURLOPT_RETURNTRANSFER)
CURLOPT_NETRCbooltrueДля считывания файла ~/.netrc, чтобы найти логин и пароль для удалённого сайта, с которым устанавливается соединение.
CURLOPT_NOBODYbooltrueДля исключения тела ответа из вывода. Метод запроса устанавливается в HEAD. Смена этого параметра в false не меняет его обратно в GET.
CURLOPT_NOPROGRESSbooltrueДля отмены индикатора прогресса при передачах cURL. <i>PHP автоматически устанавливает этот параметр в true, меняйте его только для отладочных целей.</i>
CURLOPT_NOSIGNALbooltrueДля игнорирования любой функции cURL, посылающей сигналы PHP процессу. Этот параметр включён по умолчанию в многопоточных SAPI для корректной работы параметров времени ожидания.7.10
CURLOPT_PATH_AS_ISbooltrueДля игнорирования последовательностей с двумя точками.7.42.07.0.7
CURLOPT_PIPEWAITbooltrueДля ожидания конвейера/мультиплексирования.7.43.07.0.7
CURLOPT_POSTbooltrueДля использования обычного HTTP POST. Данный метод POST использует обычный application/x-www-form-urlencoded, обычно используемый в HTML-формах.
CURLOPT_PUTbooltrueДля загрузки файла методом HTTP PUT. Используемый файл должен быть установлен с помощью параметров CURLOPT_INFILE и CURLOPT_INFILESIZE.
CURLOPT_RETURNTRANSFERbooltrueДля возврата результата передачи в качестве строки из curl_exec() вместо прямого вывода в браузер.
CURLOPT_SASL_IRbooltrueДля разрешения отправки инициирующего ответа в первом пакете.7.31.107.0.7
CURLOPT_SSL_ENABLE_ALPNboolfalseДля отключения ALPN в SSL handshake (если на бекенде SSL libcurl собран с её поддержкой), это можно использовать при соединении http2.7.36.07.0.7
CURLOPT_SSL_ENABLE_NPNboolfalseДля отключения ??ALPN?? в SSL handshake (если на бэкенде SSL libcurl собран с её поддержкой), это можно использовать при соединении http2.7.36.07.0.7
CURLOPT_SSL_VERIFYPEERboolfalseДля остановки cURL от проверки сертификата узла сети. Альтернативные сертификаты дл проверки могут быть указаны с помощью параметра CURLOPT_CAINFO, или директории с сертификатами, указываемой параметром CURLOPT_CAPATH. <i>По умолчанию равно ??true??, начиная с версии cURL 7.10. Дистрибутив по умолчанию устанавливается с версией cURL 7.10.</i>7.10
CURLOPT_SSL_VERIFYSTATUSbooltrueДля проверки статуса сертификата.7.41.07.0.7
CURLOPT_PROXY_SSL_VERIFYPEERboolfalseДля остановки cURL от проверки сертификата пира. Альтернативные сертификаты для проверки могут быть указаны с помощью параметра CURLOPT_CAINFO, а каталог сертификатов может быть указан с помощью параметра CURLOPT_CAPATH. Если установлено значение ??false??, проверка сертификата однорангового узла завершается успешно несмотря ни на что. true по умолчанию.7.52.07.3.0
CURLOPT_SAFE_UPLOADbooltrueВсегда true, это отключает поддержку префикса @ для загрузки файлов в CURLOPT_POSTFIELDS и означает, что значения, начинающиеся с @, могут быть безопасно переданы в качестве полей. Вместо этого для загрузки файлов можно использовать объект CURLFile.
CURLOPT_SUPPRESS_CONNECT_HEADERSbooltrueДля подавления заголовков ответов прокси-сервера CONNECT из пользовательских callback-функций CURLOPT_HEADERFUNCTION и CURLOPT_WRITEFUNCTION, когда используется CURLOPT_HTTPPROXYTUNNEL и выполняется запрос CONNECT.7.54.07.3.0
CURLOPT_TCP_FASTOPENbooltrueДля разрешения TCP Fast Open.7.49.07.0.7
CURLOPT_TFTP_NO_OPTIONSbooltrueДля запрета посылки запроса TFTP опций.7.48.07.0.7
CURLOPT_TRANSFERTEXTbooltrueДля использования ASCII-режима при FTP-передачах. При использовании LDAP данные возвращаются простым текстом вместо HTML. В Windows системах поток STDOUT не устанавливается в бинарный режим.
CURLOPT_UNRESTRICTED_AUTHbooltrueДля продолжения отправки логина и пароля при редиректах (используя CURLOPT_FOLLOWLOCATION), даже при изменении имени хоста.
CURLOPT_UPLOADbooltrueДля подготовки к загрузке файла на сервер.
CURLOPT_VERBOSEbooltrueДля вывода дополнительной информации. Записывает вывод в поток STDERR, или файл, указанный параметром CURLOPT_STDERR.
CURLOPT_BUFFERSIZEintРазмер буфера, используемого при каждом чтении. Однако, нет никакой гарантии что данный запрос будет завершён.7.10
CURLOPT_CONNECTTIMEOUTintКоличество секунд ожидания при попытке соединения. Используйте 0 для бесконечного ожидания.
CURLOPT_CONNECTTIMEOUT_MSintКоличество миллисекунд ожидания при попытке соединения. Используйте 0 для бесконечного ожидания. Если библиотека libcurl скомпилирована с использованием стандартного системного преобразователя имён, то соединение будет по-прежнему использовать полносекундное ожидание в качестве времени ожидания с минимально допустимым временем ожидания в 1 секунду.7.16.2
CURLOPT_DNS_CACHE_TIMEOUTintКоличество секунд, в течение которых в памяти хранятся DNS-записи. По умолчанию этот параметр равен 120 (2 минуты).
CURLOPT_EXPECT_100_TIMEOUT_MSint1000Время ожидания ответов с заголовком Expect: 100-continue в миллисекундах.7.36.07.0.7
CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MSintНачало для ipv6 для алгоритма счастливые eyeballs. Счастливые eyeballs пытаются подключиться как к адресам IPv4, так и к адресам IPv6 для хостов с двумя стеками, предпочитая сначала IPv6 на время ожидания в миллисекундах. По умолчанию используется CURL_HET_DEFAULT, который в настоящее время составляет 200 миллисекунд. Добавлено в cURL 7.59.0. Доступно с PHP 7.3.0.
CURLOPT_FTPSSLAUTHintCURLFTPAUTH_DEFAULTМетод FTP-аутентификации (в активном режиме): CURLFTPAUTH_SSL (сначала проверяется SSL), CURLFTPAUTH_TLS (сначала проверяется TLS) или CURLFTPAUTH_DEFAULT (cURL решает сама).7.12.2
CURLOPT_HEADEROPTintCURLHEADER_SEPARATEЧто делать с заголовками. Одна из следующих опций: CURLHEADER_UNIFIED: заголовки, указанные в CURLOPT_HTTPHEADER будут использованы в запросах к серверам и прокси. Если разрешена эта опция, CURLOPT_PROXYHEADER не будет иметь эффекта. CURLHEADER_SEPARATE: заголовки CURLOPT_HTTPHEADER будут отсылаться только на сервер, но не на прокси. На прокси заголовки должны посылаться CURLOPT_PROXYHEADER. Обратите внимание, что если запросы типа non-CONNECT будут слаться на прокси, то libcurl будет посылать как серверные, так и прокси заголовки. Если же происходит CONNECT, libcurl пошлёт на прокси только заголовки CURLOPT_PROXYHEADER, а потом заголовки CURLOPT_HTTPHEADER только на сервер. По умолчанию CURLHEADER_SEPARATE, начиная с cURL 7.42.1, и CURLHEADER_UNIFIED до него.7.37.07.0.7
CURLOPT_HTTP_VERSIONintCURL_HTTP_VERSION_NONECURL_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 (принудительное использование HTTP/2.0, алиас CURL_HTTP_VERSION_2_0), CURL_HTTP_VERSION_2TLS (принудительное использование HTTP/2.0 только по TLS (HTTPS), доступно с PHP 7.0), CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE (принудительное использование HTTP/2.0 HTTP-запросы без TLS).
CURLOPT_HTTPAUTHintИспользуемые HTTP-методы авторизации. Используемые параметры: CURLAUTH_BASIC, CURLAUTH_DIGEST, CURLAUTH_GSSNEGOTIATE, CURLAUTH_NTLM, CURLAUTH_ANY и CURLAUTH_ANYSAFE. Можно использовать побитовый оператор | (или) для комбинации нескольких методов вместе. В этом случае cURL опросит сервер на предмет поддерживаемых методов авторизации и выберет лучший из них. CURLAUTH_ANY - это псевдоним CURLAUTH_BASIC | CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM. CURLAUTH_ANYSAFE - это псевдоним CURLAUTH_DIGEST | CURLAUTH_GSSNEGOTIATE | CURLAUTH_NTLM.
CURLOPT_INFILESIZEintОжидаемый размер файла в байтах при загрузке файла на удалённый сервер. Учтите, что использование этой опции не остановит дальнейшую посылку данных, превышающих это значение, так как посылаемые данные зависят от результата CURLOPT_READFUNCTION.
CURLOPT_LOW_SPEED_LIMITintВерхний порог скорости передачи данных, в байтах в секунду. Проверка происходит в течение CURLOPT_LOW_SPEED_TIME секунд, после чего PHP считает передачу слишком медленной и прерывает её.
CURLOPT_LOW_SPEED_TIMEintМаксимальное количество секунд, в течение которых скорость передачи не должна превышать CURLOPT_LOW_SPEED_LIMIT, иначе PHP пометит передачу как слишком медленную и прекратит её.
CURLOPT_MAXCONNECTSintМаксимальное количество постоянных соединений. При достижении лимита, самое старое соединение в кеше закрывается, чтобы предотвратить увеличение числа открытых соединений.
CURLOPT_MAXREDIRSint20Максимальное количество принимаемых редиректов. Используйте этот параметр вместе с параметром CURLOPT_FOLLOWLOCATION. Значение по умолчанию 20 установлено для предотвращения бесконечных перенаправлений. Значение -1 разрешает бесконечные перенаправления, а 0 отклоняет все перенаправления.
CURLOPT_PORTintАльтернативный порт соединения.
CURLOPT_POSTREDIRintБитовая маска, содержащая 1 (301 Moved Permanently), 2 (302 Found) и 4 (303 See Other), чтобы задавать должен ли метод HTTP POST обрабатываться при включённой опции CURLOPT_FOLLOWLOCATION, если произошёл указанный тип перенаправления.7.19.1
CURLOPT_PROTOCOLSintБитовая маска из значений 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_ALL7.19.4
CURLOPT_PROXYAUTHintМетоды авторизации HTTP, используемые при соединении с прокси-сервером. Используйте те же самые битовые маски, которые были описаны у параметра CURLOPT_HTTPAUTH. В данный момент для авторизации прокси поддерживаются только CURLAUTH_BASIC и CURLAUTH_NTLM.7.10.7
CURLOPT_PROXYPORTintНомер порта прокси-сервера, к которому осуществляется соединение. Этот номер также может быть установлен с помощью параметра CURLOPT_PROXY.
CURLOPT_PROXYTYPEintCURLPROXY_HTTPЛибо CURLPROXY_HTTP (по умолчанию), либо CURLPROXY_SOCKS4, CURLPROXY_SOCKS5, CURLPROXY_SOCKS4A или CURLPROXY_SOCKS5_HOSTNAME.7.10
CURLOPT_REDIR_PROTOCOLSintБитовая маска из значений CURLPROTO_*. Данная битовая маска ограничивает протоколы, используемые libcurl при редиректе (при включённом параметре CURLOPT_FOLLOWLOCATION). Это позволяет ограничить набор используемых протоколов при редиректах для некоторых передач. По умолчанию, libcurl поддерживает все протоколы, кроме FILE и SCP. В версиях, предшествовавших 7.19.4, перенаправление использовалось для всех протоколов без исключения. Смотрите также описание параметра CURLOPT_PROTOCOLS для списка констант со значениями протоколов.7.19.4
CURLOPT_RESUME_FROMintСмещение в байтах для возобновления передачи.
CURLOPT_SOCKS5_AUTHintМетод аутентификации SOCKS5, который нужно использовать. Варианты: CURLAUTH_BASIC, CURLAUTH_GSSAPI, CURLAUTH_NONE. Побитовый оператор | (или) можно использовать для объединения нескольких методов. Если это будет сделано, cURL будет опрашивать сервер, чтобы выяснить, какие методы он поддерживает, и выбрать наилучший. CURLAUTH_BASIC разрешает аутентификацию по constant пользователя/пароля. CURLAUTH_GSSAPI разрешает аутентификацию GSS-API. CURLAUTH_NONE не разрешает аутентификацию. По умолчанию CURLAUTH_BASIC|CURLAUTH_GSSAPI. Установите действительное имя пользователя и пароль с помощью параметра CURLOPT_PROXYUSERPWD.7.55.07.3.0
CURLOPT_SSL_OPTIONSintУстанавливает опции поведения SSL. Битовая маска из следующих констант: CURLSSLOPT_ALLOW_BEAST: не пытаться найти обходной путь для изъяна в безопасности протоколов SSL3 и TLS1.0. CURLSSLOPT_NO_REVOKE: не производить проверку, отозван ли сертификат, для тех SSL бэкендов, где оно есть.7.25.07.0.7
CURLOPT_SSL_VERIFYHOSTint2Используйте 2, чтобы убедиться, что поле общего имени или поле альтернативного имени субъекта в сертификате узла SSL соответствует указанному имени хоста. Используйте 0, чтобы не проверять имена. 1 не следует использовать. В боевом окружении значение этого параметра должно быть 2 (установлено по умолчанию). Поддержка значения 1 убрана в cURL 7.28.1
CURLOPT_SSLVERSIONintОдна из констант CURL_SSLVERSION_DEFAULT (0), CURL_SSLVERSION_TLSv1 (1), CURL_SSLVERSION_SSLv2 (2), CURL_SSLVERSION_SSLv3 (3), CURL_SSLVERSION_TLSv1_0 (4), CURL_SSLVERSION_TLSv1_1 (5) CURL_SSLVERSION_TLSv1_2 (6) или CURL_SSLVERSION_TLSv1_3 (7). Максимальная версия 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, or CURL_SSLVERSION_MAX_TLSv1_3. Рекомендуется не устанавливать эту опцию и оставить значение по умолчанию. Установка в 2 или 3 опасно и допускает применение известных уязвимостей в SSLv2 и SSLv3.
CURLOPT_PROXY_SSL_OPTIONSintЗадайте параметры поведения SSL прокси, которые являются битовой маской любой из следующих констант: CURLSSLOPT_ALLOW_BEAST: не пытайтесь использовать обходные пути для устранения уязвимости в протоколах SSL3 и TLS1.0. CURLSSLOPT_NO_REVOKE: отключите проверки отзыва сертификатов для тех бэкендов SSL, где такое поведение присутствует. (curl >= 7.44.0) CURLSSLOPT_NO_PARTIALCHAIN: не принимайте "частичные" цепочки сертификатов, что в противном случае делается по умолчанию. (curl >= 7.68.0).7.52.07.3.0
CURLOPT_PROXY_SSL_VERIFYHOSTint2Установите значение 2 для проверки в полях имени сертификата прокси-сервера HTTPS по отношению к имени прокси-сервера. Когда установлено значение 0, соединение успешно выполняется независимо от имён, используемых в сертификате. Используйте эту способность с осторожностью! 1 рассматривается как опция отладки в curl 7.28.0 и более ранних версиях. С версии curl 7.28.1 до 7.65.3 возвращена CURLE_BAD_FUNCTION_ARGUMENT. Начиная с curl 7.66.0 и далее 1 и 2 обрабатываются как одно и то же значение. В продакшене значение этой опции должно быть 2 (значение по умолчанию).7.52.07.3.0
CURLOPT_PROXY_SSLVERSIONintCURL_SSLVERSION_DEFAULTОдна из 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. Лучше всего не устанавливать это и разрешать использовать значение по умолчанию CURL_SSLVERSION_DEFAULT, которое попытается выяснить версию протокола удалённого SSL.7.52.07.3.0
CURLOPT_STREAM_WEIGHTintУстановить вес цифрового потока (число между 1 и 256).7.46.07.0.7
CURLOPT_TCP_KEEPALIVEint0Если установлено значение 1, будут отправлены пробные сообщения поддержки активности TCP. Задержку и частоту этих проб можно контролировать с помощью параметров CURLOPT_TCP_KEEPIDLE и CURLOPT_TCP_KEEPINTVL, если операционная система их поддерживает. Если установлено значение 0 (по умолчанию), пробные сообщения проверки активности отключены.7.25.0
CURLOPT_TCP_KEEPIDLEint60Устанавливает задержку в секундах, в течение которой операционная система будет ждать, пока соединение находится в режиме ожидания, перед отправкой проб проверки активности, если включено CURLOPT_TCP_KEEPALIVE. Не все операционные системы поддерживают эту опцию. По умолчанию установлено значение 60.7.25.0
CURLOPT_TCP_KEEPINTVLint60Устанавливает интервал в секундах, в течение которого операционная система будет ожидать между отправкой проб проверки активности, если включено CURLOPT_TCP_KEEPALIVE. Не все операционные системы поддерживают эту опцию. По умолчанию установлено значение 60.7.25.0
CURLOPT_TIMECONDITIONintСпособ трактовки параметра 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.
CURLOPT_TIMEOUTintМаксимально позволенное количество секунд для выполнения cURL-функций.
CURLOPT_TIMEOUT_MSintМаксимально позволенное количество миллисекунд для выполнения cURL-функций. Если libcurl собрана с использованием обычного системного распознавателя имён, то этот промежуток соединения всё ещё будет использовать секундное округление времени ожидания, с минимально разрешённым временем ожидания в одну секунду.7.16.2
CURLOPT_TIMEVALUEintКоличество секунд, начиная с 1 января 1970 года. Это время будет использовано параметром CURLOPT_TIMECONDITION.
CURLOPT_TIMEVALUE_LARGEint0Время в секундах с 1 января 1970 года. Время будет использовано CURLOPT_TIMECONDITION. По умолчанию ноль. Разница между этой опцией и CURLOPT_TIMEVALUE заключается в типе аргумента. В системах, где "long" имеет размер всего 32 бита, этот параметр необходимо использовать для установки дат после 2038 года.7.59.07.3.0
CURLOPT_MAX_RECV_SPEED_LARGEintЕсли скорость скачки превысит это значение (указанное в байтах в секунду) в среднем в течение всей передачи, то скачка будет приостановлена для поддержания средней скорости меньше либо равной данному параметру. По умолчанию скорость не ограничивается.7.15.5
CURLOPT_MAX_SEND_SPEED_LARGEintЕсли загрузка на сервер превысит это значение (указанное в байтах в секунду) в среднем в течение всей передачи, то загрузка будет приостановлена для поддержания средней скорости меньше либо равной данному параметру. По умолчанию скорость не ограничивается.7.15.5
CURLOPT_SSH_AUTH_TYPESintБитовая маска, состоящая из одной или более констант: CURLSSH_AUTH_PUBLICKEY, CURLSSH_AUTH_PASSWORD, CURLSSH_AUTH_HOST, CURLSSH_AUTH_KEYBOARD. Установите CURLSSH_AUTH_ANY, чтобы libcurl сам выбрал одну из них.7.16.1
CURLOPT_IPRESOLVEintCURL_IPRESOLVE_WHATEVERПозволяет приложению выбрать вид IP-адреса, с которым определяется имя хоста. Это необходимо, если используется имя хоста, которое получается с использованием более одной версии IP адреса. Возможными значениями могут быть CURL_IPRESOLVE_WHATEVER, CURL_IPRESOLVE_V4, CURL_IPRESOLVE_V6, и по умолчанию CURL_IPRESOLVE_WHATEVER.7.10.8
CURLOPT_FTP_FILEMETHODintКакой метод использовать, чтобы достать файл на сервере FTP. Варианты: CURLFTPMETHOD_MULTICWD, CURLFTPMETHOD_NOCWD и CURLFTPMETHOD_SINGLECWD.7.15.1
CURLOPT_ABSTRACT_UNIX_SOCKETstringПозволяет использовать абстрактный доменный сокет Unix вместо установления TCP-соединения с хостом и устанавливает путь к указанной строке (string). Эта опция использует ту же семантику, что и CURLOPT_UNIX_SOCKET_PATH. Эти два параметра совместно используют одно и то же хранилище, поэтому для каждого дескриптора можно установить только один из них.7.53.07.3.0
CURLOPT_CAINFOstringИмя файла, содержащего один или более сертификатов, с которыми будут сверяться узлы. Этот параметр имеет смысл только при использовании совместно с CURLOPT_SSL_VERIFYPEER. Может потребоваться абсолютный путь.
CURLOPT_CAPATHstringДиректория, содержащая несколько CA сертификатов. Используйте этот параметр совместно с CURLOPT_SSL_VERIFYPEER.
CURLOPT_COOKIEstringСодержимое заголовка "Cookie: ", используемого в HTTP-запросе. Обратите внимание, что несколько cookies разделяются точкой с запятой с последующим пробелом (например, "fruit=apple; colour=red")
CURLOPT_COOKIEFILEstringИмя файла, содержащего cookies. Данный файл должен быть в формате Netscape или просто заголовками HTTP, записанными в файл. Если в качестве имени файла передана пустая строка, то cookies сохраняться не будут, но их обработка всё ещё будет включена.
CURLOPT_COOKIEJARstringИмя файла, в котором будут сохранены все внутренние cookies текущей передачи после закрытия дескриптора, например, после вызова curl_close.
CURLOPT_COOKIELISTstringСтрока cookie (т.е. одна строка в формате Netscape/Mozilla или обычный заголовок Set-Cookie в стиле HTTP) добавляет этот единственный cookie во внутреннее хранилище cookie. "ALL" удаляет все файлы cookie, хранящиеся в памяти. "SESS" удаляет все файлы cookie сессии, хранящиеся в памяти. "FLUSH" записывает все известные файлы cookie в файл, указанный в CURLOPT_COOKIEJAR. "RELOAD" загружает все файлы cookie из файлов, указанных в CURLOPT_COOKIEFILE.7.14.1
CURLOPT_CUSTOMREQUESTstringСобственный метод запроса, используемый вместо "GET" или "HEAD" при выполнении HTTP-запроса. Это полезно при запросах "DELETE" или других, более редких HTTP-запросах. Корректными значениями будут такие как "GET", "POST", "CONNECT" и так далее; т.е. не вводите здесь всю строку с HTTP-запросом. Например, указание "GET /index.html HTTP/1.0\r\n\r\n" будет неправильным. Не используйте эту возможность пока не убедитесь, что сервер поддерживает данный тип запроса.
CURLOPT_DEFAULT_PROTOCOLstringПротокол по умолчанию, если он отсутствует в схеме URL.7.45.07.0.7
CURLOPT_DNS_INTERFACEstringУстанавливает имя сетевого интерфейса, к которому привязан DNS. Это должно быть имя интерфейса, а не адрес.7.33.07.0.7
CURLOPT_DNS_LOCAL_IP4stringУстановить локальный IPv4-адрес, по которому доступен DNS. Адрес должен быть представлен в виде строки, содержащий одно число.7.33.07.0.7
CURLOPT_DNS_LOCAL_IP6stringУстановить локальный IPv6-адрес, по которому доступне DNS. Адрес должен быть представлен в виде строки, содержащий одно число.7.33.07.0.7
CURLOPT_EGDSOCKETstringНаподобие CURLOPT_RANDOM_FILE, за исключением того, что имя файла устанавливается в сокет Entropy Gathering Daemon.
CURLOPT_ENCODINGstringСодержимое заголовка "Accept-Encoding: ". Это позволяет декодировать запрос. Поддерживаемыми кодировками являются "identity", "deflate" и "gzip". Если передана пустая строка, "", посылается заголовок, содержащий все поддерживаемые типы кодировок.7.10
CURLOPT_FTPPORTstringЗначение, которое будет использоваться для определения IP-адреса для команды "PORT" FTP-протокола. Команда "PORT" сообщает серверу, с каким IP-адресом он должен устанавливать соединение. Это может быть IP-адрес, имя хоста, имя сетевого интерфейса (под Unix) или просто "-" для использования системного IP-адреса по умолчанию.
CURLOPT_INTERFACEstringИмя используемого сетевого интерфейса. Может быть именем интерфейса, IP адресом или именем хоста.
CURLOPT_KEYPASSWDstringПароль, который требуется для использования закрытого ключа CURLOPT_SSLKEY или CURLOPT_SSH_PRIVATE_KEYFILE.7.16.1
CURLOPT_KRB4LEVELstringУровень безопасности KRB4 (Kerberos 4). Любое из следующих значений (в порядке от слабого к самому сильному) корректно: "clear", "safe", "confidential", "private". Если указанная строка отличается от данных значений, будет использовано значение "private". Установка этого параметра в null полностью отключит безопасность KRB4. На данный момент безопасность KRB4 работает только с FTP-транзакциями.
CURLOPT_LOGIN_OPTIONSstringИспользуется для установки специфичных для протокола настроек логина, таких как предпочитаемый механизм аутентификации "AUTH=NTLM" или "AUTH=*", и должна использоваться совместно с CURLOPT_USERNAME.7.34.07.0.7
CURLOPT_PINNEDPUBLICKEYstringУстанавливает зафиксированный открытый ключ. Строка должны содержать имя файла, в котором лежит ваш зафиксированный открытый ключ. Ожидается формат файла "PEM" или "DEX". Строка также может быть числом в формате base64, закодированным sha256 с префиксом "sha256//" и разделённая точкой с запятой ";".7.39.07.0.7
CURLOPT_POSTFIELDSstringВсе данные, передаваемые в HTTP POST-запросе. Этот параметр может быть передан как в качестве url-закодированной строки, наподобие para1=val1&para2=val2&..., так и в виде массива, ключами которого будут имена полей, а значениями - их содержимое. Если value является массивом, заголовок Content-Type будет установлен в значение multipart/form-data. Файлы можно отправлять с использованием CURLFile или CURLStringFile, в этом случае value должен быть массивом.
CURLOPT_PRIVATEstringЛюбые данные, которые должны связаны с этим дескриптором cURL. Эти данные могут быть выбраны подзапросом опции CURLINFO_PRIVATE функции curl_getinfo(). cURL ничего не делает с этими данными. Если используется множество дескрипторов cURL, эти данные обычно используются как уникальный ключ для определения дескриптора cURL.7.10.3
CURLOPT_PRE_PROXYstringЗадайте строку (string), содержащую имя хоста или IP-адрес, который будет использоваться в качестве прокси-сервера, к которому подключается curl, прежде чем он подключится к прокси-серверу HTTP(S), указанному в опции CURLOPT_PROXY для предстоящего запроса. Предварительный прокси-сервер может быть только SOCKS-прокси, и перед ним должен стоять префикс [scheme]://, чтобы указать, какой тип socks используется. Числовой адрес IPv6 должен быть написан в [скобках]. Установка препрокси в пустую строку явно отключает использование препрокси. Чтобы указать номер порта в этой строке, добавьте :[port] в конец имени хоста. Номер порта прокси-сервера может быть дополнительно указан с помощью отдельной опции CURLOPT_PROXYPORT. По умолчанию используется порт 1080 для прокси, если порт не указан.7.52.07.3.0
CURLOPT_PROXYstringHTTP-прокси, через который будут направляться запросы.
CURLOPT_PROXY_SERVICE_NAMEstringИмя сервиса аутентификации прокси.7.49.07.0.7
CURLOPT_PROXY_CAINFOstringПуть к прокси-серверу центра сертификации. Задайте путь в виде строки (string) с именем файла, содержащего один или несколько сертификатов для проверки прокси с помощью HTTPS. Этот параметр предназначен для подключения к прокси-серверу HTTPS, а не к серверу HTTPS. По умолчанию задан системный путь, где предполагается хранить пакет cacert libcurl.7.52.07.3.0
CURLOPT_PROXY_CAPATHstringКаталог, содержащий несколько сертификатов центра сертификации для проверки прокси HTTPS.7.52.07.3.0
CURLOPT_PROXY_CRLFILEstringЗадайте имя файла с помощью конкатенации CRL (списка отзыва сертификатов) в формате PEM для использования при проверке сертификата, которая происходит во время обмена SSL.7.52.07.3.0
CURLOPT_PROXY_KEYPASSWDstringУстановите строку, используемую в качестве пароля, необходимого для использования закрытого ключа CURLOPT_PROXY_SSLKEY. Вам не нужен пароль для загрузки сертификата, но вам нужен пароль для загрузки вашего закрытого ключа. Этот параметр предназначен для подключения к прокси-серверу HTTPS, а не к серверу HTTPS.7.52.07.3.0
CURLOPT_PROXY_PINNEDPUBLICKEYstringУстановите закреплённый открытый ключ для HTTPS-прокси. Строка может быть именем файла вашего закреплённого открытого ключа. Ожидаемый формат файла: "PEM" или "DER". Строка также может быть любым количеством закодированных в base64 хешей sha256, которым предшествует "sha256//" и разделяются ";"7.52.07.3.0
CURLOPT_PROXY_SSLCERTstringИмя файла вашего клиентского сертификата, используемого для подключения к прокси HTTPS. Формат по умолчанию - "P12" в Secure Transport и "PEM" в других движках; его можно изменить с помощью CURLOPT_PROXY_SSLCERTTYPE. С NSS или Secure Transport это также может быть псевдоним сертификата, с которым вы хотите пройти аутентификацию, так как он назван в базе данных безопасности. Если вы хотите использовать файл из текущего каталога, пожалуйста, добавьте к нему префикс "./", чтобы избежать путаницы с псевдонимом.7.52.07.3.0
CURLOPT_PROXY_SSLCERTTYPEstringФормат сертификата вашего клиента, используемый при подключении к HTTPS-прокси. Поддерживаемые форматы: "PEM" и "DER", за исключением Secure Transport. OpenSSL (версии 0.9.3 и новее) и Secure Transport (в iOS 5 или новее или OS X 10.7 или новее) также поддерживают "P12" для файлов в кодировке PKCS#12. По умолчанию "PEM".7.52.07.3.0
CURLOPT_PROXY_SSL_CIPHER_LISTstringСписок шифров, используемых для подключения к прокси HTTPS. Список должен быть синтаксически правильным, он состоит из одной или нескольких строк шифров, разделённых двоеточиями. Запятые или пробелы также являются допустимыми разделителями, но обычно качестве операторов используются двоеточия, !, - и +.7.52.07.3.0
CURLOPT_PROXY_TLS13_CIPHERSstringСписок наборов шифров, которые будут использоваться для подключения TLS 1.3 к прокси. Список должен быть синтаксически правильным, он состоит из одной или нескольких строк набора шифров, разделённых двоеточиями. Эта опция в настоящее время используется только тогда, когда curl собран для использования OpenSSL 1.1.1 или новее. Если вы используете другой бэкенд SSL, вы можете попытаться установить наборы шифров TLS 1.3, используя параметр CURLOPT_PROXY_SSL_CIPHER_LIST. Доступно при сборке с OpenSSL >= 1.1.1.7.61.07.3.0
CURLOPT_PROXY_SSLKEYstringИмя файла вашего личного ключа, используемого для подключения к прокси HTTPS. Формат по умолчанию - "PEM", и его можно изменить с помощью CURLOPT_PROXY_SSLKEYTYPE. (Только для iOS и Mac OS X). Этот параметр игнорируется, если curl был создан для Secure Transport. Доступно, если включён встроенный TLS.7.52.07.3.0
CURLOPT_PROXY_SSLKEYTYPEstringФормат вашего закрытого ключа. Поддерживаемые форматы: "PEM", "DER" и "ENG".7.52.07.3.0
CURLOPT_PROXY_TLSAUTH_PASSWORDstringПароль, используемый для метода аутентификации TLS, указанного в параметре CURLOPT_PROXY_TLSAUTH_TYPE. Требует, чтобы также был установлен параметр CURLOPT_PROXY_TLSAUTH_USERNAME.7.52.07.3.0
CURLOPT_PROXY_TLSAUTH_TYPEstringМетод аутентификации TLS, используемый для соединения HTTPS. Поддерживаемый метод - "SRP". Аутентификация Secure Remote Password (SRP) для TLS обеспечивает взаимную аутентификацию, если обе стороны имеют общий секрет. Чтобы использовать TLS-SRP, вы также должны установить параметры CURLOPT_PROXY_TLSAUTH_USERNAME и CURLOPT_PROXY_TLSAUTH_PASSWORD.7.52.07.3.0
CURLOPT_PROXY_TLSAUTH_USERNAMEstringИмя пользователя, которое будет использоваться для метода аутентификации TLS прокси-сервера HTTPS, указанного в параметре CURLOPT_PROXY_TLSAUTH_TYPE. Требует, чтобы параметр CURLOPT_PROXY_TLSAUTH_PASSWORD также был установлен.7.52.07.3.0
CURLOPT_PROXYUSERPWDstringЛогин и пароль, записанные в виде "[username]:[password]", используемые при соединении через прокси.
CURLOPT_RANDOM_FILEstringИмя файла, используемого для инициализации генератора случайных чисел для SSL.
CURLOPT_RANGEstringДиапазон данных, которые нужно загрузить, в формате "X-Y", причём либо X, либо Y могут быть опущены. Протокол HTTP также поддерживает передачу нескольких диапазонов, разделённых запятыми, они задаются в формате "X-Y,N-M".
CURLOPT_REFERERstringСодержимое заголовка "Referer: ", который будет использован в HTTP-запросе.
CURLOPT_SERVICE_NAMEstringИмя сервиса аутентификации.7.43.07.0.7
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5stringСтрока, содержащая 32 шестнадцатеричных цифры. Строка должна являться контрольной суммой по алгоритму MD5 открытого ключа удалённого компьютера и libcurl будет сбрасывать соединение к удалённому хосту до тех пор, пока контрольная сумма не будет соответствовать публичному ключу. Эта опция предназначена только для передачи данных с помощью SCP и SFTP.7.17.1
CURLOPT_SSH_PUBLIC_KEYFILEstringИмя файла для вашего публичного ключа. Если не задано, то libcurl использует по умолчанию файл $HOME/.ssh/id_dsa.pub, если переменная окружения HOME установлена и файл "id_dsa.pub" в текущей директории, если переменная HOME не установлена.7.16.1
CURLOPT_SSH_PRIVATE_KEYFILEstringИмя файла для вашего приватного ключа. Если не задано, то libcurl использует по умолчанию файл $HOME/.ssh/id_dsa, если переменная окружения HOME установлена и файл "id_dsa" в текущей директории, если переменная HOME не установлена. Если файл защищён паролем, установите пароль с помощью CURLOPT_KEYPASSWD.7.16.1
CURLOPT_SSL_CIPHER_LISTstringСписок шифров, используемый в SSL-передачах. Например, RC4-SHA и TLSv1 являются корректными списками шифров.
CURLOPT_SSLCERTstringИмя файла с корректно отформатированным PEM-сертификатом.
CURLOPT_SSLCERTPASSWDstringПароль, необходимый для использования сертификата CURLOPT_SSLCERT.
CURLOPT_SSLCERTTYPEstringФормат сертификата. Поддерживаются форматы "PEM" (по умолчанию), "DER" и "ENG". Начиная с OpenSSL 0.9.3, "P12" (для файлов, закодированных в PKCS#12).7.9.3
CURLOPT_SSLENGINEstringИдентификатор механизма шифрования для закрытого ключа SSL, указанного в параметре CURLOPT_SSLKEY.
CURLOPT_SSLENGINE_DEFAULTstringИдентификатор механизма шифрования, используемого для ассиметричных операций шифрования.
CURLOPT_SSLKEYstringИмя файла с закрытым ключом SSL.
CURLOPT_SSLKEYPASSWDstringТайный пароль, необходимый для использования закрытого ключа SSL, указанного параметром CURLOPT_SSLKEY. Так как этот параметр содержит ценный пароль, помните, что данный PHP-скрипт нужно хранить в безопасном месте.
CURLOPT_SSLKEYTYPEstringТип закрытого ключа SSL, указанного в параметре CURLOPT_SSLKEY. Поддерживаются следующие типы ключей: "PEM" (по умолчанию), "DER" и "ENG".
CURLOPT_TLS13_CIPHERSstringСписок комплектов шифров для использования в соединении TLS 1.3. Список должен быть синтаксически правильным, он состоит из одной или нескольких строк набора шифров, разделённых двоеточиями. Эта опция в настоящее время используется только тогда, когда curl собран для использования OpenSSL 1.1.1 или новее. Если вы используете другой бэкенд SSL, вы можете попробовать установить наборы шифров TLS 1.3, используя параметр CURLOPT_SSL_CIPHER_LIST. OpenSSL >= 1.1.1.7.61.07.3.0
CURLOPT_UNIX_SOCKET_PATHstringРазрешает использовать доменные сокеты UNIX в качестве конечной точки для соединения и устанавливает путь к ним равным заданной строке (string).7.40.07.0.7
CURLOPT_URLstringЗагружаемый URL. Данный параметр может быть также установлен при инициализации сеанса с помощью curl_init().
CURLOPT_USERAGENTstringСодержимое заголовка "User-Agent: ", посылаемого в HTTP-запросе.
CURLOPT_USERNAMEstringИмя пользователя для аутентификации.7.19.1
CURLOPT_PASSWORDstringПароль для аутентификации.7.19.1
CURLOPT_USERPWDstringЛогин и пароль, используемые при соединении, указанные в формате "[username]:[password]".
CURLOPT_XOAUTH2_BEARERstringЗадаёт токен доступа OAuth 2.0.7.33.07.0.7
CURLOPT_CONNECT_TOarrayСоединяться с указанный хостом по указанному порту, игнорируя URL. Принимает массив строк формата HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT.7.49.07.0.7
CURLOPT_HTTP200ALIASESarrayМассив HTTP 200 ответов, которые будут трактоваться корректными ответами, а не ошибочными.7.10.3
CURLOPT_HTTPHEADERarrayМассив устанавливаемых HTTP-заголовков, в формате array("Content-type: text/plain", "Content-length: 100")
CURLOPT_POSTQUOTEarrayМассив FTP-команд, выполняемых на сервере, после выполнения FTP-запроса.
CURLOPT_PROXYHEADERarrayМассив пользовательских HTTP-заголовков для отправки на прокси7.37.07.0.7
CURLOPT_QUOTEarrayМассив FTP-команд, выполняемых на сервере, перед выполнением FTP-запроса.
CURLOPT_RESOLVEarrayПредоставляет адрес для определённой пары хоста и порта. Массив, содержащий строки состоящие из имени хоста, порта и IP-адреса, разделённых двоеточием. Пример: array("example.com:80:127.0.0.1")7.21.3
CURLOPT_FILEresourceФайл, в который будет записан результат передачи. По умолчанию используется поток вывода STDOUT (окно браузера).
CURLOPT_INFILEresourceФайл, из которого должно идти чтение данных, при загрузке на сервер.
CURLOPT_STDERRresourceАльтернативный файл для вывода ошибок, используемый вместо потока ошибок STDERR.
CURLOPT_WRITEHEADERresourceФайл, в который будут записаны заголовки текущей операции.
CURLOPT_HEADERFUNCTIONfunctionCallback-функция принимает два параметра. Первым параметром является дескриптор cURL, вторым параметром является строка с записываемыми заголовками. Заголовки должны быть записаны с помощью данной callback-функции. Должна возвратить количество записанных байт.
CURLOPT_PASSWDFUNCTIONfunctionCallback-функция принимает три параметра. Первым параметром является дескриптор cURL, вторым параметром является строка с запросом пароля, третьим параметром является максимальная длина пароля. Должна возвратить строку, содержащую пароль. <b>Удалено, начиная с PHP 7.3.0.</b>
CURLOPT_PROGRESSFUNCTIONfunctionCallback-функция принимает пять параметров. Первый является декскриптором cURL, второй - общим количеством байт, которое ожидается загрузить с сервера, третий - количество уже загруженных байт, четвёртый - общее количество байт, которое ожидается отправить на сервер, и пятый - количество уже отправленных байт. Callback-функция вызывается только, если опция CURLOPT_NOPROGRESS установлена в значение false. Можно вернуть ненулевое значение, чтобы отменить передачу. В этом случае будет выдана ошибка CURLE_ABORTED_BY_CALLBACK.
CURLOPT_READFUNCTIONfunctionCallback-функция принимает три параметра. Первым параметром является дескриптор cURL, вторым параметром является ресурс потока, переданный cURL через опцию CURLOPT_INFILE, а третьим параметром является максимально разрешённое количество данных для чтения. Callback-функция должна возвратить строку с длиной, не превышающей запрошенного количества данных, обычно с помощью чтения из переданного потокового ресурса. Должна возвратить пустую строку для сигнала о конце файла EOF.
CURLOPT_WRITEFUNCTIONfunctionCallback-функция принимает два параметра. Первым параметром является дескриптор cURL, а вторым параметром является строка с записываемыми данными. Данные должны быть сохранены с помощью данной функции. Она должна возвратить точное количество записанных байт, иначе закачка будет прервана с ошибкой.
CURLOPT_XFERINFOFUNCTIONfunctionCallback-функция, принимающая два параметра. Имеет схожее назначение с константой CURLOPT_PROGRESSFUNCTION, но является более современным и предпочтительным вариантом от cURL.7.32.08.2.0
CURLOPT_SHAREshareРезультат выполнения функции curl_share_init(). Позволяет обработчику cURL использовать данные из общего обработчика.