Php/docs/function.curl-getinfo
来自菜鸟教程
curl_getinfo
(PHP 4 >= 4.0.4, PHP 5, PHP 7)
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 .
|
范例
Example #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 handlecurl_close($ch);?>
注释
Note:
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.