Curl_setopt — Устанавливает параметр для вызова CURL. Описание
bool Curl_setopt (int ch, строковый параметр, смешанное значение)
Функция Curl_setopt() устанавливает параметры для сеанса CURL. Параметр опции — это желаемая настройка, а значение — это значение, заданное этой опцией.
Значения следующих параметров будут использоваться как длинные целые числа (указанные в параметре option):
*CURLOPT_INFILESIZE: Когда вы загружаете файл на удаленный сайт, этот параметр сообщает PHP размер загружаемого файла.
*CURLOPT_VERBOSE: Если вы хотите, чтобы CURL сообщал о каждом непредвиденном событии, установите для этого параметра ненулевое значение.
*CURLOPT_HEADER: если вы хотите включить заголовок в выходные данные, установите для этого параметра ненулевое значение.
*CURLOPT_NOPROGRESS: Если вы не хотите, чтобы PHP отображал индикатор выполнения передачи CURL, установите для этой опции ненулевое значение.
Примечание. PHP автоматически устанавливает для этой опции ненулевое значение, вам следует изменять эту опцию только в целях отладки.
*CURLOPT_NOBODY: Если вы не хотите включать часть тела в выходные данные, установите для этой опции ненулевое значение.
*CURLOPT_FAILONERROR: Если вы хотите, чтобы PHP не отображал ошибку (возврат кода HTTP больше или равен 300) при возникновении ошибки, установите для этой опции ненулевое значение. Поведение по умолчанию — вернуть обычную страницу и игнорировать код.
*CURLOPT_UPLOAD: Если вы хотите, чтобы PHP подготовился к загрузке, установите для этой опции ненулевое значение.
*CURLOPT_POST: Если вы хотите, чтобы PHP выполнял обычный HTTP POST, установите для этой опции ненулевое значение. Этот POST имеет обычный тип application/x-www-from-urlencoded, который в основном используется HTML-формами.
*CURLOPT_FTPLISTONLY: установите для этой опции ненулевое значение, и PHP выведет список имен каталогов для FTP.
*CURLOPT_FTPAPPEND: установите для этой опции ненулевое значение, и PHP применит удаленный файл, а не перезапишет его.
*CURLOPT_NETRC: установите для этой опции ненулевое значение, и PHP будет искать в вашем файле ~./netrc имя пользователя и пароль удаленного сайта, к которому вы хотите подключиться.
*CURLOPT_FOLLOWLOCATION: установите для этой опции ненулевой заголовок (например, «Location:»), и сервер отправит его как часть заголовка HTTP (обратите внимание, что это рекурсивно, PHP отправит заголовок типа «Location:»).
*CURLOPT_PUT: установите для этого параметра ненулевое значение, чтобы загрузить файл по протоколу HTTP. Чтобы загрузить этот файл, необходимо установить параметры CURLOPT_INFILE и CURLOPT_INFILESIZE.
*CURLOPT_MUTE: установите для этой опции ненулевое значение, и PHP будет полностью отключать функцию CURL.
*CURLOPT_TIMEOUT: установите длинное целое число в качестве максимального количества секунд.
*CURLOPT_LOW_SPEED_LIMIT: установите длинное целое число, чтобы контролировать количество передаваемых байтов.
*CURLOPT_LOW_SPEED_TIME: установите длинное целое число, чтобы контролировать, сколько секунд будет передавать количество байтов, указанное CURLOPT_LOW_SPEED_LIMIT.
*CURLOPT_RESUME_FROM: передайте длинный параметр, содержащий адрес смещения байтов (начальную форму, в которую вы хотите передать данные).
*CURLOPT_SSLVERSION: передать длинный параметр, содержащий версию SSL. По умолчанию PHP выполняет свою тяжелую работу самостоятельно, для большей безопасности вам придется настроить его вручную.
*CURLOPT_TIMECONDITION: передайте длинный параметр, чтобы указать, как обрабатывать параметр CURLOPT_TIMEVALUE. Вы можете установить для этого параметра значение TIMECOND_IFMODSINCE или TIMECOND_ISUNMODSINCE. Это только для HTTP.
*CURLOPT_TIMEVALUE: передать количество секунд с 1970-1-1 до настоящего времени. Это время будет использоваться в качестве значения, указанного в опции CURLOPT_TIMEVALUE или в качестве значения по умолчанию TIMECOND_IFMODSINCE.
Значения следующих параметров будут рассматриваться как строки:
*CURLOPT_URL: это URL-адрес, который вы хотите получить с помощью PHP. Вы также можете установить эту опцию во время инициализации с помощью функции curl_init().
*CURLOPT_USERPWD: передайте строку в виде [имя пользователя]:[пароль] и используйте PHP для подключения.
*CURLOPT_PROXYUSERPWD: передайте строку в формате [имя пользователя]:[пароль] для подключения к HTTP-прокси.
*CURLOPT_RANGE: передайте диапазон, который вы хотите указать. Он должен быть в формате «XY», исключая X или Y. Передача HTTP также поддерживает несколько интервалов, разделенных запятыми (XY, NM).
*CURLOPT_POSTFIELDS: передать строку, содержащую все данные, как операцию HTTP «POST».
*CURLOPT_REFERER: строка, содержащая заголовок «referer» в HTTP-запросе.
*CURLOPT_USERAGENT: строка, содержащая заголовок «user-agent» в HTTP-запросе.
*CURLOPT_FTPPORT: передать IP-адрес, содержащий IP-адрес, используемый командой ftp «POST». Эта команда POST сообщает удаленному серверу подключиться к указанному нами IP-адресу. Эта строка может быть IP-адресом, именем хоста, именем сетевого интерфейса (в UNIX) или «-» (используйте IP-адрес системы по умолчанию).
*CURLOPT_COOKIE: передать в соединение заголовок, содержащий HTTP-файл cookie.
*CURLOPT_SSLCERT: передать строку, содержащую сертификат в формате PEM.
*CURLOPT_SSLCERTPASSWD: укажите пароль, содержащий необходимый пароль для использования сертификата CURLOPT_SSLCERT.
*CURLOPT_COOKIEFILE: передать строку, содержащую имя файла, содержащего данные cookie. Этот файл cookie может быть в формате Netscape или представлять собой набор заголовков в стиле HTTP, хранящихся в файле.
*CURLOPT_CUSTOMREQUEST: при выполнении HTTP-запроса передайте символ, который будет использоваться GET или HEAD. Передайте строку, которая будет использоваться вместо GET или HEAD при выполнении HTTP-запроса. Это полезно для выполнения другого, более непонятного HTTP-запроса.
Примечание. Убедитесь, что ваш сервер поддерживает команду Order не делать этого.
Следующие параметры требуют описания файла (полученного с помощью функции fopen()):
*CURLOPT_FILE: этот файл будет выходным файлом, в который вы поместите передачу. По умолчанию используется STDOUT.
*CURLOPT_INFILE: этот файл является отправленным вами входным файлом.
*CURLOPT_WRITEHEADER: Этот файл содержит часть заголовка вашего вывода.
*CURLOPT_STDERR: в этом файле вместо stderr записаны ошибки.