gulp自動為靜態(tài)資源添加md5戳

起因

瀏覽器的緩存機制邻眷,導致web項目的靜態(tài)資源不能及時獲取鹅巍。目前最優(yōu)解決方案是:基于文件內(nèi)容的hash版本冗余機制。

我們希望開發(fā)的時候靜態(tài)資源是醬紫的:

<link href="css/style.css" rel="stylesheet">

上線時词爬,靜態(tài)資源是醬紫的:

<link href="css/style_4cbfcb.css" rel="stylesheet">

試試

查找資料秃嗜,兩種辦法比較科學,如下:

1.一步到位型

使用gulp-md5-plus(常規(guī)方法gulp-rev顿膨、gulp-rev-collerctor也可以做到一樣的效果锅锨,不過不推薦)

npm install --save-dev gulp-md5-plus

gulp文件中配置

var md5 = require("gulp-md5-plus");

打包的時候,移動css的代碼中加上一段

//config是配置的靜態(tài)資源路徑
gulp.task('pack:css', function() {
return gulp.src(config.pack.css.src)
    .pipe(minifyCSS())
    .pipe(md5(6,config.pack.html.src)) //css增加md5版本號恋沃,6位
    .pipe(gulp.dest(config.pack.css.dest));
});

于是自動給靜態(tài)資源加md5版本號橡类,且自動替換頁面中的路徑。

<link href="css/style_4cbfcb.css" rel="stylesheet">

這種做法有以下的好處:

  • 線上的文件不是同名文件覆蓋芽唇,而是文件名+hash的冗余顾画,所以可以先上線靜態(tài)資源,再上線頁面匆笤,不存在間隙問題研侣。
  • 遇到版本回滾問題,只需要回滾頁面炮捧,無需回滾靜態(tài)資源庶诡。
  • 由于靜態(tài)資源版本號是文件內(nèi)容的hash,因此所有靜態(tài)資源可以開啟永久強緩存咆课,只有更新了內(nèi)容文件才會緩存失效末誓,緩存利用率大增扯俱。
  • 修改靜態(tài)資源會在線上產(chǎn)生新的文件,一個文件對應一個版本喇澡,不會受到構(gòu)造CDN緩存形式的攻擊迅栅。

1.hack插件方法

有些時候,我們需要的是下邊的情況

<link href="css/style.css" rel="stylesheet">
=>> <link href="css/style.css?v=4cbfcb" rel="stylesheet">

如果這樣的話晴玖,上邊提到的gulp-md5-plus读存,以及常規(guī)方法gulp-rev、gulp-rev-collerctor都無法使用了呕屎。

不過需要hack一下让簿,gulp-rev、gulp-rev-collerctor秀睛,可以達成這個效果尔当。

//安裝對應版本的插件
npm install --save-dev gulp-rev@5.1.0  
npm install --save-dev gulp-rev-collector@1.0.0

第一步,打開node_modules\gulp-rev\index.js

第135行 manifest[originalFile] = revisionedFile;
更新為: manifest[originalFile] = originalFile + '?v=' + file.revHash;

第二步蹂安,打開node_modules\rev-path\index.js

10行 return filename + '-' + hash + ext;
更新為: return filename + ext;

第三步椭迎,打開node_modules\gulp-rev-collector\index.js

31行 if ( path.basename(json[key]).replace(new RegExp( opts.revSuffix ), '' ) !== path.basename(key) ) {
更新為: if ( path.basename(json[key]).split('?')0 !== path.basename(key) ) {

正常使用gulp-rev和gulp-rev-collector,得到的效果就是

<link href="css/style.css" rel="stylesheet">
=>> <link href="css/style.css?v=4cbfcb32" rel="stylesheet">

這種方案使用的插件版本分別是

"gulp-rev": "^5.1.0",
"gulp-rev-collector": "^1.0.0",

如果npm install的是最新的插件藤抡,代碼位置需要調(diào)整侠碧,根據(jù)版本不一樣,改法是不一致的缠黍,不推薦大家使用這種方法弄兜,除非專門改一個放在npm上,否則不利于團隊協(xié)作瓷式。

參考文檔
靜態(tài)資源緩存與更新:https://my.oschina.net/jathon/blog/404968
gulp-md5-plus:https://www.npmjs.com/package/gulp-md5-plus
gulp-rev:https://www.npmjs.com/package/gulp-rev

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末替饿,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子贸典,更是在濱河造成了極大的恐慌视卢,老刑警劉巖,帶你破解...
    沈念sama閱讀 211,817評論 6 492
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件廊驼,死亡現(xiàn)場離奇詭異据过,居然都是意外死亡,警方通過查閱死者的電腦和手機妒挎,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,329評論 3 385
  • 文/潘曉璐 我一進店門绳锅,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人酝掩,你說我怎么就攤上這事鳞芙。” “怎么了?”我有些...
    開封第一講書人閱讀 157,354評論 0 348
  • 文/不壞的土叔 我叫張陵原朝,是天一觀的道長驯嘱。 經(jīng)常有香客問我,道長喳坠,這世上最難降的妖魔是什么鞠评? 我笑而不...
    開封第一講書人閱讀 56,498評論 1 284
  • 正文 為了忘掉前任,我火速辦了婚禮丙笋,結(jié)果婚禮上谢澈,老公的妹妹穿的比我還像新娘煌贴。我一直安慰自己御板,他們只是感情好,可當我...
    茶點故事閱讀 65,600評論 6 386
  • 文/花漫 我一把揭開白布牛郑。 她就那樣靜靜地躺著怠肋,像睡著了一般。 火紅的嫁衣襯著肌膚如雪淹朋。 梳的紋絲不亂的頭發(fā)上笙各,一...
    開封第一講書人閱讀 49,829評論 1 290
  • 那天,我揣著相機與錄音础芍,去河邊找鬼杈抢。 笑死,一個胖子當著我的面吹牛仑性,可吹牛的內(nèi)容都是我干的惶楼。 我是一名探鬼主播,決...
    沈念sama閱讀 38,979評論 3 408
  • 文/蒼蘭香墨 我猛地睜開眼诊杆,長吁一口氣:“原來是場噩夢啊……” “哼歼捐!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起晨汹,我...
    開封第一講書人閱讀 37,722評論 0 266
  • 序言:老撾萬榮一對情侶失蹤豹储,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后淘这,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體剥扣,經(jīng)...
    沈念sama閱讀 44,189評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,519評論 2 327
  • 正文 我和宋清朗相戀三年铝穷,在試婚紗的時候發(fā)現(xiàn)自己被綠了钠怯。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,654評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡氧骤,死狀恐怖呻疹,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤刽锤,帶...
    沈念sama閱讀 34,329評論 4 330
  • 正文 年R本政府宣布镊尺,位于F島的核電站,受9級特大地震影響并思,放射性物質(zhì)發(fā)生泄漏庐氮。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 39,940評論 3 313
  • 文/蒙蒙 一宋彼、第九天 我趴在偏房一處隱蔽的房頂上張望弄砍。 院中可真熱鬧,春花似錦输涕、人聲如沸音婶。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,762評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽衣式。三九已至,卻和暖如春檐什,著一層夾襖步出監(jiān)牢的瞬間碴卧,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,993評論 1 266
  • 我被黑心中介騙來泰國打工乃正, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留住册,地道東北人。 一個月前我還...
    沈念sama閱讀 46,382評論 2 360
  • 正文 我出身青樓瓮具,卻偏偏與公主長得像荧飞,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子搭综,可洞房花燭夜當晚...
    茶點故事閱讀 43,543評論 2 349

推薦閱讀更多精彩內(nèi)容