(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
Un gestor cURL devuelto por 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 ahora espera una instancia de CurlHandle;
anteriormente, se esperaba un resource.
|
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);
?>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.