Multer 文件上传中间件使用教程

Multer 文件上传中间件使用教程

multerNode.js middleware for handling `multipart/form-data`.项目地址:https://gitcode.com/gh_mirrors/mu/multer

项目介绍

Multer 是一个用于处理 multipart/form-data 类型的表单数据的 Node.js 中间件，主要用于文件上传。它是基于 busboy 构建的，以实现最高效率。需要注意的是，Multer 不会处理任何非 multipart/form-data 类型的表单。

项目快速启动

安装

首先，你需要通过 npm 安装 Multer：

npm install --save multer

基本使用

以下是一个基本的使用示例：

1. 在你的 HTML 表单中，确保包含 enctype="multipart/form-data"：

<form action="/profile" method="post" enctype="multipart/form-data">
  <input type="file" name="avatar" />
</form>

2. 在你的 Node.js 应用中，配置并使用 Multer：

const express = require('express')
const multer = require('multer')
const upload = multer({ dest: 'uploads/' })

const app = express()

app.post('/profile', upload.single('avatar'), (req, res) => {
  res.send('File uploaded successfully')
})

app.listen(3000, () => {
  console.log('Server started on http://localhost:3000')
})

应用案例和最佳实践

自定义存储引擎

Multer 允许你使用自定义的存储引擎。以下是一个自定义存储引擎的示例：

const multer = require('multer')
const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, '/tmp/my-uploads')
  },
  filename: function (req, file, cb) {
    cb(null, file.fieldname + '-' + Date.now())
  }
})

const upload = multer({ storage: storage })

错误处理

当遇到错误时，Multer 会将错误委托给 Express。你可以使用标准的 Express 方式来显示一个友好的错误页面：

app.use((err, req, res, next) => {
  if (err instanceof multer.MulterError) {
    res.status(500).send('A Multer error occurred when uploading.')
  } else {
    res.status(500).send('An unknown error occurred when uploading.')
  }
})

典型生态项目

Multer 通常与其他 Express 中间件一起使用，以构建完整的文件上传和处理流程。以下是一些常见的生态项目：

• Express: 一个快速、无约束的、极简的 Node.js Web 框架。
• body-parser: 用于解析请求体的中间件。
• cors: 用于处理跨域资源共享的中间件。
• compression: 用于压缩响应体的中间件。

通过结合这些中间件，你可以构建一个强大且高效的文件上传和处理系统。

multerNode.js middleware for handling `multipart/form-data`.项目地址:https://gitcode.com/gh_mirrors/mu/multer