php中的curl使用入门教程和常见用法实例-阿里云开发者社区

[目录]
php中的curl使用入门教程和常见用法实例
一、curl的优势
二、curl的简单使用步骤
三、错误处理
四、获取curl请求的具体信息
五、使用curl发送post请求
六、文件上传
七、文件下载
八、http 验证
九、通过代理发送请求
十、发送json数据
十一、cURL批处理（multi cURL）
十二、总结
        
          
        
        
        
          
          AI 代码解读

起先cURL是做为一种命令行工具设计出来的，比较幸运的是，php也支持cURL了。通过cURL这个利器，我们能在php程序中自由地发送 HTTP请求到某个url来获取或者提交数据，并且支持其它多种协议，比如FTP，Telnet以及SMTP等。在这篇博文中，我将简述下，在php中具体怎么使用cURL来处理一些事情。

一、curl的优势

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

$content = file_get_contents("http://www.52fhy.com");
$lines = file("http://www.52fhy.com");
readfile("http://www.52fhy.com");
        
          
        
        
        
          
          AI 代码解读

没错，以上函数在某些情况下使用起来确实很方便，但是我感觉这几个函数不够灵活，也没法进行错误处理。而且，如果遇到要在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.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

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);
}
        
          
        
        
        
          
          AI 代码解读

注意了，在做上述判断时务必要使用===，因为请求的回复可能是空字符串，curl在请求出错的情况下回返回FALSE值，所以我们必须使用===，而不是==。

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

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

curl_exec($ch);
$curl_info= curl_getinfo($ch);

echo "收到的http回复的code为： {$curl_info['http_code']}";
        
          
        
        
        
          
          AI 代码解读

上述$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.52fhy.me/post.php";

$post_data = array (
  "blog_name" => "52fhy",
  "blog_url" => "http://www.52fhy.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;
        
          
        
        
        
          
          AI 代码解读

以上请求发送到post.php中后，通过print_r($_POST)输出后，以上示例代码会输出如下回复：

Array
(
    [blog_name] => 52fhy
    [blog_url] => http://www.52fhy.com
    [action] => Submit
)
        
          
        
        
        
          
          AI 代码解读

正如我们看到的，cURL成功发送post请求到post.php，提交了一些数据，并且收到了相应的来自post.php的回复，最后输出回复。上例虽然简单，但是充分演示了cURL发送post请求的便捷及强大之处，你可以在curl_setopt上做文章。

六、文件上传

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

$url = "http://www.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

通过以上示例代码，可以将我本地机器上的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
        )

)
        
          
        
        
        
          
          AI 代码解读

由此可见，如果你要通过cURL来上传文件的话，只需要将上传的文件路径作为post数据设置到curl请求中，并且在路径前面加上@符合。

七、文件下载

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

curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        
          
        
        
        
          
          AI 代码解读

假如在52fhy的服务器根目录下面有一个test.zip文件，我们需要将其下载下来，并且保存到本地文件中，就可以尝试使用下面的代码来实现：

//设置请求的下载文件的url
$url  = 'http://www.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

注意：我以上省略了错误处理方面的代码，只是简单做个示例, 在实际中，你还需要通过curl_getinfo函数来进行错误处理!

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

$url  = 'http://www.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

在上述代码中，我们先打开个本地文件，并将文件句柄设置到curl中，然后让curl一边读取远程数据，一边写入到本地文件中。因为我们不需要在程序中获取远程回复的内容了，所以只要执行请求就可以。

八、http 验证

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

$url = "http://www.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

九、通过代理发送请求

cURL还可以通过代理服务器来向发送请求，请看一下示例代码:

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,'http://www.52fhy.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);
        
          
        
        
        
          
          AI 代码解读

十、发送json数据

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

$url = 'http://www.52fhy.me/json.php';

// 建立json字符串
$data = array('site' => '52fhy', 'url' => 'http://www.52fhy.com','email'=>'52fhy@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;
        
          
        
        
        
          
          AI 代码解读

大家可以看到，上述请求是发送到我的本地服务器的json.php下，我在该文件中使用json_decode来将接受到的json字符串转换为对象，然后输出其中的email字段，代码如下:

$json_data = json_decode($_POST['data']);

echo $json_data->email;
        
          
        
        
        
          
          AI 代码解读

在上述代码中接受的json字符串为:

'{"site":"52fhy","url":"http:\/\/www.52fhy.com","email":"52fhy@gmail.com"}'
        
          
        
        
        
          
          AI 代码解读

经过json_decode以后，就转换为php中的数据格式，成为了一个对象，所以可以通过$json_data->email来访问其中email字段的值，最后也就是输出52fhy@gmail.com。你可以使用上述代码测试一下。

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

$data = array('52fhy', 'http://www.52fhy.com', '52fhy@gmail.com');
        
          
        
        
        
          
          AI 代码解读

所生成的json字符串如下：

'["52fhy","http:\/\/www.52fhy.com","52fhy@gmail.com"]'
        
          
        
        
        
          
          AI 代码解读

上述json字符串在经过json_decode处理后，就会变成php中的数组格式，如果要获取email的话，就可以通过$json_data[2]来访问。

十一、cURL批处理（multi cURL）

cURL还有一个高级特性——批处理句柄（handle）。这一特性允许你同时或异步地打开多个URL连接。

下面是来自来自php.net的示例代码：

// 创建两个cURL资源
$ch1 = curl_init();
$ch2 = curl_init();
// 指定URL和适当的参数
curl_setopt($ch1, CURLOPT_URL, "http://lxr.php.net/");
curl_setopt($ch1, CURLOPT_HEADER, 0);
curl_setopt($ch2, CURLOPT_URL, "http://www.php.net/");
curl_setopt($ch2, CURLOPT_HEADER, 0);
// 创建cURL批处理句柄
$mh = curl_multi_init();
// 加上前面两个资源句柄
curl_multi_add_handle($mh,$ch1);
curl_multi_add_handle($mh,$ch2);
// 预定义一个状态变量
$active = null;
// 执行批处理
do {
    $mrc = curl_multi_exec($mh, $active);
} while ($mrc == CURLM_CALL_MULTI_PERFORM);
while ($active && $mrc == CURLM_OK) {
    if (curl_multi_select($mh) != -1) {
        do {
            $mrc = curl_multi_exec($mh, $active);
        } while ($mrc == CURLM_CALL_MULTI_PERFORM);
    }
}
// 关闭各个句柄
curl_multi_remove_handle($mh, $ch1);
curl_multi_remove_handle($mh, $ch2);
curl_multi_close($mh);
        
          
        
        
        
          
          AI 代码解读

这里要做的就是打开多个cURL句柄并指派给一个批处理句柄。然后你就只需在一个while循环里等它执行完毕。

这个示例中有两个主要循环。第一个 do-while 循环重复调用 curl_multi_exec() 。这个函数是无隔断（non-blocking）的，但会尽可能少地执行。它返回一个状态值，只要这个值等于常量 CURLM_CALL_MULTI_PERFORM ，就代表还有一些刻不容缓的工作要做（例如，把对应URL的http头信息发送出去）。也就是说，我们需要不断调用该函数，直到返回值发生改变。

而接下来的 while 循环，只在 $active 变量为 true 时继续。这一变量之前作为第二个参数传给了 curl_multi_exec() ，代表只要批处理句柄中是否还有活动连接。接着，我们调用 curl_multi_select() ，在活动连接（例如接受服务器响应）出现之前，它都是被“屏蔽”的。这个函数成功执行后，我们又会进入另一个 do-while 循环，继续下一条URL。

十二、总结

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

好了，就写到这里吧！谢谢你的耐心阅读！

附：

<?php
/**
 * @require curl-extension
 */
class SimpleHttpClient {
    private static $boundary = '';
    
    public static function get($url, $params) {
        $url = $url . '?' . http_build_query($params);
        return self::http($url, 'GET');
    }

    public static function post($url, $params, $files = array()) {
        $headers = array();
        if (!$files) {
            $body = http_build_query($params);
        } else {
            $body = self::build_http_query_multi($params, $files);
            $headers[] = "Content-Type: multipart/form-data; boundary=" . self::$boundary;
        }
        return self::http($url, 'POST', $body, $headers);
    }

    /**
     * Make an HTTP request
     *
     * @return string API results
     * @ignore
     */
    private static function http($url, $method, $postfields = NULL, $headers = array()) {
        try{
            $ssl = stripos($url,'https://') === 0 ? true : false;
            $ci = curl_init();
            /* Curl settings */
            curl_setopt($ci, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); //在HTTP请求中包含一个"User-Agent: "头的字符串。    
            curl_setopt($ci, CURLOPT_CONNECTTIMEOUT, 30);
            curl_setopt($ci, CURLOPT_TIMEOUT, 30);
            curl_setopt($ci, CURLOPT_RETURNTRANSFER, TRUE);
            curl_setopt($ci, CURLOPT_ENCODING, "");
            if ($ssl) {
                curl_setopt($ci, CURLOPT_SSL_VERIFYPEER, 0); // 对认证证书来源的检查 
                curl_setopt($ci, CURLOPT_SSL_VERIFYHOST, 2); // 从证书中检查SSL加密算法是否存在
            }
            curl_setopt($ci, CURLOPT_HEADER, FALSE);
    
            switch ($method) {
                case 'POST':
                    curl_setopt($ci, CURLOPT_POST, TRUE);
                    if (!empty($postfields)) {
                        curl_setopt($ci, CURLOPT_POSTFIELDS, $postfields);
                    }
                    break;
            }
    
            curl_setopt($ci, CURLOPT_URL, $url );
            curl_setopt($ci, CURLOPT_HTTPHEADER, $headers );
            curl_setopt($ci, CURLINFO_HEADER_OUT, TRUE );
    
            $response = curl_exec($ci);
            $httpCode = curl_getinfo($ci, CURLINFO_HTTP_CODE);
            $httpInfo = curl_getinfo($ci);
            
            if (FALSE === $response)
                throw new Exception(curl_error($ci), curl_errno($ci));
        
        } catch(Exception $e) {
            throw $e;
        }
        
        //echo '<pre>';
        //var_dump($response);
        //var_dump($httpInfo);

        curl_close ($ci);
        return $response;
    }

    private static function build_http_query_multi($params, $files) {
        if (!$params) return '';

        $pairs = array();

        self::$boundary = $boundary = uniqid('------------------');
        $MPboundary = '--'.$boundary;
        $endMPboundary = $MPboundary. '--';
        $multipartbody = '';

        foreach ($params as $key => $value) {
            $multipartbody .= $MPboundary . "\r\n";
            $multipartbody .= 'content-disposition: form-data; name="' . $key . "\"\r\n\r\n";
            $multipartbody .= $value."\r\n";
        }
        foreach ($files as $key => $value) {
            if (!$value) {continue;}
            
            if (is_array($value)) {
                $url = $value['url'];
                if (isset($value['name'])) {
                    $filename = $value['name'];
                } else {
                    $parts = explode( '?', basename($value['url']));
                    $filename = $parts[0];
                }
                $field = isset($value['field']) ? $value['field'] : $key;
            } else {
                $url = $value;
                $parts = explode( '?', basename($url));
                $filename = $parts[0];
                $field = $key;
            }
            $content = file_get_contents($url);
        
            $multipartbody .= $MPboundary . "\r\n";
            $multipartbody .= 'Content-Disposition: form-data; name="' . $field . '"; filename="' . $filename . '"'. "\r\n";
            $multipartbody .= "Content-Type: image/unknown\r\n\r\n";
            $multipartbody .= $content. "\r\n";
        }

        $multipartbody .= $endMPboundary;
        return $multipartbody;
    }
}
        
          
        
        
        
          
          AI 代码解读

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

一、curl的优势

二、curl的简单使用步骤

三、错误处理

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

五、使用curl发送post请求

六、文件上传

七、文件下载

八、http 验证

九、通过代理发送请求

十、发送json数据

十一、cURL批处理（multi cURL）

十二、总结

热门文章

最新文章

相关课程

相关电子书

相关实验场景

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

开发者评测

高校计划

乘风者计划

训练营

直播

下载

镜像站

技术资料

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

一、curl的优势

二、curl的简单使用步骤

三、错误处理

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

五、使用curl发送post请求

六、文件上传

七、文件下载

八、http 验证

九、通过代理发送请求

十、发送json数据

十一、cURL批处理（multi cURL）

十二、总结

热门文章

最新文章

相关课程

相关电子书

相关实验场景