curl_exec

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_execEjecuta una sesión cURL

Descripción

curl_exec(CurlHandle $handle): string|bool

Ejecuta la sesión cURL proporcionada.

Esta función debe ser llamada después de la inicialización y la configuración de la sesión cURL.

Parámetros

ch

El recurso cURL devuelto por curl_init().

Valores devueltos

En caso de éxito, esta función vacía el resultado directamente en stdout y devuelve true, o false en caso de error. Sin embargo, si CURLOPT_RETURNTRANSFER está definida, la función devolverá el resultado en caso de éxito, y false en caso de fallo.

Advertencia

Esta función puede devolver el valor booleano false, pero también puede devolver un valor no booleano que se evalúa como false. Por favor lea la sección sobre Booleanos para más información. Use el operador === para comprobar el valor devuelto por esta función.

Nota:

Tenga en cuenta que los códigos de estado de una respuesta que indican errores (como 404 Not found) no se consideran fallos. curl_getinfo() puede ser utilizado para verificar estos casos.

Historial de cambios

Versión Descripción
8.0.0 handle expects a CurlHandle instance now; previously, a resource was expected.

Ejemplos

Ejemplo #1 Recupera el contenido de una página web

<?php
// Creación de un nuevo recurso cURL
$ch = curl_init();

// Configuración de la URL y otras opciones
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// Recuperación de la URL y visualización en el navegador
curl_exec($ch);

// Cierre de la sesión cURL
curl_close($ch);
?>

Ver también