Nodejs進階：基於express+multer的文件上傳

來自：https://yq.aliyun.com/articles/62937?utm_campaign=wenzhang&utm_medium=article&utm_source=QQ-qun&utm_content=m_7444

 

摘要： 圖片上傳是web開發中常常用到的功能，本文開篇主要講解如何基於express+multer輕鬆實現單圖、多圖上傳。接着，講解如何獲取上傳圖片的信息、對圖片保存的目錄、文件名等進行個性化定製。後續章節會對圖片上傳的技術細節進行深刻挖掘。歡迎加入Express前端交流羣(197339705)。

 

本文摘錄自《Nodejs學習筆記》，更多章節及更新，請訪問 github主頁地址。

 

關於做者

程序猿小卡，前騰訊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="logos"> <input type="file" name="logos"> <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