curl_getinfo
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — 獲取一個cURL連線資源控制代碼的資訊
參數
-
handle -
由 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"
更新日誌
| 版本 | 說明 |
|---|---|
| 5.1.3 |
引入CURLINFO_HEADER_OUT.
|
範例
示例 #1 curl_getinfo() example
<?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);
?>
註釋
注意:
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.