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

handle

A cURL handle returned by curl_init().

Valores devueltos

En caso de éxito, esta función vacía el resultado directamente en stdout y devuelve true, o false si ocurre un 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 retornar false, pero también puede retornar un valor equivalente a false. Por favor, lea la sección sobre los booleanos para más información. Utilice el operador === para probar el valor de retorno exacto de 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