本篇文章給大家詳細介紹Nodejs文件上傳的方法。有一定的參考價值，有需要的朋友可以參考一下，希望對大家有所幫助。
筆者用nodejs做項目時需要用到文件上傳的功能，在網上搜索了很多教程，找到了一個express的中間件，用于處理multipart/form-data類型的表單數據，可以很方便的將表單中的文件數據保存到服務器。
介紹
multer是一個node.js文件上傳中間件，它是在 busboy的基礎上開發的，上傳的表單數據必須是multipart/form-data類型，不然會報錯。
簡單的用法
定義存儲器
Multer作為express的一個中間件，我們可以很方便的自定義上傳的文件目錄以及保存的文件名。先看一個最簡單的用法，demo1地址：
var express = require('express');
var multer = require('multer');
var app = express();
var upload = multer({
storage: multer.diskStorage({
destination: function (req, file, cb) {
cb(null, '.https://www.zztuku.com/uploads/');
},
filename: function (req, file, cb) {
//file.originalname上傳文件的原始文件名
var changedName = (new Date().getTime())+'-'+file.originalname;
cb(null, changedName);
}
})
});我們先創建了一個upload對象，這個對象中destination函數用來定義上傳文件的存儲的文件夾；filename函數用來修改上傳文件存儲到服務器的文件名稱，這里我們我們加上一個時間戳簡單區分一下。這兩個函數都是通過回調函數來實現的。每次上傳的時候這兩個函數都會調用一次，如果是多個文件上傳，那個這兩個函數就調用多次，調用順序是先調用destination，然后調用filename。
在兩個函數中都會有一個file對象，表示當前上傳的文件對象，有以下幾個屬性：
fieldname：上傳的字段名
originalname：上傳的文件名
encoding：文件的編碼類型
mimetype：文件的MIME類型
附：一些常用的MIME類型
定義路由回調
//單個文件上傳
app.post('/upload/single',upload.single('singleFile'),(req,res)=>{
console.log(req.file);
res.json({
code: '0000',
type:'single',
originalname: req.file.originalname
})
});
//多個文件上傳
app.post('/upload/multer',upload.array('multerFile'),(req,res)=>{
console.log(req.files);
let fileList = [];
req.files.map((elem)=>{
fileList.push({
originalname: elem.originalname
})
});
res.json({
code: '0000',
type:'multer',
fileList:fileList
});
});在express中定義路由的回調函數時，把定義好了的upload對象作為中間件添加進去。如果是單個文件就用single方法，如果是多個文件就用array方法，這兩個方法都需要傳一個頁面上定義好的字段名。
在路由的回調函數中，request對象已經有了file屬性（單個文件上傳）或files屬性（多個文件上傳），files屬性是一個數組，數組的每一個對象都有以下屬性：
fieldname：上傳的字段名
originalname：上傳的文件名
encoding：文件的編碼類型
mimetype：文件的MIME類型
destination：存儲的目錄（和destination回調函數中的目錄名一致）
filename：保存的文件名（和filename回調函數中的文件名一致）
path：保存的相對路徑
size：文件的大小（單位：字節byte）
我們可以發現在路由的回調函數中的file對象比diskStorage中的file對象多了幾個屬性，這是因為在diskStorage中文件還沒有保存，只能知道文件的大致屬性；而路由的回調函數文件已經在服務器上保存好了，文件的保存路徑以及文件的大小都是已知的。
混合上傳
有時候我們可能需要用字段名來對上傳的文件進行一下劃分，比如說上傳多個圖片的時候可能有身份證還有頭像。雖然可以分開放到兩個接口中，但是會產生其他一系列的麻煩事。multer支持對圖片進行字段名的劃分。demo3地址
//多字段名上傳
let multipleFields = upload.fields([
{name:'avatar'},
{name:'gallery', maxCount:3},
]);
app.post('/upload/fields', (req,res)=>{
multipleFields(req,res,(err) => {
console.log(req.files);
if(!!err){
console.log(err.message);
res.json({
code: '2000',
type: 'field',
msg:err.message
})
return;
}
var fileList = [];
for(let item in req.files){
var fieldItem = req.files[item];
fieldItem.map((elem) => {
fileList.push({
fieldname: elem.fieldname,
originalname: elem.originalname
})
});
}
res.json({
code: '0000',
type: 'field',
fileList: fileList,
msg:''
})
});
});在這邊也有req.files屬性，但是這個屬性并不是一個數組，而是一個復雜的對象，這個對象中有多個屬性，每個屬性名都是一個字段名，每個屬性下面又是一個數組，數組下面才是一個個的文件對象，結構大致如下：
{
"avatar":[{
fieldname: "",
originalname: ""
//...
}],
"gallery":[{
fieldname: "",
originalname: ""
//...
}]
}過濾文件上傳
在文件上傳時，有時候會上傳一些我們不需要的文件類型，我們需要把一些不需要的文件給過濾掉。demo2地址。
文件類型過濾
var upload = multer({
//...其他代碼
fileFilter: function(req, file, cb){
if(file.mimetype == 'image/png'){
cb(null, true)
} else {
cb(null, false)
}
}
});在定義存儲器的時候，新增一個fileFilter函數，用來過濾掉我們不需要的文件，在回調函數中我們傳入true/false來代表是否要保存；如果傳了false，那么destination函數和filename函數也不會調用了。
文件大小和數量過濾
var upload = multer({
//...其他代碼
limits:{
//限制文件大小10kb
fileSize: 10*1000,
//限制文件數量
files: 5
}
});在定義存儲器的時候，新增一個limits對象，用來控制上傳的一些信息，它有以下一些屬性：
fieldNameSize：field 名字最大長度，默認值：100 bytes
fieldSize：field 值的最大長度，默認值：1MB
fields：非文件 field 的最大數量
fileSize：在multipart表單中, 文件最大長度 (字節單位)
files：在multipart表單中, 文件最大數量
parts：在multipart表單中, part傳輸的最大數量(fields + files)
在這邊我們把fileSize的值設置得小一點，設為10kb方便測試看效果，但是如果這個時候會發現有報錯。因為上傳的文件大小很容易就會超過10KB，導致有報錯出現，我們就需要在路由回調里對錯誤的情況進行捕獲。
//單個文件上傳
let singleUpload = upload.single('singleFile');
app.post('/upload/single',(req,res)=>{
singleUpload(req,res,(err)=>{
if(!!err){
console.log(err.message)
res.json({
code: '2000',
type:'single',
originalname: '',
msg: err.message
})
return;
}
if(!!req.file){
res.json({
code: '0000',
type:'single',
originalname: req.file.originalname,
msg: ''
})
} else {
res.json({
code: '1000',
type:'single',
originalname: '',
msg: ''
})
}
});
});
//多個文件上傳
let multerUpload = upload.array('multerFile');
app.post('/upload/multer', (req,res)=>{
multerUpload(req,res,(err)=>{
if(!!err){
res.json({
code: '2000',
type:'multer',
fileList:[],
msg: err.message
});
}
let fileList = [];
req.files.map((elem)=>{
fileList.push({
originalname: elem.originalname
})
});
res.json({
code: '0000',
type:'multer',
fileList:fileList,
msg:''
});
});
});所有的demo代碼都在倉庫里，地址：https://github.com/acexyf/multerDemo
