在web开发中，经常遇到处理文件上传的情况。而express框架在4.0版本后就不在支持req.files接收上传文件，对于文件上传，需要加multipart格式数据处理的中间件。multipart数据处理中间件有：busboy, multer, formidable, multiparty, connect-multiparty, pez等。本站使用了formidable插件，比较简单易用。
formidable是一个用于处理文件、图片、视频等数据上传的模块，支持GB级上传数据处理，支持多种客户端数据提交。有极高的测试覆盖率，非常适合在生产环境中使用。

安装

formidable是一个轻量级的应用包，可以不依赖于express等框架单独使用，也可以集成到exress框架中使用。安装命令如下： 

npm install formidable@latest



 使用

在nodejs原生环境中使用formidable。 

var formidable = require('formidable'),
    http = require('http'),
    util = require('util');

//用http模块创建一个http服务端 
http.createServer(function(req, res) {
  if (req.url == '/upload' && req.method.toLowerCase() === 'post') {
    // 处理上传的文件
    var form = new formidable.IncomingForm();
 
    form.parse(req, function(err, fields, files) {
      res.writeHead(200, {'content-type': 'text/plain'});
      res.write('received upload:\n\n');
      res.end(util.inspect({fields: fields, files: files}));
    });
 
    return;
  }



 上传后，响应结果如下  

received upload:

{ fields: { title: 'title的内容' },
  files:      //所有type="file"类型的数据对象
   { upload: 
      { domain: null,
        _events: {},
        _maxListeners: 10,
        size: 41966,             //文件大小
        path: '/var/folders/1k/86kq55_n4_q2tckwz9mb5wyr0000gn/T/upload_ecbf965abc1e14c2ffc86875c2f5eaa8',   //文件保存路径
        name: 'avatar.jpg',     //上传前的文件名
        type: 'image/jpeg',    //文件类型
        hash: null,
        lastModifiedDate: Sat May 16 2015 10:38:57 GMT+0800 (CST),
        _writeStream: [Object] } } }



 常用API

创建一个incoming form实例  

var form = new formidable.IncomingForm()



 设置incoming form fields（fileds指除type="file"外的其它接收数据）编码  

form.encoding = 'utf-8';



设置文件接收后保存的文件夹。此文件夹一般为上传后的临时文件夹，上传后调用 fs.rename()对文件进行移动及重命名。默认保存路径为os.tmpDir()  

form.uploadDir = "/my/dir";

设置上传后文件是否使用原扩展名，默认值为false。如果希望保存到form.uploadDir中的文件使用原扩展名时，需要将此项设置为true  


form.keepExtensions = false;



 'multipart'或'urlencoded'类型的请求在formidable都支持，可通过上传文件的type属性查看文件类型  

form.type

 设置上传文件的大小，默认值为2M  

form.maxFieldsSize = 2 * 1024 * 1024;

 设置最大可接收字段数，用于防止内存溢出，默认值为1000  

form.maxFields = 1000;

 是否对上传文件进行hash较验，可设置为'sha1' 或 'md5'  

form.hash = false;

在express中使用formidable

在express框架中使用formidable，需要一个接收文件提交的路由。以下示例为一个接收用户头像提交的路由 

router.post("/user/avatar", user.avatar);



 路由对应的接收提交数据的方法 

//设置头像
exports.avatar = function(req, res, next) {
    var form = new formidable.IncomingForm();
    form.uploadDir = path.join(__dirname, 'tmp');   //文件保存的临时目录为当前项目下的tmp文件夹
    form.maxFieldsSize = 1 * 1024 * 1024;  //用户头像大小限制为最大1M  
    form.keepExtensions = true;        //使用文件的原扩展名
    form.parse(req, function (err, fields, file) {
        var filePath = '';
        //如果提交文件的form中将上传文件的input名设置为tmpFile，就从tmpFile中取上传文件。否则取for in循环第一个上传的文件。
        if(file.tmpFile){
            filePath = file.tmpFile.path;
        } else {
            for(var key in file){
                if( file[key].path && filePath==='' ){
                    filePath = file[key].path;
                    break;
                }
            }
        }
        //文件移动的目录文件夹，不存在时创建目标文件夹
        var targetDir = path.join(__dirname, 'upload');
        if (!fs.existsSync(targetDir)) {
            fs.mkdir(targetDir);
        }
        var fileExt = filePath.substring(filePath.lastIndexOf('.'));
        //判断文件类型是否允许上传
        if (('.jpg.jpeg.png.gif').indexOf(fileExt.toLowerCase()) === -1) {
            var err = new Error('此文件类型不允许上传');
            res.json({code:-1, message:'此文件类型不允许上传'});
        } else {
            //以当前时间戳对上传文件进行重命名
            var fileName = new Date().getTime() + fileExt;
            var targetFile = path.join(targetDir, fileName);
            //移动文件
            fs.rename(filePath, targetFile, function (err) {
                if (err) {
                    console.info(err);
                    res.json({code:-1, message:'操作失败'});
                } else {
                    //上传成功，返回文件的相对路径
                    var fileUrl = '/upload/' + fileName;
                    res.json({code:0, fileUrl:fileUrl});
                }
            });
        }
    });
}