Nodejs進(jìn)階：基于express+multer的文件上傳

作者：程序猿小卡_casper 2016-11-09 10:28:36

圖片上傳是web開(kāi)發(fā)中經(jīng)常用到的功能，node社區(qū)在這方面也有了相對(duì)完善的支持。常用的開(kāi)源組件有multer、formidable等，借助這兩個(gè)開(kāi)源組件，可以輕松搞定圖片上傳。本文主要講解以下內(nèi)容，后續(xù)章節(jié)會(huì)對(duì)技術(shù)實(shí)現(xiàn)細(xì)節(jié)進(jìn)行深入挖掘。

概覽

圖片上傳是web開(kāi)發(fā)中經(jīng)常用到的功能，node社區(qū)在這方面也有了相對(duì)完善的支持。

常用的開(kāi)源組件有multer、formidable等，借助這兩個(gè)開(kāi)源組件，可以輕松搞定圖片上傳。

本文主要講解以下內(nèi)容，后續(xù)章節(jié)會(huì)對(duì)技術(shù)實(shí)現(xiàn)細(xì)節(jié)進(jìn)行深入挖掘。

基礎(chǔ)例子：借助express、multer實(shí)現(xiàn)單圖、多圖上傳。
常用API：獲取上傳的圖片的信息。
進(jìn)階使用：自定義保存的圖片路徑、名稱(chēng)。

關(guān)于作者

程序猿小卡，前騰訊IMWEB團(tuán)隊(duì)成員，阿里云棲社區(qū)專(zhuān)家認(rèn)證博主。歡迎加入 Express前端交流群(197339705)。

正在填坑：《Nodejs學(xué)習(xí)筆記》 / 《Express學(xué)習(xí)筆記》

社區(qū)鏈接：云棲社區(qū) / github / 新浪微博 / 知乎 / Segmentfault / 博客園 / 站酷

環(huán)境初始化

非常簡(jiǎn)單，一行命令。

npm install express multer multer --save

每個(gè)示例下面，都有下面兩個(gè)文件

➜  upload-custom-filename git:(master) ✗ tree -L 1 
. 
├── app.js # 服務(wù)端代碼，用來(lái)處理文件上傳請(qǐng)求 
├── form.html # 前端頁(yè)面，用來(lái)上傳文件

基礎(chǔ)例子：?jiǎn)螆D上傳

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>

運(yùn)行服務(wù)。

node app.js

訪(fǎng)問(wèn) http://127.0.0.1:3000/form ，選擇圖片，點(diǎn)擊“提交”，done。然后，你就會(huì)看到 upload 目錄下多了個(gè)圖片。

基礎(chǔ)例子：多圖上傳

代碼簡(jiǎn)直不能更簡(jiǎn)單，將前面的 upload.single('logo') 改成 upload.array('logo', 2) 就行。表示：同時(shí)支持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>

同樣的測(cè)試步驟，不贅述。

獲取上傳的圖片的信息

很多時(shí)候，除了將圖片保存在服務(wù)器外，我們還需要做很多其他事情，比如將圖片的信息存到數(shù)據(jù)庫(kù)里。

常用的信息比如原始文件名、文件類(lèi)型、文件大小、本地保存路徑等。借助multer，我們可以很方便的獲取這些信息。

還是單文件上傳的例子，此時(shí)，multer會(huì)將文件的信息寫(xiě)到 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('文件類(lèi)型：%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>

啟動(dòng)服務(wù)，上傳文件后，就會(huì)看到控制臺(tái)下打印出的信息。

文件類(lèi)型：image/png 
原始文件名：1.png 
文件大小：18379 
文件保存路徑：upload/b7e4bb22375695d92689e45b551873d9

自定義文件上傳路徑、名稱(chēng)

有的時(shí)候，我們想要定制文件上傳的路徑、名稱(chēng)，multer也可以方便的實(shí)現(xiàn)。

自定義本地保存的路徑

非常簡(jiǎn)單，比如我們想將文件上傳到 my-upload 目錄下，修改下 dest 配置項(xiàng)就行。

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

在上面的配置下，所有資源都是保存在同個(gè)目錄下。有時(shí)我們需要針對(duì)不同文件進(jìn)行個(gè)性化設(shè)置，那么，可以參考下一小節(jié)的內(nèi)容。

自定義本地保存的文件名

代碼稍微長(zhǎng)一點(diǎn)，單同樣簡(jiǎn)單。multer 提供了 storage 這個(gè)參數(shù)來(lái)對(duì)資源保存的路徑、文件名進(jìn)行個(gè)性化設(shè)置。

使用注意事項(xiàng)如下：

destination：設(shè)置資源的保存路徑。注意，如果沒(méi)有這個(gè)配置項(xiàng)，默認(rèn)會(huì)保存在 /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); 
 
// 通過(guò) filename 屬性定制 
var storage = multer.diskStorage({ 
    destination: function (req, file, cb) { 
        cb(null, uploadFolder);    // 保存的路徑，備注：需要自己創(chuàng)建 
    }, 
    filename: function (req, file, cb) { 
        // 將保存文件名設(shè)置為 字段名 + 時(shí)間戳，比如 logo-1478521468943 
        cb(null, file.fieldname + '-' + Date.now());   
    } 
}); 
 
// 通過(guò) storage 選項(xiàng)來(lái)對(duì) 上傳行為 進(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>

測(cè)試步驟不贅述，訪(fǎng)問(wèn)一下就知道效果了。

寫(xiě)在后面

本文對(duì)multer的基礎(chǔ)用法進(jìn)行了介紹，并未涉及過(guò)多原理性的東西。俗話(huà)說(shuō) 授人以漁不如授人以漁，在后續(xù)的章節(jié)里，會(huì)對(duì)文件上傳的細(xì)節(jié)進(jìn)行挖掘，好讓讀者朋友對(duì)文件上傳加深進(jìn)一步的認(rèn)識(shí)。

責(zé)任編輯：龐桂玉來(lái)源： segmentfault