PHP輸入流php://input介紹

更新時(shí)間：2012年09月18日 12:02:21 作者：

在使用xml-rpc的時(shí)候，server端獲取client數(shù)據(jù)，主要是通過(guò)php輸入流input，而不是$_POST數(shù)組。所以，這里主要探討php輸入流php://input

對(duì)一php://input介紹，PHP官方手冊(cè)文檔有一段話對(duì)它進(jìn)行了很明確地概述。

“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”.
翻譯過(guò)來(lái)，是這樣：
“php://input可以讀取沒(méi)有處理過(guò)的POST數(shù)據(jù)。相較于$HTTP_RAW_POST_DATA而言，它給內(nèi)存帶來(lái)的壓力較小，并且不需要特殊的php.ini設(shè)置。php://input不能用于enctype=multipart/form-data”

我們應(yīng)該怎么去理解這段概述呢?!我把它劃分為三部分，逐步去理解。
讀取POST數(shù)據(jù)
不能用于multipart/form-data類型
php://input VS $HTTP_RAW_POST_DATA
讀取POST數(shù)據(jù)

PHPer們一定很熟悉$_POST這個(gè)內(nèi)置變量。$_POST與 php://input存在哪些關(guān)聯(lián)與區(qū)別呢?另外，客戶端向服務(wù)端交互數(shù)據(jù)，最常用的方法除了POST之外，還有GET。既然php://input作為PHP輸入流，它能讀取GET數(shù)據(jù)嗎？這二個(gè)問(wèn)題正是我們這節(jié)需要探討的主要內(nèi)容。
經(jīng)驗(yàn)告訴我們，從測(cè)試與觀察中總結(jié)，會(huì)是一個(gè)很湊效的方法。這里，我寫了幾個(gè)腳本來(lái)幫助我們測(cè)試。

@file 192.168.0.6:/phpinput_server.php 打印出接收到的數(shù)據(jù)
@file 192.168.0.8:/phpinput_post.php 模擬以POST方法提交表單數(shù)據(jù)
@file 192.168.0.8:/phpinput_xmlrpc.php 模擬以POST方法發(fā)出xmlrpc請(qǐng)求.
@file 192.168.0.8:/phpinput_get.php 模擬以GET方法提交表單表數(shù)
phpinput_server.php與phpinput_post.php

<?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";
?>

<?php
//@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;
}
?>
我們可以通過(guò)使用工具ngrep抓取http請(qǐng)求包（因?yàn)槲覀冃枰街氖莗hp://input，所以我們這里只抓取http Request數(shù)據(jù)包）。我們來(lái)執(zhí)行測(cè)試腳本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
通過(guò)ngrep抓到的http請(qǐng)求包如下:

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....
仔細(xì)觀察，我們不難發(fā)現(xiàn)
1，$_POST數(shù)據(jù),php://input 數(shù)據(jù)與httpd entity body數(shù)據(jù)是“一致”的
2，http請(qǐng)求中的Content-Type是application/x-www-form-urlencoded ，它表示http請(qǐng)求body中的數(shù)據(jù)是使用http的post方法提交的表單數(shù)據(jù)，并且進(jìn)行了urlencode()處理。
(注:注意加粗部分內(nèi)容，下文不再提示).

我們?cè)賮?lái)看看腳本phpinput_xmlrpc.php的原文件內(nèi)容，它模擬了一個(gè)POST方法提交的xml-rpc請(qǐng)求。

<?php
//@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;
}
?>
同樣地，讓我們來(lái)執(zhí)行這個(gè)測(cè)試腳本

@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>
執(zhí)行這個(gè)腳本的時(shí)候，我們通過(guò)ngrep抓取的http請(qǐng)求數(shù)據(jù)包如下

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>....
同樣，我樣也可以很容易地發(fā)現(xiàn):
1，http請(qǐng)求中的Content-Type是text/xml。它表示http請(qǐng)求中的body數(shù)據(jù)是xml數(shù)據(jù)格式。
2，服務(wù)端$_POST打印出來(lái)的是一個(gè)空數(shù)組，即與http entity body不一致了。這跟上個(gè)例子不一樣了，這里的Content-Type是text/xml,而不是application/x-www-form-urlencoded
3，而php://input數(shù)據(jù)還是跟http entity body數(shù)據(jù)一致。也就是php://input數(shù)據(jù)和$_POST數(shù)據(jù)不一致了。

我們?cè)賮?lái)看看通過(guò)GET方法提交表單數(shù)據(jù)的情況，php://input能不能讀取到GET方法的表單數(shù)據(jù)？在這里，我們稍加改動(dòng)一下phpinput_server.php文件，將$_POST改成$_GET。

復(fù)制代碼代碼如下:

 
<?php 
//@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"; 
?> 
<?php 
//@file phpinput_get.php 
$query_path = 'n=' . urldecode('perfgeeks') . '&amp;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; 
} 
?> 

同樣，我們執(zhí)行下一phpinput_get.php測(cè)試腳本，它模擬了一個(gè)通常情況下的GET方法提交表單數(shù)據(jù)。

@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-------------
在這個(gè)時(shí)候，使用ngrep工具，捕獲的相應(yīng)的http請(qǐng)求數(shù)據(jù)包如下

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請(qǐng)求，通常GET方法提交的請(qǐng)求中，entity body為空。同時(shí)，不會(huì)指定Content-Type和Content-Length。但是，如果強(qiáng)硬數(shù)據(jù)http entity body，并指明正確地Content-Type和Content-Length,那么php://input還可是讀取得到http entity body數(shù)據(jù)，但不是$_GET數(shù)據(jù)。

所根據(jù)，上面幾個(gè)探測(cè)，我們可以作出以下總結(jié):
1，Content- Type取值為application/x-www-form-urlencoded時(shí)，php會(huì)將http請(qǐng)求body相應(yīng)數(shù)據(jù)會(huì)填入到數(shù) 組$_POST，填入到$_POST數(shù)組中的數(shù)據(jù)是進(jìn)行urldecode()解析的結(jié)果。（其實(shí)，除了該Content-Type，還有 multipart/form-data表示數(shù)據(jù)是表單數(shù)據(jù)，稍后我們介紹）
2，php://input數(shù)據(jù)，只要Content-Type不為 multipart/form-data(該條件限制稍后會(huì)介紹)。那么php://input數(shù)據(jù)與http entity body部分?jǐn)?shù)據(jù)是一致的。該部分相一致的數(shù)據(jù)的長(zhǎng)度由Content-Length指定。
3，僅當(dāng)Content-Type為application/x-www-form-urlencoded且提交方法是POST方法時(shí)，$_POST數(shù)據(jù)與php://input數(shù)據(jù)才是”一致”（打上引號(hào)，表示它們格式不一致，內(nèi)容一致）的。其它情況，它們都不一致。
4，php://input讀取不到$_GET數(shù)據(jù)。是因?yàn)?_GET數(shù)據(jù)作為query_path寫在http請(qǐng)求頭部(header)的PATH字段，而不是寫在http請(qǐng)求的body部分。

這也幫助我們理解了，為什么xml_rpc服務(wù)端讀取數(shù)據(jù)都是通過(guò)file_get_contents(‘php://input', ‘r')。而不是從$_POST中讀取，正是因?yàn)閤ml_rpc數(shù)據(jù)規(guī)格是xml，它的Content-Type是text/xml。
php://input碰到了multipart/form-data

上傳文件的時(shí)候，表單的寫法是這樣的

復(fù)制代碼代碼如下:

 
<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請(qǐng)求頭部(head)中的Content-Type設(shè)置為multipart/form-data。請(qǐng)查閱RFC1867對(duì) 它的描述。multipart/form-data也表示以POST方法提交表單數(shù)據(jù)，它還伴隨了文件上傳，所以會(huì)跟application/x- www-form-urlencoded數(shù)據(jù)格式不一樣。它會(huì)以一更種更合理的，更高效的數(shù)據(jù)格式傳遞給服務(wù)端。我們提交該表單數(shù)據(jù)，并且打印出響應(yīng)結(jié) 果，如下:

-------$_POST------------------
array(1) { ["n"]=> string(9) "perfgeeks" }
-------php://input-------------
同時(shí)，我們通過(guò)ngrep抓取的相應(yīng)的http請(qǐng)求數(shù)據(jù)包如下:

########
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--..
##
從響應(yīng)輸出來(lái)比對(duì)，$_POST數(shù)據(jù)跟請(qǐng)求提交數(shù)據(jù)相符，即$_POST = array(‘n' => ‘perfgeeks')。這也跟http請(qǐng)求body中的數(shù)據(jù)相呼應(yīng)，同時(shí)說(shuō)明PHP把相應(yīng)的數(shù)據(jù)填入$_POST全局變量。而php://input 輸出為空，沒(méi)有輸出任何東西，盡管http請(qǐng)求數(shù)據(jù)包中body不為空。這表示，當(dāng)Content-Type為multipart/form-data的時(shí)候，即便http請(qǐng)求body中存在數(shù)據(jù)，php://input也為空，PHP此時(shí)，不會(huì)把數(shù)據(jù)填入php://input流。所以，可以確定: php://input不能用于讀取enctype=multipart/form-data數(shù)據(jù)。

我們?cè)俦容^這次通過(guò)ngrep抓取的http請(qǐng)求數(shù)據(jù)包，我們會(huì)發(fā)現(xiàn)，最大不同的一點(diǎn)是Content-Type后面跟了boundary定義了數(shù)據(jù)的分界符，bounday是隨機(jī)生成的。另外一個(gè)大不一樣的，就是http entity body中的數(shù)據(jù)組織結(jié)構(gòu)不一樣了。

上一節(jié)，我們概述了，當(dāng)Content-Type為application/x- www-form-urlencoded時(shí)，php://input和$_POST數(shù)據(jù)是“一致”的，為其它Content-Type的時(shí)候，php: //input和$_POST數(shù)據(jù)數(shù)據(jù)是不一致的。因?yàn)橹挥性贑ontent-Type為application/x-www-form- urlencoded或者為multipart/form-data的時(shí)候，PHP才會(huì)將http請(qǐng)求數(shù)據(jù)包中的body相應(yīng)部分?jǐn)?shù)據(jù)填入$_POST全局變量中,其它情況PHP都忽略。而php://input除了在數(shù)據(jù)類型為multipart/form-data之外為空外，其它情況都可能不為空。通過(guò)這一節(jié)，我們更加明白了php://input與$_POST的區(qū)別與聯(lián)系。所以，再次確認(rèn)，php://input無(wú)法讀取 enctype=multipart/form-data數(shù)據(jù)，當(dāng)php://input遇到它時(shí)，永遠(yuǎn)為空，即便http entity body有數(shù)據(jù)。
php://input VS $http_raw_post_data

相信大家對(duì)php://input已經(jīng)有一定深度地了解了。那么$http_raw_post_data是什么呢？$http_raw_post_data是PHP內(nèi)置的一個(gè)全局變量。它用于，PHP在無(wú)法識(shí)別的 Content-Type的情況下，將POST過(guò)來(lái)的數(shù)據(jù)原樣地填入變量$http_raw_post_data。它同樣無(wú)法讀取Content- Type為multipart/form-data的POST數(shù)據(jù)。需要設(shè)置php.ini中的 always_populate_raw_post_data值為On，PHP才會(huì)總把POST數(shù)據(jù)填入變量$http_raw_post_data。

把腳本phpinput_server.php改變一下，可以驗(yàn)證上述內(nèi)容

復(fù)制代碼代碼如下:

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

執(zhí)行測(cè)試腳本

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

得出的結(jié)果輸出都是一樣的，即都為1，表示php://input和$HTTP_RAW_POST_DATA是相同的。至于對(duì)內(nèi)存的壓力，我們這里就不做細(xì)致地測(cè)試了。有興趣的，可以通過(guò)xhprof進(jìn)行測(cè)試和觀察。

以此，我們這節(jié)可以總結(jié)如下:
1, php://input 可以讀取http entity body中指定長(zhǎng)度的值,由Content-Length指定長(zhǎng)度,不管是POST方式或者GET方法提交過(guò)來(lái)的數(shù)據(jù)。但是，一般GET方法提交數(shù)據(jù) 時(shí)，http request entity body部分都為空。
2,php://input 與$HTTP_RAW_POST_DATA讀取的數(shù)據(jù)是一樣的，都只讀取Content-Type不為multipart/form-data的數(shù)據(jù)。
學(xué)習(xí)筆記

1，Coentent-Type僅在取值為application/x-www-data-urlencoded和multipart/form-data兩種情況下，PHP才會(huì)將http請(qǐng)求數(shù)據(jù)包中相應(yīng)的數(shù)據(jù)填入全局變量$_POST
2，PHP不能識(shí)別的Content-Type類型的時(shí)候，會(huì)將http請(qǐng)求包中相應(yīng)的數(shù)據(jù)填入變量$HTTP_RAW_POST_DATA
3, 只有Coentent-Type不為multipart/form-data的時(shí)候，PHP不會(huì)將http請(qǐng)求數(shù)據(jù)包中的相應(yīng)數(shù)據(jù)填入php://input，否則其它情況都會(huì)。填入的長(zhǎng)度，由Coentent-Length指定。
4，只有Content-Type為application/x-www-data-urlencoded時(shí)，php://input數(shù)據(jù)才跟$_POST數(shù)據(jù)相一致。
5，php://input數(shù)據(jù)總是跟$HTTP_RAW_POST_DATA相同，但是php://input比$HTTP_RAW_POST_DATA更湊效，且不需要特殊設(shè)置php.ini
6，PHP會(huì)將PATH字段的query_path部分，填入全局變量$_GET。通常情況下，GET方法提交的http請(qǐng)求，body為空。

您可能感興趣的文章: