深入解析 multipart/form-data

一個 HTML 表單中的 enctype 有三種類型

  • application/x-www-urlencoded
  • multipart/form-data
  • text-plain

默認情況下是 application/x-www-urlencoded,當表單使用 POST 請求時财松,數(shù)據(jù)會被以 x-www-urlencoded 方式編碼到 Body 中來傳送瘪贱,
而如果 GET 請求,則是附在 url 鏈接后面來發(fā)送辆毡。

GET 請求只支持 ASCII 字符集菜秦,因此,如果我們要發(fā)送更大字符集的內容舶掖,我們應使用 POST 請求球昨。

注意

"application/x-www-form-urlencoded" 編碼的格式是 ASCII,如果 form 中傳遞的是二進制等 Media Type 類型的數(shù)據(jù)眨攘,那么 application/x-www-form-urlencoded 會把其編碼轉換成 ASCII 類型主慰。對于 1 個 non-ASCII 字符,它需要用 3 個 ASCII字符來表示鲫售,如果要發(fā)送大量的二進制數(shù)據(jù)(non-ASCII)共螺,"application/x-www-form-urlencoded" 顯然是低效的。因此情竹,這種情況下藐不,應該使用 "multipart/form-data" 格式。

The content type "application/x-www-form-urlencoded" is inefficient for sending large quantities of binary data or text containing non-ASCII characters. The content type "multipart/form-data" should be used for submitting forms that contain files, non-ASCII data, and binary data.

application/x-www-urlencoded

我們在通過 HTTP 向服務器發(fā)送 POST 請求提交數(shù)據(jù),都是通過 form 表單形式提交的佳吞,代碼如下:

<FORM method="post" action="http://w.sohu.com" >
    <INPUT type="text" name="txt1">
    <INPUT type="text" name="txt2">
 </FORM>

提交時會向服務器端發(fā)出這樣的數(shù)據(jù)(已經(jīng)去除部分不相關的頭信息)拱雏,數(shù)據(jù)如下:

POST / HTTP/1.1
Content-Type:application/x-www-form-urlencoded
Accept-Encoding: gzip, deflate
Host: w.sohu.com
Content-Length: 21
Connection: Keep-Alive
Cache-Control: no-cache
 
txt1=hello&txt2=world

對于普通的 HTML Form POST請求,它會在頭信息里使用 Content-Length 注明內容長度底扳。
請求頭信息每行一條铸抑,空行之后便是 Body,即“內容”(entity)衷模。內容的格式是在頭信息中的 Content-Type 指定的鹊汛,如上是 application/x-www-form-urlencoded,這意味著消息內容會經(jīng)過 URL 格式編碼阱冶,就像在 GET請 求時 URL 里的 QueryString 那樣刁憋。txt1=hello&txt2=world

multipart/form-data

multipart/form-data 定義在 rfc2388 中,最早的 HTTP POST 是不支持文件上傳的木蹬,給編程開發(fā)帶來很多問題至耻。但是在1995年,ietf 出臺了 rfc1867镊叁,也就是《RFC 1867 -Form-based File Upload in HTML》尘颓,用以支持文件上傳。所以 Content-Type 的類型擴充了multipart/form-data 用以支持向服務器發(fā)送二進制數(shù)據(jù)晦譬。因此疤苹,發(fā)送 POST 請求時候,表單 <form> 屬性 enctype 共有二個值可選敛腌,這個屬性管理的是表單的 MIME 編碼:

① application/x-www-form-urlencoded (默認值)
② multipart/form-data

注:form 表單中 enctype 的默認值是 enctype="application/x- www-form-urlencoded".

通過 form 表單提交文件操作如下:

<FORM method="POST" action="http://w.sohu.com/t2/upload.do" enctype="multipart/form-data">
    <INPUT type="text" name="city" value="Santa colo">
    <INPUT type="text" name="desc">
    <INPUT type="file" name="pic">
 </FORM>

瀏覽器將會發(fā)送以下數(shù)據(jù):

POST /t2/upload.do HTTP/1.1
User-Agent: SOHUWapRebot
Accept-Language: zh-cn,zh;q=0.5
Accept-Charset: GBK,utf-8;q=0.7,*;q=0.7
Connection: keep-alive
Content-Length: 60408
Content-Type:multipart/form-data; boundary=ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Host: w.sohu.com

--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Content-Disposition: form-data; name="city"

Santa colo
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Content-Disposition: form-data;name="desc"
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
 
...
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC
Content-Disposition: form-data;name="pic"; filename="photo.jpg"
Content-Type: application/octet-stream
Content-Transfer-Encoding: binary
 
... binary data of the jpg ...
--ZnGpDtePMx0KrHh_G0X99Yef9r8JZsRJSXC--

從上面的 multipart/form-data 格式發(fā)送的請求的樣式來看卧土,它包含了多個 Parts,每個 Part 都包含頭信息部分像樊,
Part 頭信息中必須包含一個 Content-Disposition 頭尤莺,其他的頭信息則為可選項, 比如 Content-Type 等生棍。

Content-Disposition 包含了 type 和 一個名字為 name 的 parameter缝裁,type 是 form-data,name 參數(shù)的值則為表單控件(也即 field)的名字足绅,如果是文件,那么還有一個 filename 參數(shù)韩脑,值就是文件名氢妈。

比如:

Content-Disposition: form-data; name="user"; filename="hello.txt"

上面的 "user" 就是表單中的控件的名字,后面的參數(shù) filename 則是點選的文件名段多。
對于可選的 Content-Type(如果沒有的話)首量,默認就是 text/plain

注意:

如果文件內容是通過填充表單來獲得,那么上傳的時候加缘,Content-Type 會被自動設置(識別)成相應的格式鸭叙,如果沒法識別,那么就會被設置成 "application/octet-stream"
如果多個文件被填充成單個表單項拣宏,那么它們的請求格式則會是 multipart/mixed沈贝。

如果 Part 的內容跟默認的 encoding 方式不同,那么會有一個 "content-transfer-encoding" 頭信息來指定勋乾。

下面宋下,我們填充兩個文件到一個表單項中,行程的請求信息如下:

Content-Type: multipart/form-data; boundary=AaB03x

--AaB03x
Content-Disposition: form-data; name="submit-name"

Larry
--AaB03x
Content-Disposition: form-data; name="files"
Content-Type: multipart/mixed; boundary=BbC04y

--BbC04y
Content-Disposition: file; filename="file1.txt"
Content-Type: text/plain

... contents of file1.txt ...
--BbC04y
Content-Disposition: file; filename="file2.gif"
Content-Type: image/gif
Content-Transfer-Encoding: binary

...contents of file2.gif...
--BbC04y--
--AaB03x--

Boundary 分隔符

每個部分使用 --boundary 分割開來辑莫,最后一行使用 --boundary-- 結尾学歧。

實驗

To see exactly what is happening, use nc -l and an user agent like a browser or cURL.

Save the form to an .html file:

<FORM action="http://localhost:8000" method="post" enctype="multipart/form-data">
    <p><INPUT type="text" name="text" value="text default">
    <p><INPUT type="file" name="file1">
    <p><INPUT type="file" name="file2">
    <p><BUTTON type="submit">Submit</BUTTON>
</FORM>

Create files to upload:

echo 'Content of a.txt.' > a.txt
echo '<!DOCTYPE html><title>Content of a.html.</title>' > a.html

Run:

nc -l localhost 8000

Open the HTML on your browser, select the files and click on submit and check the terminal.

nc prints the request received. Firefox sent:

POST / HTTP/1.1
Host: localhost:8000
User-Agent: Mozilla/5.0 (X11; Ubuntu; Linux i686; rv:29.0) Gecko/20100101 Firefox/29.0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Language: en-US,en;q=0.5
Accept-Encoding: gzip, deflate
Cookie: __atuvc=34%7C7; permanent=0; _gitlab_session=226ad8a0be43681acf38c2fab9497240; __profilin=p%3Dt; request_method=GET
Connection: keep-alive
Content-Type: multipart/form-data; boundary=---------------------------9051914041544843365972754266
Content-Length: 554

-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="text"

text default
-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file1"; filename="a.txt"
Content-Type: text/plain

Content of a.txt.

-----------------------------9051914041544843365972754266
Content-Disposition: form-data; name="file2"; filename="a.html"
Content-Type: text/html

<!DOCTYPE html><title>Content of a.html.</title>

-----------------------------9051914041544843365972754266--

Aternativelly, cURL should send the same POST request as your a browser form:

nc -l localhost 8000
curl -F "text=default" -F "file1=@a.html" -F "file1=@a.txt" localhost:8000

You can do multiple tests with:

while true; do printf '' | nc -l localhost 8000; done

參考:

https://www.w3.org/TR/html401/interact/forms.html#h-17.13.4
https://stackoverflow.com/questions/4526273/what-does-enctype-multipart-form-data-mean/28380690#28380690
https://tools.ietf.org/html/rfc2388
https://stackoverflow.com/questions/913626/what-should-a-multipart-http-request-with-multiple-files-look-like

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市各吨,隨后出現(xiàn)的幾起案子枝笨,更是在濱河造成了極大的恐慌,老刑警劉巖揭蜒,帶你破解...
    沈念sama閱讀 216,324評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件横浑,死亡現(xiàn)場離奇詭異,居然都是意外死亡忌锯,警方通過查閱死者的電腦和手機伪嫁,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,356評論 3 392
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來偶垮,“玉大人张咳,你說我怎么就攤上這事∷贫妫” “怎么了脚猾?”我有些...
    開封第一講書人閱讀 162,328評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長砚哗。 經(jīng)常有香客問我龙助,道長,這世上最難降的妖魔是什么蛛芥? 我笑而不...
    開封第一講書人閱讀 58,147評論 1 292
  • 正文 為了忘掉前任提鸟,我火速辦了婚禮,結果婚禮上仅淑,老公的妹妹穿的比我還像新娘称勋。我一直安慰自己,他們只是感情好涯竟,可當我...
    茶點故事閱讀 67,160評論 6 388
  • 文/花漫 我一把揭開白布赡鲜。 她就那樣靜靜地躺著空厌,像睡著了一般。 火紅的嫁衣襯著肌膚如雪银酬。 梳的紋絲不亂的頭發(fā)上嘲更,一...
    開封第一講書人閱讀 51,115評論 1 296
  • 那天,我揣著相機與錄音揩瞪,去河邊找鬼赋朦。 笑死,一個胖子當著我的面吹牛壮韭,可吹牛的內容都是我干的北发。 我是一名探鬼主播,決...
    沈念sama閱讀 40,025評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼喷屋,長吁一口氣:“原來是場噩夢啊……” “哼琳拨!你這毒婦竟也來了?” 一聲冷哼從身側響起屯曹,我...
    開封第一講書人閱讀 38,867評論 0 274
  • 序言:老撾萬榮一對情侶失蹤狱庇,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后恶耽,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體密任,經(jīng)...
    沈念sama閱讀 45,307評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,528評論 2 332
  • 正文 我和宋清朗相戀三年偷俭,在試婚紗的時候發(fā)現(xiàn)自己被綠了浪讳。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,688評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡涌萤,死狀恐怖淹遵,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情负溪,我是刑警寧澤透揣,帶...
    沈念sama閱讀 35,409評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站川抡,受9級特大地震影響辐真,放射性物質發(fā)生泄漏。R本人自食惡果不足惜崖堤,卻給世界環(huán)境...
    茶點故事閱讀 41,001評論 3 325
  • 文/蒙蒙 一侍咱、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧密幔,春花似錦放坏、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,657評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至蜡豹,卻和暖如春麸粮,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背镜廉。 一陣腳步聲響...
    開封第一講書人閱讀 32,811評論 1 268
  • 我被黑心中介騙來泰國打工弄诲, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人娇唯。 一個月前我還...
    沈念sama閱讀 47,685評論 2 368
  • 正文 我出身青樓齐遵,卻偏偏與公主長得像,于是被迫代替她去往敵國和親塔插。 傳聞我的和親對象是個殘疾皇子梗摇,可洞房花燭夜當晚...
    茶點故事閱讀 44,573評論 2 353

推薦閱讀更多精彩內容