您好,登錄后才能下訂單哦!
筆者用nodejs做項目時需要用到文件上傳的功能,在網上搜索了很多教程,找到了一個express的中間件,用于處理 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, './uploads/'); }, filename: function (req, file, cb){ //file.originalname上傳文件的原始文件名 var changedName = (new Date().getTime())+'-'+file.originalname; cb(null, changedName); } }) });
我們先創建了一個upload對象,這個對象中destination函數用來定義上傳文件的存儲的文件夾;filename函數用來修改上傳文件存儲到服務器的文件名稱,這里我們我們加上一個時間戳簡單區分一下。這兩個函數都是通過回調函數來實現的。每次上傳的時候這兩個函數都會調用一次,如果是多個文件上傳,那個這兩個函數就調用多次,調用順序是先調用destination,然后調用filename。
在兩個函數中都會有一個 file 對象,表示當前上傳的文件對象,有以下幾個屬性:
定義路由回調
//單個文件上傳 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屬性是一個數組,數組的每一個對象都有以下屬性:
我們可以發現在路由的回調函數中的file對象比diskStorage中的file對象多了幾個屬性,這是因為在diskStorage中文件還沒有保存,只能知道文件的大致屬性;而路由的回調函數文件已經在服務器上保存好了,文件的保存路徑以及文件的大小都是已知的。
過濾文件上傳
在文件上傳時,有時候會上傳一些我們不需要的文件類型,我們需要把一些不需要的文件給過濾掉。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對象,用來控制上傳的一些信息,它有以下一些屬性:
在這邊我們把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代碼都在這個 倉庫里
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持億速云。
免責聲明:本站發布的內容(圖片、視頻和文字)以原創、轉載和分享為主,文章觀點不代表本網站立場,如果涉及侵權請聯系站長郵箱:is@yisu.com進行舉報,并提供相關證據,一經查實,將立刻刪除涉嫌侵權內容。