在前端開發中,靜態資源快取是很常見的問題。若 CSS、JavaScript 或圖片更新後,瀏覽器仍讀取舊快取,就可能造成頁面沒有即時生效。以下介紹兩種常見的自動添加版本號方式。
這種方式由伺服器端語言讀取檔案最後修改時間,並將時間作為版本號附加在資源網址後方。
以 PHP 為例:
<?php
function AutoVersion($file) {
if (file_exists($_SERVER['DOCUMENT_ROOT'] . $file)) {
$ver = filemtime($_SERVER['DOCUMENT_ROOT'] . $file);
} else {
$ver = 1;
}
return $file . '?v=' . $ver;
}
?>
使用方式:
<link rel="stylesheet" href="<?=AutoVersion('assets/css/style.css')?>" type="text/css" />
若檔案存在,輸出結果可能類似:
<link rel="stylesheet" href="assets/css/style.css?v=1367936144322" type="text/css" />
此外,也可以將生成的靜態 HTML 快取起來。當靜態檔案透過 SVN 更新時,可利用 post-commit hooks 執行腳本,更新快取內容。
若專案使用 GruntJS 自動化構建工具,可以透過外掛產生版本號。其原理是取得檔案的 MD5 值,同一檔案內容不變時,MD5 值也固定不變。GruntJS 會將檔案路徑與對應雜湊值輸出為 JSON 或 PHP 等格式,再由後端程式讀取並套用。
推薦使用外掛:
此插件可指定輸出 JSON 或 PHP 格式檔案。
JSON 範例:
{
"path/css/filename1.css": "fa6a5a3224d7da66d9e0bdec25f62cf0",
"path/css/filename2.css": "5ba48b6e5a7c4d4930fda256f411e55b",
"path/js/filename1.js": "08e0484db917d5c6d9a64863d38d8524",
"path/js/filename2.js": "acf18f30162b04df1a35ba5cc51fff1a"
}
PHP 範例:
<?php
return array(
'md5' => array(
'js/main.js' => 'ae65552d65cd19ab4f1996c77915ed42',
'js/vendor/modernizr-2.6.2.min.js' => 'b8009fa783ea3de3802efcd29d7473d5',
'img/bg/about.jpg' => '7e402c1d64f0b00b4ade850f9017556a',
'crossdomain.xml' => '625e6c239ea0b5504ce0641b74ec2a3b',
),
);
?>
也可以自訂輸出格式,詳細用法可參考官方文件。
其他類似的外掛:
可依專案需求選擇合適的外掛,也能在 GruntJS 官方外掛目錄中找到更多工具。