curl_setopt
(PHP 4 >= 4.0.2, PHP 5, PHP 7)
curl_setopt — Устанавливает параметр для сеанса CURL
Описание
Устанавливает параметр для указанного сеанса cURL.
Список параметров
-
handle -
Дескриптор cURL, полученный из curl_init().
-
option -
Устанавливаемый параметр
CURLOPT_XXX. -
value -
Значение параметра
option.Для следующих значений параметра
option, параметрvalueдолжен быть типа bool:Параметр Устанавливаемое значение valueЗамечания CURLOPT_AUTOREFERERtrueдля автоматической установки поляReferer:в запросах, перенаправленных заголовкомLocation:.CURLOPT_BINARYTRANSFERtrueдля возврата необработанного ответа при использовании константыCURLOPT_RETURNTRANSFER.С PHP 5.1.3 эта опция больше не требуется: необработанный вывод всегда возвращается при использовании опции CURLOPT_RETURNTRANSFER.CURLOPT_COOKIESESSIONtrueдля указания текущему сеансу начать новую "сессию" cookies. Это заставит libcurl проигнорировать все "сессионные" cookies, которые она должна была бы загрузить, полученные из предыдущей сессии. По умолчанию libcurl всегда сохраняет и загружает все cookies, вне зависимости от того, являются ли они "сессионными" или нет. "Сессионные" cookies - это cookies без срока истечения, которые должны существовать только для текущей "сессии".CURLOPT_CERTINFOtrueдля вывода информации о сертификате SSL в потокSTDERRпри безопасных соединениях.Добавлена в cURL 7.19.1. Доступна, начиная с версии PHP 5.3.2. Для корректной работы требует включенной опции CURLOPT_VERBOSE.CURLOPT_CONNECT_ONLYtrueсообщает библиотеке, чтобы она провела необходимые аутентификацию прокси и настройку соединения, но не передавала данные. Эта опция реализована для HTTP, SMTP и POP3.Добавлена в 7.15.2. Доступна с PHP 5.5.0. CURLOPT_CRLFtrueдля преобразования концов строк Unix в CRLF.CURLOPT_DISALLOW_USERNAME_IN_URLtrueдля запрета URL-адресов, содержащих имя пользователя. Имена пользователей по умолчанию разрешены (0).Добавлено в cURL 7.61.0. Доступно с PHP 7.3.0. CURLOPT_DNS_SHUFFLE_ADDRESSEStrueдля перетасовки порядка всех возвращенных адресов, чтобы они использовались в случайном порядке, когда имя разрешено и возвращается более одного IP-адреса.trueto shuffle the order of all returned addresses so that they will be used in a random order, when a name is resolved and more than one IP address is returned. Это может привести к тому, что IPv4 будет использоваться до IPv6 или наоборот.Добавлено в cURL 7.60.0. Доступно с PHP 7.3.0. CURLOPT_HAPROXYPROTOCOLtrueдля отправки заголовка протокола HAProxy PROXY v1 в начале соединения. Действие по умолчанию - не отправлять заголовок.Добавлено в cURL 7.60.0. Доступно с PHP 7.3.0. CURLOPT_SSH_COMPRESSIONtrueдля включения встроенного сжатия SSH. Это запрос, а указание; сервер может это и не выполнить.Добавлено в cURL 7.56.0. Доступно с PHP 7.3.0. CURLOPT_DNS_USE_GLOBAL_CACHEtrueдля использования глобального кеша DNS. Этот параметр не является потокобезопасным. Он по умолчанию включен если PHP собран для потоконебезопасного использования (CLI, FCGI, Apache2-Prefork, и т.д.).CURLOPT_FAILONERRORtrueдля подробного отчета при неудаче, если полученный HTTP-код больше или равен 400. Поведение по умолчанию возвращает страницу как обычно, игнорируя код.CURLOPT_SSL_FALSESTARTtrueдля разрешения ложного старта TLS.Добавлено cURL 7.42.0. Доступно с PHP 7.0.7. CURLOPT_FILETIMEtrueдля попытки получения даты модификации удаленного документа. Это значение может быть получено с помощью параметраCURLINFO_FILETIMEиз функции curl_getinfo().CURLOPT_FOLLOWLOCATIONtrueдля следования любому заголовку"Location: ", отправленному сервером в своем ответе (учтите, что это происходит рекурсивно, PHP будет следовать за всеми посылаемыми заголовками"Location: ", за исключением случая, когда установлена константаCURLOPT_MAXREDIRS).CURLOPT_FORBID_REUSEtrueдля принудительного закрытия соединения после завершения его обработки так, чтобы его нельзя было использовать повторно.CURLOPT_FRESH_CONNECTtrueдля принудительного использования нового соединения вместо закешированного.CURLOPT_FTP_USE_EPRTtrueдля использования EPRT (и LPRT) при активных FTP-загрузках. Используйтеfalseдля того, чтобы отключить EPRT и LPRT и использовать только PORT.CURLOPT_FTP_USE_EPSVtrueдля первоначальной пробы команды EPSV при FTP-передачах. Если команда не удалась, будет произведен обратный откат к PASV. Установите вfalseдля отключения EPSV.CURLOPT_FTP_CREATE_MISSING_DIRStrueдля создания отсутствующих директорий, если FTP-операция обнаруживает несуществующий путь.CURLOPT_FTPAPPENDtrueдля записи в конец удаленного файла, вместо перезаписывания.CURLOPT_TCP_NODELAYtrueдля отключения алгоритма Нейгла, который пытается уменьшить количество мелких пакетов в сети.Доступна с версии PHP 5.2.1 для версий собранных с libcurl 7.11.2 или новее. CURLOPT_FTPASCIIПсевдоним CURLOPT_TRANSFERTEXT. Используйте его вместо этого.CURLOPT_FTPLISTONLYtrueдля возврата только списка имен из FTP-директории.CURLOPT_HEADERtrueдля включения заголовков в вывод.CURLINFO_HEADER_OUTtrueдля отслеживания строки запроса дескриптора.Доступен, начиная с версии PHP 5.1.3. Префикс CURLINFO_используется специально.CURLOPT_HTTP09_ALLOWEDОпределяет разрешить ли ответы HTTP/0.9. По умолчанию falsec версии libcurl 7.66.0; ранее по умолчанию былоtrue.Available since PHP 7.3.15 and 7.4.3, respectively, if built against libcurl >= 7.64.0 CURLOPT_HTTPGETtrueдля сброса метода HTTP-запроса на метод GET. Так как GET используется по умолчанию, этот параметр необходим только в случае, если метод запроса был ранее изменен.CURLOPT_HTTPPROXYTUNNELtrueдля туннелирования через указанный HTTP-прокси.CURLOPT_HTTP_CONTENT_DECODINGfalseдля получения необработанного тела HTTP-ответа.Доступно с PHP 5.5.0, если собран с libcurl >= 7.16.2. CURLOPT_KEEP_SENDING_ON_ERRORtrueдля продолжения посылать тело запроса, если возвращаемый HTTP-код равен или больше 300. Действие по умолчанию - остановить отправку и закрыть поток или соединение. Подходит для ручной аутентификации NTLM. Большинству приложений эта опция не нужна.Доступно с PHP 7.3.0, если собран с libcurl >= 7.51.0. CURLOPT_MUTEtrueдля полного отключения сообщений функций cURL.Удалена в cURL 7.15.5 (Можно использовать опцию CURLOPT_RETURNTRANSFER) CURLOPT_NETRCtrueдля считывания файла ~/.netrc, чтобы найти логин и пароль для удаленного сайта, с которым устанавливается соединение.CURLOPT_NOBODYtrueдля исключения тела ответа из вывода. Метод запроса устанавливается в HEAD. Смена этого параметра вfalseне меняет его обратно в GET.CURLOPT_NOPROGRESStrueдля отмены индикатора прогресса при передачах cURL.Замечание:
PHP автоматически устанавливает этот параметр в
true, меняйте его только для отладочных целей.CURLOPT_NOSIGNALtrueдля игнорирования любой функции cURL, посылающей сигналы PHP процессу. Этот параметр включен по умолчанию в многопоточных SAPI для корректной работы параметров тайм-аута.Добавлен в cURL 7.10. CURLOPT_PATH_AS_IStrueдля игнорирования последовательностей с двумя точками.Добавлено в cURL 7.42.0. Доступно с PHP 7.0.7. CURLOPT_PIPEWAITtrueдля ожидания конвеера/мультиплексирования.Добавлено в cURL 7.43.0. Доступно с PHP 7.0.7. CURLOPT_POSTtrueдля использования обычного HTTP POST. Данный метод POST использует обычныйapplication/x-www-form-urlencoded, обычно используемый в HTML-формах.CURLOPT_PUTtrueдля загрузки файла методом HTTP PUT. Используемый файл должен быть установлен с помощью параметровCURLOPT_INFILEиCURLOPT_INFILESIZE.CURLOPT_RETURNTRANSFERtrueдля возврата результата передачи в качестве строки из curl_exec() вместо прямого вывода в браузер.CURLOPT_SASL_IRtrueдля разрешения отправки инициирующего ответа в первом пакете.Добавлено в cURL 7.31.10. Доступно с PHP 7.0.7. CURLOPT_SSL_ENABLE_ALPNfalseдля отключения ALPN в SSL handshake (если на бекенде SSL libcurl собран с ее поддержкой), это можно использовать при соединении http2.Добавлено в cURL 7.36.0. Доступно с PHP 7.0.7. CURLOPT_SSL_ENABLE_NPNfalseдля отключения ALPN в SSL handshake (если на бэкенде SSL libcurl собран с ее поддержкой), это можно использовать при соединении http2.Добавлено в cURL 7.36.0. Доступно с PHP 7.0.7. CURLOPT_SSL_VERIFYPEERfalseдля остановки cURL от проверки сертификата узла сети. Альтернативные сертификаты дл проверки могут быть указаны с помощью параметраCURLOPT_CAINFO, или директории с сертификатами, указываемой параметромCURLOPT_CAPATH.По умолчанию равно true, начиная с версии cURL 7.10. Дистрибутив по умолчанию устанавливается с версией cURL 7.10.CURLOPT_SSL_VERIFYSTATUStrueдля проверки статуса сертификата.Добавлено в cURL 7.41.0. Доступно с PHP 7.0.7. CURLOPT_PROXY_SSL_VERIFYPEERfalseдля остановки cURL от проверки сертификата пира. Альтернативные сертификаты для проверки могут быть указаны с помощью параметраCURLOPT_CAINFO, а каталог сертификатов может быть указан с помощью параметраCURLOPT_CAPATH. Если установлено значение false, проверка сертификата однорангового узла завершается успешно несмотря ни на что.trueпо умолчанию. Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0.CURLOPT_SUPPRESS_CONNECT_HEADERStrueдля подавления заголовков ответов прокси-сервера CONNECT из пользовательских callback-функциCURLOPT_HEADERFUNCTIONиCURLOPT_WRITEFUNCTION, когда используетсяCURLOPT_HTTPPROXYTUNNELи выполняется запрос CONNECT.Добавлено в cURL 7.54.0. Доступно с PHP 7.3.0. CURLOPT_TCP_FASTOPENtrueдля разрешения TCP Fast Open.Добавлено в cURL 7.49.0. Доступно с PHP 7.0.7. CURLOPT_TFTP_NO_OPTIONStrueдля запрета посылки запроса TFTP опций.Добавлено в cURL 7.48.0. Доступно с PHP 7.0.7. CURLOPT_TRANSFERTEXTtrueдля использования ASCII-режима при FTP-передачах. При использовании LDAP данные возвращаются простым текстом вместо HTML. В Windows системах потокSTDOUTне устанавливается в бинарный режим.CURLOPT_UNRESTRICTED_AUTHtrueдля продолжения отправки логина и пароля при редиректах (используяCURLOPT_FOLLOWLOCATION), даже при изменении имени хоста.CURLOPT_UPLOADtrueдля подготовки к загрузке файла на сервер.CURLOPT_VERBOSEtrueдля вывода дополнительной информации. Записывает вывод в потокSTDERR, или файл, указанный параметромCURLOPT_STDERR.Для следующих значений параметра
option, параметрvalueдолжен быть типа int:Параметр Устанавливаемое значение valueЗамечания CURLOPT_BUFFERSIZEРазмер буфера, используемого при каждом чтении. Однако, нет никакой гарантии что данный запрос будет завершен. Добавлен в версии cURL 7.10. CURLOPT_CLOSEPOLICYОдна из констант CURLCLOSEPOLICY_*.Замечание:
Эта опция устарела, так как никогда не была реализована в cURL и не работала.
Удалена в PHP 5.6.0. CURLOPT_CONNECTTIMEOUTКоличество секунд ожидания при попытке соединения. Используйте 0 для бесконечного ожидания. CURLOPT_CONNECTTIMEOUT_MSКоличество миллисекунд ожидания при попытке соединения. Используйте 0 для бесконечного ожидания. Если библиотека libcurl скомпилирована с использованием стандартного системного преобразователя имен, то соединение будет по-прежнему использовать полносекундное ожидание в качестве тайм-аута с минимально допустимым тайм-аутом в 1 секунду. Добавлен в версии cURL 7.16.2. Доступно, начиная с PHP 5.2.3. CURLOPT_DNS_CACHE_TIMEOUTКоличество секунд, в течение которых в памяти хранятся DNS-записи. По умолчанию этот параметр равен 120 (2 минуты). CURLOPT_EXPECT_100_TIMEOUT_MSТаймаут для ответов с заголовком Expect: 100-continue в миллисекундах. По умолчанию - 1000 миллисекунд. Добавлено в cURL 7.36.0. Доступно с PHP 7.0.7. CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MSНачало для ipv6 для алгоритма счастливые eyeballs. Счастливые eyeballs пытаются подключиться как к адресам IPv4, так и к адресам IPv6 для хостов с двумя стеками, предпочитая сначала IPv6 на время ожидания в миллисекундах. По умолчанию используется CURL_HET_DEFAULT, который в настоящее время составляет 200 миллисекунд. Добавлено в cURL 7.59.0. Доступно с PHP 7.3.0. CURLOPT_FTPSSLAUTHМетод FTP-аутентификации (в активном режиме): CURLFTPAUTH_SSL(сначала проверяется SSL),CURLFTPAUTH_TLS(сначала проверяется TLS) илиCURLFTPAUTH_DEFAULT(cURL решает сама).Добавлен в cURL 7.12.2. CURLOPT_HEADEROPTЧто делать с заголовками. Одна из следующих опций: 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до него.Добавлено в cURL 7.37.0. Доступно с PHP 7.0.7. CURLOPT_HTTP_VERSIONCURL_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, доступно с PHP 5.5),CURL_HTTP_VERSION_2(принудительное использование HTTP/2.0, доступно с PHP 7.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, доступно с PHP 7.0).CURLOPT_HTTPAUTHИспользуемые 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_INFILESIZEОжидаемый размер файла в байтах при загрузке файла на удаленный сервер. Учтите, что использование этой опции не остановит дальнейшую посылку данных, превышающих это значение, так как посылаемые данные зависят от результата CURLOPT_READFUNCTION.CURLOPT_LOW_SPEED_LIMITВерхний порог скорости передачи данных, в байтах в секунду. Проверка происходит в течение CURLOPT_LOW_SPEED_TIMEсекунд, после чего PHP считает передачу слишком медленной и прерывает ее.CURLOPT_LOW_SPEED_TIMEМаксимальное количество секунд, в течение которых скорость передачи не должна превышать CURLOPT_LOW_SPEED_LIMIT, иначе PHP пометит передачу как слишком медленную и прекратит ее.CURLOPT_MAXCONNECTSМаксимальное количество постоянных соединений. При достижении лимита для определения закрываемого соединения используется параметр CURLOPT_CLOSEPOLICY.CURLOPT_MAXREDIRSМаксимальное количество принимаемых редиректов. Используйте этот параметр вместе с параметром CURLOPT_FOLLOWLOCATION.CURLOPT_PORTАльтернативный порт соединения. CURLOPT_POSTREDIRБитовая маска, содержащая 1 (301 Moved Permanently), 2 (302 Found) и 4 (303 See Other), чтобы задавать должен ли метод HTTP POST обрабатываться при включенной опции CURLOPT_FOLLOWLOCATION, если произошел указанный тип перенаправления.Добавлено в cURL 7.19.1. Доступно с PHP 5.3.2. CURLOPT_PROTOCOLSБитовая маска из значений
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_ALLДобавлен в cURL 7.19.4. CURLOPT_PROXYAUTHМетоды авторизации HTTP, используемые при соединении с прокси-сервером. Используйте те же самые битовые маски, которые были описаны у параметра CURLOPT_HTTPAUTH. В данный момент для авторизации прокси поддерживаются толькоCURLAUTH_BASICиCURLAUTH_NTLM.Добавлен в версии cURL 7.10.7. CURLOPT_PROXYPORTНомер порта прокси-сервера, к которому осуществляется соединение. Этот номер также может быть установлен с помощью параметра CURLOPT_PROXY.CURLOPT_PROXYTYPEЛибо CURLPROXY_HTTP(по умолчанию), либоCURLPROXY_SOCKS4,CURLPROXY_SOCKS5,CURLPROXY_SOCKS4AилиCURLPROXY_SOCKS5_HOSTNAME.Добавлен в версии cURL 7.10. CURLOPT_REDIR_PROTOCOLSБитовая маска из значений CURLPROTO_*. Данная битовая масска ограничивает протоколы, используемые libcurl при редиректе (при включенном параметреCURLOPT_FOLLOWLOCATION). Это позволяет ограничить набор используемых протоколов при редиректах для некоторых передач. По умолчанию, libcurl поддерживает все протоколы, кроме FILE и SCP. В версиях, предшествовавших 7.19.4, перенаправление использовалось для всех протоколов без исключения. Смотрите также описание параметраCURLOPT_PROTOCOLSдля списка констант со значениями протоколов.Добавлен в версии cURL 7.19.4. CURLOPT_RESUME_FROMСмещение в байтах для возобновления передачи. CURLOPT_SOCKS5_AUTHМетод аутентификации SOCKS5, который нужно использовать. Варианты:
CURLAUTH_BASIC,CURLAUTH_GSSAPI,CURLAUTH_NONE.Побитовый оператор
|(или) можно использовать для объединения нескольких методов. Если это будет сделано, cURL будет опрашивать сервер, чтобы выяснить, какие методы он поддерживает, и выбрать налучший.CURLAUTH_BASICразрешает аутентификацию по constant пользователя/пароля.CURLAUTH_GSSAPIразрешает аутентификацию GSS-API.CURLAUTH_NONEне разрешает аутентификацию.По умолчанию
CURLAUTH_BASIC|CURLAUTH_GSSAPI. Установите действительное имя пользователя и пароль с помощью параметраCURLOPT_PROXYUSERPWD.Доступно с 7.3.0 и curl >= 7.55.0. CURLOPT_SSL_OPTIONSУстанавливает опции поведения SSL. Битовая маска из следующих констант: CURLSSLOPT_ALLOW_BEAST: не пытаться найти обходной путь для изъяна в безопасности протоколов SSL3 и TLS1.0.CURLSSLOPT_NO_REVOKE: не производить проверку, отозван ли сертификат, для тех SSL бэкендов, где оно есть.Добавлено в cURL 7.25.0. Доступно с PHP 7.0.7. CURLOPT_SSL_VERIFYHOSTИспользуйте 1для проверки существования общего имени в сертификате SSL. Используйте2для проверки существования общего имени и также его совпадения с указанным хостом.0чтобы не проверять имена. В боевом окружении значение этого параметра должно быть2(установлено по умолчанию).Поддержка значения 1убрана в cURL 7.28.1CURLOPT_SSLVERSIONОдна из констант 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). Максимальная версия 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, orCURL_SSLVERSION_MAX_TLSv1_3.Замечание:
Рекомендуется не устанавливать эту опцию и оставить значение по умолчанию. Установка в 2 или 3 опасно и допускает применение известных уязвимостей в SSLv2 и SSLv3.
CURLOPT_PROXY_SSL_OPTIONSЗадайте параметры поведения SSL прокси, которые являются битовой маской любой из следующих констант: CURLSSLOPT_ALLOW_BEAST: не пытайтесь использовать обходные пути для устранения уязвимости в протоколах SSL3 и TLS1.0.CURLSSLOPT_NO_REVOKE: отключите проверки отзыва сертификатов для тех бекэндов SSL, где такое поведение присутствует. (curl >= 7.44.0)CURLSSLOPT_NO_PARTIALCHAIN: не принимайте "частичные" цепочки сертификатов, что в противном случае делается по умолчанию. (curl >= 7.68.0)Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSL_VERIFYHOSTУстановите значение 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(значение по умолчанию).Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0. CURLOPT_PROXY_SSLVERSIONОдна из 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.Доступно с PHP 7.3.0 и libcurl >= cURL 7.52.0. CURLOPT_STREAM_WEIGHTУстановить вес цифрового потока (число между 1 и 256). Добавлено в cURL 7.46.0. Доступно с PHP 7.0.7. CURLOPT_TCP_KEEPALIVEЕсли установлено значение 1, будут отправлены пробные сообщения поддержки активности TCP. Задержку и частоту этих проб можно контролировать с помощью параметровCURLOPT_TCP_KEEPIDLEиCURLOPT_TCP_KEEPINTVL, если операционная система их поддерживает. Если установлено значение0(по умолчанию), пробные сообщения проверки активности отключены.Добавлено в cURL 7.25.0. Доступно с PHP 5.5.0. CURLOPT_TCP_KEEPIDLEУстанавливает задержку в секундах, в течение которой операционная система будет ждать, пока соединение находится в режиме ожидания, перед отправкой проб проверки активности, если включено CURLOPT_TCP_KEEPALIVE. Не все операционные системы поддерживают эту опцию. По умолчанию установлено значение60.Добавлено в cURL 7.25.0. Доступно с PHP 5.5.0. CURLOPT_TCP_KEEPINTVLУстанавливает интервал в секундах, в течение которого операционная система будет ожидать между отправкой проб проверки активности, если включено CURLOPT_TCP_KEEPALIVE. Не все операционные системы поддерживают эту опцию. По умолчанию установлено значение60.Добавлено в cURL 7.25.0. Доступно с PHP 5.5.0. CURLOPT_TIMECONDITIONСпособ трактовки параметра CURLOPT_TIMEVALUE. ИспользуйтеCURL_TIMECOND_IFMODSINCEдля возвращения страницы, только если она была изменена со времени, указанного в параметреCURLOPT_TIMEVALUE. Если страница не была изменена, вернется заголовок"304 Not Modified", подразумевая, что параметрCURLOPT_HEADERустановлен вtrue. ИспользуйтеCURL_TIMECOND_IFUNMODSINCEдля обратного эффекта. По умолчанию используетсяCURL_TIMECOND_IFMODSINCE.CURLOPT_TIMEOUTМаксимально позволенное количество секунд для выполнения cURL-функций. CURLOPT_TIMEOUT_MSМаксимально позволенное количество миллисекунд для выполнения cURL-функций. Если libcurl собрана с использованием обычного системного распознавателя имен, то этот промежуток соединения все еще будет использовать секундное округление тайм-аутов, с минимально разрешенным тайм-аутом в одну секунду. Добавлен в версии cURL 7.16.2. Доступен, начиная с PHP 5.2.3. CURLOPT_TIMEVALUEКоличество секунд, начиная с 1 января 1970 года. Это время будет использовано параметром CURLOPT_TIMECONDITION. По умолчанию, используется параметрCURL_TIMECOND_IFMODSINCE.CURLOPT_TIMEVALUE_LARGEВремя в секундах с 1 января 1970 года. Время будет использовано CURLOPT_TIMECONDITION. По умолчанию ноль. Разница между этой опцией иCURLOPT_TIMEVALUEзаключается в типе аргумента. В системах, где 'long' имеет размер всего 32 бита, этот параметр необходимо использовать для установки дат после 2038 года.Добавлено в cURL 7.59.0. Доступно с PHP 7.3.0. CURLOPT_MAX_RECV_SPEED_LARGEЕсли скорость скачки превысит это значение (указанное в байтах в секунду) в среднем в течение всей передачи, то скачка будет приостановлена для поддержания средней скорости меньше либо равной данному параметру. По умолчанию скорость не ограничивается. Добавлен в версии cURL 7.15.5. Доступен, начиная с PHP 5.4.0. CURLOPT_MAX_SEND_SPEED_LARGEЕсли загрузка на сервер превысит это значение (указанное в байтах в секунду) в среднем в течение всей передачи, то загрузка будет приостановлена для поддержания средней скорости меньше либо равной данному параметру. По умолчанию скорость не ограничивается. Добавлен в версии cURL 7.15.5. Доступен, начиная с PHP 5.4.0. CURLOPT_SSH_AUTH_TYPESБитовая маска, состоящая из одной или более констант: CURLSSH_AUTH_PUBLICKEY,CURLSSH_AUTH_PASSWORD,CURLSSH_AUTH_HOST,CURLSSH_AUTH_KEYBOARD. УстановитеCURLSSH_AUTH_ANY, чтобы libcurl сам выбрал одну из них.Добавлено в cURL 7.16.1. CURLOPT_IPRESOLVEПозволяет приложению выбрать вид IP-адреса, с которым определяется имя хоста. Это необходимо, если используется имя хоста, которое получается с использованием более одной версии IP адреса. Возможными значениями могут быть CURL_IPRESOLVE_WHATEVER,CURL_IPRESOLVE_V4,CURL_IPRESOLVE_V6, и по умолчаниюCURL_IPRESOLVE_WHATEVER.Добавлено в cURL 7.10.8. CURLOPT_FTP_FILEMETHODКакой метод использовать, чтобы достать файл на сервере FTP. Варианты: CURLFTPMETHOD_MULTICWD,CURLFTPMETHOD_NOCWDиCURLFTPMETHOD_SINGLECWD.Добавлено в cURL 7.15.1. Доступно с PHP 5.3.0. Для следующих значений параметра
option, параметрvalueдолжен быть типа string:Параметр Устанавливаемое значение valueЗамечания 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¶2=val2&...', так и в виде массива, ключами которого будут имена полей, а значениями - их содержимое. Еслиvalueявляется массивом, заголовокContent-Typeбудет установлен в значениеmultipart/form-data. Файлы можно отправлять с использованием CURLFile, в этом случаеvalueдолжен быть массивом.CURLOPT_PRIVATEЛюбые данные, которые должны связаны с этим дескриптором cURL. Эти данные могут быть выбраны подзапросом опции CURLINFO_PRIVATEфункции curl_getinfo(). cURL ничего не делает с этими данными. Если используется множество дескрипторов cURL, эти данные обычно используются как уникальный ключ для определения дескриптора cURL.Добавлено в 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_PROXYHTTP-прокси, через который будут направляться запросы. 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. Данный параметр может быть также установлен при инициализации сеанса с помощью curl_init(). 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. Для следующих значений параметра
option, параметрvalueдолжен быть массивом:Параметр Устанавливаемое значение valueЗамечания CURLOPT_CONNECT_TOСоединяться с указанный хостом по указанному порту, игнорируя URL. Принимает массив строк формата HOST:PORT:CONNECT-TO-HOST:CONNECT-TO-PORT.Добавлено в cURL 7.49.0. Доступно с PHP 7.0.7. CURLOPT_HTTP200ALIASESМассив HTTP 200 ответов, которые будут трактоваться корректными ответами, а не ошибочными. Добавлен в cURL 7.10.3. CURLOPT_HTTPHEADERМассив устанавливаемых HTTP-заголовков, в формате array('Content-type: text/plain', 'Content-length: 100')CURLOPT_POSTQUOTEМассив FTP-команд, выполняемых на сервере, после выполнения FTP-запроса. CURLOPT_PROXYHEADERМассив пользовательских HTTP-заголовков для отправки на прокси Добавлено в cURL 7.37.0. Доступно с PHP 7.0.7. CURLOPT_QUOTEМассив FTP-команд, выполняемых на сервере, перед выполнением FTP-запроса. CURLOPT_RESOLVEПредоставляет адрес для определенной пары хоста и порта. Массив, содержащий строки состоящие из имени хоста, порта и IP-адреса, разделенных двоеточием. Пример: array("example.com:80:127.0.0.1")Добавлено в cURL 7.21.3. Доступно с PHP 5.5.0. Для следующих значений параметра
option, параметрvalueдолжен быть потоковым дескриптором (возвращаемым, например, функцией fopen()):Параметр Устанавливаемое значение valueCURLOPT_FILEФайл, в который будет записан результат передачи. По умолчанию используется поток вывода STDOUT(окно браузера).CURLOPT_INFILEФайл, из которого должно идти чтение данных, при загрузке на сервер. CURLOPT_STDERRАльтернативный файл для вывода ошибок, используемый вместо потока ошибок STDERR.CURLOPT_WRITEHEADERФайл, в который будут записаны заголовки текущей операции. Для следующих значений параметра
option, параметрvalueдолжен быть правильным именем функции или замыканием:Параметр Устанавливаемое значение valueCURLOPT_HEADERFUNCTIONCallback-функция принимает два параметра. Первым параметром является дескриптор cURL, вторым параметром является строка с записываемыми заголовками. Заголовки должны быть записаны с помощью данной callback-функции. Должна возвратить количество записанных байт. CURLOPT_PASSWDFUNCTIONCallback-функция принимает три параметра. Первым параметром является дескриптор cURL, вторым параметром является строка с запросом пароля, третьим параметром является максимальная длина пароля. Должна возвратить строку, содержащую пароль. CURLOPT_PROGRESSFUNCTIONCallback-функция принимает пять параметров. Первый является декскриптором cURL, второй - общим количеством байт, которое ожидается загрузить с сервера, третий - количество уже загруженных байт, четвертый - общее количество байт, которое ожидается отправить на сервер, и пятый - количество уже отправленных байт.
Замечание:
Callback-функция вызывается только, если опция
CURLOPT_NOPROGRESSустановлена в значениеfalse.Можно вернуть ненулевое значение, чтобы отменить передачу. В этом случае будет выдана ошибка
CURLE_ABORTED_BY_CALLBACK.CURLOPT_READFUNCTIONCallback-функция принимает три параметра. Первым параметром является дескриптор cURL, вторым параметром является ресурс потока, переданный cURL через опцию CURLOPT_INFILE, а третьим параметром является максимально разрешенное количество данных для чтения. Callback-функция должна возвратить строку с длиной, не превышающей запрошенного количества данных, обычно с помощью чтения из переданного потокового ресурса. Должна возвратить пустую строку для сигнала о конце файлаEOF.CURLOPT_WRITEFUNCTIONCallback-функция принимает два параметра. Первым параметром является дескриптор cURL, а вторым параметром является строка с записываемыми данными. Данные должны быть сохранены с помощью данной функции. Она должна возвратить точное количество записанных байт, иначе закачка будет прервана с ошибкой. Другие значения:
Параметр Устанавливаемое значение valueCURLOPT_SHAREРезультат выполнения функции curl_share_init(). Позволяет обработчику cURL использовать данные из общего обработчика.
Возвращаемые значения
Возвращает true в случае успешного завершения или false в случае возникновения ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 8.0.0 |
handle теперь ожидает экземпляр CurlHandle;
раньше, ожидался ресурс (resource).
|
| 7.3.15, 7.4.3 |
Добавлено CURLOPT_HTTP09_ALLOWED.
|
| 7.3.0 |
Введенны CURLOPT_ABSTRACT_UNIX_SOCKET, CURLOPT_KEEP_SENDING_ON_ERROR,
CURLOPT_PRE_PROXY, CURLOPT_PROXY_CAINFO,
CURLOPT_PROXY_CAPATH, CURLOPT_PROXY_CRLFILE,
CURLOPT_PROXY_KEYPASSWD, CURLOPT_PROXY_PINNEDPUBLICKEY,
CURLOPT_PROXY_SSLCERT, CURLOPT_PROXY_SSLCERTTYPE,
CURLOPT_PROXY_SSL_CIPHER_LIST, CURLOPT_PROXY_SSLKEY,
CURLOPT_PROXY_SSLKEYTYPE, CURLOPT_PROXY_SSL_OPTIONS,
CURLOPT_PROXY_SSL_VERIFYHOST, CURLOPT_PROXY_SSL_VERIFYPEER,
CURLOPT_PROXY_SSLVERSION, CURLOPT_PROXY_TLSAUTH_PASSWORD,
CURLOPT_PROXY_TLSAUTH_TYPE, CURLOPT_PROXY_TLSAUTH_USERNAME,
CURLOPT_SOCKS5_AUTH, CURLOPT_SUPPRESS_CONNECT_HEADERS,
CURLOPT_DISALLOW_USERNAME_IN_URL, CURLOPT_DNS_SHUFFLE_ADDRESSES,
CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS, CURLOPT_HAPROXYPROTOCOL,
CURLOPT_PROXY_TLS13_CIPHERS, CURLOPT_SSH_COMPRESSION,
CURLOPT_TIMEVALUE_LARGE и CURLOPT_TLS13_CIPHERS.
|
| 7.0.7 |
Добавлены CURL_HTTP_VERSION_2, CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE,
CURL_HTTP_VERSION_2TLS, CURL_REDIR_POST_301,
CURL_REDIR_POST_302, CURL_REDIR_POST_303,
CURL_REDIR_POST_ALL, CURL_VERSION_KERBEROS5,
CURL_VERSION_PSL, CURL_VERSION_UNIX_SOCKETS,
CURLAUTH_NEGOTIATE, CURLAUTH_NTLM_WB,
CURLFTP_CREATE_DIR, CURLFTP_CREATE_DIR_NONE,
CURLFTP_CREATE_DIR_RETRY, CURLHEADER_SEPARATE,
CURLHEADER_UNIFIED, CURLMOPT_CHUNK_LENGTH_PENALTY_SIZE,
CURLMOPT_CONTENT_LENGTH_PENALTY_SIZE, CURLMOPT_MAX_HOST_CONNECTIONS,
CURLMOPT_MAX_PIPELINE_LENGTH, CURLMOPT_MAX_TOTAL_CONNECTIONS,
CURLOPT_CONNECT_TO, CURLOPT_DEFAULT_PROTOCOL,
CURLOPT_DNS_INTERFACE, CURLOPT_DNS_LOCAL_IP4,
CURLOPT_DNS_LOCAL_IP6, CURLOPT_EXPECT_100_TIMEOUT_MS,
CURLOPT_HEADEROPT, CURLOPT_LOGIN_OPTIONS,
CURLOPT_PATH_AS_IS, CURLOPT_PINNEDPUBLICKEY,
CURLOPT_PIPEWAIT, CURLOPT_PROXY_SERVICE_NAME,
CURLOPT_PROXYHEADER, CURLOPT_SASL_IR,
CURLOPT_SERVICE_NAME, CURLOPT_SSL_ENABLE_ALPN,
CURLOPT_SSL_ENABLE_NPN, CURLOPT_SSL_FALSESTART,
CURLOPT_SSL_VERIFYSTATUS, CURLOPT_STREAM_WEIGHT,
CURLOPT_TCP_FASTOPEN, CURLOPT_TFTP_NO_OPTIONS,
CURLOPT_UNIX_SOCKET_PATH, CURLOPT_XOAUTH2_BEARER,
CURLPROTO_SMB, CURLPROTO_SMBS,
CURLPROXY_HTTP_1_0, CURLSSH_AUTH_AGENT и
CURLSSLOPT_NO_REVOKE.
|
Примеры
Пример #1 Инициализация сеанса CURL и загрузка веб-страницы
<?php
// создание нового ресурса cURL
$ch = curl_init();
// установка URL и других необходимых параметров
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, false);
// загрузка страницы и выдача её браузеру
curl_exec($ch);
// завершение сеанса и освобождение ресурсов
curl_close($ch);
?>
Примечания
Замечание:
Передача массива в
CURLOPT_POSTFIELDSзакодирует данные в виде multipart/form-data, тогда как передача URL-кодированной строки закодирует данные в виде application/x-www-form-urlencoded.