在使用xml-rpc的時候,server端獲取client數據,主要是經過php輸入流input,而不是$_POST數組。因此,這裏主要探 討php輸入流php://inputphp
對一php://input介紹,PHP官方手冊文檔有一段話對它進行了很明確地概述。html
「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」數組
咱們應該怎麼去理解這段概述呢?!我把它劃分爲三部分,逐步去理解。app
讀取POST數據less
不能用於multipart/form-data類型工具
php://input VS $HTTP_RAW_POST_DATApost
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測試
$raw_post_data = 'php://input', 'r'; ; $_POST . ; ; $raw_post_data . ; ?> $http_entity_body = 'n=' . 'perfgeeks' . '&p=' . '7788'; $http_entity_type = 'application/x-www-form-urlencoded'; $http_entity_length = $http_entity_body; $host = '192.168.0.6'; $port = ; $path = '/phpinput_server.php'; $fp = $host, $port, $error_no, $error_desc, 30; $fp $fp, ; $fp, ; $fp, ; $fp, ; $fp, ; $fp, $http_entity_body . ; !$fp $d .= $fp, 4096; $fp; $d; ?>
咱們能夠經過使用工具ngrep抓取http請求包(由於咱們須要探知的是php://input,因此咱們這裏只抓取http Request數據包)。咱們來執行測試腳本phpinput_post.phpurl
@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-------------
經過ngrep抓到的http請求包以下:
T 192.168.0.8:57846 -> 192.168.0.6:80 [AP] /phpinput_server.php HTTP/1.1.. Host: 192.168.0.6....Co ntent-Length: 18..Connection: close........
仔細觀察,咱們不難發現
1,$_POST數據,php://input 數據與httpd entity body數據是「一致」的
2,http請求中的Content-Type是application/x-www-form-urlencoded ,它表示http請求body中的數據是使用http的post方法提交的表單數據,而且進行了urlencode()處理。
(注:注意加粗部份內容,下文再也不提示).
咱們再來看看腳本phpinput_xmlrpc.php的原文件內容,它模擬了一個POST方法提交的xml-rpc請求。
$http_entity_body = ; $http_entity_type = 'text/html'; $http_entity_length = $http_entity_body; $host = '192.168.0.6'; $port = ; $path = '/phpinput_server.php'; $fp = $host, $port, $error_no, $error_desc, 30; $fp $fp, ; $fp, ; $fp, ; $fp, ; $fp, ; $fp, $http_entity_body . ; !$fp $d .= $fp, 4096; $fp; $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-------------
執行這個腳本的時候,咱們經過ngrep抓取的http請求數據包以下
T 192.168.0.8:45570 -> 192.168.0.6:80 [AP] /phpinput_server.php HTTP/1.1.. Host: 192.168.0.6....Content-Length: 75..Connec tion: close........
一樣,我樣也能夠很容易地發現:
1,http請求中的Content-Type是text/xml。它表示http請求中的body數據是xml數據格式。
2,服務端$_POST打印出來的是一個空數組,即與http entity body不一致了。這跟上個例子不同了,這裏的Content-Type是text/xml,而不是application/x-www-form- urlencoded
3,而php://input數據仍是跟http entity body數據一致。也就是php://input數據和$_POST數據不一致了。
咱們再來看看經過GET方法提交表單數據的狀況,php://input能不能讀取到GET方法的表單數據?在這裏,咱們稍加改動一下 phpinput_server.php文件,將$_POST改爲$_GET。
$raw_post_data = 'php://input', 'r'; ; $_GET . ; ; $raw_post_data . ; ?> $query_path = 'n=' . 'perfgeeks' . '&p=' . '7788'; $host = '192.168.0.6'; $port = ; $path = '/phpinput_server.php'; $d = ''; $fp = $host, $port, $error_no, $error_desc, 30; $fp $fp, ; $fp, ; $fp, ; !$fp $d .= $fp, 4096; $fp; $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] /phpinput_server.php? 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數據。
所根據,上面幾個探測,咱們能夠做出如下總結:
1,Content-Type取值爲application/x-www-form-urlencoded時,php會將http請求body相應數據會 填入到數組$_POST,填入到$_POST數組中的數據是進行urldecode()解析的結果。(其實,除了該Content-Type,還有 multipart/form-data表示數據是表單數據,稍後咱們介紹)
2,php://input數據,只要Content-Type不爲multipart/form-data(該條件限制稍後會介紹)。那麼php: //input數據與http entity body部分數據是一致的。該部分相一致的數據的長度由Content-Length指定。
3,僅當Content-Type爲application/x-www-form-urlencoded且提交方法是POST方法時,$_POST數據 與php://input數據纔是」一致」(打上引號,表示它們格式不一致,內容一致)的。其它狀況,它們都不一致。
4,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。
上傳文件的時候,表單的寫法是這樣的
< = = = > < = = /> < = = /> < = = /> </>
那麼,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] /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....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; ..------WebKitFormBoundarybLQwkp4opIEZn1fA..C ontent-Disposition: form-data; ..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已經有必定深度地瞭解了。那麼$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 = 'php://input', 'r'; $rtn = $raw_post_data == $HTTP_RAW_POST_DATA ? 1 : ; $rtn; ?>
執行測試腳本
@php phpinput_post.php @php phpinput_get.php @php phpinput_xmlrpc.php
得出的結果輸出都是同樣的,即都爲1,表示php://input和$HTTP_RAW_POST_DATA是相同的。至於對內存的壓力,咱們這裏 就不作細緻地測試了。有興趣的,能夠經過xhprof進行測試和觀察。
以此,咱們這節能夠總結以下:
1, php://input 能夠讀取http entity body中指定長度的值,由Content-Length指定長度,不論是POST方式或者GET方法提交過來的數據。可是,通常GET方法提交數據 時,http request entity body部分都爲空。
2,php://input 與$HTTP_RAW_POST_DATA讀取的數據是同樣的,都只讀取Content-Type不爲multipart/form-data的數據。
1,Coentent-Type僅在取值爲application/x-www-data-urlencoded和multipart/form- data兩種狀況下,PHP纔會將http請求數據包中相應的數據填入全局變量$_POST2,PHP不能識別的Content-Type類型的時候,會將http請求包中相應的數據填入變量$HTTP_RAW_POST_DATA3, 只有Coentent-Type不爲multipart/form-data的時候,PHP不會將http請求數據包中的相應數據填入php: //input,不然其它狀況都會。填入的長度,由Coentent-Length指定。4,只有Content-Type爲application/x-www-data-urlencoded時,php://input數據才 跟$_POST數據相一致。5,php://input數據老是跟$HTTP_RAW_POST_DATA相同,可是php://input 比$HTTP_RAW_POST_DATA更湊效,且不須要特殊設置php.ini6,PHP會將PATH字段的query_path部分,填入全局變量$_GET。一般狀況下,GET方法提交的http請求,body爲空。