PHP輸入資料流 php://input與POST/GET的區別

PHP輸入資料流php://input
在使用xml-rpc的時候，server端擷取client資料，主要是通過php輸入資料流input，而不是$_POST數組。所以，這裡主要探討php輸入資料流php://input
對於php://input介紹，PHP官方手冊文檔有一段話對它進行了很明確地概述：

“php://input allows you to read raw POST data. It is a less memory intensive alternative to $HTTP_RAW_POST_DATA and does not need any special php.ini directives. php://input is not available with enctype=”multipart/form-data”.

翻譯過來，是這樣：

“php://input可以讀取沒有處理過的POST資料。相較於$HTTP_RAW_POST_DATA而言，它給記憶體帶來的壓力較小，並且不需要特殊的php.ini設定。php://input不能用於enctype=multipart/form-data”
我們應該怎麼去理解這段概述呢？我把它劃分為三部分，逐步去理解：

讀取POST資料

不能用於multipart/form-data類型
php://input VS $HTTP_RAW_POST_DATA

讀取POST資料

PHPer們一定很熟悉$_POST這個內建變數。$_POST與php://input存在哪些關聯與區別呢?另外，用戶端向服務端互動資料，最常用的方法除了POST之外，還有GET。既然php://input作為PHP輸入資料流，它能讀取GET資料嗎？這二個問題正是我們這節需要探討的主要內容。

經驗告訴我們，從測試與觀察中總結，會是一個很湊效的方法。這裡，我寫了幾個指令碼來協助我們測試。

@file 192.168.0.6:/phpinput_server.php 列印出接收到的資料
@file 192.168.0.8:/phpinput_post.php 類比以POST方法提交表單資料
@file 192.168.0.8:/phpinput_xmlrpc.php 類比以POST方法發出xmlrpc請求.
@file 192.168.0.8:/phpinput_get.php 類比以GET方法提交表單表數
phpinput_server.php與phpinput_post.php

//@file phpinput_server.php
$raw_post_data = file_get_contents('php://input', 'r');
echo "-------\$_POST------------------\n";
echo var_dump($_POST) . "\n";
echo "-------php://input-------------\n";
echo $raw_post_data . "\n";
//@file phpinput_post.php
$http_entity_body = 'n=' . urldecode('perfgeeks') . '&p=' . urldecode('7788');
$http_entity_type = 'application/x-www-form-urlencoded';
$http_entity_length = strlen($http_entity_body);
$host = '192.168.0.6';
$port = 80;
$path = '/phpinput_server.php';
$fp = fsockopen($host, $port, $error_no, $error_desc, 30);
if ($fp) {
  fputs($fp, "POST {$path} HTTP/1.1\r\n");
  fputs($fp, "Host: {$host}\r\n");
  fputs($fp, "Content-Type: {$http_entity_type}\r\n");
  fputs($fp, "Content-Length: {$http_entity_length}\r\n");
  fputs($fp, "Connection: close\r\n\r\n");
  fputs($fp, $http_entity_body . "\r\n\r\n");
 
  while (!feof($fp)) {
    $d .= fgets($fp, 4096);
  }
  fclose($fp);
  echo $d;
}

我們可以通過使用工具ngrep抓取http請求包（因為我們需要探知的是php://input，所以我們這裡只抓取http Request資料包）。我們來執行測試指令碼phpinput_post.php

@php /phpinput_post.php
HTTP/1.1 200 OK
Date: Thu, 08 Apr 2010 03:23:36 GMT
Server: Apache/2.2.3 (CentOS)
X-Powered-By: PHP/5.1.6
Content-Length: 160
Connection: close
Content-Type: text/html; charset=UTF-8
-------$_POST------------------
array(2) {
  ["n"]=> string(9) "perfgeeks"
  ["p"]=> string(4) "7788"
}
-------php://input-------------
n=perfgeeks&p=7788
通過ngrep抓到的http請求包如下：

T 192.168.0.8:57846 -> 192.168.0.6:80 [AP]
  POST /phpinput_server.php HTTP/1.1..
  Host: 192.168.0.6..Content-Type: application/x-www-form-urlencoded..Co
  ntent-Length: 18..Connection: close....n=perfgeeks&p=7788....

仔細觀察，我們不難發現：

$_POST資料，php://input 資料與httpd entity body資料是“一致”的。
http請求中的Content-Type是application/x-www-form-urlencoded ，它表示http請求body中的資料是使用http的post方法提交的表單資料，並且進行了urlencode()處理。
(註：注意加粗部分內容，下文不再提示)。

我們再來看看指令碼phpinput_xmlrpc.php的原檔案內容，它類比了一個POST方法提交的xml-rpc請求。

//@file phpinput_xmlrpc.php
$http_entity_body = "\n\n   jt_userinfo\n";
$http_entity_type = 'text/html';
$http_entity_length = strlen($http_entity_body);
$host = '192.168.0.6';
$port = 80;
$path = '/phpinput_server.php';
$fp = fsockopen($host, $port, $error_no, $error_desc, 30);
if ($fp) {
  fputs($fp, "POST {$path} HTTP/1.1\r\n");
  fputs($fp, "Host: {$host}\r\n");
  fputs($fp, "Content-Type: {$http_entity_type}\r\n");
  fputs($fp, "Content-Length: {$http_entity_length}\r\n");
  fputs($fp, "Connection: close\r\n\r\n");
  fputs($fp, $http_entity_body . "\r\n\r\n");
  while (!feof($fp)) {
    $d .= fgets($fp, 4096);
  }
 
  fclose($fp);
  echo $d;
}
同樣地，讓我們來執行這個測試指令碼：

@php /phpinput_xmlrcp.php
HTTP/1.1 200 OK
Date: Thu, 08 Apr 2010 03:47:18 GMT
Server: Apache/2.2.3 (CentOS)
X-Powered-By: PHP/5.1.6
Content-Length: 154
Connection: close
Content-Type: text/html; charset=UTF-8
 
-------$_POST------------------
array(0) {
}
 
-------php://input-------------
<?xml version="1.0">
<methodcall>
   <name>jt_userinfo</name>
</methodcall>
執行這個指令碼的時候，我們通過ngrep抓取的http請求資料包如下：

T 192.168.0.8:45570 -> 192.168.0.6:80 [AP]
  POST /phpinput_server.php HTTP/1.1..
  Host: 192.168.0.6..Content-Type: text/html..Content-Length: 75..Connec
  tion: close....<?xml version="1.0">.<methodcall>.   <name>jt_userinfo<
  /name>.</methodcall>....
同樣，我樣也可以很容易地發現:

http請求中的Content-Type是text/xml。它表示http請求中的body資料是xml資料格式。
服務端$_POST列印出來的是一個空數組，即與http entity body不一致了。這跟上個例子不一樣了，這裡的Content-Type是text/xml,而不是application/x-www-form-urlencoded
而php://input資料還是跟http entity body資料一致。也就是php://input資料和$_POST資料不一致了。
我們再來看看通過GET方法提交表單資料的情況，php://input能不能讀取到GET方法的表單資料？在這裡，我們稍加改動一下phpinput_server.php檔案，將$_POST改成$_GET。

//@file phpinput_server.php
$raw_post_data = file_get_contents('php://input', 'r');
echo "-------\$_GET------------------\n";
echo var_dump($_GET) . "\n";
echo "-------php://input-------------\n";
echo $raw_post_data . "\n";
//@file phpinput_get.php
$query_path = 'n=' . urldecode('perfgeeks') . '&p=' . urldecode('7788');
$host = '192.168.0.6';
$port = 80;
$path = '/phpinput_server.php';
$d = '';
$fp = fsockopen($host, $port, $error_no, $error_desc, 30);
if ($fp) {
  fputs($fp, "GET {$path}?{$query_path} HTTP/1.1\r\n");
  fputs($fp, "Host: {$host}\r\n");
  fputs($fp, "Connection: close\r\n\r\n");
 
  while (!feof($fp)) {
    $d .= fgets($fp, 4096);
  }
  fclose($fp);
  echo $d;
 }
同樣，我們執行下一phpinput_get.php測試指令碼，它類比了一個通常情況下的GET方法提交表單資料。

@php /phpinput_get.php
HTTP/1.1 200 OK
Date: Thu, 08 Apr 2010 07:38:15 GMT
Server: Apache/2.2.3 (CentOS)
X-Powered-By: PHP/5.1.6
Content-Length: 141
Connection: close
Content-Type: text/html; charset=UTF-8
 
-------$_GET------------------
array(2) {
  ["n"]=>
  string(9) "perfgeeks"
  ["p"]=>
  string(4) "7788"
}
 
-------php://input-------------
在這個時候，使用ngrep工具，捕獲的相應的http請求資料包如下：

T 192.168.0.8:36775 -> 192.168.0.6:80 [AP]
  GET /phpinput_server.php?n=perfgeeks&p=7788 HTTP/1.1..
Host: 192.168.0.6..Connection: close….
比較POST方法提交的http請求，通常GET方法提交的請求中，entity body為空白。同時，不會指定Content-Type和Content-Length。但是，如果強硬資料http entity body，並指明正確地Content-Type和Content-Length,那麼php://input還可是讀取得到http entity body資料，但不是$_GET資料。

所根據，上面幾個探測，我們可以作出以下總結:

Content-Type取值為application/x-www-form-urlencoded時，php會將http請求body相應資料會填入到數組$_POST，填入到$_POST數組中的資料是進行urldecode()解析的結果。（其實，除了該Content-Type，還有multipart/form-data表示資料是表單資料，稍後我們介紹）
php://input資料，只要Content-Type不為multipart/form-data(該條件限制稍後會介紹)。那麼php://input資料與http entity body部分資料是一致的。該部分相一致的資料的長度由Content-Length指定。
僅當Content-Type為application/x-www-form-urlencoded且提交方法是POST方法時，$_POST資料與php://input資料才是”一致”（打上引號，表示它們格式不一致，內容一致）的。其它情況，它們都不一致。
php://input讀取不到$_GET資料。是因為$_GET資料作為query_path寫在http要求標頭部(header)的PATH欄位，而不是寫在http請求的body部分。
這也協助我們理解了，為什麼xml_rpc服務端讀取資料都是通過file_get_contents(‘php://input’, ‘r’)。而不是從$_POST中讀取，正是因為xml_rpc資料規格是xml，它的Content-Type是text/xml。

php://input碰到了multipart/form-data

上傳檔案的時候，表單的寫法是這樣的：

<form enctype="multipart/form-data" action="phpinput_server.php" method="POST" >
    <input type="text" name="n"  />
    <input type="file" name="f" />
    <input type="submit" value="upload now" />
</form>

那麼，enctype=multipart/form-data這裡的意義，就是將該次http要求標頭部(head)中的Content-Type設定為multipart/form-data。請查閱RFC1867對它的描述。multipart/form-data也表示以POST方法提交表單資料，它還伴隨了檔案上傳，所以會跟application/x-www-form-urlencoded資料格式不一樣。它會以一更種更合理的，更高效的資料格式傳遞給服務端。我們提交該表單資料，並且列印出響應結果，如下：

-------$_POST------------------
array(1) { ["n"]=> string(9) "perfgeeks" }
-------php://input-------------
同時，我們通過ngrep抓取的相應的http請求資料包如下：

########
T 192.168.0.8:3981 -> 192.168.0.6:80 [AP]
  POST /phpinput_server.php HTTP/1.1..Host: 192.168.0.6..Connection: kee
  p-alive..User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US) A
  ppleWebKit/533.2 (KHTML, like Gecko) Chrome/5.0.342.3 Safari/533.2..Re
  ferer: http://192.168.0.6/phpinput_server.php..Content-Length: 306..Ca
  che-Control: max-age=0..Origin: http://192.168.0.6..Content-Type: mult
  ipart/form-data; boundary=----WebKitFormBoundarybLQwkp4opIEZn1fA..Acce
  pt: application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q
  =0.8,image/png,*/*;q=0.5..Accept-Encoding: gzip,deflate,sdch..Accept-L
  anguage: zh-CN,zh;q=0.8..Accept-Charset: GBK,utf-8;q=0.7,*;q=0.3..Cook
  ie: SESS3b0e658f87cf58240de13ab43a399df6=lju6o5bg8u04lv1ojugm2ccic6...
  .
##
T 192.168.0.8:3981 -> 192.168.0.6:80 [AP]
  ------WebKitFormBoundarybLQwkp4opIEZn1fA..Content-Disposition: form-da
  ta; name="n"....perfgeeks..------WebKitFormBoundarybLQwkp4opIEZn1fA..C
  ontent-Disposition: form-data; name="f"; filename="test.txt"..Content-
  Type: text/plain....i am file..multipart/form-data..------WebKitFormBo
  undarybLQwkp4opIEZn1fA--..
##
從響應輸出來比對，$_POST資料跟請求提交資料相符，即$_POST = array(‘n’ => ‘perfgeeks’)。這也跟http請求body中的資料相呼應，同時說明PHP把相應的資料填入$_POST全域變數。而php://input輸出為空白，沒有輸出任何東西，儘管http請求資料包中body不為空白。這表示，當Content-Type為multipart/form-data的時候，即便http請求body中存在資料，php://input也為空白，PHP此時，不會把資料填入php://input流。所以，可以確定: php://input不能用於讀取enctype=multipart/form-data資料。

我們再比較這次通過ngrep抓取的http請求資料包，我們會發現，最大不同的一點是Content-Type後面跟了boundary定義了資料的分界符，bounday是隨機產生的。另外一個大不一樣的，就是http entity body中的資料群組織結構不一樣了。

上一節，我們概述了，當Content-Type為application/x-www-form-urlencoded時，php://input和$_POST資料是“一致”的，為其它Content-Type的時候，php://input和$_POST資料資料是不一致的。因為只有在Content-Type為application/x-www-form-urlencoded或者為multipart/form-data的時候，PHP才會將http請求資料包中的body相應部分資料填入$_POST全域變數中,其它情況PHP都忽略。而php://input除了在資料類型為multipart/form-data之外為空白外，其它情況都可能不為空白。通過這一節，我們更加明白了php://input與$_POST的區別與聯絡。所以，再次確認，php://input無法讀取enctype=multipart/form-data資料，當php://input遇到它時，永遠為空白，即便http entity body有資料。

php://input VS $http_raw_post_data

相信大家對php://input已經有一定深度地瞭解了。那麼$http_raw_post_data是什麼呢？$http_raw_post_data是PHP內建的一個全域變數。它用於，PHP在無法識別的Content-Type的情況下，將POST過來的資料原樣地填入變數$http_raw_post_data。它同樣無法讀取Content-Type為multipart/form-data的POST資料。需要設定php.ini中的always_populate_raw_post_data值為On，PHP才會總把POST資料填入變數$http_raw_post_data。

把指令碼phpinput_server.php改變一下，可以驗證上述內容：

$raw_post_data = file_get_contents('php://input', 'r');
$rtn = ($raw_post_data == $HTTP_RAW_POST_DATA) ? 1 : 0;
echo $rtn;

執行測試指令碼：

@php phpinput_post.php
@php phpinput_get.php
@php phpinput_xmlrpc.php

得出的結果輸出都是一樣的，即都為1，表示php://input和$HTTP_RAW_POST_DATA是相同的。至於對記憶體的壓力，我們這裡就不做細緻地測試了。有興趣的，可以通過xhprof進行測試和觀察。

以此，我們這節可以總結如下:

php://input 可以讀取http entity body中指定長度的值，由Content-Length指定長度,不管是POST方式或者GET方法提交過來的資料。但是，一般GET方法提交資料時，http request entity body部分都為空白。
php://input 與$HTTP_RAW_POST_DATA讀取的資料是一樣的，都唯讀取Content-Type不為multipart/form-data的資料。
小結

Coentent-Type僅在取值為application/x-www-data-urlencoded和multipart/form-data兩種情況下，PHP才會將http請求資料包中相應的資料填入全域變數$_POST

PHP不能識別的Content-Type類型的時候，會將http請求包中相應的資料填入變數$HTTP_RAW_POST_DATA
只有Coentent-Type不為multipart/form-data的時候，PHP不會將http請求資料包中的相應資料填入php://input，否則其它情況都會。填入的長度，由Coentent-Length指定。

只有Content-Type為application/x-www-data-urlencoded時，php://input資料才跟$_POST資料相一致。
php://input資料總是跟$HTTP_RAW_POST_DATA相同，但是php://input比$HTTP_RAW_POST_DATA更湊效，且不需要特殊設定php.ini

PHP會將PATH欄位的query_path部分，填入全域變數$_GET。通常情況下，GET方法提交的http請求，body為空白。