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(guān)信息。

參數(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 - 在事務(wù)傳輸開始前重定向所使用的時間
• 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 - 通過設(shè)置CURLOPT_SSL_VERIFYPEER返回的SSL證書驗證請求的結(jié)果
• CURLINFO_CONTENT_LENGTH_DOWNLOAD - 從Content-Length: field中讀取的下載內(nèi)容長度
• CURLINFO_CONTENT_LENGTH_UPLOAD - 上傳內(nèi)容大小的說明
• CURLINFO_CONTENT_TYPE - 下載內(nèi)容的Content-Type:值，NULL表示服務(wù)器沒有發(fā)送有效的Content-Type: header

返回值

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

PHP cURL參考手冊