在 Web 开发领域，处理文件上传是一项常见要求。无论是个人资料图片、文档还是图像，许多应用程序都需要安全高效地上传和存储文件。将 Node.js 与 Express 结合使用时，Multer 是可顺利处理此任务的最佳库之一。
在本博客中，我们将介绍有关在 Node.js 中使用 Multer 所需了解的所有信息，包括安装、配置、存储选项、文件过滤以及常见用例和代码示例。
Multer 是一个用于处理 multipart/form-data 的中间件，multipart/form-data 是 Web 应用程序中上传文件的常用格式。它专门设计用于与 Express 配合使用，并通过提供以下功能来帮助管理文件上传：
要开始使用 Multer，请通过 npm 安装它：
npm install 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'));
在此示例中：
Multer 提供两种主要存储选项：
磁盘存储提供了对文件命名和目标路径的更多控制。
npm install 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'));
对于生产应用程序，将文件直接存储在云存储（如 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
});
正确的错误处理对于流畅的用户体验至关重要。 Multer 可以抛出多种类型的错误，您可以像这样处理：
const upload = multer({
storage: storage,
limits: { fileSize: 1 * 1024 * 1024 } // 1 MB limit
});
以下是使用 Multer 的一些实际应用：
Multer 通过提供灵活的存储选项、文件过滤以及处理从单个文件到多个文件的各种上传要求，简化了 Node.js 应用程序中的文件处理。无论您是构建小型应用程序还是具有文件处理需求的生产级应用程序，Multer 都能满足您的需求。
编码快乐！ ?
以上是使用 Multer 在 Node.js 中处理文件上传：综合指南的详细内容。更多信息请关注PHP中文网其他相关文章！
