Informationen zu einem bestimmten Transfer abfragen

Beschreibung

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

Gibt Informationen über den letzen Transfer zurück.

Parameter-Liste

ch

Ein von curl_init() zurückgegebenes cURL-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 Upload-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"

Changelog

Version	Beschreibung
5.1.3	Konstante `CURLINFO_HEADER_OUT` eingeführt.

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);
?>