四種常見的 POST 提交數據方式 · 全棧之路

### application/x-www-form-urlencoded 這應該是最常見的 POST 提交數據的方式了。瀏覽器的原生表單，如果不設置`enctype`屬性，那么最終就會以 application/x-www-form-urlencoded 方式提交數據。請求類似于下面這樣（無關的請求頭在本文中都省略掉了）： ~~~ BASHPOST http://www.example.com HTTP/1.1 Content-Type: application/x-www-form-urlencoded;charset=utf-8 title=test&sub%5B%5D=1&sub%5B%5D=2&sub%5B%5D=3 ~~~ 首先，Content-Type 被指定為 application/x-www-form-urlencoded；其次，提交的數據按照 key1=val1&key2=val2 的方式進行編碼，key 和 val 都進行了 URL 轉碼。大部分服務端語言都對這種方式有很好的支持。例如 PHP 中，$\_POST\['title'\] 可以獲取到 title 的值，$\_POST\['sub'\] 可以得到 sub 數組。很多時候，我們用 Ajax 提交數據時，也是使用這種方式。例如[JQuery](http://jquery.com/)和[QWrap](http://www.qwrap.com/)的 Ajax，Content-Type 默認值都是「application/x-www-form-urlencoded;charset=utf-8」。 ### multipart/form-data 這又是一個常見的 POST 數據提交的方式。我們使用表單上傳文件時，必須讓表單的`enctype`等于 multipart/form-data。直接來看一個請求示例： ~~~ BASHPOST http://www.example.com HTTP/1.1 Content-Type:multipart/form-data; boundary=----WebKitFormBoundaryrGKCBY7qhFd3TrwA ------WebKitFormBoundaryrGKCBY7qhFd3TrwA Content-Disposition: form-data; name="text" title ------WebKitFormBoundaryrGKCBY7qhFd3TrwA Content-Disposition: form-data; name="file"; filename="chrome.png" Content-Type: image/png PNG ... content of chrome.png ... ------WebKitFormBoundaryrGKCBY7qhFd3TrwA-- ~~~ 這個例子稍微復雜點。首先生成了一個 boundary 用于分割不同的字段，為了避免與正文內容重復，boundary 很長很復雜。然后 Content-Type 里指明了數據是以 multipart/form-data 來編碼，本次請求的 boundary 是什么內容。消息主體里按照字段個數又分為多個結構類似的部分，每部分都是以`--boundary`開始，緊接著是內容描述信息，然后是回車，最后是字段具體內容（文本或二進制）。如果傳輸的是文件，還要包含文件名和文件類型信息。消息主體最后以`--boundary--`標示結束。關于 multipart/form-data 的詳細定義，請前往[rfc1867](http://www.ietf.org/rfc/rfc1867.txt)查看。這種方式一般用來上傳文件，各大服務端語言對它也有著良好的支持。上面提到的這兩種 POST 數據的方式，都是瀏覽器原生支持的，而且現階段標準中原生表單也[只支持這兩種方式](http://www.w3.org/TR/html401/interact/forms.html#h-17.13.4)（通過元素的`enctype`屬性指定，默認為`application/x-www-form-urlencoded`。其實`enctype`還支持`text/plain`，不過用得非常少）。隨著越來越多的 Web 站點，尤其是 WebApp，全部使用 Ajax 進行數據交互之后，我們完全可以定義新的數據提交方式，給開發帶來更多便利。 ### application/json application/json 這個 Content-Type 作為響應頭大家肯定不陌生。實際上，現在越來越多的人把它作為請求頭，用來告訴服務端消息主體是序列化后的 JSON 字符串。由于 JSON 規范的流行，除了低版本 IE 之外的各大瀏覽器都原生支持 JSON.stringify，服務端語言也都有處理 JSON 的函數，使用 JSON 不會遇上什么麻煩。 JSON 格式支持比鍵值對復雜得多的結構化數據，這一點也很有用。記得我幾年前做一個項目時，需要提交的數據層次非常深，我就是把數據 JSON 序列化之后來提交的。不過當時我是把 JSON 字符串作為 val，仍然放在鍵值對里，以 x-www-form-urlencoded 方式提交。 Google 的[AngularJS](http://angularjs.org/)中的 Ajax 功能，默認就是提交 JSON 字符串。例如下面這段代碼： ~~~ JSvar data = {'title':'test', 'sub' : [1,2,3]}; $http.post(url, data).success(function(result) { ... }); ~~~ 最終發送的請求是： ~~~ BASHPOST http://www.example.com HTTP/1.1 Content-Type: application/json;charset=utf-8 {"title":"test","sub":[1,2,3]} ~~~ 這種方案，可以方便的提交復雜的結構化數據，特別適合 RESTful 的接口。各大抓包工具如 Chrome 自帶的開發者工具、Firebug、Fiddler，都會以樹形結構展示 JSON 數據，非常友好。但也有些服務端語言還沒有支持這種方式，例如 php 就無法通過 $\_POST 對象從上面的請求中獲得內容。這時候，需要自己動手處理下：在請求頭中 Content-Type 為 application/json 時，從`php://input`里獲得原始輸入流，再`json_decode`成對象。一些 php 框架已經開始這么做了。當然 AngularJS 也可以配置為使用 x-www-form-urlencoded 方式提交數據。如有需要，可以參考[這篇文章](http://victorblog.com/2012/12/20/make-angularjs-http-service-behave-like-jquery-ajax/)。 ### text/xml 我的博客之前[提到過 XML-RPC](http://www.imququ.com/post/64.html)（XML Remote Procedure Call）。它是一種使用 HTTP 作為傳輸協議，XML 作為編碼方式的遠程調用規范。典型的 XML-RPC 請求是這樣的： ~~~ HTMLPOST http://www.example.com HTTP/1.1 Content-Type: text/xml <?xml version="1.0"?> <methodCall> <methodName>examples.getStateName</methodName> <params> <param> <value><i4>41</i4></value> </param> </params> </methodCall> ~~~ XML-RPC 協議簡單、功能夠用，各種語言的實現都有。它的使用也很廣泛，如 WordPress 的[XML-RPC Api](http://codex.wordpress.org/XML-RPC_WordPress_API)，搜索引擎的[ping 服務](http://help.baidu.com/question?prod_en=master&class=476&id=1000423)等等。JavaScript 中，也有[現成的庫](http://plugins.jquery.com/xmlrpc/)支持以這種方式進行數據交互，能很好的支持已有的 XML-RPC 服務。不過，我個人覺得 XML 結構還是過于臃腫，一般場景用 JSON 會更靈活方便。