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 生命週期、也不必依賴外掛。在只需要服務小範圍使用者、對相容性要求不高的內部系統中,相當省事。
缺點需要清楚評估:
如果目標是「非同步上傳、有進度條」,其實不必繞道 Base64:
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 及以下不支援。