Fonction PHP curl_getinfo
(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);
?>
Autres extensions
Manuel de référence PHP cURL