您的位置:永利集团登录网址 > 计算机教学 > 【PHP】php://input、$_POST、$_GET、$HTTP_RAW_POST_DATA 关

【PHP】php://input、$_POST、$_GET、$HTTP_RAW_POST_DATA 关

2019-10-03 22:49

现在微服务中,很多API由于需要传递的参数较多所以要求用包含所有参数的JSON数据作为POST请求的请求体来替代FormData传递参数的方式,在参数量较多时POST JSON要比POST FormData便于开发和测试,今天我们就来看一下在PHP中如何发送和接受JOSN POST,以及在Laravel框架中针对JSON Request提供的访问JSON请求数据的便捷方法。

本文主要参考

  • 深入剖析PHP输入流 php://input

PHP发送JSON POST

最近在Coding的时候遇到了一个让人头晕的问题:前端用axios库提交的数据,在后端框架无法捕获;于是本着追本溯源的精神开始了这个问题的探索!

$url = "http://example.com/request/post/json"; 
$data = json_encode(["foo" => "bar"]);
$curl = curl_init($url);
curl_setopt($curl, CURLOPT_HEADER, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HTTPHEADER, array("Content-type: application/json"));
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
curl_exec($curl);
curl_close($curl);
一、填坑

图片 1

前端数据抓包

首先抓取前端的数据请求包,可以看到HTTP Method为PUT,提交的数据在entity body中,并且为JSON数据格式,但是我们在后台接口框架中打印捕获到的POST数据为:

图片 2

image.png

很显然后端框架虽然捕获到了前端提交的POST数据,但是并没有正确解析,因此问题应该主要出在框架上(后端使用Phalcon框架)。通过跟踪代码看到,后端获取POST数据的代码为:

   if ($method == PostedDataMethods::JSON_BODY) {
        return $this->getJsonRawBody(true);
    }
    else if($method == PostedDataMethods::POST) {
        return $this->getPost();
    }
    else if($method == PostedDataMethods::PUT) {
        return $this->getPut();
    }
    else if($method == PostedDataMethods::GET) {
        return $this->getQuery();
    }

接口框架通过判断HTTP请求方法调用不同的方法获取POST数据,本例使用PUT提交数据,所以调用了getPut(),该方法为Phalcon框架的方法,因此调出Phalcon源码继续追踪。

Phalcon源码部分:

public function getPut(string! name = null, var filters = null, var defaultValue = null, boolean notAllowEmpty = false, boolean noRecursive = false) -> var
{
    var put;

    let put = this->_putCache;

    if typeof put != "array" {
        let put = [];
        parse_str(this->getRawBody(), put);

        let this->_putCache = put;
    }

    return this->getHelper(put, name, filters, defaultValue, notAllowEmpty, noRecursive);
}

/**
 * Gets HTTP raw request body
 */
public function getRawBody() -> string
{
    var rawBody, contents;

    let rawBody = this->_rawBody;
    if empty rawBody {

        let contents = file_get_contents("php://input");

        /**
         * We need store the read raw body because it can't be read again
         */
        let this->_rawBody = contents;
        return contents;
    }
    return rawBody;
}

从上面代码可以看到,对于PUT请求,Phalcon框架首先获取php://input输入流中的信息,在本例中,php://input输入流中的值为:

{"id":22,"package_name":"test","md5":"ste1","type":"3","op_id":0,"status":1,"update_time":1509677637,"create_time":1509625133}

因此该字符串通过parse_str()解析后,就变成了:

{{"id":22,"package_name":"test","md5":"ste1","type":"3","op_id":0,"status":1,"update_time":1509677637,"create_time":1509625133} : ""}

即:我们在后台获取到的POST值。
至此,这个问题的原因基本可以确定,是由于前端提交的数据是JSON格式的数据,然而Phalcon并没有去解析这个JSON数据,而是直接把它当做一个字符串,然后直接进行解析。

所以解决当前问题的解决方法有:

  • 让前端提交的数据格式由JSON格式转化为形如:id=22&package_name=test&…… 的字符串形式,从而后端能够正确解析前端传过来的参数;
  • 或者在接口框架中指定前端传过来的数据为JSON格式,让接口框架调用Phalcon框架中getJsonRawBody()方法,从而也能够正确解析前端传过来的参数

最后,实践证明这两种方法都有效!

PHP接受JSON POST

二、扩展

这个问题虽然解决了,但是自己仍然对不同HTTP method情况下,http请求参数获取的内部关系一知半解,在仔细阅读了Phalcon 请求参数获取部分源码后,我知道自己需要先从PHP中php://input输入流、$_POST、$_GET、$HTTP_RAW_POST_DATA这几个兄弟之间的关系开始了解。

$data = json_decode(file_get_contents('php://input'), true);
2.1 php://input

php://input是个可以访问请求的原始数据的只读流。 POST请求的情况下,最好使用php://input来代替$HTTP_RAW_POST_DATA,因为它不依赖于特定的php.ini指令。 而且,这样的情况下$HTTP_RAW_POST_DATA默认没有填充, 比激活always_populate_raw_post_data潜在需要更少的内存。当enctype="multipart/form-data"的时候,php://input是无效的。

  • 不需要任何特殊的 php.ini 设置
  • 不能用于 enctype="multipart/form-data"

$HTTP_RAW_POST_DATA]( php.ini 指令。 而且,这样的情况下 [$HTTP_RAW_POST_DATA 默认没有填充, 比激活 always_populate_raw_post_data 潜在需要更少的内存。 enctype="multipart/form-data" 的时候 php://input 是无效的。

2.2 $_POST

$_POST是我们最常用的获取POST数据的方式,它是以关联数组方式组织提交的数据,并对此进行编码处理,如urldecode,甚至编码转换,识别的数据类型是PHP默认识别的数据类型 application/x-www.form-urlencoded

  • 无法解析如text/xml,application/json等非 application/x-www.form-urlencoded 数据类型的内容

Note: 在 PHP 5.6 之前 php://input 打开的数据流只能读取一次; 数据流不支持 seek 操作。 不过,依赖于 SAPI 的实现,请求体数据被保存的时候, 它可以打开另一个 php://input 数据流并重新读取。 通常情况下,这种情况只是针对 POST 请求,而不是其他请求方式,比如 PUT 或者 PROPFIND。

2.3 $HTTP_RAW_POST_DATA

PHP默认识别的数据类型是application/x-www.form-urlencoded,用Content-Type=application/json 类型,提交的POST数据这时候 $_POST 就无法获取到了,但是使用 $GLOBALS['HTTP_RAW_POST_DATA'] 可以获取到。因为在PHP无法识别Content-Type的时候,就会把 POST 数据填入到 $HTTP_RAW_POST_DATA 中。

  • 需要设置 php.ini 中的 always_populate_raw_post_data 值为 on 才会生效
  • 当$_POST 与 php://input可以取到值时 $HTTP_RAW_POST_DATA 为空
  • 不能用于 enctype="multipart/form-data"
  • PHP7中已经移除了这个全局变量,用 php://input 替代

使用Guzzle发送JSON请求

2.4 $_GET

从带有 GET 方法的表单发送的信息,对任何人都是可见的(会显示在浏览器的地址栏),并且对发送信息的量也有限制。

很多时候在开发中我们并不会像上面那样用php curl库来发送请求而是使用开源的Http包,常用的Http package比如 Guzzle都有为发送JSON请求提供了便捷的方法。

三、总结
//Guzzle version >= 5
use GuzzleHttpClient;

$client = new Client();

$response = $client->post('url', [
 GuzzleHttpRequestOptions::JSON => ['foo' => 'bar']
]);
3.1 php://input

php://input数据与http entity body部分数据是总是一致的(该部分相一致的数据的长度由Content-Length指定),除了当Content-Type为multipart/form-data的时候。

multipart/form-data表示以POST方法提交表单数据,它还伴随了文件上传,所以会跟application/x-www-form-urlencoded数据格式不一样。它会以一更种更合理的,更高效的数据格式传递给服务端。

Laravel中接受JSON POST

3.2 $_POST

只有在Content-Type为application/x-www-form-urlencoded或者为multipart/form-data的时候,PHP才会将http请求数据包中的body相应部分数据填入$_POST全局变量中,其它情况PHP都忽略。

使用Request的json()->all()获取请求体里的整个JSON

3.3 $HTTP_RAW_POST_DATA

$HTTP_RAW_POST_DATA数据总是跟php://input相同,但是php://input比$HTTP_RAW_POST_DATA更高效,且不需要特殊设置php.ini。

//IN controller
public function recieveJson(Request $request)
{
 $request->json()->all();
 //返回值是一个数组
 //针对前面的请求例子,json方法返回的是数组 ["foo" => "bar"]
 //$request->json()返回的是ParamBage
}
3.4 $_GET

PHP会将PATH字段的query_path部分,填入全局变量$_GET。通常情况下,GET方法提交的http请求body为空。

【PHP】php://input、$_POST、$_GET、$HTTP_RAW_POST_DATA 关系梳理。注:文中如有任何错误,请各位批评指正!

使用Request的input方法获取请求中的整个JSON或者具体key的值

发送 JSON 请求到Laravel应用的时候,只要 Content-Type 请求头被设置为 application/json,都可以通过 input 方法获取 JSON 数据,还可以通过“.”号解析数组:

public function laravelRecieveJson(Reuqest $request)
{
  $foo = $request->input('foo');//echo $foo => 'bar'
  //使用点号获取内嵌数组key的值
  //假设请求体中的JSON为 {"user": {"name": "kevin", "age": 18}}
  $name = $reqeust->input('user.name');//echo $name => 'kevin'
}

本文由永利集团登录网址发布于计算机教学,转载请注明出处:【PHP】php://input、$_POST、$_GET、$HTTP_RAW_POST_DATA 关

关键词: