Модуль определяет перечисленные ниже константы
и открывает к ним доступ только тогда, когда модуль либо собрали в PHP,
либо динамически загрузили во время исполнения кода.
Константы |
Описание |
curl_getinfo()
CURLINFO_APPCONNECT_TIME
(int)
|
Время в секундах, которое прошло от запуска до установления SSL- или SSH-подключения или рукопожатия с удалённым хостом
|
CURLINFO_APPCONNECT_TIME_T
(int)
|
Время в микросекундах, которое прошло от запуска до завершения SSL- или SSH-подключения или рукопожатия с удалённым хостом.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_CAINFO
(int)
|
Путь ко встроенному сертификату удостоверяющиего центра по умолчанию.
Опция доступна с PHP 8.3.0 и cURL 7.84.0
|
CURLINFO_CAPATH
(int)
|
Строка пути встроенного сертификата удостоверяющего центра по умолчанию.
Опция доступна с PHP 8.3.0 и cURL 7.84.0
|
CURLINFO_CERTINFO
(int)
|
Цепочка сертификатов TLS
|
CURLINFO_CONDITION_UNMET
(int)
|
Информация о невыполненных за отведённое время условиях
|
CURLINFO_CONNECT_TIME
(int)
|
Время в секундах, затраченное на установку соединения
|
CURLINFO_CONNECT_TIME_T
(int)
|
Общее время в микросекундах, которое прошло от запуска до завершения подключения к удалённому хосту или прокси-серверу.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_CONTENT_LENGTH_DOWNLOAD
(int)
|
Размер полученных данных, прочитанный из поля заголовка Content-Length
|
CURLINFO_CONTENT_LENGTH_DOWNLOAD_T
(int)
|
Размер полученных данных. Это значение считывается из поля Content-Length. Значение будет равно -1, если размер неизвестен.
Опция доступна с PHP 7.3.0 и cURL 7.55.0
|
CURLINFO_CONTENT_LENGTH_UPLOAD
(int)
|
Размер переданных данных
|
CURLINFO_CONTENT_LENGTH_UPLOAD_T
(int)
|
Размер отправленных данных. Значение будет равно -1, если размер неизвестен.
Опция доступна с PHP 7.3.0 и cURL 7.55.0
|
CURLINFO_CONTENT_TYPE
(int)
|
Значение заголовка Content-Type запрошенного документа. Значение NULL указывает, что сервер не отправил допустимый заголовок Content-Type
|
CURLINFO_COOKIELIST
(int)
|
Все известные cookies
|
CURLINFO_EFFECTIVE_URL
(int)
|
Последний эффективный URL (в цепочке перенаправлений — прим. перев.)
|
CURLINFO_FILETIME
(int)
|
Время получения документа по часам удалённого сервера, если параметр CURLOPT_FILETIME включён для дескриптора cURL; если возвращается значение -1, то время получения документа неизвестно
|
CURLINFO_FILETIME_T
(int)
|
Время получения документа в виде метки времени Unix по часам удалённого сервера, альтернатива опции CURLINFO_FILETIME , чтобы разрешить системам с 32-битными long-переменными извлекать даты за пределами диапазона 32-битных меток времени
Опция доступна с PHP 7.3.0 и cURL 7.59.0
|
CURLINFO_FTP_ENTRY_PATH
(int)
|
Путь входа на FTP-сервер
|
Отправленная строка запроса. Чтобы этот параметр работал, нужно добавить опцию CURLINFO_HEADER_OUT в дескриптор через вызов функции curl_setopt()
|
Суммарный размер полученных заголовков
|
CURLINFO_HTTPAUTH_AVAIL
(int)
|
Битовая маска доступного метода или методов аутентификации на основе данных предыдущего ответа
|
CURLINFO_HTTP_CODE
(int)
|
Последний код ответа.
С cURL 7.10.8 это устаревший псевдоним опции CURLINFO_RESPONSE_CODE .
|
CURLINFO_HTTP_CONNECTCODE
(int)
|
Код ответа на запрос CONNECT
|
CURLINFO_HTTP_VERSION
(int)
|
Версия HTTP-протокола последнего соединении. Возвращаемое значение будет равно значению константы из семейства CURL_HTTP_VERSION_* или 0, если версию невозможно определить
Опция доступна с PHP 7.3.0 и cURL 7.50.0
|
CURLINFO_LOCAL_IP
(int)
|
Локальный (исходящий) IP-адрес последнего соединения
|
CURLINFO_LOCAL_PORT
(int)
|
Локальный (исходящий) порт последнего соединения
|
CURLINFO_NAMELOOKUP_TIME
(int)
|
Время в секундах, затраченное на разрешение имени
|
CURLINFO_NAMELOOKUP_TIME_T
(int)
|
Время в микросекундах от запуска до разрешения имени.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_NUM_CONNECTS
(int)
|
Количество соединений, которые модулю curl пришлось создать, что успешно выполнить предыдущую передачу
|
CURLINFO_OS_ERRNO
(int)
|
Значение переменной Errno в случае сбоя соединения. Номер ошибки зависит от ОС и особенностей системы
|
CURLINFO_PRETRANSFER_TIME
(int)
|
Время в секундах от запуска до момента начала передачи файла
|
CURLINFO_PRETRANSFER_TIME_T
(int)
|
Время в микросекундах от запуска до момента начала передачи файла.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_PRIMARY_IP
(int)
|
IP-адрес последнего соединения
|
CURLINFO_PRIMARY_PORT
(int)
|
Порт назначения последнего соединения
|
CURLINFO_PRIVATE
(int)
|
Закрытые данные, связанные с текущим дескриптором cURL, которые до этого были установлены функцией curl_setopt() с опцией CURLOPT_PRIVATE
|
CURLINFO_PROTOCOL
(int)
|
Протокол последнего HTTP-соединения. Возвращаемое значение будет равно значению константы семейства CURLPROTO_* .
Опция доступна с PHP 7.3.0 и cURL 7.52.0
|
CURLINFO_PROXYAUTH_AVAIL
(int)
|
Битовая маска доступного метода или методов аутентификации прокси-сервера на основе данных предыдущего ответа
|
CURLINFO_PROXY_ERROR
(int)
|
Подробный код ошибки прокси-сервера (SOCKS), когда последняя передача вернула ошибку CURLE_PROXY error. Возвращаемое значение будет равно значению константы из семейства CURLPX_* . Код ошибки будет равен значению константы CURLPX_OK , если код ответа не был доступен.
Опция доступна с PHP 8.2.0 и cURL 7.73.0
|
CURLINFO_PROXY_SSL_VERIFYRESULT
(int)
|
Результат запрошенной проверки сертификата (с опцией CURLOPT_PROXY_SSL_VERIFYPEER option). Работает только для серверов HTTPS-прокси.
Опция доступна с PHP 7.3.0 и cURL 7.52.0
|
CURLINFO_REDIRECT_COUNT
(int)
|
Число перенаправлений, если опцию CURLOPT_FOLLOWLOCATION включили
|
CURLINFO_REDIRECT_TIME
(int)
|
Общее время в секундах, которое потребовалось для всех шагов перенаправления до запуска последней транзакции, если опцию CURLOPT_FOLLOWLOCATION включили
|
CURLINFO_REDIRECT_TIME_T
(int)
|
Общее время в микросекундах, которое потребовалось для всех шагов перенаправления, включая поиск имени, подключение, предварительную о основную передачу до запуска окончательной транзакции.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_REDIRECT_URL
(int)
|
Если опцию CURLOPT_FOLLOWLOCATION отключили:
URL-адрес перенаправления, найденный в последней транзакции, который в следующий раз надо запросить вручную. Если опцию CURLOPT_FOLLOWLOCATION включили: пустое значение. Тогда URL-адрес перенаправления доступен в опции CURLINFO_EFFECTIVE_URL
|
CURLINFO_REFERER
(int)
|
Заголовок реферера.
Опция доступна с PHP 8.2.0 и cURL 7.76.0
|
CURLINFO_REQUEST_SIZE
(int)
|
Общий размер отправленных запросов, работает пока только для HTTP-запросов
|
CURLINFO_RESPONSE_CODE
(int)
|
Последний код ответа.
Опция доступна с cURL 7.10.8
|
CURLINFO_RETRY_AFTER
(int)
|
Информация из заголовка Retry-After: или ноль, если допустимого заголовка не было.
Опция доступна с PHP 8.2.0 и cURL 7.66.0
|
CURLINFO_RTSP_CLIENT_CSEQ
(int)
|
Следующий CSeq-заголовок RTSP-клиента
|
CURLINFO_RTSP_CSEQ_RECV
(int)
|
Последний полученный заголовок CSeq
|
CURLINFO_RTSP_SERVER_CSEQ
(int)
|
Следующий CSeq-заголовок RTSP-сервера
|
CURLINFO_RTSP_SESSION_ID
(int)
|
Идентификатор RTSP-сессии
|
CURLINFO_SCHEME
(int)
|
Схема URL последнего соединения.
Опция доступна с PHP 7.3.0 и cURL 7.52.0
|
CURLINFO_SIZE_DOWNLOAD
(int)
|
Общее количество полученных байтов
|
CURLINFO_SIZE_DOWNLOAD_T
(int)
|
Общее количество байтов, которые были получены. Число будет указано только для последней передачи и будет сбрасываться при каждой новой передаче.
Опция доступна с PHP 7.3.0 и cURL 7.50.0
|
CURLINFO_SIZE_UPLOAD
(int)
|
Общее количество переданных байтов
|
CURLINFO_SIZE_UPLOAD_T
(int)
|
Общее количество байтов, которые были переданы.
Опция доступна с PHP 7.3.0 и cURL 7.50.0
|
CURLINFO_SPEED_DOWNLOAD
(int)
|
Средняя скорость получения данных
|
CURLINFO_SPEED_DOWNLOAD_T
(int)
|
Средняя скорость получения данных в байтах в секунду, которую curl измерил в конце передачи.
Опция доступна с PHP 7.3.0 и cURL 7.50.0
|
CURLINFO_SPEED_UPLOAD
(int)
|
Средняя скорость передачи данных
|
CURLINFO_SPEED_UPLOAD_T
(int)
|
Средняя скорость передачи данных в байтах в секунду, которую curl измерил в конце передачи.
Опция доступна с PHP 7.3.0 и cURL 7.50.0
|
CURLINFO_SSL_ENGINES
(int)
|
Список поддерживаемых криптодвижков библиотеки OpenSSL
|
CURLINFO_SSL_VERIFYRESULT
(int)
|
Результат проверки SSL-сертификата, запрошенный с опцией CURLOPT_SSL_VERIFYPEER
|
CURLINFO_STARTTRANSFER_TIME
(int)
|
Время в секундах от запуска передачи до получения первого байта
|
CURLINFO_STARTTRANSFER_TIME_T
(int)
|
Время в микросекундах от запуска передачи до получения первого байта.
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
CURLINFO_TOTAL_TIME
(int)
|
Общее время транзакции в секундах для последней передачи
|
CURLINFO_TOTAL_TIME_T
(int)
|
Общее время предыдущей передачи в микросекундах, включая разрешение имени, TCP-соединение и т. д..
Опция доступна с PHP 7.3.0 и cURL 7.61.0
|
Константы |
Описание |
Константы ошибок cURL
CURLE_ABORTED_BY_CALLBACK
(int)
|
Callback-функция прервала выполнение. Обратный вызов вернул модулю libcurl «прерывание».
|
CURLE_BAD_CALLING_ORDER
(int)
|
|
CURLE_BAD_CONTENT_ENCODING
(int)
|
Нераспознанная кодировка передачи.
|
CURLE_BAD_DOWNLOAD_RESUME
(int)
|
Не удалось возобновить загрузку, поскольку указанное смещение вышло за пределы файла.
|
CURLE_BAD_FUNCTION_ARGUMENT
(int)
|
Функцию вызвали с неверным параметром.
|
CURLE_BAD_PASSWORD_ENTERED
(int)
|
|
CURLE_COULDNT_CONNECT
(int)
|
Не удалось подключиться к хосту или прокси.
|
CURLE_COULDNT_RESOLVE_HOST
(int)
|
Не удалось разрешить хост. Удаленный хост не был разрешён.
|
CURLE_COULDNT_RESOLVE_PROXY
(int)
|
Не удалось разрешить прокси. Не удалось разрешить прокси-хост.
|
CURLE_FAILED_INIT
(int)
|
Early initialization code failed.
Скорее всего, это внутренняя ошибка или проблема,
или проблема с ресурсами, когда что-то фундаментальное не может быть выполнено во время инициализации.
|
CURLE_FILESIZE_EXCEEDED
(int)
|
Превышен максимальный размер файла.
|
CURLE_FILE_COULDNT_READ_FILE
(int)
|
Не удалось открыть файл, путь к которому указали через FILE://.
Скорее всего, потому, что путь к файлу не идентифицирует существующий файл
или из-за отсутствия соответствующих прав доступа к файлу.
|
CURLE_FTP_ACCESS_DENIED
(int)
|
|
CURLE_FTP_BAD_DOWNLOAD_RESUME
(int)
|
|
CURLE_FTP_CANT_GET_HOST
(int)
|
Внутренняя ошибка при поиске хоста для нового соединения.
|
CURLE_FTP_CANT_RECONNECT
(int)
|
|
CURLE_FTP_COULDNT_GET_SIZE
(int)
|
|
CURLE_FTP_COULDNT_RETR_FILE
(int)
|
Это был или неожиданный ответ на команду RETR,
или передача нулевого байта завершена.
|
CURLE_FTP_COULDNT_SET_ASCII
(int)
|
|
CURLE_FTP_COULDNT_SET_BINARY
(int)
|
|
CURLE_FTP_COULDNT_STOR_FILE
(int)
|
|
CURLE_FTP_COULDNT_USE_REST
(int)
|
Команда FTP-сервера REST вернула ошибку.
Этого никогда не должно произойти, если сервер в порядке.
|
CURLE_FTP_PARTIAL_FILE
(int)
|
|
CURLE_FTP_PORT_FAILED
(int)
|
Команда FTP-сервера PORT вернула ошибку.
Чаще всего это происходит, когда не указали достаточно хороший адрес для модуля libcurl.
Смотрите описание параметра CURLOPT_FTPPORT .
|
CURLE_FTP_QUOTE_ERROR
(int)
|
|
CURLE_FTP_SSL_FAILED
(int)
|
|
CURLE_FTP_USER_PASSWORD_INCORRECT
(int)
|
|
CURLE_FTP_WEIRD_227_FORMAT
(int)
|
FTP-серверы возвращают строку ответа с кодом 227 на команду PASV.
Если модуль libcurl не сможет проанализировать эту строку, этот код возврата передаётся обратно.
|
CURLE_FTP_WEIRD_PASS_REPLY
(int)
|
После отправки FTP-пароля на сервер модуль libcurl ожидает правильного ответа.
Этот код ошибки указывает на то, что сервер вернул неожиданный код.
|
CURLE_FTP_WEIRD_PASV_REPLY
(int)
|
Модулю libcurl не удалось получить от сервера приемлемый результат
в ответ на команду PASV или EPSV. Сервер неисправен.
|
CURLE_FTP_WEIRD_SERVER_REPLY
(int)
|
Сервер отправил данные, которые модуль libcurl не смог проанализировать.
С cURL 7.51.0 этот код ошибки называется
CURLE_WEIRD_SERVER_REPLY .
|
CURLE_FTP_WEIRD_USER_REPLY
(int)
|
|
CURLE_FTP_WRITE_ERROR
(int)
|
|
CURLE_FUNCTION_NOT_FOUND
(int)
|
Функция не найдена. Модуль не смог найти требуемую zlib-функцию.
|
CURLE_GOT_NOTHING
(int)
|
Сервер ничего не вернул, и в этих обстоятельствах
отсутствие ответа считается ошибкой.
|
CURLE_HTTP_NOT_FOUND
(int)
|
|
CURLE_HTTP_PORT_FAILED
(int)
|
|
CURLE_HTTP_POST_ERROR
(int)
|
Это необычная ошибка, которая в основном возникает из-за внутренней неясности.
|
CURLE_HTTP_RANGE_ERROR
(int)
|
|
CURLE_HTTP_RETURNED_ERROR
(int)
|
Ошибка возвращается, если для параметра CURLOPT_FAILONERROR установили значение true
и HTTP-сервер возвращает код ошибки, который больше или равен 400.
|
CURLE_LDAP_CANNOT_BIND
(int)
|
LDAP-клиент не может привязаться. Операция LDAP-аутентификации не удалась.
|
CURLE_LDAP_INVALID_URL
(int)
|
|
CURLE_LDAP_SEARCH_FAILED
(int)
|
LDAP-поиск не удался.
|
CURLE_LIBRARY_NOT_FOUND
(int)
|
|
CURLE_MALFORMAT_USER
(int)
|
|
CURLE_OBSOLETE
(int)
|
|
CURLE_OK
(int)
|
Всё в порядке. Продолжайте как обычно.
|
CURLE_OPERATION_TIMEDOUT
(int)
|
Время ожидания операции истекло.
Указанный период времени ожидания истёк в соответствии с условиями.
|
CURLE_OPERATION_TIMEOUTED
(int)
|
|
CURLE_OUT_OF_MEMORY
(int)
|
Запрос на выделение памяти не выполнен.
|
CURLE_PARTIAL_FILE
(int)
|
Передача файла оказалась короче или длиннее, чем ожидалось.
Ошибка возникает, когда сервер впервые сообщает ожидаемый размер передачи,
а затем доставляет данные, которые не соответствуют ранее заданному размеру.
|
CURLE_PROXY
(int)
|
Ошибка подтверждения связи с прокси-сервером.
Опция CURLINFO_PROXY_ERROR даёт дополнительную информацию о конкретной проблеме.
Ошибка доступна с PHP 8.2.0 и cURL 7.73.0
|
CURLE_READ_ERROR
(int)
|
Возникла проблема с чтением локального файла или ошибка, которую вернула callback-функция чтения.
|
CURLE_RECV_ERROR
(int)
|
Сбой при получении сетевых данных.
|
CURLE_SEND_ERROR
(int)
|
Не удалось отправить сетевые данные.
|
CURLE_SHARE_IN_USE
(int)
|
|
CURLE_SSH
(int)
|
Во время SSH-сеанса возникла неизвестная ошибка.
Ошибка доступна с cURL 7.16.1.
|
CURLE_SSL_CACERT
(int)
|
|
CURLE_SSL_CACERT_BADFILE
(int)
|
Проблема с чтением SSL-сертификата удостоверяющего CA-центра.
|
CURLE_SSL_CERTPROBLEM
(int)
|
Проблема с сертификатом локального клиента.
|
CURLE_SSL_CIPHER
(int)
|
Could not use specified cipher.
|
CURLE_SSL_CONNECT_ERROR
(int)
|
Проблема возникла на каком-то этапе подтверждения связи по протоколу SSL или TLS.
Чтение сообщения в буфере ошибок даёт более подробную информацию о проблеме.
Проблему вызывают сертификаты (форматы файлов, пути, разрешения), пароли и т. д.
|
CURLE_SSL_ENGINE_NOTFOUND
(int)
|
Модуль не смог найти криптомеханизм, который установили в параметрах дескриптора.
|
CURLE_SSL_ENGINE_SETFAILED
(int)
|
Модуль не смог установить выбранный SSL-механизм шифрования по умолчанию.
|
CURLE_SSL_PEER_CERTIFICATE
(int)
|
|
CURLE_SSL_PINNEDPUBKEYNOTMATCH
(int)
|
Модуль не смог сопоставить закреплённый ключ, который указали через параметр
CURLOPT_PINNEDPUBLICKEY .
|
CURLE_TELNET_OPTION_SYNTAX
(int)
|
|
CURLE_TOO_MANY_REDIRECTS
(int)
|
Слишком много перенаправлений. При следовании по перенаправлениям модуль libcurl достигает максимального значения.
Ограничение устанавливают через параметр CURLOPT_MAXREDIRS .
|
CURLE_UNKNOWN_TELNET_OPTION
(int)
|
|
CURLE_UNSUPPORTED_PROTOCOL
(int)
|
URL-адрес, который передали модулю libcurl, использовал протокол, который libcurl не поддерживает.
Проблема может заключаться в неиспользованной опции времени компиляции,
в строке протокола, которую неправильно написали, или просто в протоколе, для которого в модуле libcurl нет кода.
|
CURLE_URL_MALFORMAT
(int)
|
URL-адрес отформатировали неправильно.
|
CURLE_URL_MALFORMAT_USER
(int)
|
|
CURLE_WEIRD_SERVER_REPLY
(int)
|
Сервер отправил данные, которые модуль libcurl не смог проанализировать.
До cURL 7.51.0 этот код ошибки назывался
CURLE_FTP_WEIRD_SERVER_REPLY .
Ошибка доступна с PHP 7.3.0 и cURL 7.51.0
|
CURLE_WRITE_ERROR
(int)
|
Ошибка возникла при записи полученных данных в локальный файл
или ошибка вернулась в модуль libcurl из callback-функции записи.
|