curl_getinfo 获取一个cURL连接资源句柄的信息
发表日期：2021-07-01 08:56:36 | 来源： | | 浏览(920) 分类：cURL 函数
curl_getinfo
(PHP 4 >= 4.0.4, PHP 5, PHP 7, PHP 8)
curl_getinfo — 获取一个cURL连接资源句柄的信息
说明
curl_getinfo(resource
$ch, int $opt = 0): mixed获取最后一次传输的相关信息。
参数
-
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 handlecurl_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.
- PHP（0）
- PHP杂项（34）
- PHP基础-李炎恢系列课程（20）
- 中文函数手册（0）
- 错误处理 函数（13）
- OPcache 函数（6）
- PHP 选项/信息 函数（54）
- Zip 函数（10）
- Hash 函数（15）
- OpenSSL 函数（63）
- Date/Time 函数（51）
- 目录函数（9）
- Fileinfo 函数（6）
- iconv 函数（11）
- 文件系统函数（81）
- 多字节字符串 函数（57）
- GD 和图像处理 函数（114）
- 可交换图像信息（5）
- Math 函数（50）
- 程序执行函数（11）
- PCNTL 函数（23）
- JSON 函数（4）
- SPL 函数（15）
- URL 函数（10）
- cURL 函数（32）
- curl_close 关闭 cURL 会话（0）
- curl_copy_handle 复制一个cURL句柄和它的所有选项（0）
- curl_errno 返回最后一次的错误代码（0）
- curl_error 返回当前会话最后一次错误的字符串（0）
- curl_escape 使用 URL 编码给定的字符串（0）
- curl_exec 执行 cURL 会话（0）
- curl_file_create 创建一个 CURLFile 对象（0）
- curl_getinfo 获取一个cURL连接资源句柄的信息（0）
- curl_init 初始化 cURL 会话（0）
- curl_multi_add_handle 向curl批处理会话中添加单独的curl句柄（0）
- curl_multi_close 关闭一组cURL句柄（0）
- curl_multi_errno 返回上一次 curl 批处理的错误码（0）
- curl_multi_exec 运行当前 cURL 句柄的子连接（0）
- curl_multi_getcontent 如果设置了CURLOPT_RETURNTRANSFER，则返回获取的输出的文本流（0）
- curl_multi_info_read 获取当前解析的cURL的相关传输信息（0）
- curl_multi_init 返回一个新cURL批处理句柄（0）
- curl_multi_remove_handle 移除cURL批处理句柄资源中的某个句柄资源（0）
- curl_multi_select 等待所有cURL批处理中的活动连接（0）
- curl_multi_setopt 为 cURL 并行处理设置一个选项（0）
- curl_multi_strerror 返回字符串描述的错误代码（0）
- curl_pause 暂停和取消暂停一个连接。（0）
- curl_reset 重置一个 libcurl 会话句柄的所有的选项（0）
- curl_setopt_array 为 cURL 传输会话批量设置选项（0）
- curl_setopt 设置 cURL 传输选项（0）
- curl_share_close 关闭 cURL 共享句柄（0）
- curl_share_errno 返回共享 curl 句柄的最后一次错误号（0）
- curl_share_init 初始化一个 cURL 共享句柄。（0）
- curl_share_setopt 为 cURL 共享句柄设置选项。（0）
- curl_share_strerror 返回错误号对应的错误消息（0）
- curl_strerror 返回错误代码的字符串描述（0）
- curl_unescape 解码给定的 URL 编码的字符串（0）
- curl_version 获取 cURL 版本信息（0）
- 网络 函数（33）
- FTP 函数（36）
- Session 函数（23）
- PCRE 函数（11）
- PCRE 正则语法（19）
- 数组 函数（81）
- 类/对象 函数（18）
- 函数处理 函数（13）
- 变量处理 函数（37）
- SimpleXML 函数（3）
- 杂项 函数（31）
- 字符串 函数（101）
宁公网安备 64010402001209号