php中的curl使用入门教程和常见用法实例


Posted in PHP onApril 10, 2014

一、curl的优势

你也许会说,在php中可以很容易的获取某个url的内容,只要通过file_get_contents,file或者readfile函数就能轻松实现,根本不必使用cURL:

        $content = file_get_contents("http://www.360weboy.com");
        $lines = file("http://www.360weboy.com");
        readfile("http://www.360weboy.com");

没错,以上函数在某些情况下使用起来确实很方便,但是我感觉这几个函数不够灵活,也没法进行错误处理。而且,如果遇到要在php程序中向某个服务器提交表单数据,上传文件,处理cookies或者认证等任务时,以上三个函数根本无法胜任。这个时候,cURL就体现它的价值了。

cURl不但支持很多的网络协议,而且提供了关于url请求的具体信息,很强大!

二、curl的简单使用步骤

要使用cURL来发送url请求,具体步骤大体分为以下四步:

1.初始化
2.设置请求选项
3.执行一个cURL会话并且获取相关回复
4.释放cURL句柄,关闭一个cURL会话

    
        // 1. 初始化一个cURL会话
        $ch = curl_init();        // 2. 设置请求选项, 包括具体的url
        curl_setopt($ch, CURLOPT_URL, "http://www.360weboy.com");
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        // 3. 执行一个cURL会话并且获取相关回复
        $response = curl_exec($ch);
        // 4. 释放cURL句柄,关闭一个cURL会话
        curl_close($ch);
   
cURL之所以强大,正是体现在第二个步骤中。你可以通过curl_setopt灵活地设置请求选项,这里面有很多的可选项,具体可以参考http://cn2.php.net/manual/zh/function.curl-setopt.php

三、错误处理

在上述代码中,你也可以增加错误处理的代码:

        $response = curl_exec($ch);

        if ($response  === FALSE) {
          echo "cURL 具体出错信息: " . curl_error($ch);
        }
   
注意了,在做上述判断时务必要使用===,因为请求的回复可能是空字符串,curl在请求出错的情况下回返回FALSE值,所以我们必须使用===,而不是==。

四、获取curl请求的具体信息

在执行一个cURL请求后,你也可以使用curl_getinfo获取该请求的具体信息:

        curl_exec($ch);
        $curl_info= curl_getinfo($ch);
        echo "收到的http回复的code为: {$curl_info['http_code']}";
   
上述$curl_info是一个关联数组,可以从中获取很多的具体请求信息。参考http://cn2.php.net/manual/zh/function.curl-getinfo.php

五、使用curl发送post请求

我们在前面说过,在向某个url发送get请求的话,没有必要使用cURL来发送get请求,可以使用比较便捷的file_get_contents函数来完成请求。但是,一般地,我们在提交某个表单的时候,数据是通过post请求的内容区域来提交的,而不是通过url参数来传递的, 这种情况下,我们应该使用灵活的cURL来模拟发送post请求。

现在,让我们使用cURL来模拟发送一个post请求到post.php脚本,提交几个数据到post.php,然后在post.php中输出post请求中的数据。示例代码如下:

       $url = "http://www.360weboy.me/post.php";

        $post_data = array (
          "blog_name" => "360weboy",
          "blog_url" => "http://www.360weboy.com",
          "action" => "Submit"
        );
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // 设置请求为post类型
        curl_setopt($ch, CURLOPT_POST, 1);
        // 添加post数据到请求中
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
        // 执行post请求,获得回复
        $response= curl_exec($ch);
        curl_close($ch);
        echo $response;
 
  
以上请求发送到post.php中后,通过print_r($_POST)输出后,以上示例代码会输出如下回复:
        Array
        (
            [blog_name] => 360weboy
            [blog_url] => http://www.360weboy.com
            [action] => Submit
        )
   
正如我们看到的,cURL成功发送post请求到post.php,提交了一些数据,并且收到了相应的来自post.php的回复,最后输出回复。上例虽然简单,但是充分演示了cURL发送post请求的便捷及强大之处,你可以在curl_setopt上做文章。

六、文件上传

下面来看下如果通过cURL发送post请求来实现文件上传。就拿深入浅出PHP下的文件上传中的文件上传例子来演示,在深入浅出php下的文件上传中,是通过表单的提交来实现文件上传的,那么通过cURL怎么来实现呢?

 

   
       $url = "http://www.360weboy.me/upload.php";
        $post_data = array (
          "attachment" => "@E:/jackblog/boy.jpg"
        );
        //初始化cURL会话
        $ch = curl_init();
        //设置请求的url
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        //设置为post请求类型
        curl_setopt($ch, CURLOPT_POST, 1);
        //设置具体的post数据
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
        $response = curl_exec($ch);
        curl_close($ch);
        print_r($response);
   
通过以上示例代码,可以将我本地机器上的boy.jpg上传到本地服务器的upload.php中,如果在upload.php输出上传的具体信息的话,以上示例代码最后的输出的回复为:
    
        Array
        (
            [attachment] => Array
                (
                    [name] => boy.jpg
                    [type] => application/octet-stream
                    [tmp_name] => D:\xampp\tmp\phpF27D.tmp
                    [error] => 0
                    [size] => 11490
                )        )
 
  
由此可见,如果你要通过cURL来上传文件的话,只需要将上传的文件路径作为post数据设置到curl请求中,并且在路径前面加上@符合。

七、文件下载

上述将了文件上传,同样的也可以使用curl来自动地完成文件的下载以及保存。有一点要补充下,在执行一个curl请求时,如果你需要获取返回的内容,而不是直接输出返回的内容的话,别忘记使用下面的代码设置,因为curl的默认是输出请求的回复内容:

        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
   

假如在360weboy的服务器根目录下面有一个test.zip文件,我们需要将其下载下来,并且保存到本地文件中,就可以尝试使用下面的代码来实现:
        //设置请求的下载文件的url
        $url  = 'http://www.360weboy.com/test.zip';
        //保存到本地的文件路径
        $path = 'local/path/to/test.zip';
        //初始化请求,设置请求,获取回复,关闭会话
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $data = curl_exec($ch);
        curl_close($ch);
        //将文件内容写入本地文件
        file_put_contents($path, $data);
   
注意:我以上省略了错误处理方面的代码,只是简单做个示例, 在实际中,你还需要通过curl_getinfo函数来进行错误处理!

上述代码对于下载比较大型的文件是不适用的,因为需要先将文件读取到内存中,等所有内容都读取完毕,然后再写入到本地硬盘中。即使php中设置的memory limit非常大,这种情况对性能的影响也是很大的。所以,我们对于大型文件的下载,应该让curl来接管这个任务,实现边下载,边写入的处理,这样的话,就没什么问题了。请看下述代码:

        $url  = 'http://www.360weboy.com/test.zip';
        $path = 'local/path/to/test.zip';
        // 打开本地文件
        $fp = fopen($path, 'w');
        // 告诉curl本地文件句柄
        $ch = curl_init($url);
        curl_setopt($ch, CURLOPT_FILE, $fp);
        curl_exec($ch);
        curl_close($ch);
        fclose($fp);
   
在上述代码中,我们先打开个本地文件,并将文件句柄设置到curl中,然后让curl一边读取远程数据,一边写入到本地文件中。因为我们不需要在程序中获取远程回复的内容了,所以只要执行请求就可以。

八、http 验证

如果服务器端需要验证请求,可以通过类似一下示例代码来实现:

        $url = "http://www.360weboy.com/users/";
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // 设置用户名以及密码
        curl_setopt($ch, CURLOPT_USERPWD, "username:password");
        // 设置重导向
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($ch, CURLOPT_UNRESTRICTED_AUTH, 1);
        $response = curl_exec($ch);
        curl_close($ch);
   
九、通过代理发送请求

cURL还可以通过代理服务器来向发送请求,请看一下示例代码:
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL,'http://www.360weboy.com');
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // 设置代理ip地址
        curl_setopt($ch, CURLOPT_PROXY, '222.73.173.50:8080');
        // 要验证的话,这里设置用户名以及密码
        curl_setopt($ch, CURLOPT_PROXYUSERPWD,'username:password');
        $response = curl_exec($ch);
        curl_close ($ch);
  
十、发送json数据

最后,我们来看下通过cURL来想服务器端发送json数据。具体的代码如下:

 

   
        $url = 'http://www.360weboy.me/json.php';        // 建立json字符串
        $data = array('site' => '360weboy', 'url' => 'http://www.360weboy.com','email'=>'360weboy@gmail.com');
        $json_string = json_encode($data);
        $ch=curl_init($url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        // 通过post请求发送上述json字符串
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
        curl_setopt($ch, CURLOPT_POSTFIELDS, array('data'=>$json_string));
        $response = curl_exec($ch);
        curl_close($ch);
        echo $response;
 
 
大家可以看到,上述请求是发送到我的本地服务器的json.php下,我在该文件中使用json_decode来将接受到的json字符串转换为对象,然后输出其中的email字段,代码如下:
        $json_data = json_decode($_POST['data']);

        echo $json_data->email;
   
在上述代码中接受的json字符串为:
        '{"site":"360weboy","url":"http:\/\/www.360weboy.com","email":"360weboy@gmail.com"}'
   
经过json_decode以后,就转换为php中的数据格式,成为了一个对象,所以可以通过$json_data->email来访问其中email字段的值,最后也就是输出360weboy@gmail.com。你可以使用上述代码测试一下。

如果通过以下php数组生成json字符串的话:

        $data = array('360weboy', 'http://www.360weboy.com', '360weboy@gmail.com');
   
所生成的json字符串如下:
        '["360weboy","http:\/\/www.360weboy.com","360weboy@gmail.com"]'
   
上述json字符串在经过json_decode处理后,就会变成php中的数组格式,如果要获取email的话,就可以通过$json_data[2]来访问。

十一、总结

在这篇博文中只是列举了一些cURL的用途,其中示例代码是比较简单的。但是,相信你看完后应该有使用cURL的冲动了吧! 那就自己去找相关资料,手册进行测试吧!

好了,就写到这里吧!谢谢你的耐心阅读!

PHP 相关文章推荐
php入门小知识
Mar 24 PHP
超级好用的一个php上传图片类(随机名,缩略图,加水印)
Jun 30 PHP
Win下如何安装PHP的APC拓展
Aug 07 PHP
php常用的url处理函数总结
Nov 19 PHP
PHP中让curl支持sock5的代码实例
Jan 21 PHP
PHP和C#可共用的可逆加密算法详解
Oct 26 PHP
浅谈PHP的exec()函数无返回值排查方法(必看)
Mar 31 PHP
php脚本守护进程原理与实现方法详解
Jul 20 PHP
CakePHP框架Model关联对象用法分析
Aug 04 PHP
yii2 开发api接口时优雅的处理全局异常的方法
May 14 PHP
Mac下关于PHP环境和扩展的安装详解
Oct 17 PHP
PHP常用函数之获取汉字首字母功能示例
Oct 21 PHP
免费手机号码归属地API查询接口和PHP使用实例分享
Apr 10 #PHP
PHP快速按行读取CSV大文件的封装类分享(也适用于其它超大文本文件)
Apr 10 #PHP
php实现批量下载百度云盘文件例子分享
Apr 10 #PHP
PHP图片等比缩放类SimpleImage使用方法和使用实例分享
Apr 10 #PHP
PHP按行读取、处理较大CSV文件的代码实例
Apr 09 #PHP
PHP二维数组排序的3种方法和自定义函数分享
Apr 09 #PHP
php计算几分钟前、几小时前、几天前的几个函数、类分享
Apr 09 #PHP
You might like
php 服务器调试 Zend Debugger 的安装教程
2009/09/25 PHP
PHP 数据结构队列(SplQueue)和优先队列(SplPriorityQueue)简单使用实例
2015/05/12 PHP
Thinkphp5行为使用方法汇总
2017/12/21 PHP
jQuery中使用Ajax获取JSON格式数据示例代码
2013/11/26 Javascript
jQuery使用andSelf()来包含之前的选择集
2014/05/19 Javascript
JavaScript DOM节点添加示例
2014/07/16 Javascript
jQuery结合CSS制作漂亮的select下拉菜单
2015/05/03 Javascript
6种javascript显示当前系统时间代码
2015/12/01 Javascript
简单介绍jsonp 使用小结
2016/01/27 Javascript
基于JavaScript实现的插入排序算法分析
2017/04/14 Javascript
关于foreach循环中遇到的问题小结
2017/05/08 Javascript
简述Angular 5 快速入门
2017/11/04 Javascript
简单了解TypeScript中如何继承 Error 类
2019/06/21 Javascript
JavaScript实现单英文金山打字通
2020/07/24 Javascript
基于纯JS实现多张图片的懒加载Lazy过程解析
2019/10/14 Javascript
vue v-on:click传递动态参数的步骤
2020/09/11 Javascript
jquery实现淡入淡出轮播图效果
2020/12/13 jQuery
[02:02:38]VG vs Mineski Supermajor 败者组 BO3 第一场 6.6
2018/06/07 DOTA
Python的Django框架下管理站点的基本方法
2015/07/17 Python
用Python将动态GIF图片倒放播放的方法
2016/11/02 Python
浅谈pycharm出现卡顿的解决方法
2018/12/03 Python
详解从Django Rest Framework响应中删除空字段
2019/01/11 Python
通过python连接Linux命令行代码实例
2020/02/18 Python
Pycharm安装并配置jupyter notebook的实现
2020/05/18 Python
详解selenium + chromedriver 被反爬的解决方法
2020/10/28 Python
详解Pytorch显存动态分配规律探索
2020/11/17 Python
Html5实现单张、多张图片上传功能
2019/04/28 HTML / CSS
英国汽车座椅和婴儿车购物网站:Uber Kids
2017/04/19 全球购物
室内设计专业个人的自我评价
2013/10/19 职场文书
给交警的表扬信
2014/01/12 职场文书
会计出纳员的自我评价
2014/01/15 职场文书
餐饮投资计划书
2014/04/25 职场文书
好人好事演讲稿
2014/09/01 职场文书
车间安全生产管理制度
2015/08/06 职场文书
2019年度行政文员工作计划范本!
2019/07/04 职场文书
vue代码分块和懒加载非必要资源文件
2022/04/11 Vue.js