天天看點

Nodejs進階:基于express+multer的檔案上傳

Nodejs進階:基于express+multer的檔案上傳

概覽

圖檔上傳是web開發中經常用到的功能,node社群在這方面也有了相對完善的支援。

常用的開源元件有multer、formidable等,借助這兩個開源元件,可以輕松搞定圖檔上傳。

本文主要講解以下内容,後續章節會對技術實作細節進行深入挖掘。

基礎例子:借助express、multer實作單圖、多圖上傳。

常用api:擷取上傳的圖檔的資訊。

進階使用:自定義儲存的圖檔路徑、名稱。

關于作者

程式猿小卡,前騰訊imweb團隊成員,阿裡雲栖社群專家認證部落客。歡迎加入 express前端交流群(197339705)。

環境初始化

非常簡單,一行指令。

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.post('/upload', upload.array('logo', 2), function(req, res, next){ 

<form action="/upload-multi" method="post" enctype="multipart/form-data"> 

    <h2>多圖上傳</h2> 

    <input type="file" name="logos"> 

同樣的測試步驟,不贅述。

擷取上傳的圖檔的資訊

很多時候,除了将圖檔儲存在伺服器外,我們還需要做很多其他事情,比如将圖檔的資訊存到資料庫裡。

常用的資訊比如原始檔案名、檔案類型、檔案大小、本地儲存路徑等。借助multer,我們可以很友善的擷取這些資訊。

還是單檔案上傳的例子,此時,multer會将檔案的資訊寫到 req.file 上,如下代碼所示。

    var file = req.file; 

    console.log('檔案類型:%s', file.mimetype); 

    console.log('原始檔案名:%s', file.originalname); 

    console.log('檔案大小:%s', file.size); 

    console.log('檔案儲存路徑:%s', file.path); 

<form action="/upload" method="post" enctype="multipart/form-data"> 

啟動服務,上傳檔案後,就會看到控制台下列印出的資訊。

檔案類型:image/png 

原始檔案名:1.png 

檔案大小:18379 

檔案儲存路徑:upload/b7e4bb22375695d92689e45b551873d9  

自定義檔案上傳路徑、名稱

有的時候,我們想要定制檔案上傳的路徑、名稱,multer也可以友善的實作。

自定義本地儲存的路徑

非常簡單,比如我們想将檔案上傳到 my-upload 目錄下,修改下 dest 配置項就行。

在上面的配置下,所有資源都是儲存在同個目錄下。有時我們需要針對不同檔案進行個性化設定,那麼,可以參考下一小節的内容。

自定義本地儲存的檔案名

代碼稍微長一點,單同樣簡單。multer 提供了 storage 這個參數來對資源儲存的路徑、檔案名進行個性化設定。

使用注意事項如下:

destination:設定資源的儲存路徑。注意,如果沒有這個配置項,預設會儲存在 /tmp/uploads 下。此外,路徑需要自己建立。

filename:設定資源儲存在本地的檔案名。

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 }) 

測試步驟不贅述,通路一下就知道效果了。

寫在後面

本文對multer的基礎用法進行了介紹,并未涉及過多原理性的東西。俗話說 授人以漁不如授人以漁,在後續的章節裡,會對檔案上傳的細節進行挖掘,好讓讀者朋友對檔案上傳加深進一步的認識。

作者:程式猿小卡_casper

來源:51cto

繼續閱讀