脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 网络编程 → JavaScript → node.js → Express multer文件上传

Express使用multer实现文件上传的示例代码

 更新时间：2024年03月14日 08:27:57   作者：云牧  
这篇文章主要介绍了Express 使用 multer 实现文件上传的操作步骤，文中通过代码示例和图文结合的方式讲解的非常详细，对大家的学习或工作有一定的帮助,需要的朋友可以参考下

环境搭建

首先，创建一个新的项目目录，并初始化 package.json 文件：

mkdir express-multer-test
cd express-multer-test
npm init -y

安装必要的包：

npm install express multer cors
  • express：一个简洁而灵活的 Node.js Web 应用框架。
  • multer：一个用于处理 multipart/form-data 类型表单数据，特别适合于处理文件上传的中间件。
  • cors：提供跨域资源共享（CORS）的中间件。

单文件上传

后端实现

在项目根目录下创建 index.js 文件，并添加以下内容：

const express = require('express')
const multer = require('multer')
const cors = require('cors')

const app = express()

// 使用 cors 中间件，允许所有来源的请求
app.use(cors())

// 配置 multer 中间件，设置文件存储的目录为 'uploads/'
const upload = multer({ dest: 'uploads/' })

// 使用 multer 中间件处理单个文件上传
// 创建一个 POST 路由，路径为 '/aaa'，文件字段名为 'aaa'
app.post('/aaa', upload.single('aaa'), function (req, res, next) {
	console.log('req.file', req.file)
	console.log('req.body', req.body)
})

app.listen(3333)

前端实现

新建一个 index.html，并通过 npx http-server 运行：

<!DOCTYPE html>
<html lang="en">
	<head>
		<script src="https://unpkg.com/axios@0.24.0/dist/axios.min.js"></script>
	</head>
	<body>
		<input id="fileInput" type="file" />
		<script>
			const fileInput = document.querySelector('#fileInput')

			async function formData() {
				const data = new FormData()
				data.set('name', 'Yun')
				data.set('age', 20)
				data.set('aaa', fileInput.files[0])

				const res = await axios.post('http://localhost:3333/aaa', data)
				console.log(res)
			}

			fileInput.onchange = formData
		</script>
	</body>
</html>

通过 FormData + axios 上传文件
准备一张图片：

浏览器选中文件上传：

服务端打印的结果是：

fieldname 是前端上传过来的字段名

origialname 是图片的原始名称。

其余非文件字段在 req.body。

并且服务端多了 uploads 目录，里面就保存着我们上传的文件。

多文件上传

后端实现

在 index.js 中添加一个新的路由来处理多文件上传：

bbb 路由通过 array 方法来取上传的文件，并且指定最大数量的限制。
上传的文件通过 req.files 来取。

前端实现

<!DOCTYPE html>
<html lang="en">
	<head>
		<script src="https://unpkg.com/axios@0.24.0/dist/axios.min.js"></script>
	</head>
	<body>
    <!-- input 标签添加 multiple 属性允许多选 -->
		<input id="fileInput" type="file" multiple />
		<script>
			const fileInput = document.querySelector('#fileInput')

			async function formData2() {
				const data = new FormData()
				data.set('name', 'Yun')
				data.set('age', 20)
				;[...fileInput.files].forEach(item => {
					data.append('bbb', item)
				})

				const res = await axios.post('http://localhost:3333/bbb', data)
				console.log(res)
			}

			fileInput.onchange = formData2
		</script>
	</body>
</html>

服务接收到了多个文件：

错误处理

在 express 里，约定有 4 个参数的中间件为错误处理中间件：

app.post('/bbb', upload.array('bbb', 2), (req, res, next) => {
    // ...之前的代码
}, (err, req, res, next) => {
    if (err instanceof MulterError && err.code === 'LIMIT_UNEXPECTED_FILE') {
        res.status(400).end('Too many files uploaded');
    }
});

不同字段上传

后端实现

如果需要处理多个字段上传文件，可以使用 fields 方法：

app.post(
	'/ccc',
	upload.fields([
		{ name: 'aaa', maxCount: 3 },
		{ name: 'bbb', maxCount: 2 },
	]),
	function (req, res, next) {
		console.log('req.files', req.files)
		console.log('req.body', req.body)
	}
)

前端实现

async function formData3() {
  const data = new FormData()
  data.set('name', 'Yun')
  data.set('age', 20)
  data.append('aaa', fileInput.files[0])
  data.append('aaa', fileInput.files[1])
  data.append('bbb', fileInput.files[2])
  data.append('bbb', fileInput.files[3])

  const res = await axios.post('http://localhost:3333/ccc', data)
  console.log(res)
}

上传后，服务器打印的信息：

不固定字段上传

后端实现

如果没有明确前端传过来的哪些字段是 file ，可以使用 any 接收：

app.post('/ddd', upload.any(), function (req, res, next) {
	console.log('req.files', req.files)
	console.log('req.body', req.body)
})

前端实现

改下前端代码，这次设置 aaa、bbb、ccc、ddd 4 个 file 字段：

async function formData4() {
  const data = new FormData()
  data.set('name', 'Yun')
  data.set('age', 20)
  data.set('aaa', fileInput.files[0])
  data.set('bbb', fileInput.files[1])
  data.set('ccc', fileInput.files[2])
  data.set('ddd', fileInput.files[3])

  const res = await axios.post('http://localhost:3333/ddd', data)
  console.log(res)
}

再次上传 4 个文件，可以看到服务端打印的消息：

只不过这时候不是 key、value 的形式了，需要自己遍历数组来查找。

文件名和存储目录自定义

之前通过 dest 指定了保存的目录：

现在重新指定：

const express = require('express')
const multer = require('multer')
const cors = require('cors')
const fs = require('fs')
const path = require('path')

const app = express()
app.use(cors())

// 磁盘存储
const storage = multer.diskStorage({
  // 自定义目录
	destination: function (req, file, cb) {
		try {
      // 尝试创建一个文件夹
			fs.mkdirSync(path.join(process.cwd(), 'my-uploads'))
		} catch (e) {}

		cb(null, path.join(process.cwd(), 'my-uploads'))
	},
  // 自定义文件名
	filename: function (req, file, cb) {
		const uniqueSuffix =
			Date.now() + '-' + Math.round(Math.random() * 1e9) + '-' + file.originalname

    // 设置文件名为字段名+唯一后缀
		cb(null, file.fieldname + '-' + uniqueSuffix)
	},
})

const upload = multer({ storage })

app.post('/ddd', upload.any(), function (req, res, next) {
	console.log('req.files', req.files)
	console.log('req.body', req.body)
})

app.listen(3333)

file 对象没变：

浏览器再次上传，就可以看到目录和文件名都修改了：

到此这篇关于Express使用multer实现文件上传的示例代码的文章就介绍到这了,更多相关Express multer文件上传内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

相关文章

  • nodejs集成sqlite使用示例

    nodejs集成sqlite使用示例

    本篇文章主要介绍了nodejs集成sqlite使用示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2017-06-06
  • 利用n工具轻松管理Node.js的版本

    利用n工具轻松管理Node.js的版本

    我们在测试写的Nodejs的程序在不同Nodejs版本下是否能正常运行，或是我们想要尝试下最新版 Nodejs 的新特性，但常用的代码需要旧版本的 Nodejs的时候就需要用 Node 版本管理工具，本文介绍的是利用n工具如何轻松管理Node.js的版本,需要的朋友可以参考下。
    2017-04-04
  • nodejs微信扫码支付功能实现

    nodejs微信扫码支付功能实现

    本片文章通过代码示例给大家详细讲述了如何用nodejs写出微信扫码支付这个功能，有兴趣的朋友可以参考下。
    2018-02-02
  • 使用GruntJS构建Web程序之合并压缩篇

    使用GruntJS构建Web程序之合并压缩篇

    前一篇讲述了如何使用concat和uglify命令实现JavaScript资源的合并，压缩。这篇讲述下css资源的合并和压缩。
    2014-06-06
  • 详解node child_process模块学习笔记

    详解node child_process模块学习笔记

    这篇文章主要介绍了详解node child_process模块学习笔记，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • 安装node-sass的方法步骤

    安装node-sass的方法步骤

    本文主要介绍了安装node-sass的方法步骤，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2023-05-05
  • 教你用十行node.js代码读取docx的文本

    教你用十行node.js代码读取docx的文本

    这篇文章主要给大家介绍了用十行node.js代码读取docx文本的相关资料，文中介绍的非常详细，需要的朋友可以参考借鉴，下面来一起看看吧。
    2017-03-03
  • Nodejs使用fs-extra模块进行目录和文件操作用法示例

    Nodejs使用fs-extra模块进行目录和文件操作用法示例

    fs-extra模块是基于fs 的文件操作相关工具库,封装了一些fs实现起来相对复杂的工具,下面这篇文章主要给大家介绍了关于Nodejs使用fs-extra模块进行目录和文件操作用法的相关资料,需要的朋友可以参考下
    2024-06-06
  • Node.JS事件的绑定与触发示例详解

    Node.JS事件的绑定与触发示例详解

    Node中的事件模型就是我们常见的订阅发布模式,Nodejs核心API都采用异步事件驱动,所有可能触发事件的对象都是一个继承自EventEmitter类的子类实例对象,这篇文章主要给大家介绍了关于Node.JS事件的绑定与触发事件的相关资料,需要的朋友可以参考下
    2022-11-11
  • Node.js制作简单聊天室

    Node.js制作简单聊天室

    这篇文章主要为大家详细介绍了Node.js制作简单聊天室的相关资料，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
    2017-01-01

最新评论