PHP curl_getinfo-Funktion

PHP Calendar 参考手册PHP cURL-Referenzhandbuch

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

PHP Calendar 参考手册PHP cURL-Referenzhandbuch

Andere Erweiterungen