朋友問怎麼做無刷新上傳檔案。最粗暴的解法就是上網找各種 JS 函式庫,順便還附贈多圖上傳、預覽、甚至圖片處理等一堆特技。但如果完全不碰第三方庫,只用原生 Ajax 做得到嗎?
常見的答案是借助 iframe 隱藏框架,這裡不細談。而 HTML5 提供了更好的東西——FormData。它能幫我們把參數、乃至檔案資源本身打包好,於是只要一行 new FormData(form),就能用 $.ajax 輕鬆完成無刷新上傳,也不需要 iframe。
<!DOCTYLE html> <meta charset=utf-> <head> <script type="text/javascript" src="https://apps.bdimg.com/libs/jquery/../jquery.min.js"></script> </head> <script type="text/javascript"> $(function(){ $('#add').submit(function(){ var data = new FormData($('#add')[]); console.log(data); $.ajax({ url: 'ajax.php', type: 'POST', data: data, dataType: 'JSON', cache: false, processData: false, contentType: false, success:function(data){ alert("UploadFile Success"); } }); return false; }); }); </script> <form id='add'> <input type="text" name='book'></input> <input type="file" name='source'></input> <input type="submit"> </form>
其他部分不贅述,只講關鍵的那一行:
var data = new FormData($('#add')[0]);
因為 FormData 的建構子要的是原生 DOM 元素,而 jQuery 選到的永遠是一個包裝過的集合物件。用 [0] 把裡面的原生節點取出來,等價寫法就是 document.getElementById('add')。記住這個關係:js 元素 = $(selector)[0]。
把表單物件丟進去之後,它會把每個表單欄位整理成 key => value 的形式。更棒的是,你也可以完全不從表單建構,改用手動 append:
var fd = new FormData(); fd.append('book', 'some title'); fd.append('source', document.getElementById('file').files[0]); fd.append('extra', 'additional field');
這在「表單不存在」或「要送出額外欄位」的場景特別有用。
$.ajax 裡的這兩行是無痛關鍵:
processData: false:阻止 jQuery 把 FormData 轉成字串。少了它,你送出去的會是 [object FormData]。contentType: false:阻止 jQuery 手動設定 Content-Type。少了它,boundary 分隔符號會出錯,伺服器永遠解析不到檔案。讓瀏覽器自己帶上正確的 multipart/form-data; boundary=... 才是對的。 <?php header('Content-Type:application/json; charset=utf-8'); echo json_encode(array($_FILES,$_REQUEST)); ?>
這裡只是做個測試:若 $_FILES 裡有東西,就證明上傳確實成功。
可以看到請求確實送到了 ajax.php:

看一下 preview,就能確認 $_FILES 的相關資訊都回來了:

範例中的 PHP 只是把 $_FILES 原封不動 echo 出來,實際專案至少要處理三件事:用 move_uploaded_file() 落檔(不要用 copy(),前者才會檢查上傳合法性)、以白名單驗證副檔名並重新命名存檔(切勿沿用使用者傳來的檔名)、以及限制檔案大小並在伺服器端再驗一次型別。少了這些,這個上傳端點就是一個現成的檔案上傳漏洞。