curl_setopt
(PHP 4 >= 4.0.2, PHP 5) curl_setopt — Устанавливает параметр для сеанса CURL
Описание
bool curl_setopt
( resource $ch
, string $option
, mixed $value
)
Для перечисленных ниже параметров, value
должен быть целым числом:
Для перечисленных ниже параметров, value
должен быть строкой:
-
CURLOPT_URL
: URL, с которым будет
производиться операция. Значение этого параметра также может быть
задано в вызове функции curl_init().
-
CURLOPT_USERPWD
: Стока с именем
пользователя и паролем в виде [username]:[password].
-
CURLOPT_PROXYUSERPWD
: Стока с именем
пользователя и паролем к HTTP прокси-серверу в виде
[username]:[password].
-
CURLOPT_RANGE
: Задает участок файла,
который нужно загрузить, в формате "X-Y" , причем X или Y
могут быть опущены. Протокол HTTP также поддерживает передачу
нескольких фрагментов файла, это задается в виде "X-Y,N-M".
-
CURLOPT_POSTFIELDS
: Строка, содержащая
данные для HTTP POST запроса.
-
CURLOPT_REFERER
: Задает значение HTTP
заголовка "Referer: ".
-
CURLOPT_USERAGENT
: Задает значение HTTP
заголовка "User-Agent: ".
-
CURLOPT_FTPPORT
: Задает значение, которое
будет использоваться для определения IP адреса для команды "PORT"
протокола ftp. Команда "PORT" сообщает серверу, с каким IP
адресом он должен устанавливать соединение. Это может быть IP
адрес, имя хоста, имя сетевого интерфейса (под Unix), или просто
'-' для использования IP адреса по умолчанию.
-
CURLOPT_COOKIE
: Содержимое заголовка
"Cookie: ", который будет отправлен с HTTP запросом.
-
CURLOPT_SSLCERT
: Имя файла с сертификатом в
формате PEM.
-
CURLOPT_SSLCERTPASSWD
: Пароль к файлу
сертификата, заданному параметром
CURLOPT_SSLCERT
.
-
CURLOPT_COOKIEFILE
: Имя файла, содержащего
данные cookie. Данные могут быть либо в формате Netscape, либо
просто HTTP-заголовки.
-
CURLOPT_CUSTOMREQUEST
: Задает специальный
метод, который будет использован в HTTP запросе
вместоGET или HEAD. Это
используется для отправке запросов DELETE или
других, редко используемых. Допустимыми зачениями являются
GET, POST, и т.д;
не передавайте полный HTTP запрос в этом параметре. Например,
'GET /index.html HTTP/1.0\r\n\r\n' недопустимо.
Замечание:
Перед использованием этого параметра убедитесь, что сервер, к
которому вы обращаетесь, поддерживает требуемый метод.
-
CURLOPT_PROXY
: Имя HTTP прокси, через
который будут направляться запросы.
-
CURLOPT_INTERFACE
: Имя используемого
сетевого интерфейса. Может быть именем интерфейса, IP адресом или
именем хоста.
-
CURLOPT_KRB4LEVEL
: Уровень безопасности
KRB4 (Kerberos 4). Допустимы следующие значения (в порядке
возрастания безопасности) : 'clear', 'safe',
'confidential', 'private'. Если переданное значение не входит в
этот список, используется 'private'. Установка этого параметра в
NULL, запрещает безопасность KRB4 . В настоящее
время безопасность KRB4 поддерживается только для протокола FTP.
-
CURLOPT_HTTPHEADER
: Массив с HTTP
заголовками.
-
CURLOPT_QUOTE
: Массив с FTP командами,
которые будут выполнены перед выполнением основного запроса.
-
CURLOPT_POSTQUOTE
: Массив с FTP командами,
которые будут выполнены после выполнения основного запроса.
Для перечисленных ниже параметров, value
должен быть дескриптором файла, возвращенным функцией
fopen():
-
CURLOPT_FILE
: Файл, в который будет выведен
результат операции. По умолчанию STDOUT.
-
CURLOPT_INFILE
: Файл, содержащий данные для
передачи.
-
CURLOPT_WRITEHEADER
: Файл, в который будут
выведены полученные заголовки.
-
CURLOPT_STDERR
: Файл, в который будут
выводиться сообщения об ошибках. По умолчанию STDERR.
Пример #1
Инициализация сеанса CURL и загрузка web-страницы
<?php
// инициализация сеанса
$ch = curl_init();
// установка URL и других необходимых параметров
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);
// загрузка страницы и выдача её браузеру
curl_exec($ch);
// завершение сеанса и освобождение ресурсов
curl_close($ch);
?>
|
|
