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

PHP CURL參考手冊(cè)

(PHP 4 >= 4.0.4, PHP 5)

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

語(yǔ)法

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

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

參數(shù)

ch

由 curl_init() 返回的 CURL 句柄。

opt

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

• CURLINFO_EFFECTIVE_URL - 最后一個(gè)有效的URL地址

• CURLINFO_HTTP_CODE - 最后一個(gè)收到的HTTP代碼

• CURLINFO_FILETIME - 遠(yuǎn)程獲取文檔的時(shí)間，如果無(wú)法獲取，則返回值為"-1"

• CURLINFO_TOTAL_TIME - 最后一次傳輸所消耗的時(shí)間

• CURLINFO_NAMELOOKUP_TIME - 名稱(chēng)解析所消耗的時(shí)間

• CURLINFO_CONNECT_TIME - 建立連接所消耗的時(shí)間

• CURLINFO_PRETRANSFER_TIME - 從建立連接到準(zhǔn)備傳輸所使用的時(shí)間

• CURLINFO_STARTTRANSFER_TIME - 從建立連接到傳輸開(kāi)始所使用的時(shí)間

• CURLINFO_REDIRECT_TIME - 在事務(wù)傳輸開(kāi)始前重定向所使用的時(shí)間

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

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

• CURLINFO_SPEED_DOWNLOAD - 平均下載速度

• CURLINFO_SPEED_UPLOAD - 平均上傳速度

• CURLINFO_HEADER_SIZE - header部分的大小

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

• CURLINFO_REQUEST_SIZE - 在HTTP請(qǐng)求中有問(wèn)題的請(qǐng)求的大小

• CURLINFO_SSL_VERIFYRESULT - 通過(guò)設(shè)置CURLOPT_SSL_VERIFYPEER返回的SSL證書(shū)驗(yàn)證請(qǐng)求的結(jié)果

• CURLINFO_CONTENT_LENGTH_DOWNLOAD - 從Content-Length: field中讀取的下載內(nèi)容長(zhǎng)度

• CURLINFO_CONTENT_LENGTH_UPLOAD - 上傳內(nèi)容大小的說(shuō)明

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

返回值

如果 opt 被設(shè)置，以字符串形式返回它的值。否則，返回返回一個(gè)包含下列元素的關(guān)聯(lián)數(shù)組(它們分別對(duì)應(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)建一個(gè)CURL句柄
$ch = curl_init('/');
// 執(zhí)行
curl_exec($ch);
// 檢查是否有錯(cuò)誤發(fā)生
if(!curl_errno($ch))
{
 $info = curl_getinfo($ch);
 echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url'];
}
//關(guān)閉句柄
curl_close($ch);
?>

PHP CURL參考手冊(cè)