PHP curl_getinfo函數

PHP curl_getinfo函數

PHP cURL參考手冊

(PHP 4 >= 4.0.4, PHP 5)

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

說明

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

獲取最後一次傳輸的相關信息。

參數

ch

由curl_init() 返回的cURL 句柄。

opt

這個參數可能是以下常量之一:

• 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 -上傳數據量的總值
• CURLINFO_SIZE_DOWNLOAD -下載數據量的總值
• CURLINFO_SPEED_DOWNLOAD -平均下載速度
• CURLINFO_SPEED_UPLOAD -平均上傳速度
• CURLINFO_HEADER_SIZE - header部分的大小
• CURLINFO_HEADER_OUT -發送請求的字符串
• 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表示服務器沒有發送有效的Content-Type: header

返回值

如果opt 被設置，以字符串形式返回它的值。 否則，返回返回一個包含下列元素的關聯數組(它們分別對應於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
// 创建一个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 cURL參考手冊