2、cURL

Client URL 库

介绍

PHP 支持 Daniel Stenberg 创建的 libcurl 库，能够连接通讯各种服务器、使用各种协议。libcurl 目前支持的协议有 http、https、ftp、gopher、telnet、dict、file、ldap。 libcurl 同时支持 HTTPS 证书、HTTP POST、HTTP PUT、 FTP 上传(也能通过 PHP 的 FTP 扩展完成)、HTTP 基于表单的上传、代理、cookies、用户名+密码的认证。

安装

需要安装 » libcurl 包才能使用 PHP 的 cURL 函数

编译时 必须加上 --with-curl[=DIR] 选项，DIR 为包含 lib 和 include 的目录路径。在 include 目录中必须有一个名为curl，包含了easy.h 和curl.h 的文件夹。lib文件夹里应该有一个名为libcurl.a的文件

运行时配置

CURLOPT_CAINFO 说明：
一个文件的名称，该文件包含一个或多个用于验证对等的证书。这只有在与CURLOPT_SSL_VERIFYPEER 结合使用时才有意义。

预定义常量

具体常量查看php手册

基础案例

使用 cURL 函数的基本流程：

先使用 curl_init() 初始化 cURL会话，接着可以通过 curl_setopt() 设置需要的全部选项，然后使用 curl_exec() 来执行会话，当执行完会话后使用 curl_close() 关闭会话。

如下是使用 cURL 函数获取 example.com 主页保存到文件的例子：

<?php

$ch = curl_init("http://www.example.com/");
$fp = fopen("example_homepage.txt", "w");

curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);

curl_exec($ch);
curl_close($ch);
fclose($fp);

cURL 函数

• curl_close — 关闭 cURL 会话
• curl_copy_handle — 复制一个cURL句柄和它的所有选项
• curl_errno — 返回最后一次的错误代码
• curl_error — 返回当前会话最后一次错误的字符串
• curl_escape — 使用 URL 编码给定的字符串
• curl_exec — 执行 cURL 会话
• curl_file_create — 创建一个 CURLFile 对象
• curl_getinfo — 获取一个cURL连接资源句柄的信息
• curl_init — 初始化 cURL 会话
• curl_multi_add_handle — 向curl批处理会话中添加单独的curl句柄
• curl_multi_close — 关闭一组cURL句柄
• curl_multi_errno — 返回上一次 curl 批处理的错误码
• curl_multi_exec — 运行当前 cURL 句柄的子连接
• curl_multi_getcontent — 如果设置了CURLOPT_RETURNTRANSFER，则返回获取的输出的文本流
• curl_multi_info_read — 获取当前解析的cURL的相关传输信息
• curl_multi_init — 返回一个新cURL批处理句柄
• curl_multi_remove_handle — 移除cURL批处理句柄资源中的某个句柄资源
• curl_multi_select — 等待所有cURL批处理中的活动连接
• curl_multi_setopt — 为 cURL 并行处理设置一个选项
• curl_multi_strerror — 返回字符串描述的错误代码
• curl_pause — 暂停和取消暂停一个连接。
• curl_reset — 重置一个 libcurl 会话句柄的所有的选项
• curl_setopt_array — 为 cURL 传输会话批量设置选项
• curl_setopt — 设置 cURL 传输选项
• curl_share_close — 关闭 cURL 共享句柄
• curl_share_errno — 返回共享 curl 句柄的最后一次错误号
• curl_share_init — 初始化一个 cURL 共享句柄。
• curl_share_setopt — 为 cURL 共享句柄设置选项。
• curl_share_strerror — 返回错误号对应的错误消息
• curl_strerror — 返回错误代码的字符串描述
• curl_unescape — 解码给定的 URL 编码的字符串
• curl_version — 获取 cURL 版本信息