PHP curl_getinfo-Funktion
(PHP 4 >= 4.0.4, PHP 5)
curl_getinfo — Informationen über ein cURL-Verbindungsressourcen-Handle abrufen
Beschreibung
mixed curl_getinfo ( resource $ch [, int $opt = 0 ] )
Ruft Informationen über die letzte Übertragung ab.
Parameters
ch
Das von curl_init() zurückgegebene cURL-Handle.
opt
Dieser Parameter kann eine der folgenden Konstanten sein:
- CURLINFO_EFFECTIVE_URL- Die letzte gültige URL-Adresse
- CURLINFO_HTTP_CODE- Der zuletzt empfangene HTTP-Code
- CURLINFO_FILETIME- Zeit zum Abrufen des entfernten Dokuments; gibt "-1" zurück, wenn es nicht abgerufen werden kann
- CURLINFO_TOTAL_TIME- Von der letzten Übertragung benötigte Zeit
- CURLINFO_NAMELOOKUP_TIME- Für die Namensauflösung benötigte Zeit
- CURLINFO_CONNECT_TIME- Für den Verbindungsaufbau benötigte Zeit
- CURLINFO_PRETRANSFER_TIME- Zeit vom Verbindungsaufbau bis zur Vorbereitung der Übertragung
- CURLINFO_STARTTRANSFER_TIME- Zeit vom Verbindungsaufbau bis zum Start der Übertragung
- CURLINFO_REDIRECT_TIME- Zeit für Weiterleitungen, bevor die Übertragung beginnt
- CURLINFO_SIZE_UPLOAD- Gesamtmenge der hochgeladenen Daten
- CURLINFO_SIZE_DOWNLOAD- Gesamtmenge der heruntergeladenen Daten
- CURLINFO_SPEED_DOWNLOAD- Durchschnittliche Download-Geschwindigkeit
- CURLINFO_SPEED_UPLOAD- Durchschnittliche Upload-Geschwindigkeit
- CURLINFO_HEADER_SIZE- Größe des Header-Teils
- CURLINFO_HEADER_OUT- Die Zeichenkette der gesendeten Anfrage
- CURLINFO_REQUEST_SIZE- Größe der problematischen Anfrage in der HTTP-Anfrage
- CURLINFO_SSL_VERIFYRESULT- Durch Setzen vonCURLOPT_SSL_VERIFYPEER- Das Ergebnis der zurückgegebenen SSL-Zertifikatsüberprüfungsanfrage
- CURLINFO_CONTENT_LENGTH_DOWNLOAD- AusContent-Length:- Download-Inhaltslänge, gelesen aus dem Feld
- CURLINFO_CONTENT_LENGTH_UPLOAD- Beschreibung der Upload-Inhaltsgröße
- CURLINFO_CONTENT_TYPE- DerContent-Type:-Wert des heruntergeladenen Inhalts; NULL gibt an, dass der Server keinen gültigenContent-Type: -Header gesendet hat
Rückgabewerte
Wenn opt gesetzt ist, wird sein Wert als String zurückgegeben. Andernfalls wird ein assoziatives Array zurückgegeben, das die folgenden Elemente enthält (die jeweils opt entsprechen):
- "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"
Änderungsprotokoll
| Version | Beschreibung |
|---|---|
| 5.1.3 | EingeführtCURLINFO_HEADER_OUT.
|
Beispiele
<?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);
?>
Andere Erweiterungen
PHP cURL-Referenzhandbuch