(PHP 5 >= 5.1.3, PHP 7, PHP 8)
curl_setopt_array — Establece múltiples opciones para una transferencia cURL
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().
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.
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
.
Versión | Descripción |
---|---|
8.0.0 |
handle expects a CurlHandle
instance now; previously, a resource was expected.
|
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);
?>
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.