几个月前，我写了一篇有关如何使用express-fileupload中间件在Node.js和Express中上传文件的文章。

什么是Multer？

如前所述，Multer是用于处理multipart/form-data请求的Express中间件。当用户将文件上传到服务器时，浏览器会自动将请求编码为multipart/form-data。 Multer使在服务器上轻松处理此类请求变得容易。

项目设置

让我们为演示项目创建一个新目录，并通过键入以下命令切换到该目录：

$mkdir express-multer && cd express-multer

接下来，通过运行以下命令来创建package.json文件：

$ npm init -y

现在安装Multer，Express和其他必需的依赖项：

$ npm install express multer body-parser cors morgan --save

基本的Express服务器

现在让我们创建一个基本的Express服务器。首先，创建一个index.js文件：

$ touch index.js

将以下代码复制并粘贴到其中，以初始化所有模块并启动Express应用程序：
index.js

const express = require('express');
const multer = require('multer');
const cors = require('cors');
const bodyParser = require('body-parser');
const morgan = require('morgan');

// create express app
const app = express();

// upload file path
const FILE_PATH = 'uploads';

// configure multer
const upload = multer({
    dest: `${FILE_PATH}/`
});

// enable CORS
app.use(cors());

// add other middleware
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
app.use(morgan('dev'));

// start the app 
const port = process.env.PORT || 3000;

app.listen(port, () =>
    console.log(`App is listening on port ${port}.`)
);

上面的代码将Multer配置为接受multipart/form-data文件的上传请求并将其保存到uploads文件夹，启用跨域原始资源共享（CORS），并在端口3000上启动Express服务器。

上传单文件

让我们在Express应用程序中创建第一个路由，以允许用户上传其个人资料图片：

app.post('/upload-avatar', upload.single('avatar'), async (req, res) => {
    try {
        const avatar = req.file;

        // make sure file is available
        if (!avatar) {
            res.status(400).send({
                status: false,
                data: 'No file is selected.'
            });
        } else {
            // send response
            res.send({
                status: true,
                message: 'File is uploaded.',
                data: {
                    name: avatar.originalname,
                    mimetype: avatar.mimetype,
                    size: avatar.size
                }
            });
        }

    } catch (err) {
        res.status(500).send(err);
    }
});

上面的函数接收一个HTTP POST请求。 upload.single('avatar')是Multer中间件，它接受字段名称为avatar的单个文件，将其上传到目标文件夹，并将file属性添加到req对象。
我们可以使用req.file属性访问上传的文件。它具有以下重要信息：

fieldname —表单中使用的字段名称
originalname-用户计算机上文件的名称
encoding —文件的编码类型
mimetype—文件的Mime类型
size —文件大小，以字节为单位

在单个文件上传路由中，我们仅使用这些属性即可返回上传文件的详细信息。

上传多个文件

让我们添加另一条路由。这次一次上传多个文件：

app.post('/upload-photos', upload.array('photos', 8), async (req, res) => {
    try {
        const photos = req.files;

        // check if photos are available
        if (!photos) {
            res.status(400).send({
                status: false,
                data: 'No photo is selected.'
            });
        } else {
            let data = [];

            // iterate over all photos
            photos.map(p => data.push({
                name: p.originalname,
                mimetype: p.mimetype,
                size: p.size
            }));

            // send response
            res.send({
                status: true,
                message: 'Photos are uploaded.',
                data: data
            });
        }

    } catch (err) {
        res.status(500).send(err);
    }
});

使用Multer上传多个文件类似于对单个文件上传但有一些更改。 Multer中间件现在接受一个文件数组作为输入，一次最多8个文件。字段名称也更改为photos。

测试应用程序

通过在终端的项目根目录中运行以下命令来启动Express应用程序：

$ node index.js

它将在端口3000上启动应用程序。让我们使用Postman发送HTTP multipart/form-data请求：

单文件

Single File

多个文件

Multiple Files

文件大小限制

如果要限制文件大小，请将limits属性添加到传递给multer()的对象中：

const upload = multer({
    dest: `${FILE_PATH}/`,
    limits: {
        files: 5, // allow up to 5 files per request,
        fieldSize: 2 * 1024 * 1024 // 2 MB (max file size)
    }
});

过滤文件类型

有时我们只允许用户上传图像。您可以使用fileFilter属性轻松限制文件类型：

const upload = multer({
    dest: `${FILE_PATH}/`,
    limits: {
        files: 5, // allow up to 5 files per request,
        fieldSize: 2 * 1024 * 1024 // 2 MB (max file size)
    },
    fileFilter: (req, file, cb) => {
        // allow images only
        if (!file.originalname.match(/\.(jpg|jpeg|png|gif)$/)) {
            return cb(new Error('Only image are allowed.'), false);
        }
        cb(null, true);
    }
});

源代码：在MIT许可下从GitHub下载完整的源代码。

结论

今天就这些。您已经了解了如何在Node.js中使用Express和Multer上传文件。 Multer是一种易于使用的Express中间件，用于处理multipart/form-data请求。

查看官方文档以获取更多配置选项。

喜欢这篇文章吗？在Twitter和LinkedIn上关注我。您也可以订阅RSS Feed。

在Node.js中使用Multer进行文件上传