PHP curl_getinfo() 函數(shù)用法及示例

PHP CURL參考手冊

(PHP 4 >= 4.0.4, PHP 5)

curl_getinfo — 獲取一個CURL連接資源句柄的信息

語法

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

獲取最后一次傳輸?shù)南嚓P信息。

參數(shù)

ch

由 curl_init() 返回的 CURL 句柄。

opt

這個參數(shù)可能是以下常量之一:

• CURLINFO_EFFECTIVE_URL - 最后一個有效的URL地址

• CURLINFO_HTTP_CODE - 最后一個收到的HTTP代碼

• CURLINFO_FILETIME - 遠程獲取文檔的時間，如果無法獲取，則返回值為"-1"

• CURLINFO_TOTAL_TIME - 最后一次傳輸所消耗的時間

• CURLINFO_NAMELOOKUP_TIME - 名稱解析所消耗的時間

• CURLINFO_CONNECT_TIME - 建立連接所消耗的時間

• CURLINFO_PRETRANSFER_TIME - 從建立連接到準備傳輸所使用的時間

• CURLINFO_STARTTRANSFER_TIME - 從建立連接到傳輸開始所使用的時間

• CURLINFO_REDIRECT_TIME - 在事務傳輸開始前重定向所使用的時間

• CURLINFO_SIZE_UPLOAD - 上傳數(shù)據(jù)量的總值

• CURLINFO_SIZE_DOWNLOAD - 下載數(shù)據(jù)量的總值

• CURLINFO_SPEED_DOWNLOAD - 平均下載速度

• CURLINFO_SPEED_UPLOAD - 平均上傳速度

• CURLINFO_HEADER_SIZE - header部分的大小

• CURLINFO_HEADER_OUT - 發(fā)送請求的字符串

• CURLINFO_REQUEST_SIZE - 在HTTP請求中有問題的請求的大小

• CURLINFO_SSL_VERIFYRESULT - 通過設置CURLOPT_SSL_VERIFYPEER返回的SSL證書驗證請求的結果

• CURLINFO_CONTENT_LENGTH_DOWNLOAD - 從Content-Length: field中讀取的下載內容長度

• CURLINFO_CONTENT_LENGTH_UPLOAD - 上傳內容大小的說明

• CURLINFO_CONTENT_TYPE - 下載內容的Content-Type:值，NULL表示服務器沒有發(fā)送有效的Content-Type: header

返回值

如果 opt 被設置，以字符串形式返回它的值。否則，返回返回一個包含下列元素的關聯(lián)數(shù)組(它們分別對應于 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"

更新日志

在線示例

<?php
// 創(chuàng)建一個CURL句柄
$ch = curl_init('/');
// 執(zhí)行
curl_exec($ch);
// 檢查是否有錯誤發(fā)生
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);
 echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url'];
}
//關閉句柄
curl_close($ch);
?>

PHP CURL參考手冊