curl_setopt_array

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

Descripción#
Notas#
Véase también#

curl_setopt_array

Establece múltiples opciones para una transferencia cURL

Descripción#

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

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

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

'http://www.example.com/', CURLOPT_HEADER => false ); curl_setopt_array($ch, $options); // captura la URL y la pasa al navegador curl_exec($ch); ?>

```php

Notas#

[!NOTE] 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.

Véase también#

curl_setopt