基于 gulp 的自動化構(gòu)建之“靜態(tài)資源版本管理”

在靜態(tài)資源版本管理方面题诵,以前用過兩種方案(都是通過后端實現(xiàn)) :
第一種:獲取文件最新修改時間拷淘。可以實現(xiàn)比較好的版本管理效果茄猫,但客戶端每一次訪問一個資源文件,服務(wù)器都會動態(tài)讀取一次該文件的最新修改時間困肩。對這種方案划纽,頭腦有限,暫時無法評估其對性能和訪問速度的影響锌畸。但就版本管理效果來說勇劣,更傾向于這一種。
第二種:設(shè)置日期常量蹋绽。版本管理效果非常差芭毙。

目前已實現(xiàn)的新方案如下:
在構(gòu)建階段計算靜態(tài)資源的 hash 值筋蓖,并將該值以參數(shù)的形式追加到<link><script>中的 URL退敦。
大家需要知道的是粘咖,如果某個文件發(fā)生了修改,我這里會自動修改引用了該文件的各個模塊的view文件侈百。
此方案可實現(xiàn)真正的版本管理效果瓮下,并且可以確定對性能和訪問速度無影響。

1. 默認(rèn)方案:

如果使用gulp-rev + gulp-rev-collector钝域,默認(rèn)效果如下:

"/css/style.css" => "/dist/css/style-1d87bebe.css"    
"/js/script1.js" => "/dist/script1-61e0be79.js"    
"cdn/image.gif"  => "http://cdn8.example.dot/img/image-35c3af8134.gif"

但是如果用上面方法讽坏,實現(xiàn)的是非覆蓋式更新:即每次修改文件之后,生成帶新版本號的文件例证,但是帶舊版本號的文件不會被刪除路呜,長此以往,最后你會發(fā)現(xiàn)文件夾里累積了大量帶舊版本號的無用文件织咧。例如胀葱,style.css文件經(jīng)過三次更新之后,會累積一下三個文件:

style-a3654c03aa.css
style-98c5f098bd.css
style-6e4cfcf9de.css

2. 改良方案:

期望效果:

href="dist/css/style.css" => href="dist/css/style.css?v=1d87bebe"
src="dist/js/all.min.js" => src="dist/js/all.min.js?v=98c5f098bd"
src="dist/img/image.gif"  => src="dist/img/image.gif?v=35c3af8134"

原理:

(1)gulp-rev根據(jù)文件內(nèi)容計算生成一個 hash 字符串笙蒙,如:98c5f098bd
(2)gulp-rev生成一個映射表抵屿,列出映射關(guān)系

{
  "all.min.js": "all.min.js?v=98c5f098bd"
}

(3)gulp-rev-collector根據(jù)該映射表 將<link><script>URL中的文件名all.min.js替換為all.min.js?v=98c5f098bd

如何修改捅位?

需要對gulp-revgulp-rev-collector進(jìn)行修改轧葛。修改如下:

修改映射表中 屬性值的格式:
打開node_modules\gulp-rev\index.js

第133行 manifest[originalFile] = revisionedFile;
修改為: manifest[originalFile] = originalFile + '?v=' + file.revHash;

修改生成文件的文件名(原來是將 hash 值加入到文件名中,現(xiàn)要文件名保持不變):
打開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) ) {

避免引用 URL 中的版本號累積:dist/js/all.min.js?v=6e4cfcf9de => dist/js/all.min.js?v=54a62a8eb6?v=6e4cfcf9de
打開node_modules\gulp-rev-collector\index.js

第107行 regexp: new RegExp( '([\/\\\\\'"])' + pattern, 'g' ),
修改為: regexp: new RegExp( '([\/\\\\\'"])' + pattern+'(\\?v=\\w{10})?', 'g' ),

3. gulpfile.js 部分配置

var rev = require('gulp-rev');
var revCollector = require('gulp-rev-collector');

gulp.task('css-rev', ['cleanCss'], function() {
    console.log('開始--計算 css 資源版本號艇搀,并生成映射表...');
    return gulp.src(['src/css/tmp/*.css'])
        .pipe(rev())
        .pipe(gulp.dest('dist/css'))
        .pipe(rev.manifest({
            path: 'rev-manifest-css.json'
        }))
        .pipe(gulp.dest('src/rev'));
});

gulp.task('css', ['css-rev'], function() {
    console.log('開始--修改 css 引用鏈接的資源版本號...');
    return gulp.src(['src/rev/rev-manifest-css.json', 'views/**/*.php'])
        .pipe(revCollector())
        .pipe(gulp.dest('views'));
});

gulp.task('js-rev', ['js-move'], function() {
    console.log('開始--計算 js 資源版本號佳簸,并生成映射表...');
    return gulp.src(['dist/js/**/*.js'])
        .pipe(rev())
        // .pipe(gulp.dest('dist/js'))
        .pipe(rev.manifest({
            path: 'rev-manifest-js.json'
        }))
        .pipe(gulp.dest('src/rev'));
});

gulp.task('js', ['js-rev'], function() {
    console.log('開始--修改 js 引用鏈接的資源版本號...');
    return gulp.src(['src/rev/rev-manifest-js.json', 'views/**/*.php'])
        .pipe(revCollector())
        .pipe(gulp.dest('views'));
});

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

最后編輯于
?著作權(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
  • 文/潘曉璐 我一進(jìn)店門郭膛,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人氛悬,你說我怎么就攤上這事则剃≡胖” “怎么了?”我有些...
    開封第一講書人閱讀 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)容