(PHP 5 >= 5.1.3, PHP 7, PHP 8)
curl_setopt_array — Устанавливает несколько параметров для сеанса cURL
Функция устанавливает массив параметров cURL-сеанса. Функция полезна для установки большого количества cURL-параметров без повторных вызовов функции curl_setopt().
handle
Дескриптор модуля cURL, который вернула функция curl_init().
optionsМассив (array) параметров и значений, которые требуется установить для сеанса. Ключи — допустимые для функции curl_setopt() константы или целочисленные эквиваленты констант.
Функция возвращает значение true, если все параметры установились успешно.
При ошибке установки хотя бы одной опции функция
немедленно возвращает значение false, а остальные параметры
в массиве options игнорирует.
| Версия | Описание |
|---|---|
| 8.0.0 |
Параметр handle теперь ожидает экземпляр класса CurlHandle;
раньше, параметр ждал ресурс (resource).
|
Пример #1 Пример инициализации нового сеанса cURL и загрузки веб-страницы
<?php
// Создаём новый cURL-дескриптор
$ch = curl_init();
// Устанавливаем URL-адрес и другие параметры
$options = array(
CURLOPT_URL => 'http://www.example.com/',
CURLOPT_HEADER => false
);
curl_setopt_array($ch, $options);
// Получаем данные по URL-адресу и отправляем результат в стандартный вывод
curl_exec($ch);
?>Замечание:
Как и при работе с функцией curl_setopt(), передача массива в опцию
CURLOPT_POSTзакодирует данные в формате multipart/form-data, а передача в опцию строки в формате закодированного URL-адреса кодируется при передаче по сети в формате application/x-www-form-urlencoded.