PHP 5 cURL 函数参考手册
PHP 支持由 Daniel Stenberg 创建的 libcurl 库
libcurl 允许我们与各种的服务器使用各种类型的协议进行连接和通讯
libcurl 目前支持 http、https、ftp、gopher、telnet、dict、file和ldap协议
libcurl 同时也支持 HTTPS 认证、HTTP POST、HTTP PUT、 FTP 上传(这个也能通过PHP的FTP扩展完成)、HTTP 基于表单的上传、代理、cookies 和 用户名+密码的认证
PHP 使用 cURL 实现 GET 和 POST 请求的方法
需求
为了使用 PHP 的 cURL 函数,我们需要安装 » libcurl 包
PHP 需要使用 libcurl 7.0.2-beta 或者更高版本
PHP 4.2.3 使用 cURL, 需要安装 7.9.0 或更高版本的 libcurl
PHP 4.3.0 开始,我们需要安装 7.9.0 或更高版本的 libcurl
PHP 5.0.0 开始,我们需要安装 7.10.5 或更高版本的 libcurl
安装
要使用 PHP 的 cURL 扩展,我们必须在编译 PHP 时加上 --with-curl[=DIR] 选项
DIR为包含 lib 和 include 的目录路径
include 目录中必须有一个名为 curl,包含了 easy.h 和 curl.h 的文件夹
lib 文件夹里应该有一个名为 libcurl.a 的文件
PHP 4.3.0 可以配置 --with-curlwrappers 使 cURL 使用 URL 流
注意
Win32 用户注意 要在 Windows 环境下使用这个模块,libeay32.dll 和 ssleay32.dll 必须放到 PATH 环境变量包含的目录下
不用 cURL 网站上的 libcurl.dll
资源类型
PHP cURL 扩展定义了 2 种资源:cURL 句柄和 cURL 批处理句柄
PHP 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_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_init() | 初始化cURL共享句柄 |
curl_share_setopt() | 设置一个共享句柄的cURL传输选项 |
curl_strerror() | 返回错误代码的字符串描述 |
curl_unescape() | 解码URL编码后的字符串 |
curl_version() | 获取cURL版本信息 |