diff --git a/README.md b/README.md index e4678dc..f9dc05e 100644 --- a/README.md +++ b/README.md @@ -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` 헤더를 내려 문서 자체가 브라우저 캐시에 오래 남지 않게 합니다. ## 데이터/저장소 diff --git a/public/asset-version.php b/public/asset-version.php index c067eb9..6e8881c 100644 --- a/public/asset-version.php +++ b/public/asset-version.php @@ -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); diff --git a/public/assets/asset-reload.js b/public/assets/asset-reload.js index 694c770..2c74cd7 100644 --- a/public/assets/asset-reload.js +++ b/public/assets/asset-reload.js @@ -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); diff --git a/public/index.php b/public/index.php index 0e09033..1c05812 100644 --- a/public/index.php +++ b/public/index.php @@ -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(); - - - - - + + + + + - + +