array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.curl-setopt-array.php', 1 => 'curl_setopt_array', 2 => 'Устанавливает несколько параметров для сеанса cURL', ), 'up' => array ( 0 => 'ref.curl.php', 1 => 'Функции cURL', ), 'prev' => array ( 0 => 'function.curl-setopt.php', 1 => 'curl_setopt', ), 'next' => array ( 0 => 'function.curl-share-close.php', 1 => 'curl_share_close', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/curl/functions/curl-setopt-array.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

curl_setopt_array

(PHP 5 >= 5.1.3, PHP 7, PHP 8)

curl_setopt_array — Устанавливает несколько параметров для сеанса cURL

Описание

curl_setopt_array(CurlHandle $handle, array $options): bool

Функция устанавливает массив параметров 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.

Смотрите также