文章目录
- 先安装基本的模块
- 附上multer的github当中别人汉化的API文档
- 开始创建基本express(上传图片)
- 测试是否正常
- 前端部分
- 前端需要注意的
- multer使用
- multer({})创建一个变量当中一些可以设置的(具体可以参考官网)
- multer代码
- multer部分需要注意的
- 具体文件目录结构和参考完整代码下载
- 目录文件结构
- 参考完整代码下载
先安装基本的模块
$ npm init -y
$ npm install express --save
$ npm install multer --save
附上multer的github当中别人汉化的API文档
我这使用的nodemon,如果那么使用node运行,修改记得重启
开始创建基本express(上传图片)
当前目录下创建fileup.js文件
const express = require("express");
const multer = require("multer");
var app = express();//创建express实例
//这里是为了后期没有跨域问题设置的静态资源目录
//__dirname为NodeJS全局变量: 返回运行当前js的文件夹的绝对路径
app.use("/",express.static(__dirname));
//后期ajax提交地址就为:http://localhost:3000/file 端口号可在下方自行设置
app.post("/file",(req, res) => {
//前期测试接口发送数据,没有问题再进行下一步
res.send("file ok");
})
//设置在本地端口3000
app.listen("3000", () => {
console.log("-------------server start-------------------");
})
测试是否正常
这里使用postman测试
测试没有问题再继续,不然后期很难改
前端部分
当前目录下创建up.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
<script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
</head>
<body>
<input type="file" id="fileInput">
<button id="btn">上传文件</button>
<script>
//这里不用jQuery获取是后期需要用到DOM元素,用jQuery也可以,用get或则[]就可以转为DOM元素
var fileInput = document.getElementById("fileInput");
var $btn = $("#btn");
$btn.click(function () {
//创建表单
//这里new FormData不传入参数,因为这里只是上传一个图片,不存在其他数据,如果要传,传入form标签对应的DOM元素
var formData = new FormData();
//传入文件的key和value
//fileInput.files[0]获取第一个文件,为什么是数组的我猜是因为开发js的为了和多文件上传一样用
formData.append("fileusers", fileInput.files[0]);
//注意formData.append和formData.set区别,
$.ajax({
"type": "post",
"url": "http://localhost:3000/file",
//contentType:true;默认值,值为application/x-www-form-urlencoded
//contentType:false;值为multipart/form-data
//重要!!!!!!!!!!!!!!!!!!!!!!!!
"contentType": false,
//重要!!!!!!!!!!!!!!!!!!!!!!!!
"processData": false,
"data": formData,
"success": function (data) {
console.log(data);
},
"error": function (error) {
console.log("错误了", error);
}
});
});
</script>
</body>
</html>
前端需要注意的
- 注意formData.append和formData.set区别
- formData.append是如果存在值则会添加到后面,就像[{…},{…}]一样
- formData.set是会覆盖前面的,只保留一个
- jQuery上传数据的时候,记得设置下面二点
- “processData”: false
- “contentType”: false
- formData.append(“fileusers”, fileInput.files[0]); 当中fileusers在这里的作用
- 后端multer需要通过用户定义的key,在这里也就是fileusers来设置数据
- new FormData();如果需要传入参数,是传入form标签对应的DOM元素
multer使用
- 大体分为而部分
- 根据multer({})创建一个变量(对文件的一些设置和过滤),比如说 var fileOption = multer({})
- 依据这个变量创建单例fileOption.single(key)或者fileOption.array(key,maxcount)
- 使用这个单例作为过滤器来对文件进行过滤和操作(也就是中间件)
multer({})创建一个变量当中一些可以设置的(具体可以参考官网)
- limits{对象}(一个对象,指定一些数据大小的限制)
Key | Description | Default |
| field 名字最大长度 | 100 bytes |
| field 值的最大长度 | 1MB |
| 非文件 field 的最大数量 | 无限 |
| 在 multipart 表单中,文件最大长度 (字节单位) | 无限 |
| 在 multipart 表单中,文件最大数量 | 无限 |
| 在 multipart 表单中,part 传输的最大数量(fields + files) | 无限 |
| 在 multipart 表单中,键值对最大组数 | 2000 |
- fileFilter{函数}设置一个函数来控制什么文件可以上传以及什么文件应该跳过
function fileFilter (req, file, cb) {
// 这个函数应该调用 `cb` 用boolean值来
// 指示是否应接受该文件
// 拒绝这个文件,使用`false`,像这样:
cb(null, false)
// 接受这个文件,使用`true`,像这样:
cb(null, true)
// 如果有问题,你可以总是这样发送一个错误:
cb(new Error('I don\'t have a clue!'))
}
- storage{返回值} 为运行multer.diskStorage({设置参数})的返回值
const storage = multer.diskStorage({
//定义文件存储位置
destination: function (req, file, cb) {
//回调函数file当中
/* file对象的内容{
fieldname: 'fileusers',//通过formData.append(key,value)添加的key值
originalname: '_1464815392_.bmp',//文件名
encoding: '7bit',//编码
mimetype: 'image/bmp' //mimeType类型
} */
//cb(null,存储路径)
cb(null, './myfile');//可能是以fileup.js在哪里运行为基准的参考的
},
//重定义上传的文件
filename: function (req, file, cb) {
//cb(null,新文件名称)
cb(null, file.fieldname + '-' + Date.now())
}
})
const upload = multer({ storage: storage })
multer代码
当前目录下创建fileup.js文件和myfile文件夹
const express = require("express");
const multer = require("multer");
var app = express(); //创建express实例
//这里是为了后期没有跨域问题设置的静态资源目录
//__dirname为NodeJS全局变量: 返回运行当前js的文件夹的绝对路径
app.use("/", express.static(__dirname));
//根据multer({})创建一个变量(对文件的一些设置和过滤)
var fileOption = multer({
//上传限制
limits: {
fileSize: 5 * 1024 * 1024 * 1024,
files: 1
},
//存储位置
storage: multer.diskStorage({
destination: function (req, file, cb) {
cb(null, './myfile');
},
//重定义上传的文件
filename: function (req, file, cb) {
//cb(null,新文件名称)
cb(null, file.fieldname + '-' + Date.now()+"-"+file.originalname);
}
}),
//过滤
fileFilter: function (req, file, cb) {
//这里就不写了~,如果添加了这个对象,一定要设置cb(null,true);不然数据过不去
cb(null,true);
}
});
//依据这个变量创建单例multer.single(key)或者multer.array(key,maxcount)
var fileOptionFunction=fileOption.single("fileusers");//传入通过formData.append(key,value)添加的key值
//后期ajax提交地址就为:http://localhost:3000/file 端口号可在下方自行设置
app.post("/file", (req, res) => {
//这里传入的是app.post当中的req,和res
fileOptionFunction(req,res,(error)=>{
if (error) {
return res.send({err:-1,msg:'上传图片不能大于5M'})
}
res.send({error:0,msg:"文件上传成功"})
})
})
//设置在本地端口3000
app.listen("3000", () => {
console.log("-------------server start-------------------");
})
multer部分需要注意的
- 如果使用app.post(“/file”, uploadOption.single(“fileusers”),(req, res) => { });好像无法处理文件过大时候的异常
- 如果使用上面fileup.js文件当中的方式,可以在回调当中处理文件过大时候的异常
- 如果设置了文件过滤,那么遇到不符合的文件扩展名,req.file的值会为undefined
- 如果设置了fileFilter文件过滤,一定要设置cb(null,true)(通过),或者cb(null,false);(不通过),不然留空的话数据会一直处于"pending"状态
具体文件目录结构和参考完整代码下载
启动后浏览器输入http://localhost:3000/up.html
目录文件结构
参考完整代码下载
express+multer+jQuery前端后端上传单个文件演示