點擊下載
本文文檔

當前位置：首頁 - 科技 - 知識百科 - 正文

Nodejs進階：基于express+multer的文件上傳實例

來源：懂視網責編：小采時間：2020-11-27 20:28:59

Nodejs進階：基于express+multer的文件上傳實例

Nodejs進階：基于express+multer的文件上傳實例:概覽圖片上傳是web開發中經常用到的功能，node社區在這方面也有了相對完善的支持。常用的開源組件有multer、formidable等，借助這兩個開源組件，可以輕松搞定圖片上傳。本文主要講解以下內容，后續章節會對技術實現細節進行深入挖掘。基礎例子：借助expr

推薦度：

點擊下載本文 文檔為doc格式

導讀Nodejs進階：基于express+multer的文件上傳實例:概覽圖片上傳是web開發中經常用到的功能，node社區在這方面也有了相對完善的支持。常用的開源組件有multer、formidable等，借助這兩個開源組件，可以輕松搞定圖片上傳。本文主要講解以下內容，后續章節會對技術實現細節進行深入挖掘。基礎例子：借助expr

概覽

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

聲明：本網頁內容旨在傳播知識，若有侵權等問題請及時與本網聯系，我們將在第一時間刪除處理。TEL:177 7030 7066 E-MAIL:11247931@qq.com