PHP使用curl发送post请求的注意事项

前几天在工作中遇到了一个需求，当用户点击了某个按钮以后，后台发起一个post请求到我这里，我接收传递过来的数据。一开始同事是用公司框架公共封装的httpRequest()方法进行发送的，代码如下：

function httpRequest($url, $post='', $timeOut=5){
    if(empty($url)){
        return;
    }
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
    if($post !='' && !empty($post)){
        curl_setopt($ch, CURLOPT_POST, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
        curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Content-Length: '.strlen($post)));
    }
    curl_setopt($ch, CURLOPT_TIMEOUT, $timeOut);
    $ret = curl_exec($ch);
    curl_close($ch);
    return $ret;
}

一开始我并没有留意传递过来的数据是application/json编码的json字符串，我在后台直接用接收application/x-www-form-urlencoded编码格式的数据方式来取传递过来的数据（就是直接用的$_POST方式获取的），结果当然没什么也没有取到了。后来，同事直接改了httpRequest()方法，直接传递application/x-www-form-urlencoded编码格式的数据过来，我这就没有做更改。

对于上面的问题，我一直纳闷当时为什么没有拿到传递过来的数据。

今天项目基本完工，研究了一下。

php中的curl()函数进行post请求的时候，传递数据的格式可以有以下几种方式:

1、由参数拼接而成的key=>value键值对字符串。形如以下： name=dyp&age=29&sex=1 

这种请求参数默认是按照application/x-www-form-urlencoded进行编码的。

2、由参数组成的key=>value键值对数组(只能是一维数组，更高维度的数组会报错)。

形如以下格式： [name="dyp", age=29, sex=1] 

这种请求参数默认是按照multipart/form-data格式进行编码的。

上面说了，curl()进行post请求的时候，只能传递一维数组作为传递的参数，那么如果想要传递多维数组需要怎么处理呢？

有两种方式可以来处理，分别是下面的方式3以及方式4。

3、将多维数组进行http_build_query()处理，得到一个key=>value键值对格式的字符串。

如下面所示：

$data = [
    "msg"=>"这是一条测试数据",
    "xxx"=>"yyy",
    "msg_data"=>[
        "name"=>"dyp",
        "age"=>29,
        "sex"=>1,
        "content"=>[1,2,3]
    ],
];
$data = http_build_query($data);

将得到以下的字符串： msg=这是一条测试数据&xxx=yyy&msg_data[name]=dyp&msg_data[age]=29&msg_data[sex]=1&msg_data[content][0]=1&msg_data[content][1]=2&msg_data[content][2]=3 

这种方式也是通过application/x-www-form-urlencoded进行编码的，在接收方可以通过$_POST直接获取。

4、将多维数组转换为json格式的字符串，对字符串进行application/json格式编码，接收方通过file_get_contents("php://input")或者$GLOBALS['HTTP_RAW_POST_DATA']的方式获取传递过来的json格式的字符串，然后将json格式的字符串转换为数组进行处理。

$data = [];
$dataString = json_encode($data);
// ...
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $dataString);
// 设置header信息
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json', 
    'Content-Length: '.strlen($dataString))
);
// ...

注意：对于application/json格式编码的数据，$_POST是不能直接获取的，需要通过file_get_contents("php://input")或者$GLOBALS['HTTP_RAW_POST_DATA']的方式获取。