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 防注入函数(格式化数据)
Aug 08 PHP
微博短链接算法php版本实现代码
Sep 15 PHP
PHP中判断变量为空的几种方法小结
Nov 12 PHP
php实现文件下载(支持中文文名)
Dec 04 PHP
php上传图片到指定位置路径保存到数据库的具体实现
Dec 30 PHP
PHP学习笔记之字符串编码的转换和判断
May 22 PHP
PHP小教程之实现双向链表
Jun 12 PHP
图文详解PHP环境搭建教程
Jul 16 PHP
PHP的Json中文处理解决方案
Sep 29 PHP
php基于自定义函数记录log日志方法
Jul 21 PHP
php格式文件打开的四种方法
Feb 24 PHP
解决laravel(5.5)访问public报错的问题
Oct 12 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
1 Tube Radio
2021/03/02 无线电
Thinkphp和Bootstrap结合打造个性的分页样式(推荐)
2016/08/01 PHP
php使用fullcalendar日历插件详解
2019/03/06 PHP
php利用ZipArchive类操作文件的实例
2020/01/21 PHP
JavaScript 笔记二 Array和Date对象方法
2010/05/22 Javascript
Jqyery中同等与js中windows.onload的应用
2011/05/10 Javascript
javascript:window.open弹出窗口的位置问题
2014/03/18 Javascript
JS根据浏览器窗口大小实时动态改变网页文字大小的方法
2016/02/25 Javascript
浅谈JS中的三种字符串连接方式及其性能比较
2016/09/02 Javascript
AngularJS日程表案例详解
2017/08/15 Javascript
vue axios请求频繁时取消上一次请求的方法
2018/11/10 Javascript
了解前端理论:rscss和rsjs
2019/05/23 Javascript
微信小程序返回上一级页面的实现代码
2020/06/19 Javascript
python解析html开发库pyquery使用方法
2014/02/07 Python
用python 制作图片转pdf工具
2015/01/30 Python
python单例模式实例分析
2015/04/08 Python
python getopt详解及简单实例
2016/12/30 Python
老生常谈python函数参数的区别(必看篇)
2017/05/29 Python
基于Python的关键字监控及告警
2017/07/06 Python
Python 获得命令行参数的方法(推荐)
2018/01/24 Python
一份python入门应该看的学习资料
2018/04/11 Python
Python终端输出彩色字符方法详解
2020/02/11 Python
Python环境下安装PyGame和PyOpenGL的方法
2020/03/25 Python
Python实现GIF图倒放
2020/07/16 Python
sublime3之内网安装python插件Anaconda的流程
2020/11/10 Python
Python 数据分析之逐块读取文本的实现
2020/12/14 Python
python热力图实现简单方法
2021/01/29 Python
土木工程毕业生推荐信
2013/10/28 职场文书
小学生检讨书大全
2014/02/06 职场文书
项目合作意向书模板
2014/07/29 职场文书
大学生自我评价200字(4篇)
2014/09/17 职场文书
财政局个人总结
2015/03/04 职场文书
学校后勤工作总结2015
2015/05/15 职场文书
Nginx Rewrite使用场景及配置方法解析
2021/04/01 Servers
SQL 聚合、分组和排序
2021/11/11 MySQL
docker 制作mysql镜像并自动安装
2022/05/20 Servers