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

返回上一级

PHP 5 函数参考手册

关于   |   FAQ   |   我们的愿景   |   广告投放   |  博客

  简单教程,简单编程 - IT 入门首选站

Copyright © 2013-2018 简单教程 twle.cn All Rights Reserved.