Nodejs进阶:基于express+multer的文件上传

概览

成都网站建设、成都网站设计介绍好的网站是理念、设计和技术的结合。创新互联建站拥有的网站设计理念、多方位的设计风格、经验丰富的设计团队。提供PC端+手机端网站建设,用营销思维进行网站设计、采用先进技术开源代码、注重用户体验与SEO基础,将技术与创意整合到网站之中,以契合客户的方式做到创意性的视觉化效果。

图片上传是web开发中经常用到的功能,node社区在这方面也有了相对完善的支持。

常用的开源组件有multer、formidable等,借助这两个开源组件,可以轻松搞定图片上传。

本文主要讲解以下内容,后续章节会对技术实现细节进行深入挖掘。

  • 基础例子:借助express、multer实现单图、多图上传。
  • 常用API:获取上传的图片的信息。
  • 进阶使用:自定义保存的图片路径、名称。

关于作者

程序猿小卡,前腾讯IMWEB团队成员,阿里云栖社区专家认证博主。欢迎加入 Express前端交流群(197339705)。

正在填坑:《Nodejs学习笔记》 / 《Express学习笔记》

社区链接:云栖社区 / github / 新浪微博 / 知乎 / Segmentfault / 博客园 / 站酷

环境初始化

非常简单,一行命令。

 
 
  1. npm install express multer multer --save 

每个示例下面,都有下面两个文件

 
 
  1.   upload-custom-filename git:(master)  tree -L 1 
  2. ├── app.js # 服务端代码,用来处理文件上传请求 
  3. ├── form.html # 前端页面,用来上传文件  

基础例子:单图上传

app.js。

 
 
  1. var fs = require('fs'); 
  2. var express = require('express'); 
  3. var multer  = require('multer') 
  4.  
  5. var app = express(); 
  6. var upload = multer({ dest: 'upload/' }); 
  7.  
  8. // 单图上传 
  9. app.post('/upload', upload.single('logo'), function(req, res, next){ 
  10.     res.send({ret_code: '0'}); 
  11. }); 
  12.  
  13. app.get('/form', function(req, res, next){ 
  14.     var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); 
  15.     res.send(form); 
  16. }); 
  17.  
  18. app.listen(3000);  

form.html。

 
 
  1.  
  2.     

    单图上传

     
  3.      
  4.      
  5.   

运行服务。

 
 
  1. node app.js 

访问 http://127.0.0.1:3000/form ,选择图片,点击“提交”,done。然后,你就会看到 upload 目录下多了个图片。

基础例子:多图上传

代码简直不能更简单,将前面的 upload.single('logo') 改成 upload.array('logo', 2) 就行。表示:同时支持2张图片上传,并且 name 属性为 logo。

app.js。

 
 
  1. var fs = require('fs'); 
  2. var express = require('express'); 
  3. var multer  = require('multer') 
  4.  
  5. var app = express(); 
  6. var upload = multer({ dest: 'upload/' }); 
  7.  
  8. // 多图上传 
  9. app.post('/upload', upload.array('logo', 2), function(req, res, next){ 
  10.     res.send({ret_code: '0'}); 
  11. }); 
  12.  
  13. app.get('/form', function(req, res, next){ 
  14.     var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); 
  15.     res.send(form); 
  16. }); 
  17.  
  18. app.listen(3000);  

form.html。

 
 
  1.  
  2.     

    多图上传

     
  3.      
  4.      
  5.      
  6.   

同样的测试步骤,不赘述。

获取上传的图片的信息

很多时候,除了将图片保存在服务器外,我们还需要做很多其他事情,比如将图片的信息存到数据库里。

常用的信息比如原始文件名、文件类型、文件大小、本地保存路径等。借助multer,我们可以很方便的获取这些信息。

还是单文件上传的例子,此时,multer会将文件的信息写到 req.file 上,如下代码所示。

app.js。

 
 
  1. var fs = require('fs'); 
  2. var express = require('express'); 
  3. var multer  = require('multer') 
  4.  
  5. var app = express(); 
  6. var upload = multer({ dest: 'upload/' }); 
  7.  
  8. // 单图上传 
  9. app.post('/upload', upload.single('logo'), function(req, res, next){ 
  10.     var file = req.file; 
  11.  
  12.     console.log('文件类型:%s', file.mimetype); 
  13.     console.log('原始文件名:%s', file.originalname); 
  14.     console.log('文件大小:%s', file.size); 
  15.     console.log('文件保存路径:%s', file.path); 
  16.  
  17.     res.send({ret_code: '0'}); 
  18. }); 
  19.  
  20. app.get('/form', function(req, res, next){ 
  21.     var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); 
  22.     res.send(form); 
  23. }); 
  24.  
  25. app.listen(3000);  

form.html。

 
 
  1.  
  2.     

    单图上传

     
  3.      
  4.      
  5.   

启动服务,上传文件后,就会看到控制台下打印出的信息。

 
 
  1. 文件类型:image/png 
  2. 原始文件名:1.png 
  3. 文件大小:18379 
  4. 文件保存路径:upload/b7e4bb22375695d92689e45b551873d9  

自定义文件上传路径、名称

有的时候,我们想要定制文件上传的路径、名称,multer也可以方便的实现。

自定义本地保存的路径

非常简单,比如我们想将文件上传到 my-upload 目录下,修改下 dest 配置项就行。

 
 
  1. var upload = multer({ dest: 'upload/' }); 

在上面的配置下,所有资源都是保存在同个目录下。有时我们需要针对不同文件进行个性化设置,那么,可以参考下一小节的内容。

自定义本地保存的文件名

代码稍微长一点,单同样简单。multer 提供了 storage 这个参数来对资源保存的路径、文件名进行个性化设置。

使用注意事项如下:

  • destination:设置资源的保存路径。注意,如果没有这个配置项,默认会保存在 /tmp/uploads 下。此外,路径需要自己创建。
  • filename:设置资源保存在本地的文件名。

app.js。

 
 
  1. var fs = require('fs'); 
  2. var express = require('express'); 
  3. var multer  = require('multer') 
  4.  
  5. var app = express(); 
  6.  
  7. var createFolder = function(folder){ 
  8.     try{ 
  9.         fs.accessSync(folder);  
  10.     }catch(e){ 
  11.         fs.mkdirSync(folder); 
  12.     }   
  13. }; 
  14.  
  15. var uploadFolder = './upload/'; 
  16.  
  17. createFolder(uploadFolder); 
  18.  
  19. // 通过 filename 属性定制 
  20. var storage = multer.diskStorage({ 
  21.     destination: function (req, file, cb) { 
  22.         cb(null, uploadFolder);    // 保存的路径,备注:需要自己创建 
  23.     }, 
  24.     filename: function (req, file, cb) { 
  25.         // 将保存文件名设置为 字段名 + 时间戳,比如 logo-1478521468943 
  26.         cb(null, file.fieldname + '-' + Date.now());   
  27.     } 
  28. }); 
  29.  
  30. // 通过 storage 选项来对 上传行为 进行定制化 
  31. var upload = multer({ storage: storage }) 
  32.  
  33. // 单图上传 
  34. app.post('/upload', upload.single('logo'), function(req, res, next){ 
  35.     var file = req.file; 
  36.     res.send({ret_code: '0'}); 
  37. }); 
  38.  
  39. app.get('/form', function(req, res, next){ 
  40.     var form = fs.readFileSync('./form.html', {encoding: 'utf8'}); 
  41.     res.send(form); 
  42. }); 
  43.  
  44. app.listen(3000);  

form.html。

 
 
  1.  
  2.     

    单图上传

     
  3.      
  4.      
  5.   

测试步骤不赘述,访问一下就知道效果了。

写在后面

本文对multer的基础用法进行了介绍,并未涉及过多原理性的东西。俗话说 授人以渔不如授人以渔,在后续的章节里,会对文件上传的细节进行挖掘,好让读者朋友对文件上传加深进一步的认识。

新闻名称:Nodejs进阶:基于express+multer的文件上传
URL地址:http://www.shufengxianlan.com/qtweb/news5/128455.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联