multer用于处理文件上传的nodejs中间件,主要跟express框架搭配使用，只支持表单MIME编码为multipart/form-data类型的数据请求.
如果要处理其他编码的表单数据可以通过busboy或者formidable。
multer模块的安装: npm install multer
构造multer对象: multer(opt)
opt是个key-value对象，包含属性dest/storage,fileFilter,limits.分表表示文件的存储位置/方式，文件过滤，文件大小限制.
例如:
//通过设置dest属性，表示上传文件的存储位置
let objmulter = multer({ dest: path.join(__dirname,'uploads')});
如果想对上传文件做更多的选项设置，比如文件名，存储类型等可以通过指定storagelet storage = multer.diskStorage({
//文件存储路径
destination: (req , file , cb )=>{
cb(null , path.join(__dirname , 'uploads'));
},
//修改上传文件的名字
//file 是个文件对象 ,fieldname对应在客户端的name属性
//存储的文件需要自己加上文件的后缀，multer并不会自动添加
//这里直接忽略文件的后缀.
filename: (req , file , cb ) => {
cb( null, file.fieldname +'-' + Date.now());
}
});
let objMulter = multer({storage : storage });
如果初始化multer时候没有指定dest或者storage，上传的文件将保存在内存中，永远不会写入到磁盘中，在storage中如果没有指定destination值，那么上传的文件将存储在系统默认的临时文件夹.
multer关联的文件信息:
filedname : 在form表单中指定的name属性值
orginalname : 原始文件名
encoding : 文件编码方式
mimetype : 多媒体类型
size : 文件大小，单位b
destination : 文件上传后存储在服务端的路径
filename : 文件在服务端的命名
path : 文件在服务端的完整路径
buffer : 文件二进制数据
ps:其中destination,filename和path只有在指定storage属性时候有效.而buffer只有文件在内存中存储时候有效.
multer同时提供了single/array/fields/any方法用于对接受文件数的控制.
1) single(fieldname) 接收单个文件，通过req.file访问该文件
2) array(fieldnaem,[maxcount]) 接收多个文件,通过req.files数组方法文件.maxcount指定接收文件最大数.
3) fields(fields) 接受指定fieldname的文件,fieldname由客户端决定，通过req.files数组方法
4) any 接收所有文件上传,通过req.files访问文件
ps:该实例基于nodejs v5.8，js部分使用到es6， web框架基于express，web模板esj-mate,所以你需要安装nodejs，同时通过npm install命令安装express,ejs-mate,multer模块.
1.app.js
"use strict" const express = require('express'); const path = require('path'); const multer = require('multer'); let app = express(); let storage = multer.diskStorage({ //文件存储路径 destination: (req , file , cb )=>{ cb(null , path.join(__dirname , 'uploads')); }, //修改上传文件的名字 //file 是个文件对象 ,fieldname对应在客户端的name属性 filename: (req , file , cb ) => { cb( null, file.fieldname +'-' + Date.now()); } }); let METHOD_MODE = { SINGLE:'single',ARRAY:'array' , ANY:"any"}; let isDest = false; //不是dest就是storage let obj = null; let multerobj = null; if( isDest ){ multerobj = multer({ dest: path.join(__dirname,'uploads') }); }else { multerobj = multer({ storage: storage }); }; //默认使用single方法，如果需要使用 //array和any和field等方法 //在index.html也需要做相应的修改 let mode = METHOD_MODE.SINGLE; const FIELD_NAME = "_file"; let upload_multer ; (function(){ switch( mode ){ case METHOD_MODE.SINGLE: upload_multer = multerobj.single(FIELD_NAME);break; case METHOD_MODE.ARRAY: upload_multer = multerobj.array(FIELD_NAME);break; case METHOD_MODE.ANY: upload_multer = multerobj.any();break; default: upload_multer = null; break; } })(); if(upload_multer == null ){ throw new Error("exception"); } app.use('/public',express.static(path.join(__dirname , 'public'))); app.set('views',path.join(__dirname , "views")); app.set('view engine','html'); app.engine('html',require('ejs-mate')); app.get('/' , (req ,res) =>{ res.render('index',{title:'multer: File Upload Demo'}); }); let objMulter = multer({storage : storage }); app.post('/upload', (req, res ) => { upload_multer( req, res , function( err ){ if( mode == METHOD_MODE.ARRAY || mode == METHOD_MODE.ANY){ console.log( "file length: " + req.files.length ); }else if(mode == METHOD_MODE.SINGLE){ console.log(JSON.stringify( req.file )); } if(err) return res.json({issuccessful: 0, message: err }); else return res.json({issuccessful: 1, message: "File is uploaded "}); }); }); app.listen(3000,()=>{console.log("server is running...")});
2.index.html
<!doctype html> <html> <head> <meta charset="utf-8"> <title><%=title %> </title> </head> <body> <div> <form enctype="multipart/form-data" method="post" action="/upload"> File:<input type="file" id="_file" name="_file" style="400px;height:35px;"/> <!-- 仅仅在使用multer。array时候 --> <!-- <input type="file" id="_file1" name="_file" style="400px;height:35px;"/> <input type="file" id="_file2" name="_file" style="400px;height:35px;"/> --> <input type="submit" value="submit" style="100px;height:35px;" /> </form> </div> </body> </html>
启动程序，打开cmd然后cd到工程目录，node app.js