curl_exec

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

curl_exec — Exécute une session cURL

Description

curl_exec(CurlHandle $handle): string|bool

Exécute la session cURL fournie.

Cette fonction doit être appelée après l'initialisation et le paramétrage de la session cURL.

Liste de paramètres

handle

Un gestionnaire cURL retourné par curl_init().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient. Cependant, si l'option CURLOPT_RETURNTRANSFER est définie, la fonction retournera le résultat en cas de succès, et false en cas d'échec.

Avertissement

Cette fonction peut retourner false, mais elle peut aussi retourner une valeur équivalent à false. Veuillez lire la section sur les booléens pour plus d'informations. Utilisez l'opérateur === pour tester la valeur de retour exacte de cette fonction.

Note:

Notez que les codes de status d'une réponse qui indiquent des erreurs (tel que 404 Not found) ne sont pas considérés comme des échecs. curl_getinfo() peut être utilisé pour vérifier ces cas.

Historique

Version Description
8.0.0 handle attend désormais une instance de CurlHandle; auparavant; une resource était attendue.

Exemples

Exemple #1 Récupère le contenu d'une page web

<?php
// Création d'une nouvelle ressource cURL
$ch = curl_init();

// Configuration de l'URL et d'autres options
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// Récupération de l'URL et affichage sur le navigateur
curl_exec($ch);

// Fermeture de la session cURL
curl_close($ch);
?>

Voir aussi