curl_getinfo

参数

handle

由 curl_init() 返回的 cURL 句柄。

option

这个参数可能是以下常量之一:

• CURLINFO_EFFECTIVE_URL——最后一个有效的 URL
• CURLINFO_HTTP_CODE——最后的响应代码。从 cURL 7.10.8 开始，这是 CURLINFO_RESPONSE_CODE 的旧别名
• CURLINFO_FILETIME——启用了 CURLOPT_FILETIME 后检索文档的远程时间；如果返回 -1，则文档的时间未知
• CURLINFO_TOTAL_TIME——最后一次传输的总事务时间（以秒为单位）
• CURLINFO_NAMELOOKUP_TIME——到名称解析完成所需的时间（以秒为单位）
• CURLINFO_CONNECT_TIME——建立连接所需的时间（以秒为单位）
• CURLINFO_PRETRANSFER_TIME——从开始到文件准备传输所需的时间（以秒为单位）
• CURLINFO_STARTTRANSFER_TIME——从开始到传输第一个字节所需的时间（以秒为单位）
• CURLINFO_REDIRECT_COUNT——启用 CURLOPT_FOLLOWLOCATION 选项的重定向次数
• CURLINFO_REDIRECT_TIME——在启用 CURLOPT_FOLLOWLOCATION 选项的情况下，最终事务开始之前所有重定向步骤的时间（以秒为单位）
• CURLINFO_REDIRECT_URL——禁用 CURLOPT_FOLLOWLOCATION 选项：重定向 URL 在上次事务中找到，接下来应该手动请求。在启用 CURLOPT_FOLLOWLOCATION 选项的情况下，此返回值为空。在这种情况下，重定向的 URL 可以在 CURLINFO_EFFECTIVE_URL 中获取
• CURLINFO_PRIMARY_IP——最近连接的 IP 地址
• CURLINFO_PRIMARY_PORT——最近一次连接的目标端口
• CURLINFO_LOCAL_IP——最近连接的本地（源）IP 地址
• CURLINFO_LOCAL_PORT——最近连接的本地（源）端口
• CURLINFO_SIZE_UPLOAD——以字节为单位返回上传数据量的总值
• CURLINFO_SIZE_DOWNLOAD——以字节为单位返回下载数据量的总值
• CURLINFO_SPEED_DOWNLOAD——平均下载速度
• CURLINFO_SPEED_UPLOAD——平均上传速度
• CURLINFO_HEADER_SIZE——检索到的所有 header 大小
• CURLINFO_HEADER_OUT——发送请求的字符串。为此，通过调用 curl_setopt() 将 CURLINFO_HEADER_OUT 选项添加到句柄
• CURLINFO_REFERER - The referrer header
• CURLINFO_REQUEST_SIZE——已发出请求的总大小，当前仅针对 HTTP 请求
• CURLINFO_RETRY_AFTER - The information from the Retry-After: header, or zero if there was no valid header.
• CURLINFO_SSL_VERIFYRESULT——通过设置 CURLOPT_SSL_VERIFYPEER 请求的 SSL 认证验证结果
• CURLINFO_CONTENT_LENGTH_DOWNLOAD——从 Content-Length: 字段中读取的下载内容长度
• CURLINFO_CONTENT_LENGTH_UPLOAD——上传指定大小
• CURLINFO_CONTENT_TYPE——Content-Type:所请求文档的类型。NULL 表示服务器没有发送有效的 Content-Type: header
• CURLINFO_PRIVATE——与此 cURL 句柄关联的私有数据，之前使用 curl_setopt() 的 CURLOPT_PRIVATE 选项设置
• CURLINFO_PROXY_ERROR - The detailed (SOCKS) proxy error code when the most recent transfer returned a CURLE_PROXY error. The returned value will be exactly one of the CURLPX_* values. The error code will be CURLPX_OK if no response code was available.
• CURLINFO_RESPONSE_CODE——最后的响应代码
• CURLINFO_HTTP_CONNECTCODE——CONNECT 响应代码
• CURLINFO_HTTPAUTH_AVAIL——位掩码表示先前响应可用的身份验证方法
• CURLINFO_PROXYAUTH_AVAIL——位掩码表示先前响应可用的代理身份验证方法
• CURLINFO_OS_ERRNO——来自连接失败的 Errno。该数字特定于 OS 和指定系统。
• CURLINFO_NUM_CONNECTS - curl 为实现先前的传输所必须创建的连接数
• CURLINFO_SSL_ENGINES——支持 OpenSSL 加密引擎
• CURLINFO_COOKIELIST——所有已知的 cookie
• CURLINFO_FTP_ENTRY_PATH——FTP 服务器中的入口路径
• CURLINFO_APPCONNECT_TIME——从开始到SSL/SSH 完成与远程主机的连接/握手所花费的时间（以秒为单位）
• CURLINFO_CERTINFO——TLS 证书链
• CURLINFO_CONDITION_UNMET——未满足时间条件的信息
• CURLINFO_RTSP_CLIENT_CSEQ——下一个 RTSP 客户端 CSeq
• CURLINFO_RTSP_CSEQ_RECV——最近检索到的 CSeq
• CURLINFO_RTSP_SERVER_CSEQ——下一个 RTSP 服务器端 CSeq
• CURLINFO_RTSP_SESSION_ID——RTSP 会话 ID
• CURLINFO_CONTENT_LENGTH_DOWNLOAD_T——下载的内容长度。此值从 Content-Length: 字段读取。如果大小未知则为 -1
• CURLINFO_CONTENT_LENGTH_UPLOAD_T——上传的指定大小。如果未知则为 -1
• CURLINFO_HTTP_VERSION - 返回最后一次 HTTP 连接中使用的版本。返回值将是定义的 CURL_HTTP_VERSION_* 常量之一，如果无法确定版本，则返回 0。
• CURLINFO_PROTOCOL - 在最后一个 HTTP 连接中使用的协议。返回值将会是 CURLPROTO_* 中的一个值
• CURLINFO_PROXY_SSL_VERIFYRESULT - 请求的证书验证结果（使用 CURLOPT_PROXY_SSL_VERIFYPEER 选项）。仅用于 HTTPS 代理
• CURLINFO_SCHEME - 最近连接使用的 URL 协议
• CURLINFO_SIZE_DOWNLOAD_T - 已下载的总字节数。此数值仅针对最新的传输，并且在每次新的传输时都将会重置
• CURLINFO_SIZE_UPLOAD_T——上传的总字节数
• CURLINFO_SPEED_DOWNLOAD_T - curl 测量的完整下载速度的平均值，以字节/秒为单位
• CURLINFO_SPEED_UPLOAD_T - curl 测量的完整上传速度的平均值，以字节/秒为单位
• CURLINFO_APPCONNECT_TIME_T - 从开始到与远程主机 SSL/SSH 连接/握手完成所经过的时间，以微秒为单位
• CURLINFO_CONNECT_TIME_T - 从开始到与远程主机（或代理）建立连接完成所经过的总时间，以微秒为单位
• CURLINFO_FILETIME_T - 检索的文档的远程时间（Unix 时间戳），是 CURLINFO_FILETIME 的替代值，允许具有 32 bit 变量的系统提取超出 32 bit 时间戳范围之外的日期
• CURLINFO_NAMELOOKUP_TIME_T——从开始到名称解析完成的时间（以微秒为单位）
• CURLINFO_PRETRANSFER_TIME_T - 从开始到文件传输即将开始的时间，以微秒为单位
• CURLINFO_REDIRECT_TIME_T - 在最终事务开始之前，所有重定向步骤（包括名称查找、连接、预传输和传输）所花费的总时间，以微秒为单位。
• CURLINFO_STARTTRANSFER_TIME_T——从开始到接收到第一个字节所花费的时间（以微秒为单位）
• CURLINFO_TOTAL_TIME_T——上次传输的总时间（以微秒为单位），包括名称解析、TCP 连接等。