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

在node中 使用 axios 上传文件_服务端

在node中 使用 axios 上传文件_html_02

<!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="width:400px;height:35px;"/>
      <!-- 仅仅在使用multer。array时候 -->
      <!-- <input type="file" id="_file1" name="_file" style="width:400px;height:35px;"/>
      <input type="file" id="_file2" name="_file" style="width:400px;height:35px;"/> -->
      <input type="submit" value="submit" style="width:100px;height:35px;" />
    </form>
  </div>
</body>
</html>

View Code

 

启动程序，打开cmd然后cd到工程目录，node app.js