Nodejs+express中間件實現文件上傳的方法

小編給大家分享一下Nodejs+express中間件實現文件上傳的方法，相信大部分人都還不怎么了解，因此分享這篇文章給大家參考一下，希望大家閱讀完這篇文章后大有收獲，下面讓我們一起去了解一下吧！

用nodejs做項目時需要用到文件上傳的功能，在網上搜索了很多教程，找到了一個express的中間件，用于處理multipart/form-data類型的表單數據，可以很方便的將表單中的文件數據保存到服務器。

介紹

multer是一個node.js文件上傳中間件，它是在 busboy的基礎上開發的，上傳的表單數據必須是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對象，表示當前上傳的文件對象，有以下幾個屬性：

• fieldname：上傳的字段名

• originalname：上傳的文件名

• encoding：文件的編碼類型

• mimetype：文件的MIME類型

附：一些常用的MIME類型

定義路由回調

//單個文件上傳
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屬性是一個數組，數組的每一個對象都有以下屬性：

• fieldname：上傳的字段名

• originalname：上傳的文件名

• encoding：文件的編碼類型

• mimetype：文件的MIME類型

• destination：存儲的目錄（和destination回調函數中的目錄名一致）

• filename：保存的文件名（和filename回調函數中的文件名一致）

• path：保存的相對路徑

• size：文件的大小（單位：字節byte）

　　我們可以發現在路由的回調函數中的file對象比diskStorage中的file對象多了幾個屬性，這是因為在diskStorage中文件還沒有保存，只能知道文件的大致屬性；而路由的回調函數文件已經在服務器上保存好了，文件的保存路徑以及文件的大小都是已知的。

混合上傳

有時候我們可能需要用字段名來對上傳的文件進行一下劃分，比如說上傳多個圖片的時候可能有身份證還有頭像。雖然可以分開放到兩個接口中，但是會產生其他一系列的麻煩事。multer支持對圖片進行字段名的劃分。demo3地址

//多字段名上傳
let multipleFields = upload.fields([
    {name:'avatar'},
    {name:'gallery', maxCount:3},
]);
app.post('/upload/fields', (req,res)=>{
    multipleFields(req,res,(err) => {
        console.log(req.files);
        if(!!err){
            console.log(err.message);
            res.json({
                code: '2000',
                type: 'field',
                msg:err.message
            })
            return;
        }
        var fileList = [];
        for(let item in req.files){
            var fieldItem = req.files[item];
            fieldItem.map((elem) => {
                fileList.push({
                    fieldname: elem.fieldname,
                    originalname: elem.originalname
                })
            });
        }
        res.json({
            code: '0000',
            type: 'field',
            fileList: fileList,
            msg:''
        })
    });
});

在這邊也有req.files屬性，但是這個屬性并不是一個數組，而是一個復雜的對象，這個對象中有多個屬性，每個屬性名都是一個字段名，每個屬性下面又是一個數組，數組下面才是一個個的文件對象，結構大致如下：

{
    "avatar":[{
        fieldname: "",
        originalname: ""
        //...
    }],
    "gallery":[{
        fieldname: "",
        originalname: ""
        //...
    }]
}

過濾文件上傳

在文件上傳時，有時候會上傳一些我們不需要的文件類型，我們需要把一些不需要的文件給過濾掉。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對象，用來控制上傳的一些信息，它有以下一些屬性：

• fieldNameSize：field 名字最大長度，默認值：100 bytes

• fieldSize：field 值的最大長度，默認值：1MB

• fields：非文件 field 的最大數量

• fileSize：在multipart表單中, 文件最大長度 (字節單位)

• files：在multipart表單中, 文件最大數量

• parts：在multipart表單中, part傳輸的最大數量(fields + files)

在這邊我們把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:''
        });
    });
});

以上是“Nodejs+express中間件實現文件上傳的方法”這篇文章的所有內容，感謝各位的閱讀！相信大家都有了一定的了解，希望分享的內容對大家有所幫助，如果還想學習更多知識，歡迎關注億速云行業資訊頻道！