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

# curl_setopt_array

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

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

### Описание

function 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.

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

- curl_setopt() - Устанавливает параметр для cURL-передачи

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open