curl_getinfo
(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"
更新日志
版本 說明 5.1.3 引入CURLINFO_HEADER_OUT
.
范例
Example #1 curl_getinfo() example
// 創(chuàng)建一個cURL句柄
$ch = curl_init('http://www.yahoo.com/');
// 執(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'];
}
// Close handle
curl_close($ch);
?>
注釋
Note:
Information gathered by this function is kept if the handle is re-used. This means that unless a statistic is overridden internally by this function, the previous info is returned.