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恰恰提供了对这些功能的支持。

开启方法：

1. 拷贝PHP目录中的libeay32.dll 和 ssleay32.dll 两个文件到 C:windowssystem32 目录。
2. 修改php.ini。去掉 extension = php_curl.dll 前面的分号。
3. 重启Apache服务
4. 查看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值了；还可以实现上传文件的功能等等。