= 4.0.4, PHP 5, PHP 7, PHP 8)curl_getinfo — 獲取一個cURL連接資源句柄的信息說明curl_getinfo(resource $ch, int $opt = 0): mixed獲取最后一次傳輸?shù)南嚓P(guān)信息。 參數(shù)han">

curl_getinfo

(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)

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

說明

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

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

參數(shù)

handle

由 curl_init() 返回的 cURL 句柄。

opt

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

  • CURLINFO_EFFECTIVE_URL - 最后一個有效的URL地址
  • CURLINFO_HTTP_CODE - 最后一個收到的HTTP代碼
  • CURLINFO_FILETIME - 遠(yuǎn)程獲取文檔的時間，如果無法獲取，則返回值為“-1”
  • CURLINFO_TOTAL_TIME - 最后一次傳輸所消耗的時間
  • CURLINFO_NAMELOOKUP_TIME - 名稱解析所消耗的時間
  • CURLINFO_CONNECT_TIME - 建立連接所消耗的時間
  • CURLINFO_PRETRANSFER_TIME - 從建立連接到準(zhǔn)備傳輸所使用的時間
  • CURLINFO_STARTTRANSFER_TIME - 從建立連接到傳輸開始所使用的時間
  • CURLINFO_REDIRECT_TIME - 在事務(wù)傳輸開始前重定向所使用的時間
  • CURLINFO_SIZE_UPLOAD - 以字節(jié)為單位返回上傳數(shù)據(jù)量的總值
  • CURLINFO_SIZE_DOWNLOAD - 以字節(jié)為單位返回下載數(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"

更新日志

版本 說明
5.1.3 引入CURLINFO_HEADER_OUT.

范例

示例 #1 curl_getinfo() example

<?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);
?>

注釋

注意:

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.