Manuel PHP

curl_getinfo

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfoLit les informations détaillant un transfert cURL

Description

mixed curl_getinfo ( resource $ch [, int $opt ] )

Lit les informations détaillant le dernier transfert.

Liste de paramètres

ch

Un gestionnaire cURL retourné par la fonction curl_init().

opt

Ce paramètre peut prendre l'une des valeurs suivantes :

  • CURLINFO_EFFECTIVE_URL - Dernière URL réelle
  • CURLINFO_HTTP_CODE - Dernier code HTTP reçu
  • CURLINFO_FILETIME - Date distante du document, et -1 si la date du document distant est inconnue.
  • CURLINFO_TOTAL_TIME - Durée de la transaction en secondes pour le dernier transfert
  • CURLINFO_NAMELOOKUP_TIME - Durée de résolution du nom de domaine en secondes
  • CURLINFO_CONNECT_TIME - Durée d'établissement de la connexion en secondes
  • CURLINFO_PRETRANSFER_TIME - Durée en secondes, entre le début de la transaction et de début du transfert de fichiers
  • CURLINFO_STARTTRANSFER_TIME - Durée en secondes jusqu'à ce que le premier octet soit sur le point d'être transféré
  • CURLINFO_REDIRECT_TIME - Durée en secondes de toutes les étapes de redirection avant que la transaction finale ne soit débutée
  • CURLINFO_SIZE_UPLOAD - Nombre total d'octets envoyés
  • CURLINFO_SIZE_DOWNLOAD - Nombre total d'octets téléchargés
  • CURLINFO_SPEED_DOWNLOAD - Vitesse moyenne de téléchargement
  • CURLINFO_SPEED_UPLOAD - Vitesse moyenne d'envoi
  • CURLINFO_HEADER_SIZE - Taille des en-têtes reçus
  • CURLINFO_HEADER_OUT - La chaîne de demande envoyée. Disponible depuis PHP 5.1.3
  • CURLINFO_REQUEST_SIZE - Taille totale des requêtes envoyées. Actuellement, uniquement pour les requêtes HTTP
  • CURLINFO_SSL_VERIFYRESULT - Résultat de la vérification de la certification SSL demandée par CURLOPT_SSL_VERIFYPEER
  • CURLINFO_CONTENT_LENGTH_DOWNLOAD - Taille du corps du téléchargement, lu dans l'en-tête Content-Length:
  • CURLINFO_CONTENT_LENGTH_UPLOAD - Taille spécifiée de l'envoi.
  • CURLINFO_CONTENT_TYPE - Content-Type: du fichier téléchargé. NULL indique que le serveur n'a pas envoyé d'en-tête Content-Type:

Valeurs de retour

Si opt est fourni, la valeur retournée sera une chaîne. Sinon, ce sera un tableau associatif contenant les éléments suivants : (qui correspond à opt ):

  • "url"
  • "content_type"
  • "http_code"
  • "header_size"
  • "request_size"
  • "filetime"
  • "ssl_verify_result"
  • "redirect_count"
  • "total_time"
  • "namelookup_time"
  • "connect_time"
  • "pretransfer_time"
  • "size_upload"
  • "size_download"
  • "speed_download"
  • "speed_upload"
  • "download_content_length"
  • "upload_content_length"
  • "starttransfer_time"
  • "redirect_time"

Exemples

Exemple #1 Exemple avec curl_getinfo()

  1. <?php
  2. // Création d'un gestionnaire curl vers une URL inexistante
  3. $ch = curl_init('http://www.yahoo.com/');  
  4.  
  5. // Exécution
  6. curl_exec($ch);  
  7.  
  8. // Vérification si une erreur est survenue
  9. if(!curl_errno($ch))  
  10. { 
  11.    $info = curl_getinfo($ch); 
  12.  
  13.    echo 'La requête a mis ' . $info['total_time'] . ' secondes à être envoyée à ' . $info['url'];  
  14. }  
  15.  
  16. // Fermeture du gestionnaire
  17. curl_close($ch);  
  18. ?> 


Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Bretagne - php - Moto - Kit graphique