curl_exec
Just a quick note: if you want to use curl_getinfo() with option CURLINFO_HEADER_OUT in order to debug your cURL request, you must add curl_setopt($handle, CURLINFO_HEADER_OUT, true); first while specifying the options.
curl_getinfo
(PHP 4 >= 4.0.4, PHP 5)
curl_getinfo — Lit les informations détaillant un transfert cURL
Description
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"
add a note
User Contributed Notescurl_getinfo
nemetral
17-Jun-2008 04:57
17-Jun-2008 04:57
luiheidsgoeroe at hotmail dot com
05-Feb-2008 12:02
05-Feb-2008 12:02
Keep in mind that for CURLOPT_RETURNTRANSFER it has to be set with curl_setopt() before execution:
This doesn't work:
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_exec($ch);
var_dump(curl_getinfo($ch,CURLINFO_HEADER_OUT));
?>
This works:
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLINFO_HEADER_OUT, true);
curl_exec($ch);
var_dump(curl_getinfo($ch,CURLINFO_HEADER_OUT));
?>
Mark Evers
17-Jan-2008 07:14
17-Jan-2008 07:14
There is a constant missing from that list. CURLINFO_REDIRECT_COUNT will give you the number of redirects it went through if CURLOPT_FOLLOWLOCATION was set.
ssttoo at hotmail dot com
06-Apr-2004 09:13
06-Apr-2004 09:13
Here are the response codes ready for pasting in an ini-style file. Can be used to provide more descriptive message, corresponding to 'http_code' index of the arrray returned by curl_getinfo().
These are taken from the W3 consortium HTTP/1.1: Status Code Definitions, found at
http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
[Informational 1xx]
100="Continue"
101="Switching Protocols"
[Successful 2xx]
200="OK"
201="Created"
202="Accepted"
203="Non-Authoritative Information"
204="No Content"
205="Reset Content"
206="Partial Content"
[Redirection 3xx]
300="Multiple Choices"
301="Moved Permanently"
302="Found"
303="See Other"
304="Not Modified"
305="Use Proxy"
306="(Unused)"
307="Temporary Redirect"
[Client Error 4xx]
400="Bad Request"
401="Unauthorized"
402="Payment Required"
403="Forbidden"
404="Not Found"
405="Method Not Allowed"
406="Not Acceptable"
407="Proxy Authentication Required"
408="Request Timeout"
409="Conflict"
410="Gone"
411="Length Required"
412="Precondition Failed"
413="Request Entity Too Large"
414="Request-URI Too Long"
415="Unsupported Media Type"
416="Requested Range Not Satisfiable"
417="Expectation Failed"
[Server Error 5xx]
500="Internal Server Error"
501="Not Implemented"
502="Bad Gateway"
503="Service Unavailable"
504="Gateway Timeout"
505="HTTP Version Not Supported"
And an example usage:
<?php
$ch = curl_init(); // create cURL handle (ch)
if (!$ch) {
die("Couldn't initialize a cURL handle");
}
// set some cURL options
$ret = curl_setopt($ch, CURLOPT_URL, "http://mail.yahoo.com");
$ret = curl_setopt($ch, CURLOPT_HEADER, 1);
$ret = curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
$ret = curl_setopt($ch, CURLOPT_RETURNTRANSFER, 0);
$ret = curl_setopt($ch, CURLOPT_TIMEOUT, 30);
// execute
$ret = curl_exec($ch);
if (empty($ret)) {
// some kind of an error happened
die(curl_error($ch));
curl_close($ch); // close cURL handler
} else {
$info = curl_getinfo($ch);
curl_close($ch); // close cURL handler
if (empty($info['http_code'])) {
die("No HTTP code was returned");
} else {
// load the HTTP codes
$http_codes = parse_ini_file("path/to/the/ini/file/I/pasted/above");
// echo results
echo "The server responded: <br />";
echo $info['http_code'] . " " . $http_codes[$info['http_code']];
}
}
?>
12-Sep-2002 11:02
You can get some documentation about what these values mean in the libcurl C API documentation here:
http://curl.haxx.se/libcurl/c/curl_easy_getinfo.html