Rechercher une fonction PHP

curl_getinfo

Table des matières

(PHP 4 >= 4.0.4, PHP 5, PHP 7)

curl_getinfo — Lit les informations détaillant un transfert cURL

Description

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

curl_getinfo() lit les informations concernant le transfert ch.

  

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_COUNT : Nombre de redirections, avec l'option CURLOPT_FOLLOWLOCATION activée
  • CURLINFO_REDIRECT_TIME : durée en secondes de toutes les étapes de redirection avant que la transaction finale ne soit débutée, avec l'option CURLOPT_FOLLOWLOCATION activée
  • CURLINFO_REDIRECT_URL - Avec l'option CURLOPT_FOLLOWLOCATION désactivée: URL de redirection trouvée dans la dernière transaction, qui devra être interrogé manuellement par la suite. Si l'option CURLOPT_FOLLOWLOCATION est activée : cette valeur est vide. Dans ce cas, l'url de redirection est disponible dans CURLINFO_EFFECTIVE_URL
  • CURLINFO_PRIMARY_IP - Adresse IP de la plus récente connexion
  • CURLINFO_PRIMARY_PORT - Port de destination de la plus récente connexion
  • CURLINFO_LOCAL_IP - Adresse IP locale (source) de la plus récente connexion
  • CURLINFO_LOCAL_PORT - Port local (source) de la plus récente connexion
  • 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 requête envoyée. Pour que cela fonctionne, appelez curl_setopt() avec l'option CURLINFO_HEADER_OUT.
  • 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 document demandé. NULL indique que le serveur n'a pas envoyé d'en-tête Content-Type:
  • CURLINFO_PRIVATE - Données privées associées avec le gestionnaire cURL, précédement défini avec l'option CURLOPT_PRIVATE de la fonction curl_setopt()

  

Valeurs de retour

Si opt est fourni, la valeur sera retournée. Sinon, ce sera un tableau associatif contenant les éléments suivants (qui correspond à opt), ou FALSE si une erreur survient :

  • "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"
  • "certinfo"
  • "primary_ip"
  • "primary_port"
  • "local_ip"
  • "local_port"
  • "redirect_url"
  • "request_header" (Existe seulement si CURLINFO_HEADER_OUT est utilisé via un appel à curl_setopt())
Veuillez noter que les données privées ne sont pas incluses dans le tableau associatif et doivent être récupérées individuellement avec l'option CURLINFO_PRIVATE.

  

Historique

Version Description
5.4.7 Ajout de CURLINFO_PRIMARY_IP, CURLINFO_PRIMARY_PORT, CURLINFO_LOCAL_IP et CURLINFO_LOCAL_PORT.
5.3.7 Ajout de CURLINFO_REDIRECT_URL.
5.2.4 Ajout de CURLINFO_PRIVATE.
5.1.3 Ajout de CURLINFO_HEADER_OUT.

  

Exemples

Exemple #1 Exemple avec curl_getinfo()

<?php
// Création d'un gestionnaire curl
$ch = curl_init('http://www.yahoo.com/');

// Exécution
curl_exec($ch);

// Vérification si une erreur est survenue
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);

 echo 'La requête a mis ' . $info['total_time'] . ' secondes à être envoyée à ' . $info['url'];
}

// Fermeture du gestionnaire
curl_close($ch);
?>

  

Notes

Note:

Les informations founies par cette fonction sont conservées si la connexion est réutilisée. La donnée précédemment utilisée est donc retournée à moins que celle-ci ne soit écrasée en interne entre temps.

Rechercher une fonction PHP

Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.curl-getinfo.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : http://php.net

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut