《PHP》使用curl访问资源

简介

PHP 支持 Daniel Stenberg 创建的 libcurl 库，能够连接通讯各种服务器、使用各种协议。

libcurl 目前支持的协议有 http、https、ftp、gopher、telnet、dict、file、ldap。

libcurl 同时支持 HTTPS 证书、HTTP POST、HTTP PUT、 FTP 上传(也能通过 PHP 的 FTP 扩展完成)、HTTP 基于表单的上传、代理、cookies、用户名+密码的认证。

一个最简样例

// 初始化新的 cURL 会话
$ch = curl_init('http://www.baidu.com/');
// 执行 cURL 会话
curl_exec($ch);
// 关闭 cURL 会话
curl_close($ch);

curl_init

初始化新的会话

curl_init ([ string $url = NULL ] ) : resource

• url

  如果提供了该参数，CURLOPT_URL 选项将会被设置成这个值。你也可以使用 curl_setopt() 函数手动地设置这个值。

初始化新的会话，成功则返回 cURL 句柄，出错则返回 FALSE。

curl_exec

执行会话

curl_exec ( resource $ch ) : mixed

• ch

  由 curl_init() 返回的 cURL 句柄。

执行给定的 cURL 会话。成功时返回 TRUE， 或者在失败时返回 FALSE。 然而，如果 设置了 CURLOPT_RETURNTRANSFER 选项，函数执行成功时会返回执行的结果，失败时返回 FALSE 。

这个函数应该在初始化一个 cURL 会话并且全部的选项都被设置后被调用。

curl_close

结束会话

curl_close ( resource $ch ) : void

• ch

  由 curl_init() 返回的 cURL 句柄。

关闭 cURL 会话并且释放所有资源。cURL 句柄 ch 也会被删除。

没有返回值。

curl_reset

重置会话

curl_reset ( resource $ch ) : void

• ch

  由 curl_init() 返回的 cURL 句柄。

该函数将给定的 cURL 句柄所有选项重新设置为默认值，跟使用 curl_init() 创建的一样。在一次请求中需要发起多次 cURL 会话时可以用此函数重置会话，以减少会话创建的次数。

没有返回值。

curl_errno

返回最后一次的错误号

curl_errno ( resource $ch ) : int

• ch

  由 curl_init() 返回的 cURL 句柄。

返回最近一次 cURL 操作的错误号；或在没有错误发生时返回 0 (零)。

curl_error

返回最后一次的错误描述

curl_error ( resource $ch ) : string

• ch

  由 curl_init() 返回的 cURL 句柄。

返回最近一次 cURL 操作的文本错误详情；或者如果没有任何错误发生就返回 ‘’ (空字符串)

curl_copy_handle

复制一个cURL句柄和它的所有选项

curl_copy_handle ( resource $ch ) : resource

• ch
  由 curl_init() 返回的 cURL 句柄。

复制一个cURL句柄并保持相同的选项。

返回一个新的 cURL 句柄。

curl_setopt

设置一个cURL传输选项

curl_setopt ( resource $ch , int $option , mixed $value ) : bool

• ch

  由 curl_init() 返回的 cURL 句柄。

• option

  需要设置的 CURLOPT_XXX 选项。

• value

  将设置在 option 选项上的值。

为 cURL 会话句柄设置选项。成功时返回 TRUE， 或者在失败时返回 FALSE。

以下为常用的一些选项（更多选项参见官网）

请求相关的选项

响应相关的选项

超时时间相关的选项

SSL认证服务端相关的选项

linux 上 openssl 库的默认证书文件 default_cert_file 和默认证书目录 default_cert_dir 下的证书，可以验证常用的服务器证书。

在 windows 上没有通用 CA 包，或者在 linux 上需要验证其他特殊证书时，通过除了可以通过 CURLOPT_CAINFO 和 CURLOPT_CAPATH 进行指定，还可以通过修改 php.ini 来设置

openssl.cafile
openssl.capath
curl.cainfo

如果你不需要特殊的证书包，可以使用Mozilla提供的通用CA包，你可以在 这里 下载(由cURL的维护者提供)。

如果要使用 CURLOPT_CAPATH 选项，应该为创建的所有有效证书创建一个目录，然后使用 openssl 附带的 c_rehash 脚本“准备”该目录。
如果不使用 c_rehash 程序，curl将忽略您设置的目录中的任何文件。
c_rehash 命令貌似只有 linux 上安装 openssl-perl 后可以使用

SSL认证客户端相关的选项

HTTP相关的选项

curl_setopt_array

批量设置选项

curl_setopt_array ( resource $ch , array $options ) : bool

• ch

  由 curl_init() 返回的 cURL 句柄。

• options

  一个 array 用来确定将被设置的选项及其值。数组的键值必须是一个有效的 curl_setopt() 常量或者是它们对等的整数值。

为 cURL 传输会话批量设置选项。这个函数对于需要设置大量的 cURL 选项是非常有用的，不需要重复地调用 curl_setopt()。

如果全部的选项都被成功设置，返回 TRUE。如果一个选项不能被成功设置，马上返回 FALSE，忽略其后的任何在 options 数组中的选项。

curl_getinfo

获取最后一次传输的相关信息

curl_getinfo ( resource $ch [, int $opt = 0 ] ) : mixed

• ch

  由 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”

curl_version

获取 cURL 的版本信息

curl_version ([ int $age = CURLVERSION_NOW ] ) : array

• age 官方文档没有说明，未知

返回一个关于 cURL 版本的信息的关联数组，包含如下元素：