前端靜態(tài)資源版本更新與緩存——通過gulp 在原h(huán)tml文件上自動化添加js癞尚、css、img版本號

原理

1乱陡、修改js和css文件
2浇揩、通過對js,css文件內(nèi)容進行hash運算,生成一個文件的唯一hash字符串(如果文件修改則hash號會發(fā)生變化)
3憨颠、替換html中的js,css文件名胳徽,生成一個帶版本號的文件名

  • 原h(huán)tml文件代碼
<link rel="stylesheet" href="css/common.css"/>
<script type="text/javascript" src="js/simper_posterTvGrid.js"></script>
<img src="images/simper_logo.png" width="298" height="53" class="logo"/>
  • 預期效果:在原目錄結(jié)構(gòu)下html文件代碼
<link rel="stylesheet" href="css/common.css?v=c59c2ee7e8"/>
<script type="text/javascript" src="js/simper_posterTvGrid.js?v=3576a6e73c"></script>
<img src="images/simper_logo.png?v=ed4b91c157" width="298" height="53" class="logo"/>
先說說gulp的使用步驟

安裝nodejs -> 全局安裝gulp -> 項目安裝gulp以及gulp插件 -> 配置gulpfile.js -> 運行任務(wù)
詳細步驟見鏈接 http://www.ydcss.com/archives/18

  • 下面回到正題,如果給靜態(tài)資源文件自動添加版本號

1:安裝gulp和gulp插件

 打開命令指示符(cmd)執(zhí)行
 ```

npm install --save-dev gulp
npm install --save-dev gulp-rev
npm install --save-dev gulp-rev-collector
npm install --save-dev run-sequence
```
2:編寫gulpfile.js

//引入gulp和gulp插件
var gulp = require('gulp'),    
    runSequence = require('run-sequence'),    
    rev = require('gulp-rev'),    
    revCollector = require('gulp-rev-collector');

//定義css、js膜廊、img文件路徑乏沸,是本地css,js,img文件的路徑,可自行配置
var cssUrl = 'css/*.css',   
    jsUrl = 'js/*.js';    
    imageUrl = 'images/*';

//CSS生成文件hash編碼并生成 rev-manifest.json文件名對照映射
gulp.task('revCss', function(){    
    return gulp.src(cssUrl)        
        .pipe(rev())       
        .pipe(rev.manifest())        
        .pipe(gulp.dest('rev/css'));
});

//js生成文件hash編碼并生成 rev-manifest.json文件名對照映射
gulp.task('revJs', function(){    
    return gulp.src(jsUrl)        
        .pipe(rev())        
        .pipe(rev.manifest())        
        .pipe(gulp.dest('rev/js'));
});

//img生成文件hash編碼并生成 rev-manifest.json文件名對照映射
gulp.task('revImg', function(){    
    return gulp.src(imageUrl)        
        .pipe(rev())        
        .pipe(rev.manifest())        
        .pipe(gulp.dest('rev/images'));
});

//Html更換css爪瓜、js蹬跃、img文件版本
gulp.task('revHtml', function () {   
    return gulp.src(['rev/**/*.json', './*.html'])  /*./是本地html文件的路徑,可自行配置*/       
        .pipe(revCollector())        
        .pipe(gulp.dest('.'));  /*Html更換css铆铆、js文件版本,.也是和本地html文件的路徑一致*/});

//開發(fā)構(gòu)建
gulp.task('dev', function (done) {   
    condition = false;   
    runSequence(        
        ['revCss'],        
       ['revJs'],        
       ['revImg'],       
       ['revHtml'],        
       done);
});

gulp.task('default', ['dev']);

執(zhí)行g(shù)ulp命令后的效果

//rev目錄下生成了manifest.json對應(yīng)文件
{ "common.css": "common-803a7fe4ae.css"}
<link rel="stylesheet" href="css/common-803a7fe4ae.css"/>
<img src="images/simper_logo-803a7fe4ae.png" width="298" height="53" class="logo"/>
<script type="text/javascript" src="js/simper_posterTvGrid-803a7fe4ae.js"></script>

很顯然這不是我們需要的效果

3.更改gulp-rev和gulp-rev-collector

打開node_modules\gulp-rev\index.js
第144行 manifest[originalFile] = revisionedFile;
更新為: manifest[originalFile] = originalFile + '?v=' + file.revHash;
打開node_modules\gulp-rev\node_modules\rev-path\index.js
10行 return filename + '-' + hash + ext;
更新為: return filename + ext;
打開node_modules\gulp-rev-collector\index.js
31行if ( !_.isString(json[key]) || path.basename(json[key]).replace(new RegExp( opts.revSuffix ), '' ) !== path.basename(key) ) {
更新為: if ( !_.isString(json[key]) || path.basename(json[key]).split('?')[0] !== path.basename(key) ) {

再執(zhí)行g(shù)ulp命令蝶缀,得到的結(jié)果如下(效果正確):

<link rel="stylesheet" href="css/common.css?v=c59c2ee7e8"/>
<img src="images/simper_logo.png?v=ed4b91c157" width="298" height="53" class="logo"/>
<script type="text/javascript" src="js/simper_posterTvGrid.js?v=cbb4fc4f8a"></script>

但是假如我們更改了css和js后,再執(zhí)行g(shù)ulp命令薄货,得到的結(jié)果會如下:

<link rel="stylesheet" href="css/common.css?v=c59c2ee7e8?v=803a7fe4ae"/>
<img src="images/simper_logo.png?v=ed4b91c157?v=3a0d844594" width="298" height="53" alt="盼潭迹客" class="logo"/>
<script type="text/javascript" src="js/simper_posterTvGrid.js?v=cbb4fc4f8a?v=33379df310"></script>

有沒有發(fā)現(xiàn),會在版本號后面再添加一個版本號谅猾,因為gulp只替換了原來文件名柄慰,這樣又不符合預期效果了,所以我們想到税娜,還需要修改插件的替換正則表達式坐搔。

4.繼續(xù)更改gulp-rev-collector

打開node_modules\gulp-rev-collector\index.js
第107行 regexp: new RegExp( '([\/\\\\\'"])' + pattern, 'g' ),
更新為: regexp: new RegExp( '([\/\\\\\'"])' + pattern+'(\\?v=\\w{10})?', 'g' ),

現(xiàn)在你不管執(zhí)行多少遍gulp命令,得到的html效果都是

<link rel="stylesheet" href="css/common.css?v=c59c2ee7e8"/>
<img src="images/simper_logo.png?v=ed4b91c157" width="298" height="53" class="logo"/>
<script type="text/javascript" src="js/simper_posterTvGrid.js?v=cbb4fc4f8a"></script>

完美解決>淳亍8判小!弧岳!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末凳忙,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子禽炬,更是在濱河造成了極大的恐慌涧卵,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,496評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件瞎抛,死亡現(xiàn)場離奇詭異艺演,居然都是意外死亡,警方通過查閱死者的電腦和手機桐臊,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,407評論 3 392
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來晓殊,“玉大人断凶,你說我怎么就攤上這事∥装常” “怎么了认烁?”我有些...
    開封第一講書人閱讀 162,632評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我却嗡,道長舶沛,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,180評論 1 292
  • 正文 為了忘掉前任窗价,我火速辦了婚禮如庭,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘撼港。我一直安慰自己坪它,他們只是感情好,可當我...
    茶點故事閱讀 67,198評論 6 388
  • 文/花漫 我一把揭開白布帝牡。 她就那樣靜靜地躺著往毡,像睡著了一般。 火紅的嫁衣襯著肌膚如雪靶溜。 梳的紋絲不亂的頭發(fā)上开瞭,一...
    開封第一講書人閱讀 51,165評論 1 299
  • 那天,我揣著相機與錄音罩息,去河邊找鬼嗤详。 笑死,一個胖子當著我的面吹牛扣汪,可吹牛的內(nèi)容都是我干的断楷。 我是一名探鬼主播,決...
    沈念sama閱讀 40,052評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼崭别,長吁一口氣:“原來是場噩夢啊……” “哼冬筒!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起茅主,我...
    開封第一講書人閱讀 38,910評論 0 274
  • 序言:老撾萬榮一對情侶失蹤舞痰,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后诀姚,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體响牛,經(jīng)...
    沈念sama閱讀 45,324評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,542評論 2 332
  • 正文 我和宋清朗相戀三年赫段,在試婚紗的時候發(fā)現(xiàn)自己被綠了呀打。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,711評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡糯笙,死狀恐怖贬丛,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情给涕,我是刑警寧澤豺憔,帶...
    沈念sama閱讀 35,424評論 5 343
  • 正文 年R本政府宣布额获,位于F島的核電站,受9級特大地震影響恭应,放射性物質(zhì)發(fā)生泄漏抄邀。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,017評論 3 326
  • 文/蒙蒙 一昼榛、第九天 我趴在偏房一處隱蔽的房頂上張望境肾。 院中可真熱鬧,春花似錦褒纲、人聲如沸准夷。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,668評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽衫嵌。三九已至,卻和暖如春彻秆,著一層夾襖步出監(jiān)牢的瞬間楔绞,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,823評論 1 269
  • 我被黑心中介騙來泰國打工唇兑, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留酒朵,地道東北人。 一個月前我還...
    沈念sama閱讀 47,722評論 2 368
  • 正文 我出身青樓扎附,卻偏偏與公主長得像蔫耽,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子留夜,可洞房花燭夜當晚...
    茶點故事閱讀 44,611評論 2 353

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