php中curl的参数详解

引言

在php中最常用来发起http请求的莫过于curl，但是发现自己在工作中如果有需要用到curl的时候，都是直接从网上抄一段代码拿来用，而且curl的参数实在是太多，看上去让人感觉眼花缭乱，自己好像从来没有认真的去研究过每一个参数的用途，故在这篇博文中稍作整理，并配上相关的案例。

CURLOPT_RETURNTRANSFER

关于CURLOPT_RETURNTRANSFER，php文档中的概念是：

将curl_exec()获取的信息以文件流的形式返回，而不是直接输出

关于curl_exec()的返回值，php文档中的定义是：

成功时返回 TRUE， 或者在失败时返回 FALSE。 然而，如果 CURLOPT_RETURNTRANSFER选项被设置，函数执行成功时会返回执行的结果，失败时返回 FALSE 。

以一个实际案例来帮助大家理解：

<?php
//index.php
function curl_get($url){
     $ch = curl_init();
     curl_setopt($ch, CURLOPT_URL, $url);
     // curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
     $output = curl_exec($ch);
     var_dump($output);
     die();
     curl_close($ch);
     return $output;
}
curl_get("http://localhost/curl/d.php");

<?php
//d.php
exit(json_encode(
    array(
        'status' => 'ok',
        'name' => 'ben'
    )
));

当index.php中的curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1)处于注释状态时，访问结果是：

当index.php中的curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1)没有处于注释状态时，访问结果是：

从两次访问结果对比来看，可以看出，

当设置了CURLOPT_RETURNTRANSFER值时，请求接口的结果不直接输出，而是变成了curl_exec方法的返回值；
当没有设置CURLOPT_RETURNTRANSFER值时，请求接口的结果直接输出，curl_exec方法的返回值是true或者false；

CURLOPT_FOLLOWLOCATION、CURLOPT_MAXREDIRS、CURLOPT_HEADER

各位是否请求过出现302或者是301跳转的接口呢？比如下面的一个例子：

<?php
//c.php
header("location:http://localhost/curl/d.php");
exit();

<?php //index.php function curl_get($url){ $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($ch); // var_dump($output); // die(); curl_close($ch); return $output; } // curl_get("http://localhost/curl/d.php"); var_dump(curl_get("http://localhost/curl/c.php")); exit();

其中d.php文件内容与上例相同，此处不再赘述。
这时访问结果是：string ” (length=0)
发生了什么呢？我们可以加上curl_setopt($ch, CURLOPT_HEADER, 1)之后再次访问，结果是：

HTTP/1.1 302 Found

Date: Tue, 24 Nov 2015 15:01:09 GMT

Server: Apache/2.4.9 (Win32) PHP/5.5.12

X-Powered-By: PHP/5.5.12

location: http://localhost/curl/d.php

Content-Length: 0 Content-Type: text/html 

可以看到302跳转之后，接口的返回值抓取不到了，这时怎么办呢？可以使用CURLOPT_FOLLOWLOCATION，关于CURLOPT_FOLLOWLOCATION，文档中的描述是：

启用时会将服务器服务器返回的”Location: “放在header中递归的返回给服务器，使用CURLOPT_MAXREDIRS可以限定递归返回的数量。

加上之后再次访问，结果是：

{"status":"ok","name":"ben"}

这里有个待解决的疑问是CURLOPT_FOLLOWLOCATION究竟会递归几次呢？笔者测试递归六次依旧能获取接口返回值，难道默认没有递归限制会一直递归下去吗？如果有知道的读者希望不吝赐教。
CURLOPT_MAXREDIRS参数用来限定递归返回的数量，注意如果该值设定小于接口实际递归的次数的话，接口将会返回false。

未完待续。。。。