Du bist hier: Tips » Scripte » PHP
PHP
Referenzliste

curl_getinfo

cURL Funktionen

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


    Parameter-Liste:
NameBeschreibung
chEin von curl_init() zurückgegebenes cURL-Handle.
optEine der folgenden Konstanten:
NameBeschreibung
CURLINFO_EFFECTIVE_URLLetzter effektiver URL
CURLINFO_HTTP_CODEZuletzt empfangener HTTP-Code
CURLINFO_FILETIMEÜbertragungszeit für das empfangene Dokument; wenn -1 zurückgegeben wird ist die Zeit unbekannt
CURLINFO_TOTAL_TIMEGesamtdauer des letzten Transfers in Sekunden
CURLINFO_NAMELOOKUP_TIMEZeit in Sekunden zur Auflösung des Hostnamens
CURLINFO_CONNECT_TIMEDauer des Verbindungsaufbaus in Sekunden
CURLINFO_PRETRANSFER_TIMEZeit 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_TIMEZeit in Sekunden, die von allen Umleitungsschritten beansprucht wird, bevor der eigentliche Transfer beginnt
CURLINFO_SIZE_UPLOADAnzahl der gesendeten Bytes
CURLINFO_SIZE_DOWNLOADAnzahl der empfangenen Bytes
CURLINFO_SPEED_DOWNLOADDurchschnittliche Download-Geschwindigkeit
CURLINFO_SPEED_UPLOADDurchschnittliche Upload-Geschwindigkeit
CURLINFO_HEADER_SIZEGesamtgröße aller empfangenen Header
CURLINFO_HEADER_OUTDer gesendete Request. Verfügbar seit PHP 5.1.3
CURLINFO_REQUEST_SIZEGesamtgröße aller Abfragen, momentan nur für HTTP verfügbar
CURLINFO_SSL_VERIFYRESULTErgebnis der SSL-Zertifikat-Überprüfung, angefordert durch das Setzen von CURLOPT_SSL_VERIFYPEER
CURLINFO_CONTENT_LENGTH_DOWNLOADDie Größe des Downloads, ermittelt aus dem Content-Length-Header
CURLINFO_CONTENT_LENGTH_UPLOADFestgesetzte Größe des Uploads
CURLINFO_CONTENT_TYPEDer 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"

    Beschreibung:
Gibt Informationen über den letzen Transfer zurück.


    Aktiv in Version:
(PHP 4 >= 4.0.4, PHP 5, PHP 7)

curl_getinfo() - Beispiel:


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

Beschreibung:
Version Beschreibung
5.1.3 Konstante CURLINFO_HEADER_OUT eingeführt.
cURL Funktionen