DIV CSS 佈局教程網

用 FileReader 把檔案轉成 Base64 再透過 AJAX 上傳
編輯:關於JavaScript     

AJAX 本身無法直接上傳檔案。傳統做法是動態建立一個隱藏 iframe,讓表單在裡面提交,藉此達到「看起來像非同步」的效果。這個方法相容性極好,但程式碼量偏大;即使用上 plupload 這類外掛,複雜度仍在。

能不能更靈活一點,把檔案當成普通的表單參數來處理呢?FileReader 物件提供了這樣的可能:先把檔案讀成 Base64 字串,塞進隱藏欄位,再用一般的方式送出。

前端:讀檔並編碼

<head>
<meta charset="UTF-8">
</head>
<form onsubmit="return false;">
  <input type="hidden" name="file_base64" id="file_base64">
  <input type="file" id="fileup">
  <input type="submit" value="submit"
         onclick="$.post('./uploader.php', $(this).parent().serialize());">
</form>

<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.9.1/jquery.min.js"></script>
<script>
$(document).ready(function () {
  $("#fileup").change(function () {
    var reader = new FileReader();
    reader.readAsDataURL(this.files[0]);
    reader.onload = function (e) {
      console.log(e.target.result);
      $('#file_base64').val(e.target.result);
    };
  });
});
</script>

readAsDataURL 會把檔案讀成一個 data URI,格式是 data:image/png;base64,iVBORw0KG...,逗號之前是 MIME 型別,之後才是編碼內容。

後端:解碼並存檔

<?php
if (isset($_POST['file_base64'])) {
    $file_base64 = $_POST['file_base64'];
    // 去掉 data:...;base64, 前綴
    $file_base64 = preg_replace('/data:.*;base64,/i', '', $file_base64);
    $file_base64 = base64_decode($file_base64);
    file_put_contents('./file.save', $file_base64);
}

這個做法的取捨

優點:程式碼極短,檔案就跟其他欄位一樣用 serialize() 一起送出,不必處理 iframe 生命週期、也不必依賴外掛。在只需要服務小範圍使用者、對相容性要求不高的內部系統中,相當省事。

缺點需要清楚評估:

  • 體積膨脹約 33%。Base64 用 4 個字元編碼 3 個位元組,檔案會大一點五分之一,網路傳輸與記憶體佔用都跟著增加。
  • 編碼與解碼都要消耗資源。瀏覽器端把幾十 MB 的檔案讀成字串,很容易造成畫面卡頓甚至崩潰。
  • 繞過了伺服器的檔案上傳機制。PHP 的 $_FILES、upload_max_filesize、檔案暫存與串流處理都用不上,只能吃 POST body 上限(post_max_size),對大檔案不友善。
  • 記憶體壓力。檔案在後端必須完整載入記憶體才能解碼,無法串流處理。

更合適的現代方案

如果目標是「非同步上傳、有進度條」,其實不必繞道 Base64:

  • XMLHttpRequest 2 + FormData:直接把 File 物件放進 FormData 送出,支援上傳進度事件(xhr.upload.onprogress),檔案以二進位串流傳輸,沒有膨脹問題。這是目前最通用的做法。
  • fetch + FormData:語法更簡潔,但原生不提供上傳進度,需要額外手段。
const fd = new FormData();
fd.append('file', document.getElementById('fileup').files[0]);

const xhr = new XMLHttpRequest();
xhr.open('POST', './uploader.php');
xhr.upload.onprogress = e => {
  if (e.lengthComputable) {
    console.log((e.loaded / e.total * 100).toFixed(1) + '%');
  }
};
xhr.send(fd);

Base64 上傳真正合適的場合,是需要把檔案塞進 JSON payload 的 API 設計,或檔案本來就很小的場景(例如頭像、簽名圖)。處理大檔案時,FormData 才是正解。

最後補充相容性:FileReader 在主流瀏覽器與 IE10 以上都支援,IE9 及以下不支援。

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