PHP cURL模块
简介：
cURL是利用URL语法在命令行方式下工作的文件传输工具，目前苹果机器已经内置了cURL。cURL是一个综合性的传输工具，对HTTP、FTP等协议提供了广泛的支持，它甚至可以实现迅雷、快车等下载工具的所有功能。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：
一般读取文件（URL）的方法是使用PHP内置的一些读文件函数，比如file_get_contents，file等（参见文章《PHP读取文件的常见方法》）；但是这些方法都只能进行简单的文件读取，不能实现复杂的功能：向URL POST数据、使用代理服务器、读取使用SSL协议的URL、URL登陆认证等。而cURL恰恰提供了对这些功能的支持。
开启方法：
- 拷贝PHP目录中的libeay32.dll 和 ssleay32.dll 两个文件到 C:\windows\system32 目录。
- 修改php.ini。去掉 extension = php_curl.dll 前面的分号。
- 重启Apache服务
- 查看phpinfo，可以看到curl已开启
建立cURL请求的基本步骤：
1. 初始化
使用curl_init方法初始化一个cURL句柄
$ch = curl_init(“http://www.example.com/”);
curl_init方法提供了一个可选参数URL，返回一个cURL句柄供curl_setopt(), curl_exec()和curl_close() 函数使用。
如果在curl_init中没有指定URL，则需要在curl_setopt中手工设置这个值，如果指定了URL，则CURLOPT_URL被自动设成这个值。
2. 设置变量
使用curl_setopt方法设置一个cURL传输参数，或者使用curl_setopt_array批量设置一组参数。
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_HEADER, 0);
其中$ch为curl_init初始化时返回的cURL句柄。
3. 执行并获取结果
使用curl_exec执行一个cURL会话，成功时返回 TRUE， 或者在失败时返回 FALSE. 然而，如果 CURLOPT_RETURNTRANSFER选项被设置，函数执行成功时会返回执行的结果，失败时返回 FALSE 。
curl_exec($ch);
还可以使用curl_getinfo获取一个cURL会话的信息。
curl_getinfo($info);
curl_getinfo返回的数组中包括如下信息：
- “url” //资源网络地址
- “content_type” //内容编码
- “http_code” //HTTP状态码
- “header_size” //header的大小
- “request_size” //请求的大小
- “filetime” //文件创建时间
- “ssl_verify_result” //SSL验证结果
- “redirect_count” //跳转技术
- “total_time” //总耗时
- “namelookup_time” //DNS查询耗时
- “connect_time” //等待连接耗时
- “pretransfer_time” //传输前准备耗时
- “size_upload” //上传数据的大小
- “size_download” //下载数据的大小
- “speed_download” //下载速度
- “speed_upload” //上传速度
- “download_content_length”//下载内容的长度
- “upload_content_length” //上传内容的长度
- “starttransfer_time” //开始传输的时间
- “redirect_time”//重定向耗时
4. 关闭cURL会话
使用curl_close关闭cURL会话，并释放所有资源（包括cURL句柄$ch等）。
curl_close($ch);
一个完整的例子如下：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<?php
// 1. 初始化
$ch
= curl_init(
"http://www.baidu.com"
);
// 2. 设置选项
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
//将curl_exec()获取的信息以文件流的形式返回，而不是直接输出，如果没有设置CURLOPT_RETURNTRANSFER，curl_exec($ch)将直接输出返回内容。
// 3. 执行会话并获取内容
$output
= curl_exec(
$ch
);
//或者使用curl_multi_getcontent()获取会话返回的内容
echo
$output
;
$info
= curl_getinfo(
$ch
);
print_r(
$info
);
// 4. 关闭curl会话
curl_close(
$ch
);
?>
|
当然我们还可以使用curl_error来获取会话的错误信息。
|
1
2
|
if
(
$output
=== false)
//注意是三个等号，表示检查返回值是boolean类型，如果是两个等号，返回值为空字符串也会被认为是false
echo
'cURL error:'
.curl_error(
$ch
);
|
例如，我们直接访问支付宝的首页，由于支付宝首页基于SSL协议，直接访问会提示证书错误：
|
1
2
|
cURL error:SSL certificate problem, verify that the CA cert is OK. Details:
error:14090086:SSL routines:SSL3_GET_SERVER_CERTIFICATE:certificate verify failed
|
使用代理服务器
|
1
2
3
4
5
6
7
8
9
10
|
<?php
// 1. 初始化
$ch
= curl_init(
"http://www.baidu.com"
);
// 2. 设置代理服务器
curl_setopt(
$ch
, CURLOPT_PROXY,
'127.0.0.1:8888'
);
// 3. 执行会话
curl_exec(
$ch
);
// 4. 关闭curl会话
curl_close(
$ch
);
?>
|
向URL POST数据
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<?php
//POST数据
$curlPost
=
array
(
'name'
=>
'myname'
,
'pwd'
=>
'mypassword'
);
//或者 $curlPost = 'name=myname&pwd=mypassword';
//初始化
$ch
= curl_init(
"http://localhost/SP/getpost.php"
);
//设置
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
curl_setopt(
$ch
, CURLOPT_POST, 1);
//设施post方式提交数据
curl_setopt(
$ch
, CURLOPT_POSTFIELDS,
$curlPost
);
//设置POST的数据
//执行会话并获取内容
$output
= curl_exec(
$ch
);
echo
$output
;
//关闭curl会话
curl_close(
$ch
);
?>
|
使用浏览器用户代理
|
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<?php
// 1. 初始化
$ch
= curl_init(
"http://www.baidu.com"
);
// 2. 设置
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
//设置User-Agent为iPhone下的Safafi
curl_setopt(
$ch
, CURLOPT_USERAGENT,
'Mozilla/5.0 (iPhone; U; CPU like Mac OS X; en) AppleWebKit/420+ (KHTML, like Gecko) Version/3.0 Mobile/1A537a Safari/419.'
);
// 3. 执行会话并获取内容
$output
= curl_exec(
$ch
);
echo
$output
;
// 4. 释放curl句柄
curl_close(
$ch
);
?>
|
访问SSL协议的URL
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
<?php
// 1. 初始化
$ch
= curl_init(
"https://www.alipay.com"
);
// 2. 设置
curl_setopt(
$ch
, CURLOPT_RETURNTRANSFER, 1);
curl_setopt(
$ch
, CURLOPT_SSL_VERIFYPEER, false);
//使用服务器端验证
curl_setopt(
$ch
, CURLOPT_USERPWD,
"myusername:mypassword"
);
//设置登录用户名和密码
curl_setopt(
$ch
, CURLOPT_FOLLOWLOCATION, 1);
//允许服务器端重定向
// 3. 执行会话并获取内容
$output
= curl_exec(
$ch
);
echo
$output
;
// 4. 释放curl句柄
curl_close(
$ch
);
?>
|
cURL还有很多其他的实际用途，比如检查你博客的友情链接是否都有效，这里就需要用到curl_getinfo()函数返回的http_code值了；还可以实现上传文件的功能等等。