PHP curl_getinfo函數 · W3School PHP 參考手冊

# PHP curl_getinfo函數 (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" ## 更新日志 | 版本 | 說明 | | --- | --- | | 5.1.3 | 引入**`CURLINFO_HEADER_OUT`**. | ## 實例 ``` <?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); ?> ```