使用 Multer 在 Node.js 中处理文件上传：综合指南

在 Web 开发领域，处理文件上传是一项常见要求。无论是个人资料图片、文档还是图像，许多应用程序都需要安全高效地上传和存储文件。将 Node.js 与 Express 结合使用时，Multer 是可顺利处理此任务的最佳库之一。

在本博客中，我们将介绍有关在 Node.js 中使用 Multer 所需了解的所有信息，包括安装、配置、存储选项、文件过滤以及常见用例和代码示例。

---

目录

1. 什么是 Multer？
2. 安装
3. 使用 Express 设置 Multer
4. 了解存储选项
   • 磁盘存储
   • 内存存储
   • 云存储（S3 示例）
5. 按类型过滤文件
6. 限制文件大小
7. 处理多个文件上传
8. Multer 中的错误处理
9. 现实世界用例
10. 结论

---

穆尔特是什么？

Multer 是一个用于处理 multipart/form-data 的中间件，multipart/form-data 是 Web 应用程序中上传文件的常用格式。它专门设计用于与 Express 配合使用，并通过提供以下功能来帮助管理文件上传：

• 文件存储：可配置的存储选项，用于将文件存储在服务器或其他存储服务上。
• 文件过滤：允许对文件类型设置限制。
• 大小限制：帮助限制文件大小以防止上传过多的数据。

安装

要开始使用 Multer，请通过 npm 安装它：

npm install multer

使用 Express 设置 Multer

让我们首先在 Express 应用程序中使用 Multer 设置基本文件上传处理程序。开始方法如下：

const express = require('express');
const multer = require('multer');
const app = express();

// Configure Multer for basic usage
const upload = multer({ dest: 'uploads/' }); // Destination folder for uploaded files

// Single File Upload Route
app.post('/upload', upload.single('file'), (req, res) => {
  res.send('File uploaded successfully!');
});

app.listen(3000, () => console.log('Server running on port 3000'));

在此示例中：

• upload.single('file'): 该中间件处理使用密钥文件上传的单个文件。
• 上传的文件将存储在uploads/文件夹中。

---

了解存储选项

Multer 提供两种主要存储选项：

1. 磁盘存储：将文件存储在服务器本地。
2. 内存存储：将文件作为Buffer对象存储在内存中（对于处理内存中的文件很有用）。

1. 磁盘存储

磁盘存储提供了对文件命名和目标路径的更多控制。

npm install multer

• destination：指定文件上传的文件夹。
• 文件名：允许自定义文件名（例如，添加时间戳以确保唯一性）。

2. 内存存储

在内存存储中，文件被存储为缓冲区，这对于短期文件或在不将文件保存到磁盘的情况下处理上传非常有用。

const express = require('express');
const multer = require('multer');
const app = express();

// Configure Multer for basic usage
const upload = multer({ dest: 'uploads/' }); // Destination folder for uploaded files

// Single File Upload Route
app.post('/upload', upload.single('file'), (req, res) => {
  res.send('File uploaded successfully!');
});

app.listen(3000, () => console.log('Server running on port 3000'));

云存储：Multer 与 AWS S3

对于生产应用程序，将文件直接存储在云存储（如 AWS S3）上通常更可取。要与 S3 集成，请使用 multer-s3。

const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, 'uploads/'), // Folder location
  filename: (req, file, cb) => {
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
    cb(null, uniqueSuffix + '-' + file.originalname);
  }
});

const upload = multer({ storage: storage });

const upload = multer({ storage: multer.memoryStorage() });

此设置将绕过本地存储，直接将文件上传到指定的 S3 存储桶。

---

按类型过滤文件

您可以按类型过滤文件以仅接受特定的文件格式（例如图像）。使用文件过滤选项。

npm install aws-sdk multer-s3

限制文件大小

要防止上传大文件，请设置限制选项。以下是将文件大小限制为 1MB 的方法：

const aws = require('aws-sdk');
const multerS3 = require('multer-s3');

aws.config.update({ region: 'your-region' });

const s3 = new aws.S3();

const upload = multer({
  storage: multerS3({
    s3: s3,
    bucket: 'your-s3-bucket-name',
    metadata: (req, file, cb) => cb(null, { fieldName: file.fieldname }),
    key: (req, file, cb) => cb(null, Date.now().toString() + '-' + file.originalname)
  })
});

处理多个文件上传

Multer还支持多个文件上传：

const fileFilter = (req, file, cb) => {
  // Accept only image files
  if (file.mimetype.startsWith('image/')) {
    cb(null, true); // Accept file
  } else {
    cb(new Error('Only image files are allowed!'), false); // Reject file
  }
};

const upload = multer({
  storage: storage,
  fileFilter: fileFilter
});

• upload.array('files', 5): 同一字段下最多允许上传5个文件。
• upload.fields：允许处理具有不同字段名称的文件。

---

Multer 中的错误处理

正确的错误处理对于流畅的用户体验至关重要。 Multer 可以抛出多种类型的错误，您可以像这样处理：

const upload = multer({
  storage: storage,
  limits: { fileSize: 1 * 1024 * 1024 } // 1 MB limit
});

现实世界的用例

以下是使用 Multer 的一些实际应用：

1. 个人资料图片上传：允许用户上传个人资料图片，将其存储在服务器或S3中，并将文件路径保存在数据库中。
2. 文档存储：使用自定义存储和过滤配置存储用户提交的文档（例如简历、PDF）。
3. 电子商务中的媒体文件：允许供应商上传产品图片，限制文件类型和大小，并将其存储在云存储中以便于检索。

结论

Multer 通过提供灵活的存储选项、文件过滤以及处理从单个文件到多个文件的各种上传要求，简化了 Node.js 应用程序中的文件处理。无论您是构建小型应用程序还是具有文件处理需求的生产级应用程序，Multer 都能满足您的需求。

编码快乐！ ?

以上是使用 Multer 在 Node.js 中处理文件上传：综合指南的详细内容。更多信息请关注PHP中文网其他相关文章！