關於作者

程式猿小卡，前騰訊IMWEB團隊成員，阿里雲棲社群專家博主。歡迎加入 Express前端交流群(197339705)。

概覽

圖片上傳是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 # 前端頁面，用來上傳檔案

基礎例子：單圖上傳

完整示例程式碼請參考這裡。

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

<
 
formaction="/upload-single"method="post"enctype="multipart/form-data">
    <h2>單圖上傳</h2>
    <inputtype="file"name="logo">
    <inputtype="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。

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

<formaction="/upload-multi"method="post"enctype="multipart/form-data">
    <h2>多圖上傳</h2>
    <inputtype="file"name="logo">
    <inputtype="file"name="logo">
    <inputtype="submit"value="提交">
</form>

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

獲取上傳的圖片的資訊

完整示例程式碼請參考這裡。

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

常用的資訊比如原始檔名、檔案型別、檔案大小、本地儲存路徑等。藉助multer，我們可以很方便的獲取這些資訊。

還是單檔案上傳的例子，此時，multer會將檔案的資訊寫到 req.file 上，如下程式碼所示。

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

<formaction="/upload"method="post"enctype="multipart/form-data">
    <h2>單圖上傳</h2>
    <inputtype="file"name="logo">
    <inputtype="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：設定資源儲存在本地的檔名。

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

<formaction="/upload"method="post"enctype="multipart/form-data">
    <h2>單圖上傳</h2>
    <inputtype="file"name="logo">
    <inputtype="submit"value="提交">
</form>

測試步驟不贅述，訪問一下就知道效果了。

寫在後面

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

相關連結

轉載：https://www.cnblogs.com/chyingp/p/express-multer-file-upload.html