緣起
身為 Node 新手,最近在做一个聊天應用,功能涵蓋註冊登入、單人與多人聊天、表情、各類檔案上傳下載、好友增刪、聊天紀錄保存、通知音開關、背景圖切換與小遊戲等等,因此用到了 multer 這個模組。翻了不少文件、寫了幾個 demo,最後終於把單檔上傳跑通,能支援大部分常見格式,並把結果呈現在網頁上。
成品預覽
是不是有點微信的既視感?沒錯,介面參考的就是網頁版微信。

要還原整體視覺,還得搭配 CSS 與 HTML 一起調整。本身是前端初學者,第一次寫文章手忙腳亂,近期會把程式碼放上 GitHub,有興趣的朋友可以過去看看。
以下直接看程式。
安裝
開啟命令提示字元,直接安裝 multer:
npm install multer -save
//引入http
const http = require("http");
//引入express
const express = require("express");
//引入multer
const multer = require("multer");
//創建服務器,綁定監聽端口
var app = express();
var server = http.createServer(app);
server.listen(8081);
//建立public文件夾,將HTML文件放入其中,允許訪問
app.use(express.static("public"));
//文件上傳所需代碼
//設置文件上傳路徑和文件命名
var storage = multer.diskStorage({
destination: function (req, file, cb) {
//文件上傳成功後會放入public下的upload文件夾
cb(null, './public/upload')
},
filename: function (req, file, cb) {
//設置文件的名字為其原本的名字,也可以添加其他字符,來區別相同文件
//例如 file.originalname + new Date().getTime(); 利用時間來區分
cb(null, file.originalname)
}
});
var upload = multer({ storage: storage });
//處理來自頁面的ajax請求。single 表示單文件上傳
app.post('/upload', upload.single('file'), function (req, res, next) {
//拼接文件上傳後的網絡路徑
var url = 'https://' + req.headers.host + '/upload/' + req.file.originalname;
//將其發回客戶端
res.json({ code: 1, data: url });
res.end();
});
這裡有個實務上要注意的地方:直接用 file.originalname 當檔名,同名檔案會互相覆蓋。註解裡提到的「原名 + 時間戳」是更安全的做法;另外 static 資料夾若開放上傳內容直接存取,也要留意上傳可執行的檔案類型。
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8">
<title></title>
<!--依托於jquery-->
<script src="js/jquery-1.11.3.js"></script>
</head>
<body>
<div class="container">
<label>file</label>
<input type="file" name="file" id="file">
</div>
<script>
var file = $("#file")[0];
//這裡使用的是onchange事件,所以當你選擇完文件之後,就觸發事件上傳
file.onchange = function () {
//創建一個 FormData
var formData = new FormData();
//將文件信息追加到其中
formData.append('file', file.files[0]);
//利用split切割,拿到上傳文件的格式
var src = file.files[0].name, formart = src.split(".")[1];
//使用if判斷上傳文件格式是否符合
if (formart == "jpg" || formart == "png" ||
formart == "docx" || formart == "txt" ||
formart == "ppt" || formart == "xlsx" ||
formart == "zip" || formart == "rar" ||
formart == "doc") {
//只有滿足以上格式時,才會觸發ajax請求
$.ajax({
url: '/upload',
type: 'POST',
data: formData,
cache: false,
contentType: false,
processData: false,
success: function (data) {
//上傳成功之後,返回對象data
if (data.code > 0) {
var src = data.data;
//利用返回值src網絡路徑,來實現上傳文檔的下載
if (formart == "docx" || formart == "txt" || formart == "doc") {
//結合css樣式,實現顯示圖標
var className = "docx";
//拼接html,生成到頁面上去
var msg = `<a href="${src}" rel="external nofollow" ><i class="${className}"></i></a>`;
} else if (formart == "ppt") {
//PPT 格式
className = "ppt";
msg = `<a href="${src}" rel="external nofollow" ><i class="${className}"></i></a>`;
} else if (formart == "xlsx") {
//xlsx 格式
className = "xlsx";
msg = `<a href="${src}" rel="external nofollow" ><i class="${className}"></i></a>`;
} else if (formart == "zip" || formart == "rar") {
//zip || rar 格式
className = "zip";
msg = `<a href="${src}" rel="external nofollow" ><i class="${className}"></i></a>`;
} else {
//所有的圖片格式
msg = `<a href="javascript:;" rel="external nofollow" class="picCheck"><img src="${src}"></a>`;
}
//這裡將msg追加到你要顯示的區域
}
}
//不滿足上傳格式時
});
} else {
alert("文件格式不支持上傳")
}
}
</script>
</body>
</html>
整段的重點其實就三塊:前端用 FormData 裝檔案並關掉 jQuery 的 contentType/processData,multer 的 diskStorage 決定存哪、叫什麼,最後把可存取的 URL 回傳給前端拼成下載連結。格式判斷目前只看副檔名,正式環境建議前後端都做二次驗證。
總結
以上就是 Ajax 搭配 Node.js multer 實作檔案上傳的過程,希望對你有所幫助。有問題歡迎留言,我會盡快回覆。