Nodejs+express中间件实现文件上传

 3828

本篇文章给大家详细介绍Nodejs文件上传的方法。有一定的参考价值,有需要的朋友可以参考一下,希望对大家有所帮助。


Nodejs+express中间件实现文件上传


笔者用nodejs做项目时需要用到文件上传的功能,在网上搜索了很多教程,找到了一个express中间件,用于处理multipart/form-data类型的表单数据,可以很方便的将表单中的文件数据保存到服务器。

介绍

multer是一个node.js文件上传中间件,它是在 busboy的基础上开发的,上传的表单数据必须是multipart/form-data类型,不然会报错。

简单的用法

定义存储器

Multer作为express的一个中间件,我们可以很方便的自定义上传的文件目录以及保存的文件名。先看一个最简单的用法,demo1地址

  1. var express = require('express');
  2. var multer = require('multer');
  3. var app = express();
  4.  
  5. var upload = multer({
  6.     storage: multer.diskStorage({
  7.         destination: function (req, file, cb) {
  8.             cb(null, './uploads/');
  9.         },
  10.         filename: function (req, file, cb) {
  11.             //file.originalname上传文件的原始文件名
  12.             var changedName = (new Date().getTime())+'-'+file.originalname;
  13.             cb(null, changedName);
  14.         }
  15.     })
  16. });

我们先创建了一个upload对象,这个对象中destination函数用来定义上传文件的存储的文件夹;filename函数用来修改上传文件存储到服务器的文件名称,这里我们我们加上一个时间戳简单区分一下。这两个函数都是通过回调函数来实现的。每次上传的时候这两个函数都会调用一次,如果是多个文件上传,那个这两个函数就调用多次,调用顺序是先调用destination,然后调用filename。


在两个函数中都会有一个file对象,表示当前上传的文件对象,有以下几个属性:

fieldname:上传的字段名

originalname:上传的文件名

encoding:文件的编码类型

mimetype:文件的MIME类型

附:一些常用的MIME类型


定义路由回调

  1. //单个文件上传
  2. app.post('/upload/single',upload.single('singleFile'),(req,res)=>{
  3.     console.log(req.file);
  4.     res.json({
  5.         code: '0000',
  6.         type:'single',
  7.         originalname: req.file.originalname
  8.     })
  9. });
  10.  
  11. //多个文件上传
  12. app.post('/upload/multer',upload.array('multerFile'),(req,res)=>{
  13.     console.log(req.files);
  14.     let fileList = [];
  15.     req.files.map((elem)=>{
  16.         fileList.push({
  17.             originalname: elem.originalname
  18.         })
  19.     });
  20.     res.json({
  21.         code: '0000',
  22.         type:'multer',
  23.         fileList:fileList
  24.     });
  25. });


在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地址


  1. //多字段名上传
  2. let multipleFields = upload.fields([
  3.     {name:'avatar'},
  4.     {name:'gallery', maxCount:3},
  5. ]);
  6. app.post('/upload/fields', (req,res)=>{
  7.     multipleFields(req,res,(err) => {
  8.         console.log(req.files);
  9.         if(!!err){
  10.             console.log(err.message);
  11.             res.json({
  12.                 code: '2000',
  13.                 type: 'field',
  14.                 msg:err.message
  15.             })
  16.             return;
  17.         }
  18.         var fileList = [];
  19.         for(let item in req.files){
  20.             var fieldItem = req.files[item];
  21.             fieldItem.map((elem) => {
  22.                 fileList.push({
  23.                     fieldname: elem.fieldname,
  24.                     originalname: elem.originalname
  25.                 })
  26.             });
  27.         }
  28.         res.json({
  29.             code: '0000',
  30.             type: 'field',
  31.             fileList: fileList,
  32.             msg:''
  33.         })
  34.     });
  35. });

在这边也有req.files属性,但是这个属性并不是一个数组,而是一个复杂的对象,这个对象中有多个属性,每个属性名都是一个字段名,每个属性下面又是一个数组,数组下面才是一个个的文件对象,结构大致如下:

  1. {
  2.     "avatar":[{
  3.         fieldname: "",
  4.         originalname: ""
  5.         //...
  6.     }],
  7.     "gallery":[{
  8.         fieldname: "",
  9.         originalname: ""
  10.         //...
  11.     }]
  12. }


过滤文件上传

在文件上传时,有时候会上传一些我们不需要的文件类型,我们需要把一些不需要的文件给过滤掉。demo2地址

文件类型过滤

  1. var upload = multer({
  2.     //...其他代码
  3.     fileFilter: function(req, file, cb){
  4.         if(file.mimetype == 'image/png'){
  5.             cb(null, true)
  6.         } else {
  7.             cb(null, false)
  8.         }
  9.     }
  10. });

在定义存储器的时候,新增一个fileFilter函数,用来过滤掉我们不需要的文件,在回调函数中我们传入true/false来代表是否要保存;如果传了false,那么destination函数和filename函数也不会调用了。


文件大小和数量过滤

  1. var upload = multer({
  2.     //...其他代码
  3.     limits:{
  4.         //限制文件大小10kb
  5.         fileSize: 10*1000,
  6.         //限制文件数量
  7.         files: 5
  8.     }
  9. });

在定义存储器的时候,新增一个limits对象,用来控制上传的一些信息,它有以下一些属性:

fieldNameSize:field 名字最大长度,默认值:100 bytes

fieldSize:field 值的最大长度,默认值:1MB

fields:非文件 field 的最大数量

fileSize:在multipart表单中, 文件最大长度 (字节单位)

files:在multipart表单中, 文件最大数量

parts:在multipart表单中, part传输的最大数量(fields + files)

在这边我们把fileSize的值设置得小一点,设为10kb方便测试看效果,但是如果这个时候会发现有报错。因为上传的文件大小很容易就会超过10KB,导致有报错出现,我们就需要在路由回调里对错误的情况进行捕获。

  1. //单个文件上传
  2. let singleUpload = upload.single('singleFile');
  3. app.post('/upload/single',(req,res)=>{
  4.     singleUpload(req,res,(err)=>{
  5.         if(!!err){
  6.             console.log(err.message)
  7.             res.json({
  8.                 code: '2000',
  9.                 type:'single',
  10.                 originalname: '',
  11.                 msg: err.message
  12.             })
  13.             return;
  14.         }
  15.         if(!!req.file){
  16.             res.json({
  17.                 code: '0000',
  18.                 type:'single',
  19.                 originalname: req.file.originalname,
  20.                 msg: ''
  21.             })
  22.         } else {
  23.             res.json({
  24.                 code: '1000',
  25.                 type:'single',
  26.                 originalname: '',
  27.                 msg: ''
  28.             })
  29.         }
  30.     });
  31. });
  32.  
  33. //多个文件上传
  34. let multerUpload = upload.array('multerFile');
  35. app.post('/upload/multer', (req,res)=>{
  36.     multerUpload(req,res,(err)=>{
  37.         if(!!err){
  38.             res.json({
  39.                 code: '2000',
  40.                 type:'multer',
  41.                 fileList:[],
  42.                 msg: err.message
  43.             });
  44.         }
  45.         let fileList = [];
  46.         req.files.map((elem)=>{
  47.             fileList.push({
  48.                 originalname: elem.originalname
  49.             })
  50.         });
  51.         res.json({
  52.             code: '0000',
  53.             type:'multer',
  54.             fileList:fileList,
  55.             msg:''
  56.         });
  57.     });
  58. });

所有的demo代码都在仓库里,地址:https://github.com/acexyf/multerDemo



本文网址:https://www.zztuku.com/detail-8804.html
站长图库 - Nodejs+express中间件实现文件上传
申明:如有侵犯,请 联系我们 删除。

评论(0)条

您还没有登录,请 登录 后发表评论!

提示:请勿发布广告垃圾评论,否则封号处理!!

    编辑推荐