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值了;还可以实现上传文件的功能等等。