Nodejs进阶 基于express+multer的文件上传
来源:互联网 发布:android仿淘宝头条 编辑:程序博客网 时间:2024/05/16 14:16
关于作者
程序猿小卡,前腾讯IMWEB团队成员,阿里云栖社区专家博主。欢迎加入 Express前端交流群(197339705)。
正在填坑:《Nodejs学习笔记》 / 《Express学习笔记》
社区链接:云栖社区 / github / 新浪微博 / 知乎 / Segmentfault / 博客园 / 站酷
概览
图片上传是web开发中经常用到的功能,node社区在这方面也有了相对完善的支持。
常用的开源组件有multer、formidable等,借助这两个开源组件,可以轻松搞定图片上传。
本文主要讲解以下内容,后续章节会对技术实现细节进行深入挖掘。本文所有例子均有代码示例,可在这里查看。
- 基础例子:借助express、multer实现单图、多图上传。
- 常用API:获取上传的图片的信息。
- 进阶使用:自定义保存的图片路径、名称。
环境初始化
非常简单,一行命令。
npm install express multer multer --save
每个示例下面,都有下面两个文件
➜ upload-custom-filename git:(master) ✗ tree -L 1.├── app.js # 服务端代码,用来处理文件上传请求├── form.html # 前端页面,用来上传文件
基础例子:单图上传
完整示例代码请参考这里。
app.js。
var fs = require('fs');var express = require('express');var multer = require('multer')var app = express();var upload = multer({ dest: 'upload/' });// 单图上传app.post('/upload', upload.single('logo'), function(req, res, next){ res.send({ret_code: '0'});});app.get('/form', function(req, res, next){ var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); res.send(form);});app.listen(3000);
form.html。
<form action="/upload-single" method="post" enctype="multipart/form-data"> <h2>单图上传</h2> <input type="file" name="logo"> <input type="submit" value="提交"></form>
运行服务。
node app.js
访问 http://127.0.0.1:3000/form ,选择图片,点击“提交”,done。然后,你就会看到 upload 目录下多了个图片。
基础例子:多图上传
完整示例代码请参考这里。
代码简直不能更简单,将前面的 upload.single('logo') 改成 upload.array('logo', 2) 就行。表示:同时支持2张图片上传,并且 name 属性为 logo。
app.js。
var fs = require('fs');var express = require('express');var multer = require('multer')var app = express();var upload = multer({ dest: 'upload/' });// 多图上传app.post('/upload', upload.array('logo', 2), function(req, res, next){ res.send({ret_code: '0'});});app.get('/form', function(req, res, next){ var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); res.send(form);});app.listen(3000);
form.html。
<form action="/upload-multi" method="post" enctype="multipart/form-data"> <h2>多图上传</h2> <input type="file" name="logo"> <input type="file" name="logo"> <input type="submit" value="提交"></form>
同样的测试步骤,不赘述。
获取上传的图片的信息
完整示例代码请参考这里。
很多时候,除了将图片保存在服务器外,我们还需要做很多其他事情,比如将图片的信息存到数据库里。
常用的信息比如原始文件名、文件类型、文件大小、本地保存路径等。借助multer,我们可以很方便的获取这些信息。
还是单文件上传的例子,此时,multer会将文件的信息写到 req.file 上,如下代码所示。
app.js。
var fs = require('fs');var express = require('express');var multer = require('multer')var app = express();var upload = multer({ dest: 'upload/' });// 单图上传app.post('/upload', upload.single('logo'), function(req, res, next){ var file = req.file; console.log('文件类型:%s', file.mimetype); console.log('原始文件名:%s', file.originalname); console.log('文件大小:%s', file.size); console.log('文件保存路径:%s', file.path); res.send({ret_code: '0'});});app.get('/form', function(req, res, next){ var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); res.send(form);});app.listen(3000);
form.html。
<form action="/upload" method="post" enctype="multipart/form-data"> <h2>单图上传</h2> <input type="file" name="logo"> <input type="submit" value="提交"></form>
启动服务,上传文件后,就会看到控制台下打印出的信息。
文件类型:image/png原始文件名:1.png文件大小:18379文件保存路径:upload/b7e4bb22375695d92689e45b551873d9
自定义文件上传路径、名称
有的时候,我们想要定制文件上传的路径、名称,multer也可以方便的实现。
自定义本地保存的路径
非常简单,比如我们想将文件上传到 my-upload 目录下,修改下 dest 配置项就行。
var upload = multer({ dest: 'upload/' });
在上面的配置下,所有资源都是保存在同个目录下。有时我们需要针对不同文件进行个性化设置,那么,可以参考下一小节的内容。
自定义本地保存的文件名
完整示例代码请参考这里。
代码稍微长一点,单同样简单。multer 提供了 storage 这个参数来对资源保存的路径、文件名进行个性化设置。
使用注意事项如下:
- destination:设置资源的保存路径。注意,如果没有这个配置项,默认会保存在 /tmp/uploads 下。此外,路径需要自己创建。
- filename:设置资源保存在本地的文件名。
app.js。
var fs = require('fs');var express = require('express');var multer = require('multer')var app = express();var createFolder = function(folder){ try{ fs.accessSync(folder); }catch(e){ fs.mkdirSync(folder); } };var uploadFolder = './upload/';createFolder(uploadFolder);// 通过 filename 属性定制var storage = multer.diskStorage({ destination: function (req, file, cb) { cb(null, uploadFolder); // 保存的路径,备注:需要自己创建 }, filename: function (req, file, cb) { // 将保存文件名设置为 字段名 + 时间戳,比如 logo-1478521468943 cb(null, file.fieldname + '-' + Date.now()); }});// 通过 storage 选项来对 上传行为 进行定制化var upload = multer({ storage: storage })// 单图上传app.post('/upload', upload.single('logo'), function(req, res, next){ var file = req.file; res.send({ret_code: '0'});});app.get('/form', function(req, res, next){ var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); res.send(form);});app.listen(3000);
form.html。
<form action="/upload" method="post" enctype="multipart/form-data"> <h2>单图上传</h2> <input type="file" name="logo"> <input type="submit" value="提交"></form>
测试步骤不赘述,访问一下就知道效果了。
写在后面
本文对multer的基础用法进行了介绍,并未涉及过多原理性的东西。俗话说 授人以渔不如授人以渔,在后续的章节里,会对文件上传的细节进行挖掘,好让读者朋友对文件上传加深进一步的认识。
相关链接
multer官方文档:https://github.com/expressjs/multer
github博客:https://github.com/chyingp/blog
新浪微博:http://weibo.com/chyingp
站酷主页:http://www.zcool.com.cn/u/346408/
- Nodejs进阶 基于express+multer的文件上传
- NodeJS express+multer实现文件上传
- nodejs multer上传文件
- Express文件上传之Multer
- Express使用Multer实现文件上传
- nodejs + multer 实现文件上传与下载
- node+express文件上传 multer模块上传问题
- nodeJS文件上传的知识点(使用multer中间件来上传)
- nodejs express 上传文件
- express 4.X 使用multer中间件 上传文件
- nodejs express 4.0+的文件上传
- nodejs使用multer上传附件
- multer模块的使用 +文件上传+ 评论
- 基于NodeJs的Express及Webuploader实现大文件分片上传与合并(一)
- multer中间件上传文件
- Multer 文件上传
- nodejs+express实现文件上传
- nodejs express 文件上传处理
- Oracle DataGuard介绍
- LeetCode 3. Longest Substring Without Repeating Characters
- 520表白网页
- HDOJ_1001_Sum Problem
- c++map 详解大全
- Nodejs进阶 基于express+multer的文件上传
- 鼠标经过展开
- c内存管理学习总结
- python错误和异常处理
- js 创建对象的几种常用的方式
- scikit-learn中的SVM使用指南
- scrollview嵌套recycleView相关问题
- HDU2952 DFS
- python参数化-数组