curl_setopt_array

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

curl_setopt_arrayEstablece múltiples opciones para una transferencia cURL

Descripción

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

ch

El recurso 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 expects a CurlHandle instance now; previously, a resource was expected.

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);

// cierra el recurso cURL y libera los recursos del sistema
curl_close($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