(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().
handle
A cURL handle returned by curl_init().
optionsUn 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_POSThará 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.