在 Web 開(kāi)發(fā)領(lǐng)域，處理文件上傳是常見(jiàn)要求。無(wú)論是個(gè)人資料圖片、文件還是圖像，許多應(yīng)用程式都需要安全且有效率地上傳和儲(chǔ)存文件。將 Node.js 與 Express 結(jié)合使用時(shí)，Multer 是可順利處理此任務(wù)的最佳函式庫(kù)之一。

在本部落格中，我們將介紹有關(guān)在 Node.js 中使用 Multer 所需了解的所有信息，包括安裝、配置、存儲(chǔ)選項(xiàng)、文件過(guò)濾以及常見(jiàn)用例和程式碼範(fàn)例。

---

目錄

1. 什麼是 Multer？
2. 安裝
3. 使用 Express 設(shè)定 Multer
4. 了解儲(chǔ)存選項(xiàng)
   • 磁碟儲(chǔ)存
   • 記憶體儲(chǔ)存
   • 雲(yún)端儲(chǔ)存（S3 範(fàn)例）
5. 依型別過(guò)濾檔案
6. 限製檔案大小
7. 處理多個(gè)檔案上傳
8. Multer 中的錯(cuò)誤處理
9. 現(xiàn)實(shí)世界用例
10. 結(jié)論

---

穆?tīng)柼厥鞘颤N？

Multer 是用來(lái)處理 multipart/form-data 的中間件，multipart/form-data 是 Web 應(yīng)用程式中上傳檔案的常用格式。它專(zhuān)門(mén)設(shè)計(jì)用於與 Express 配合使用，並透過(guò)提供以下功能來(lái)幫助管理文件上傳：

• 檔案儲(chǔ)存：可設(shè)定的儲(chǔ)存選項(xiàng)，用於將檔案儲(chǔ)存在伺服器或其他儲(chǔ)存服務(wù)上。
• 檔案過(guò)濾：允許對(duì)檔案類(lèi)型設(shè)定限制。
• 大小限制：幫助限製檔案大小以防止上傳過(guò)多的資料。

安裝

要開(kāi)始使用 Multer，請(qǐng)透過(guò) npm 安裝它：

npm install multer

使用 Express 設(shè)定 Multer

讓我們先在 Express 應(yīng)用程式中使用 Multer 設(shè)定基本檔案上傳處理程序。開(kāi)始方法如下：

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

在此範(fàn)例中：

• upload.single('file'): 此中間件處理使用金鑰檔案上傳的單一檔案。
• 上傳的檔案將儲(chǔ)存在uploads/資料夾中。

---

了解儲(chǔ)存選項(xiàng)

Multer 提供兩種主要儲(chǔ)存選項(xiàng)：

1. 磁碟儲(chǔ)存：將檔案儲(chǔ)存在伺服器本機(jī)。
2. 記憶體儲(chǔ)存：將檔案儲(chǔ)存為Buffer物件在記憶體中（對(duì)於處理記憶體中的檔案很有用）。

1. 磁碟存儲(chǔ)

磁碟儲(chǔ)存提供了對(duì)檔案命名和目標(biāo)路徑的更多控制。

npm install multer

• destination：指定檔案上傳的資料夾。
• 檔案名稱(chēng)：允許自訂檔案名稱(chēng)（例如，新增時(shí)間戳記以確保唯一性）。

2. 內(nèi)存存儲(chǔ)

在記憶體儲(chǔ)存中，檔案被儲(chǔ)存為緩衝區(qū)，這對(duì)於短期檔案或在不將檔案儲(chǔ)存到磁碟的情況下處理上傳非常有用。

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

雲(yún)端儲(chǔ)存：Multer 與 AWS S3

對(duì)於生產(chǎn)應(yīng)用程序，將檔案直接儲(chǔ)存在雲(yún)端儲(chǔ)存（如 AWS S3）上通常更可取。若要與 S3 集成，請(qǐng)使用 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() });

此設(shè)定將繞過(guò)本機(jī)存儲(chǔ)，直接將檔案上傳到指定的 S3 儲(chǔ)存桶。

---

按類(lèi)型過(guò)濾文件

您可以按類(lèi)型過(guò)濾文件以?xún)H接受特定的文件格式（例如圖像）。使用檔案過(guò)濾選項(xiàng)。

npm install aws-sdk multer-s3

限製檔案大小

要防止上傳大文件，請(qǐng)?jiān)O(shè)定限制選項(xiàng)。以下是將檔案大小限制為 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)
  })
});

處理多個(gè)文件上傳

Multer也支援多個(gè)檔案上傳：

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個(gè)檔案。
• upload.fields：允許處理具有不同欄位名稱(chēng)的檔案。

---

Multer 中的錯(cuò)誤處理

正確的錯(cuò)誤處理對(duì)於流暢的使用者體驗(yàn)至關(guān)重要。 Multer 可以?huà)伋龆喾N類(lèi)型的錯(cuò)誤，您可以像這樣處理：

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

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

以下是使用 Multer 的一些實(shí)際應(yīng)用：

1. 個(gè)人資料圖片上傳：允許使用者上傳個(gè)人資料圖片，將其儲(chǔ)存在伺服器或S3中，並將檔案路徑保存在資料庫(kù)中。
2. 文件儲(chǔ)存：使用自訂儲(chǔ)存和篩選配置儲(chǔ)存使用者提交的文件（例如履歷、PDF）。
3. 電子商務(wù)中的媒體檔案：允許供應(yīng)商上傳產(chǎn)品圖片，限製檔案類(lèi)型和大小，並將其儲(chǔ)存在雲(yún)端儲(chǔ)存中以便於檢索。

結(jié)論

Multer 透過(guò)提供靈活的儲(chǔ)存選項(xiàng)、檔案過(guò)濾以及處理從單一檔案到多個(gè)檔案的各種上傳要求，簡(jiǎn)化了 Node.js 應(yīng)用程式中的檔案處理。無(wú)論您是建立小型應(yīng)用程式還是具有檔案處理需求的生產(chǎn)級(jí)應(yīng)用程序，Multer 都能滿(mǎn)足您的需求。

編碼快樂(lè)！ ?

以上是使用 Multer 在 Node.js 中處理檔案上傳：綜合指南的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！