環境初始化
非常簡單,一行指令。
npm install express multer multer --save
每個範例下面,都有下面兩個檔案
➜ upload-custom-filename git:(master) ✗tree -L 1. # 服務端程式碼,用來處理檔案上傳要求├── 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);
<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
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 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>
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 action="/upload" method="post" enctype="multipart/form-data"> <h2>单图上传</h2> <input type="file" name="logo"> <input type="submit" value="提交"> </form>
原始檔案名稱:1.png
檔案大小:18379檔案儲存路徑:upload/b7e4bb22375695d92689e45b551873d9
的路徑、名稱,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的基礎用法進行了介紹,並未涉及過多原理性的東西。俗話說 授人以漁不如授人以漁,在後續的章節裡,會對文件上傳的細節進行挖掘,好讓讀者朋友對文件上加深進一步的認識。