在 Web 開發(fā)領域，處理文件上傳是一項常見要求。無論是個人資料圖片、文檔還是圖像，許多應用程序都需要安全高效地上傳和存儲文件。將 Node.js 與 Express 結合使用時，Multer 是可順利處理此任務的最佳庫之一。

在本博客中，我們將介紹有關在 Node.js 中使用 Multer 所需了解的所有信息，包括安裝、配置、存儲選項、文件過濾以及常見用例和代碼示例。

---

目錄

1. 什么是 Multer？
2. 安裝
3. 使用 Express 設置 Multer
4. 了解存儲選項
   • 磁盤存儲
   • 內存存儲
   • 云存儲（S3 示例）
5. 按類型過濾文件
6. 限制文件大小
7. 處理多個文件上傳
8. Multer 中的錯誤處理
9. 現(xiàn)實世界用例
10. 結論

---

穆爾特是什么？

Multer 是一個用于處理 multipart/form-data 的中間件，multipart/form-data 是 Web 應用程序中上傳文件的常用格式。它專門設計用于與 Express 配合使用，并通過提供以下功能來幫助管理文件上傳：

• 文件存儲：可配置的存儲選項，用于將文件存儲在服務器或其他存儲服務上。
• 文件過濾：允許對文件類型設置限制。
• 大小限制：幫助限制文件大小以防止上傳過多的數(shù)據(jù)。

安裝

要開始使用 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. 內存存儲

在內存存儲中，文件被存儲為緩沖區(qū)，這對于短期文件或在不將文件保存到磁盤的情況下處理上傳非常有用。

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
});

現(xiàn)實世界的用例

以下是使用 Multer 的一些實際應用：

1. 個人資料圖片上傳：允許用戶上傳個人資料圖片，將其存儲在服務器或S3中，并將文件路徑保存在數(shù)據(jù)庫中。
2. 文檔存儲：使用自定義存儲和過濾配置存儲用戶提交的文檔（例如簡歷、PDF）。
3. 電子商務中的媒體文件：允許供應商上傳產品圖片，限制文件類型和大小，并將其存儲在云存儲中以便于檢索。

結論

Multer 通過提供靈活的存儲選項、文件過濾以及處理從單個文件到多個文件的各種上傳要求，簡化了 Node.js 應用程序中的文件處理。無論您是構建小型應用程序還是具有文件處理需求的生產級應用程序，Multer 都能滿足您的需求。

編碼快樂！ ?

以上是使用 Multer 在 Node.js 中處理文件上傳：綜合指南的詳細內容。更多信息請關注PHP中文網其他相關文章！