에셋 리로드 파일별 캐시 검증 보강

This commit is contained in:
seo
2026-07-25 19:33:34 +09:00
parent 10c00b3e57
commit 3aff2748e8
4 changed files with 58 additions and 15 deletions
+1 -1
View File
@@ -68,7 +68,7 @@ Control은 라즈베리파이/리눅스 호스트의 팬과 시스템 상태를
- `bin/wifi_observe.php`: 5G WiFi 연결 시간 보정을 위한 시스템단 관측 CLI
- `systemd/control-wifi-observe.*`: WiFi 관측 CLI를 주기적으로 실행하는 systemd unit 예시
`asset-version.php``public`의 PHP/JS/CSS/manifest/icon 파일과 `config`의 PHP 파일을 읽어 크기, 수정 시각, sha256 hash를 묶은 버전을 만듭니다. `asset-reload.js`는 화면 복귀, 포커스 복귀, 온라인 복귀, 모바일 터치/클릭 복귀, 30초 간격으로 이 값을 다시 확인하고, 값이 달라지면 브라우저 Cache Storage를 비우고 service worker 등록을 해제한 뒤 현재 화면을 다시 엽니다. 현재 URL의 `assetReload` 토큰이 최신 파일 묶음 hash와 다르면 첫 진입도 토큰을 붙인 URL로 다시 열어 낡은 JS/CSS가 먼저 실행되는 상황을 줄입니다. 삼성 브라우저 등에서 Web Storage나 `Promise.finally()` 호환성이 부족해도 동작하도록 쿠키 fallback과 timeout 기반 캐시 삭제를 사용합니다. `index.php``no-store` 헤더를 내려 문서 자체가 브라우저 캐시에 오래 남지 않게 합니다.
`asset-version.php``public`의 PHP/JS/CSS/manifest/icon 파일과 `config`의 PHP 파일을 읽어 크기, 수정 시각, sha256 hash를 묶은 전체 버전과 파일별 버전을 만듭니다. `index.php``app.js`, `asset-reload.js`, `wakelock.js`, manifest, icon 경로에 실제 파일 수정 시각과 hash 기반 `v` 값을 붙여 정적 파일 캐시가 오래 남지 않게 합니다. `asset-reload.js`는 화면 복귀, 포커스 복귀, 온라인 복귀, 모바일 터치/클릭 복귀, 30초 간격으로 이 값을 다시 확인하고, 전체 버전 또는 현재 로드된 script/link의 파일별 `v` 값이 다르면 브라우저 Cache Storage를 비우고 service worker 등록을 해제한 뒤 현재 화면을 다시 엽니다. 현재 URL의 `assetReload` 토큰이 최신 파일 묶음 hash와 다르면 첫 진입도 토큰을 붙인 URL로 다시 열어 낡은 JS/CSS가 먼저 실행되는 상황을 줄입니다. 삼성 브라우저 등에서 Web Storage나 `Promise.finally()` 호환성이 부족해도 동작하도록 쿠키 fallback과 timeout 기반 캐시 삭제를 사용합니다. `index.php``no-store` 헤더를 내려 문서 자체가 브라우저 캐시에 오래 남지 않게 합니다.
## 데이터/저장소
+8
View File
@@ -55,22 +55,30 @@ function collect_asset_files(string $root, array $scanRoots): array
clearstatcache();
$rootPath = realpath($root);
$fingerprints = [];
$assets = [];
foreach (collect_asset_files($root, $scanRoots) as $fullPath) {
$relativePath = ltrim(str_replace($rootPath ?: $root, '', $fullPath), DIRECTORY_SEPARATOR);
$fileHash = is_readable($fullPath) ? (hash_file('sha256', $fullPath) ?: 'hash-failed') : 'unreadable';
$fileVersion = (string)filemtime($fullPath) . '-' . substr($fileHash, 0, 10);
$fingerprints[] = implode('|', [
str_replace(DIRECTORY_SEPARATOR, '/', $relativePath),
(string)filesize($fullPath),
(string)filemtime($fullPath),
$fileHash,
]);
if (str_starts_with($relativePath, 'public' . DIRECTORY_SEPARATOR)) {
$publicPath = substr($relativePath, strlen('public'));
$assets[str_replace(DIRECTORY_SEPARATOR, '/', $publicPath)] = $fileVersion;
}
}
echo json_encode([
'result' => 'ok',
'service' => $service,
'version' => hash('sha256', implode("\n", $fingerprints)),
'assets' => $assets,
'count' => count($fingerprints),
'generatedAt' => time(),
], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+28 -7
View File
@@ -21,6 +21,7 @@
var running = false;
var memoryStore = {};
var lastCheckAt = 0;
var bfcacheReturn = false;
function cookieName(key) {
return key.replace(/[^A-Za-z0-9_-]/g, '_');
@@ -167,12 +168,26 @@
unregisterServiceWorkers();
function reloadWith(version) {
function loadedAssetMismatch(assets) {
if (!assets || typeof assets !== 'object') return false;
var nodes = Array.prototype.slice.call(document.querySelectorAll('script[src], link[href]'));
return nodes.some(function (element) {
var attr = element.tagName.toLowerCase() === 'script' ? 'src' : 'href';
var current = element.getAttribute(attr);
var parsed = current ? sameOriginUrl(current) : null;
if (!parsed || !Object.prototype.hasOwnProperty.call(assets, parsed.pathname)) return false;
return parsed.searchParams.get('v') !== String(assets[parsed.pathname]);
});
}
function reloadWith(version, force) {
var token = version.slice(0, 12);
var marker = token + ':' + Math.floor(Date.now() / 10000);
if (assetTokenFromLocation() === token) return;
if (assetTokenFromLocation() && sessionGet(reloadKey) === marker) return;
if (!force && assetTokenFromLocation() === token) return;
if (sessionGet(reloadKey) === marker) return;
sessionSet(reloadKey, marker);
withTimeout(Promise.all([deleteCaches(), unregisterServiceWorkers()]), 2500).then(function () {
@@ -201,15 +216,18 @@
var token = data.version.slice(0, 12);
var previous = storeGet(storageKey);
var mismatch = loadedAssetMismatch(data.assets);
var forceReload = bfcacheReturn;
bfcacheReturn = false;
storeSet(storageKey, data.version);
if (assetTokenFromLocation() !== token) {
reloadWith(data.version);
if (assetTokenFromLocation() !== token || mismatch || forceReload) {
reloadWith(data.version, mismatch || forceReload);
return;
}
if (previous && previous !== data.version) {
reloadWith(data.version);
reloadWith(data.version, false);
}
}).then(function () {
running = false;
@@ -218,7 +236,10 @@
});
}
window.addEventListener('pageshow', function () {
window.addEventListener('pageshow', function (event) {
if (event && event.persisted) {
bfcacheReturn = true;
}
check(true);
setTimeout(function () { check(true); }, 250);
setTimeout(function () { check(true); }, 1500);
+21 -7
View File
@@ -14,6 +14,20 @@ if (!headers_sent()) {
$csrf = csrf_token();
function asset_url(string $path): string
{
$fullPath = __DIR__ . '/' . ltrim($path, '/');
$version = 'dev';
if (is_file($fullPath)) {
$mtime = filemtime($fullPath) ?: time();
$hash = is_readable($fullPath) ? substr(hash_file('sha256', $fullPath) ?: '', 0, 10) : '';
$version = $mtime . ($hash !== '' ? '-' . $hash : '');
}
return $path . '?v=' . rawurlencode($version);
}
if (isset($_GET['logout'])) {
clear_remember_token();
clear_common_admin_auth_cookie_if_available();
@@ -78,11 +92,11 @@ $loggedIn = signed_in();
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Gowun+Dodum&display=swap" rel="stylesheet">
<link rel="icon" href="/assets/favicon.svg" type="image/svg+xml">
<link rel="icon" href="/assets/icon-192.png" type="image/png" sizes="192x192">
<link rel="apple-touch-icon" href="/assets/apple-touch-icon.png">
<link rel="manifest" href="/manifest.json">
<script src="/assets/asset-reload.js?v=20260721_nocache1" data-service="control" defer></script>
<link rel="icon" href="<?= e(asset_url('/assets/favicon.svg')) ?>" type="image/svg+xml">
<link rel="icon" href="<?= e(asset_url('/assets/icon-192.png')) ?>" type="image/png" sizes="192x192">
<link rel="apple-touch-icon" href="<?= e(asset_url('/assets/apple-touch-icon.png')) ?>">
<link rel="manifest" href="<?= e(asset_url('/manifest.json')) ?>">
<script src="<?= e(asset_url('/assets/asset-reload.js')) ?>" data-service="control" defer></script>
<meta name="theme-color" content="#0f1115">
<script>
try {
@@ -372,8 +386,8 @@ html[data-theme="light"] .details-panel{background:#edf3fa;border-color:#b8c7da}
</div>
</div>
</div>
<script src="/assets/app.js?v=20260723_touch_display3"></script>
<script src="/assets/wakelock.js?v=20260607_prefs1"></script>
<script src="<?= e(asset_url('/assets/app.js')) ?>"></script>
<script src="<?= e(asset_url('/assets/wakelock.js')) ?>"></script>
<?php endif; ?>
</body>
</html>