Nodejs進(jìn)階：基于express+multer的文件上傳實例
概覽
圖片上傳是web開發(fā)中經(jīng)常用到的功能，node社區(qū)在這方面也有了相對完善的支持。
常用的開源組件有multer、formidable等，借助這兩個開源組件，可以輕松搞定圖片上傳。
本文主要講解以下內(nèi)容，后續(xù)章節(jié)會對技術(shù)實現(xiàn)細(xì)節(jié)進(jìn)行深入挖掘。
- 基礎(chǔ)例子：借助express、multer實現(xiàn)單圖、多圖上傳。
- 常用API：獲取上傳的圖片的信息。
- 進(jìn)階使用：自定義保存的圖片路徑、名稱。
環(huán)境初始化
非常簡單，一行命令。
npm install express multer multer --save
每個示例下面，都有下面兩個文件
➜ upload-custom-filename git:(master) ✗ tree -L 1 . ├── app.js # 服務(wù)端代碼，用來處理文件上傳請求 ├── form.html # 前端頁面，用來上傳文件
基礎(chǔ)例子：單圖上傳
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>
運行服務(wù)。
node app.js
訪問 http://127.0.0.1:3000/form ，選擇圖片，點擊“提交”，done。然后，你就會看到 upload 目錄下多了個圖片。
基礎(chǔ)例子：多圖上傳
代碼簡直不能更簡單，將前面的 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>
同樣的測試步驟，不贅述。
獲取上傳的圖片的信息
很多時候，除了將圖片保存在服務(wù)器外，我們還需要做很多其他事情，比如將圖片的信息存到數(shù)據(jù)庫里。
常用的信息比如原始文件名、文件類型、文件大小、本地保存路徑等。借助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>
啟動服務(wù)，上傳文件后，就會看到控制臺下打印出的信息。
文件類型：image/png
原始文件名：1.png
文件大?。?8379
文件保存路徑：upload/b7e4bb22375695d92689e45b551873d9
自定義文件上傳路徑、名稱
有的時候，我們想要定制文件上傳的路徑、名稱，multer也可以方便的實現(xiàn)。
自定義本地保存的路徑
非常簡單，比如我們想將文件上傳到 my-upload 目錄下，修改下 dest 配置項就行。
var upload = multer({ dest: 'upload/' });
在上面的配置下，所有資源都是保存在同個目錄下。有時我們需要針對不同文件進(jìn)行個性化設(shè)置，那么，可以參考下一小節(jié)的內(nèi)容。
自定義本地保存的文件名
代碼稍微長一點，單同樣簡單。multer 提供了 storage 這個參數(shù)來對資源保存的路徑、文件名進(jìn)行個性化設(shè)置。
使用注意事項如下：
- destination：設(shè)置資源的保存路徑。注意，如果沒有這個配置項，默認(rèn)會保存在 /tmp/uploads 下。此外，路徑需要自己創(chuàng)建。
- filename：設(shè)置資源保存在本地的文件名。
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); // 保存的路徑，備注：需要自己創(chuàng)建
},
filename: function (req, file, cb) {
// 將保存文件名設(shè)置為 字段名 + 時間戳，比如 logo-1478521468943
cb(null, file.fieldname + '-' + Date.now());
}
});
// 通過 storage 選項來對 上傳行為 進(jìn)行定制化
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的基礎(chǔ)用法進(jìn)行了介紹，并未涉及過多原理性的東西。俗話說 授人以漁不如授人以漁，在后續(xù)的章節(jié)里，會對文件上傳的細(xì)節(jié)進(jìn)行挖掘，好讓讀者朋友對文件上傳加深進(jìn)一步的認(rèn)識。
相關(guān)鏈接
multer官方文檔：https://github.com/expressjs/multer
以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。
相關(guān)文章
nodeJS服務(wù)器的創(chuàng)建和重新啟動的實現(xiàn)方法
今天小編就為大家分享一篇nodeJS服務(wù)器的創(chuàng)建和重新啟動的實現(xiàn)方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2018-05-05
這篇文章主要介紹了Nodejs文件上傳的示例代碼，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-09-09
這篇文章主要為大家介紹了autojs的Node.js正確退出腳本示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-01-01
Node.js調(diào)用fs.renameSync報錯（Error: EXDEV, cross-device link not
這篇文章主要介紹了Node.js調(diào)用fs.renameSync報錯（Error: EXDEV, cross-device link not permitted）,非常具有實用價值，需要的朋友可以參考下2017-12-12
教你在heroku云平臺上部署Node.js應(yīng)用
heroku是構(gòu)建在AWS之上的一個PaaS云平臺，現(xiàn)在支持Ruby, Node.js, Python, Java, 和 PHP，代碼的部署是通過git進(jìn)行，編譯和運行都是自動的。2014-07-07
這篇文章主要為大家介紹了ChatGPT編程秀之最小元素的設(shè)計示例詳解，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-03-03
nodejs如何在package.json中設(shè)置多條啟動命令
這篇文章主要介紹了nodejs如何在package.json中設(shè)置多條啟動命令，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2020-03-03
Node使用Selenium進(jìn)行前端自動化操作的代碼實現(xiàn)
這篇文章主要介紹了Node使用Selenium進(jìn)行前端自動化操作的代碼實現(xiàn)，文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值，需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-10-10
這篇文章主要為大家介紹了node文件資源管理器讀取視頻信息從零實現(xiàn)示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2023-12-12
nodejs遍歷文件夾下并操作HTML/CSS/JS/PNG/JPG的方法
這篇文章主要介紹了nodejs遍歷文件夾下并操作HTML/CSS/JS/PNG/JPG的方法，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-11-11