Nodejs進階：基於express+multer的檔案上傳實例

概覽

圖片上傳是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.jse。

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/b7e4bb22375695d92689e45b551873d99
上傳的路徑、名稱，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的基礎用法進行了介紹，並未涉及過多原理性的東西。俗話說 授人以漁不如授人以漁，在後續的章節裡，會對文件上傳的細節進行挖掘，好讓讀者朋友對文件上加深進一步的認識。