Fonction PHP curl_getinfo

PHP Calendar 参考手册Manuel de référence PHP cURL

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — Obtenir des informations sur un descripteur de ressource de connexion cURL


Description

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

Obtient des informations sur le dernier transfert.


Parameters

ch

Le gestionnaire cURL retourné par curl_init().

opt

Ce paramètre peut être l'une des constantes suivantes :

  • CURLINFO_EFFECTIVE_URL- La dernière adresse URL valide
  • CURLINFO_HTTP_CODE- Le dernier code HTTP reçu
  • CURLINFO_FILETIME- Temps pour récupérer le document distant ; renvoie "-1" s'il ne peut pas être récupéré
  • CURLINFO_TOTAL_TIME- Temps consommé par le dernier transfert
  • CURLINFO_NAMELOOKUP_TIME- Temps consommé par la résolution de nom
  • CURLINFO_CONNECT_TIME- Temps consommé pour établir une connexion
  • CURLINFO_PRETRANSFER_TIME- Temps utilisé depuis l'établissement de la connexion jusqu'à la préparation du transfert
  • CURLINFO_STARTTRANSFER_TIME- Temps utilisé depuis l'établissement de la connexion jusqu'au démarrage du transfert
  • CURLINFO_REDIRECT_TIME- Temps utilisé pour les redirections avant le début du transfert
  • CURLINFO_SIZE_UPLOAD- Quantité totale de données téléversées
  • CURLINFO_SIZE_DOWNLOAD- Quantité totale de données téléchargées
  • CURLINFO_SPEED_DOWNLOAD- Vitesse de téléchargement moyenne
  • CURLINFO_SPEED_UPLOAD- Vitesse de téléversement moyenne
  • CURLINFO_HEADER_SIZE- Taille de la partie en-tête
  • CURLINFO_HEADER_OUT- La chaîne de la requête envoyée
  • CURLINFO_REQUEST_SIZE- Taille de la requête problématique dans la requête HTTP
  • CURLINFO_SSL_VERIFYRESULT- En définissantCURLOPT_SSL_VERIFYPEER- Le résultat de la requête de vérification du certificat SSL renvoyé
  • CURLINFO_CONTENT_LENGTH_DOWNLOAD- À partir deContent-Length:- Longueur du contenu téléchargé lue depuis le champ
  • CURLINFO_CONTENT_LENGTH_UPLOAD- Description de la taille du contenu téléversé
  • CURLINFO_CONTENT_TYPE- La valeurContent-Type:du contenu téléchargé ; NULL indique que le serveur n'a pas envoyé d'en-têteContent-Type: valide

Valeurs de retour

Si opt est défini, renvoie sa valeur sous forme de chaîne. Sinon, renvoie un tableau associatif contenant les éléments suivants (qui correspondent respectivement à 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"

Journal des modifications

Version Description
5.1.3 IntroduitCURLINFO_HEADER_OUT.

Exemples

<?php
// 创建一个cURL句柄
$ch = curl_init('http://www.yahoo.com/');

// 执行
curl_exec($ch);

// 检查是否有错误发生
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);

 echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url'];
}

// Close handle
curl_close($ch);
?>

PHP Calendar 参考手册Manuel de référence PHP cURL

Autres extensions