PHP Dokumentation: Function curl-getinfo
12. Januar 2010 von werner
curl_getinfo
(PHP 4 >= 4.0.4, PHP 5)
curl_getinfo — Informationen zu einem bestimmten Transfer abfragen
Beschreibung
Gibt Informationen über den letzen Transfer zurück.
Parameter-Liste
- ch
Ein von curl_init() zurückgegebenescURL-Handle.
- opt
Eine der folgenden Konstanten:
- CURLINFO_EFFECTIVE_URL – Letzter effektiver URL
- CURLINFO_HTTP_CODE – Zuletzt empfangener HTTP-Code
- CURLINFO_FILETIME – Übertragungszeit für das empfangene Dokument; wenn -1 zurückgegeben wird ist die Zeit unbekannt
- CURLINFO_TOTAL_TIME – Gesamtdauer des letzten Transfers in Sekunden
- CURLINFO_NAMELOOKUP_TIME – Zeit in Sekunden zur Auflösung des Hostnamens
- CURLINFO_CONNECT_TIME – Dauer des Verbindungsaufbaus in Sekunden
- CURLINFO_PRETRANSFER_TIME – Zeit in Sekunden zwischen dem Start und dem eigentlichen Beginn des Empfangs
- CURLINFO_STARTTRANSFER_TIME – Zeit in Sekunden bis zur Übertragung des ersten Bytes
- CURLINFO_REDIRECT_TIME – Zeit in Sekunden, die von allen Umleitungsschritten beansprucht wird, bevor der eigentliche Transfer beginnt
- CURLINFO_SIZE_UPLOAD – Anzahl der gesendeten Bytes
- CURLINFO_SIZE_DOWNLOAD – Anzahl der empfangenen Bytes
- CURLINFO_SPEED_DOWNLOAD – Durchschnittliche Download-Geschwindigkeit
- CURLINFO_SPEED_UPLOAD – Durchschnittliche Upwnload-Geschwindigkeit
- CURLINFO_HEADER_SIZE – Gesamtgröße aller empfangenen Header
- CURLINFO_HEADER_OUT – Der gesendete Request. Verfügbar seit PHP 5.1.3
- CURLINFO_REQUEST_SIZE – Gesamtgröße aller Abfragen, momentan nur für HTTP verfügbar
- CURLINFO_SSL_VERIFYRESULT – Ergebnis der SSL-Zertifikat-Überprüfung, angefordert durch das Setzen von CURLOPT_SSL_VERIFYPEER
- CURLINFO_CONTENT_LENGTH_DOWNLOAD – Die Größe des Downloads, ermittelt aus dem Content-Length-Header
- CURLINFO_CONTENT_LENGTH_UPLOAD – Festgesetzte Größe des Uploads
- CURLINFO_CONTENT_TYPE – Der Content-Type des geladenen Objekts, ermittelt aus dem empfangenen Content-Type-Header. Ein Rückgabewert NULL bedeutet, daß der Server einen ungültigen Header gesendet hat
Rückgabewerte
Wird der Parameter opt angegeben, wird der entsprechende Wert als string zurückgegeben. Andernfalls liefert die Funktion ein assoziatives Array mit den folgenden Elementen zurück (analog dem Parameter 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"
Beispiele
Beispiel #1 curl_getinfo()-Beispiel
<?php
// Eine cURL-Resource erstellen
$ch = curl_init('http://www.yahoo.com/');// ausführen
curl_exec($ch);// prüfen, ob ein Fehler aufgetreten ist
if(!curl_errno($ch))
{
$info = curl_getinfo($ch); echo
'Es wurden ' . $info['total_time'] . ' Sekunden benötigt für einen Request an ' . $info['url'];
}// Resource schliessen
curl_close($ch);
?>