PHP curl_getinfo 函数
PHP curl_getinfo() 函数用于获取一个 cURL 连接资源句柄的信息
(PHP 4 >= 4.0.4, PHP 5, PHP 7 )
函数原型
mixed curl_getinfo ( resource $ch [, int $opt = 0 ] )
获取最后一次传输的相关信息
参数说明
| 参数 | 说明 |
|---|---|
| ch | 由 curl_init() 返回的 cURL 句柄 |
| opt | 想要获取的传输的指定信息 |
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"
范例
<?php // 创建一个cURL句柄 $ch = curl_init('https://www.twle.cn/'); // 执行 curl_exec($ch); // 检查是否有错误发生 if(!curl_errno($ch)) { $info = curl_getinfo($ch); echo 'Took ' . $info['total_time'] . ' seconds to send a request to ' . $info['url']; } curl_close($ch);
更新日志
| PHP 版本 | 说明 |
|---|---|
| 5.1.3 | 引入 CURLINFO_HEADER_OUT |