DIV CSS 佈局教程網

用 HTML5 FormData 實現無刷新檔案上傳(不靠任何外掛)
編輯:AJAX基礎知識     

朋友問怎麼做無刷新上傳檔案。最粗暴的解法就是上網找各種 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]);

為什麼是 $('#add')[0]?

因為 FormData 的建構子要的是原生 DOM 元素,而 jQuery 選到的永遠是一個包裝過的集合物件。用 [0] 把裡面的原生節點取出來,等價寫法就是 document.getElementById('add')。記住這個關係:js 元素 = $(selector)[0]。

FormData 還能做什麼

把表單物件丟進去之後,它會把每個表單欄位整理成 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 端

 <?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(),前者才會檢查上傳合法性)、以白名單驗證副檔名並重新命名存檔(切勿沿用使用者傳來的檔名)、以及限制檔案大小並在伺服器端再驗一次型別。少了這些,這個上傳端點就是一個現成的檔案上傳漏洞。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved