Establece múltiples opciones para una transferencia cURL

# curl_setopt_array

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

curl_setopt_array — Establece múltiples opciones para una transferencia cURL

### Descripción

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

Establece múltiples opciones para una sesión cURL. Esta función es útil para configurar un gran número de opciones cURL sin llamar a cada vez curl_setopt().

### Parámetros

`handle`
  Un gestor cURL devuelto por curl_init().
`options`

  Un array que especifica qué opciones establecer con sus valores. Las claves deberían ser constantes válidas de curl_setopt() o sus enteros equivalentes.

### Valores devueltos

Devuelve `true` si todas las opciones se establecieron correctamente. Si una opción no puede ser establecida correctamente, `false` es devuelto inmediatamente, ignorando todas las opciones futuras en el array `options`.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | `handle` ahora espera una instancia de CurlHandle; anteriormente, se esperaba un resource.

### Ejemplos

Ejemplo #1 Inicialización de una nueva sesión cURL y recuperación de una página web

    <?php
    // crea un nuevo recurso cURL
    $ch = curl_init();

    // establece la URL y otras opciones apropiadas
    $options = array(CURLOPT_URL => 'http://www.example.com/',
                     CURLOPT_HEADER => false
                    );

    curl_setopt_array($ch, $options);

    // captura la URL y la pasa al navegador
    curl_exec($ch);
    ?>

### Notas

> Nota:

> Con la función curl_setopt(), el hecho de pasar un array como valor de la constante `CURLOPT_POST` hará que los datos sean codificados como multipart/form-data, mientras que el hecho de pasar una string codificada URL hará que los datos sean codificados como application/x-www-form-urlencoded.

### Ver también

- curl_setopt() - Establece una opción para una transferencia cURL

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