使用 Multer 在 Node.js 中上传文件
在Node.js中使用Multer进行文件上传
- 什么是Multer?
- 项目设置
- 基本的Express服务器
- 上传单文件
- 上传多个文件
- 测试应用程序
- 单文件
- 多个文件
- 文件大小限制
- 过滤文件类型
- 结论
- 相关博客
几个月前,我写了一篇有关如何使用
express-fileupload
中间件在Node.js和Express中上传文件的
文章。
什么是Multer?
如前所述,Multer是用于处理multipart/form-data
请求的Express中间件。 当用户将文件上传到服务器时,浏览器会自动将请求编码为multipart/form-data
。 Multer使在服务器上轻松处理此类请求变得容易。
项目设置
让我们为演示项目创建一个新目录,并通过键入以下命令切换到该目录:
$mkdir express-multer && cd express-multer
接下来,通过运行以下命令来创建package.json
文件:
$ npm init -y
现在安装Multer,Express和其他必需的依赖项:
$ npm install express multer body-parser cors morgan --save
基本的Express服务器
现在让我们创建一个基本的Express服务器。 首先,创建一个index.js文件:
$ touch index.js
将以下代码复制并粘贴到其中,以初始化所有模块并启动Express应用程序:index.js
const express = require('express');
const multer = require('multer');
const cors = require('cors');
const bodyParser = require('body-parser');
const morgan = require('morgan');
// create express app
const app = express();
// upload file path
const FILE_PATH = 'uploads';
// configure multer
const upload = multer({
dest: `${FILE_PATH}/`
});
// enable CORS
app.use(cors());
// add other middleware
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
app.use(morgan('dev'));
// start the app
const port = process.env.PORT || 3000;
app.listen(port, () =>
console.log(`App is listening on port ${port}.`)
);
上面的代码将Multer配置为接受multipart/form-data
文件的上传请求并将其保存到uploads
文件夹,启用跨域原始资源共享(CORS),并在端口3000
上启动Express服务器。
上传单文件
让我们在Express应用程序中创建第一个路由,以允许用户上传其个人资料图片:
app.post('/upload-avatar', upload.single('avatar'), async (req, res) => {
try {
const avatar = req.file;
// make sure file is available
if (!avatar) {
res.status(400).send({
status: false,
data: 'No file is selected.'
});
} else {
// send response
res.send({
status: true,
message: 'File is uploaded.',
data: {
name: avatar.originalname,
mimetype: avatar.mimetype,
size: avatar.size
}
});
}
} catch (err) {
res.status(500).send(err);
}
});
上面的函数接收一个HTTP POST请求。 upload.single('avatar')
是Multer中间件,它接受字段名称为avatar
的单个文件,将其上传到目标文件夹,并将file
属性添加到req
对象。
我们可以使用req.file
属性访问上传的文件。 它具有以下重要信息:
-
fieldname
—表单中使用的字段名称 -
originalname
-用户计算机上文件的名称 -
encoding
—文件的编码类型 -
mimetype
—文件的Mime类型 -
size
—文件大小,以字节为单位
在单个文件上传路由中,我们仅使用这些属性即可返回上传文件的详细信息。
上传多个文件
让我们添加另一条路由。 这次一次上传多个文件:
app.post('/upload-photos', upload.array('photos', 8), async (req, res) => {
try {
const photos = req.files;
// check if photos are available
if (!photos) {
res.status(400).send({
status: false,
data: 'No photo is selected.'
});
} else {
let data = [];
// iterate over all photos
photos.map(p => data.push({
name: p.originalname,
mimetype: p.mimetype,
size: p.size
}));
// send response
res.send({
status: true,
message: 'Photos are uploaded.',
data: data
});
}
} catch (err) {
res.status(500).send(err);
}
});
使用Multer上传多个文件类似于对单个文件上传但有一些更改。 Multer中间件现在接受一个文件数组作为输入,一次最多8个文件。 字段名称也更改为photos
。
测试应用程序
通过在终端的项目根目录中运行以下命令来启动Express应用程序:
$ node index.js
它将在端口3000
上启动应用程序。让我们使用Postman发送HTTP multipart/form-data
请求:
单文件
多个文件
文件大小限制
如果要限制文件大小,请将limits
属性添加到传递给multer()
的对象中:
const upload = multer({
dest: `${FILE_PATH}/`,
limits: {
files: 5, // allow up to 5 files per request,
fieldSize: 2 * 1024 * 1024 // 2 MB (max file size)
}
});
过滤文件类型
有时我们只允许用户上传图像。 您可以使用fileFilter
属性轻松限制文件类型:
const upload = multer({
dest: `${FILE_PATH}/`,
limits: {
files: 5, // allow up to 5 files per request,
fieldSize: 2 * 1024 * 1024 // 2 MB (max file size)
},
fileFilter: (req, file, cb) => {
// allow images only
if (!file.originalname.match(/\.(jpg|jpeg|png|gif)$/)) {
return cb(new Error('Only image are allowed.'), false);
}
cb(null, true);
}
});
源代码:在MIT许可下从GitHub下载完整的源代码。
结论
今天就这些。 您已经了解了如何在Node.js中使用Express和Multer上传文件。 Multer是一种易于使用的Express中间件,用于处理multipart/form-data
请求。
查看官方文档以获取更多配置选项。
喜欢这篇文章吗? 在Twitter和LinkedIn上关注我。 您也可以订阅RSS Feed。
相关博客
- How to read and write JSON files in Node.js
- Monitoring Your Node.js App with Scout APM
- How to encrypt and decrypt data in Node.js
- How to edit an XML file with Node.js
- How to read input from the command line in Node.js
推荐阅读
-
如何使用Poppler库在C++中读取PDF文件(二) - PDF目录
-
在Linux中通过Windows共享文件夹直接挂载并使用(实验操作)
-
使用debugfs修复被删除的文件在ext2文件系统中
-
在C语言中,如何使用另一个文件中的函数?
-
GM 图片处理工具在 Node.js 中的使用指南
-
Intellij IDEA 插件开发入门详解 - 如何添加 Application 和 Project Component,并创建 Action? 在本文中,我们将详细介绍如何在 IntelliJ IDEA 中添加 Application 和 Project Component,并且通过这些组件来创建一个简单的 Action。 首先,我们将在 src 目录上使用 Alt+Insert 快捷键打开 New 对话框,然后从中选择 Application Component 并输入名称如 MyComponent。接下来,我们在 MyComponent 类中添加一个 sayHello 方法并编写相关逻辑。 然后,我们需要为我们的插件添加一个 Action,使用户可以通过菜单或其它方式访问它。为此,我们将创建一个新的类 SayHelloAction 继承自 AnAction 类,并在 actionPerformed 方法中获取 Application 和 MyComponent 对象,最后调用 MyComponent 的 sayHello 方法。 最后,我们需要为我们的插件配置相关的文件以确保它可以正常运行。在本文中,我们将详细介绍如何进行这些配置。
-
在Unreal Engine 4的Runtime中,使用Assimp库导入各类3D文件(如fbx、obj和gltf)到UStaticMesh
-
在Ubuntu中安装make命令和使用Makefile文件以简化操作 - 让make为你工作
-
` 自动填充为 `cp test.txt`
- 文件和目录名补全:输入文件名首字母后按 Tab,如 `vi ed
` 显示可用的编辑器列表 - 查看命令帮助: - 使用 `man` 命令配合具体命令名获取详尽帮助,如 `man ls` 或者 `man grep --help`"> 在 Linux 中操作指令指南 - 基本构造与种类 - 指令组成: 1. **主指令 + 选项 + 参数**: 如 `ls -l /home`,`main-action option object` - 内置指令:系统预装的 shell 功能,如 `cd`, `pwd` - 外部指令:独立可执行文件,直接用文件名当作命令,如 `rm`, `mv` - **选项与参数**: - 选项:定制命令行为, `-l` 或 `--long-help` - 短选项:简写形式,例如 `-v` 和 `-V` 可能合并使用 - 长选项:详细描述的选项,如 `--version` 或 `--human-readable` - 参数:命令作用的目标,如 `ls` 对 `/home` 目录的操作 - **指令应用**: - 不同指令需要不同的参数 - 选项可带或不带参数,比如 `grep -i "keyword"` (忽略大小写搜索) - 参数间通常用空格分隔,如 `cp file1 file2 file3` - **中断与完成提示**: - 终止当前指令:按下 Ctrl+C - **自动完成**: - 输入部分命令关键词后,按 Tab 键补全命令,如 `cp ta
` 自动填充为 `cp test.txt` - 文件和目录名补全:输入文件名首字母后按 Tab,如 `vi ed ` 显示可用的编辑器列表 - 查看命令帮助: - 使用 `man` 命令配合具体命令名获取详尽帮助,如 `man ls` 或者 `man grep --help` -
在Node.js应用中运行shell脚本文件的步骤指南