gulp添加版本號解決靜態(tài)資源緩存問題

實現(xiàn)原理:

第一步:修改js和css文件序宦;
第二步:通過對js,css文件內(nèi)容進行hash運算睁壁,生成一個文件的唯一hash字符串(如果文件修改則hash號會發(fā)生變化);
第三步:替換html中的js,css文件名互捌,生成一個帶版本號的文件名;

最終效果

  • 原h(huán)tml文件代碼
<link rel="stylesheet" href="../css/default.css">
<script src="../js/app.js"></script>
  • 預(yù)期效果:在原目錄結(jié)構(gòu)下html文件代碼
<link rel="stylesheet" href="../css/default.css?v=5a636d79c4">
<script src="../js/app.js?v=3a0d844594"></script>
background:url("../images/none.png?v=8f204d4")

實現(xiàn)方法:

  1. 安裝gulp和gulp插件
npm install --save-dev gulp
npm install --save-dev gulp-rev
npm install --save-dev gulp-rev-collector
npm install --save-dev gulp-asset-rev
npm install --save-dev run-sequence
  1. 編寫gulpfile.js
//引入gulp和gulp插件
var gulp = require('gulp'),
    assetRev = require('gulp-asset-rev'),
    runSequence = require('run-sequence'),
    rev = require('gulp-rev'),
    revCollector = require('gulp-rev-collector');
//定義css潘明、js源文件路徑
var cssSrc = 'css/*.css',
    jsSrc = 'js/*.js';
//為css中引入的圖片/字體等添加hash編碼
gulp.task('assetRev', function(){
    return gulp.src(cssSrc)   //該任務(wù)針對的文件
      .pipe(assetRev())  //該任務(wù)調(diào)用的模塊
      .pipe(gulp.dest('src/css')); //編譯后的路徑
});
//CSS生成文件hash編碼并生成 rev-manifest.json文件名對照映射
gulp.task('revCss', function(){
    return gulp.src(cssSrc)
        .pipe(rev())
        .pipe(rev.manifest())
        .pipe(gulp.dest('rev/css'));
});
//js生成文件hash編碼并生成 rev-manifest.json文件名對照映射
gulp.task('revJs', function(){
    return gulp.src(jsSrc)
        .pipe(rev())
        .pipe(rev.manifest())
        .pipe(gulp.dest('rev/js'));
});
//Html替換css、js文件版本
gulp.task('revHtml', function () {
    return gulp.src(['rev/**/*.json', 'View/*.html'])
        .pipe(revCollector())
        .pipe(gulp.dest('View'));
});
//開發(fā)構(gòu)建
gulp.task('default', function (done) {
    condition = false;
    runSequence(       //需要說明的是秕噪,用gulp.run也可以實現(xiàn)以上所有任務(wù)的執(zhí)行钳降,只是gulp.run是最大限度的并行執(zhí)行這些任務(wù),而在添加版本號時需要串行執(zhí)行(順序執(zhí)行)這些任務(wù)腌巾,故使用了runSequence.
        ['assetRev'],
        ['revCss'],
        ['revJs'],
        ['revHtml'],
        done);
});

執(zhí)行g(shù)ulp命令后的效果:
rev目錄下生成了manifest.json對應(yīng)文件

{
  "default.css": "default-803a7fe4ae.css"
}

在html中如下:

<link rel="stylesheet" href="../css/default-803a7fe4ae.css">
<script src="../js/app-3a0d844594.js"></script>

顯然這不是我們需要的效果遂填。

  1. 修改gulp-rev和gulp-rev-collector
打開node_modules\gulp-rev\index.js
第144行 manifest[originalFile] = revisionedFile;
更新為: manifest[originalFile] = originalFile + '?v=' + file.revHash;
打開nodemodules\gulp-rev\nodemodules\rev-path\index.js
10行 return filename + '-' + hash + ext;
更新為: return filename + ext;
打開node_modules\gulp-rev-collector\index.js
40行的 let cleanReplacement =  path.basename(json[key]).replace(new RegExp( opts.revSuffix ), '' );
更新為: let cleanReplacement =  path.basename(json[key]).split('?')[0];
打開node_modules\gulp-assets-rev\index.js
78行 var verStr = (options.verConnecter || "-") + md5;
更新為:var verStr = (options.verConnecter || "") + md5;
80行 src = src.replace(verStr, '').replace(/(\.[^\.]+)$/, verStr + "$1");
更新為:src=src+"?v="+verStr;

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

<link rel="stylesheet" href="../css/default.css?v=803a7fe4ae">
<script src="../js/app.js?v=3a0d844594"></script>
background:url("../images/none.png?v=8f204d4")

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

<link rel="stylesheet" href="../css/default.css?v=33379df310?v=803a7fe4ae">
<script src="../js/app.js?v=3a0d844594?v=3a0d844594"></script>

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

  1. 繼續(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/default.css?v=5a636d79c4">
<script src="../js/app.js?v=3a0d844594"></script>

參考文章

如何讓前端強制從服務(wù)器拉取最新資源(html撕贞、css更耻、js、圖像)

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末捏膨,一起剝皮案震驚了整個濱河市秧均,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌号涯,老刑警劉巖目胡,帶你破解...
    沈念sama閱讀 206,214評論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異链快,居然都是意外死亡誉己,警方通過查閱死者的電腦和手機,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,307評論 2 382
  • 文/潘曉璐 我一進店門域蜗,熙熙樓的掌柜王于貴愁眉苦臉地迎上來巨双,“玉大人噪猾,你說我怎么就攤上這事≈郏” “怎么了袱蜡?”我有些...
    開封第一講書人閱讀 152,543評論 0 341
  • 文/不壞的土叔 我叫張陵,是天一觀的道長慢宗。 經(jīng)常有香客問我坪蚁,道長,這世上最難降的妖魔是什么婆廊? 我笑而不...
    開封第一講書人閱讀 55,221評論 1 279
  • 正文 為了忘掉前任迅细,我火速辦了婚禮,結(jié)果婚禮上淘邻,老公的妹妹穿的比我還像新娘。我一直安慰自己湘换,他們只是感情好宾舅,可當(dāng)我...
    茶點故事閱讀 64,224評論 5 371
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著彩倚,像睡著了一般筹我。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上帆离,一...
    開封第一講書人閱讀 49,007評論 1 284
  • 那天蔬蕊,我揣著相機與錄音,去河邊找鬼哥谷。 笑死岸夯,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的们妥。 我是一名探鬼主播猜扮,決...
    沈念sama閱讀 38,313評論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼监婶!你這毒婦竟也來了旅赢?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 36,956評論 0 259
  • 序言:老撾萬榮一對情侶失蹤惑惶,失蹤者是張志新(化名)和其女友劉穎煮盼,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體带污,經(jīng)...
    沈念sama閱讀 43,441評論 1 300
  • 正文 獨居荒郊野嶺守林人離奇死亡僵控,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 35,925評論 2 323
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了刮刑。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片喉祭。...
    茶點故事閱讀 38,018評論 1 333
  • 序言:一個原本活蹦亂跳的男人離奇死亡养渴,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出泛烙,到底是詐尸還是另有隱情理卑,我是刑警寧澤,帶...
    沈念sama閱讀 33,685評論 4 322
  • 正文 年R本政府宣布蔽氨,位于F島的核電站藐唠,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏鹉究。R本人自食惡果不足惜宇立,卻給世界環(huán)境...
    茶點故事閱讀 39,234評論 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望自赔。 院中可真熱鬧妈嘹,春花似錦、人聲如沸绍妨。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,240評論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽他去。三九已至毙驯,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間灾测,已是汗流浹背爆价。 一陣腳步聲響...
    開封第一講書人閱讀 31,464評論 1 261
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留媳搪,地道東北人铭段。 一個月前我還...
    沈念sama閱讀 45,467評論 2 352
  • 正文 我出身青樓,卻偏偏與公主長得像蛾号,于是被迫代替她去往敵國和親稠项。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 42,762評論 2 345

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