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

README.md

@@ -64,7 +64,7 @@ Car는 차량 모뎀/게이트웨이에서 받은 상태를 수집해 DB에 저
 - `sw.js`: 과거 등록된 service worker 정리용 파일
 - `assets/`: 아이콘과 정적 자산
 
-`asset-version.php`는 차량 모니터의 PHP/JS/CSS/manifest/icon 파일을 읽어 크기, 수정 시각, sha256 hash를 묶은 버전을 만듭니다. `assets/asset-reload.js`는 열린 모니터 화면에서 이 값을 확인하고, 달라지면 Cache Storage를 비우고 service worker 등록을 해제한 뒤 현재 화면을 다시 엽니다. 현재 URL의 `assetReload` 토큰이 최신 파일 묶음 hash와 다르면 첫 진입도 토큰을 붙인 URL로 다시 열어 낡은 JS/CSS가 먼저 실행되는 상황을 줄입니다. 모바일/삼성 브라우저 호환을 위해 화면 복귀, 온라인 복귀, 터치/클릭 복귀 이벤트도 확인하고, Web Storage 실패 시 쿠키 fallback으로 이전 버전을 비교합니다.
+`asset-version.php`는 차량 모니터의 PHP/JS/CSS/manifest/icon 파일을 읽어 전체 버전과 파일별 버전을 만듭니다. `monitor.php`는 실제 파일 수정 시각과 hash 기반 `v` 값을 icon, manifest, reload script 경로에 붙입니다. `assets/asset-reload.js`는 전체 버전이나 현재 로드된 script/link의 파일별 `v` 값이 달라지면 Cache Storage를 비우고 service worker 등록을 해제한 뒤 현재 화면을 다시 엽니다. 모바일/삼성 브라우저 호환을 위해 화면 복귀, 온라인 복귀, 터치/클릭 복귀 이벤트도 확인하고, Web Storage 실패 시 쿠키 fallback으로 이전 버전을 비교합니다.
 
 `monitor.php`는 남은 service worker 등록을 해제합니다. 차량 상태와 인증 요청은 실시간 응답이 중요하므로 브라우저 오프라인 캐시를 사용하지 않습니다.
 

asset-version.php

@@ -54,22 +54,27 @@ 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);
+    $publicPath = '/car/' . str_replace(DIRECTORY_SEPARATOR, '/', $relativePath);
     $fingerprints[] = implode('|', [
-        str_replace(DIRECTORY_SEPARATOR, '/', $relativePath),
+        ltrim($publicPath, '/'),
         (string)filesize($fullPath),
         (string)filemtime($fullPath),
         $fileHash,
     ]);
+    $assets[$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);

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 (!force && assetTokenFromLocation() === token) return;
-        if (assetTokenFromLocation() && sessionGet(reloadKey) === marker) 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) {
+            if (assetTokenFromLocation() !== token || mismatch || forceReload) {
-                reloadWith(data.version);
+                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);

monitor.php

@@ -31,6 +31,21 @@ const DATA_CURRENT_BILLING_USAGE_BYTES = [
     '2026-07' => ['total_bytes' => 6549504, 'meter_adjusted_bytes' => 7169536, 'included_bytes' => 104857600, 'coupon_registered_at' => null],
 ];
 
+function car_asset_url(string $path): string
+{
+    $relativePath = preg_replace('#^/car/#', '', $path) ?? ltrim($path, '/');
+    $fullPath = __DIR__ . '/' . ltrim($relativePath, '/');
+    $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);
+}
+
 function car_db(): PDO
 {
     static $pdo = null;
@@ -1196,13 +1211,13 @@ $carMonitorSession = car_monitor_launcher_session();
     <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
     <title>Car Monitor</title>
 
-    <link rel="icon" href="/car/assets/favicon.svg" type="image/svg+xml">
+    <link rel="icon" href="<?= htmlspecialchars(car_asset_url('/car/assets/favicon.svg'), ENT_QUOTES, 'UTF-8') ?>" type="image/svg+xml">
-    <link rel="shortcut icon" href="/car/favicon.ico">
+    <link rel="shortcut icon" href="<?= htmlspecialchars(car_asset_url('/car/favicon.ico'), ENT_QUOTES, 'UTF-8') ?>">
-    <link rel="icon" href="/car/assets/icon-32.png" type="image/png" sizes="32x32">
+    <link rel="icon" href="<?= htmlspecialchars(car_asset_url('/car/assets/icon-32.png'), ENT_QUOTES, 'UTF-8') ?>" type="image/png" sizes="32x32">
-    <link rel="icon" href="/car/assets/icon-192.png" type="image/png" sizes="192x192">
+    <link rel="icon" href="<?= htmlspecialchars(car_asset_url('/car/assets/icon-192.png'), ENT_QUOTES, 'UTF-8') ?>" type="image/png" sizes="192x192">
-    <link rel="apple-touch-icon" href="/car/assets/apple-touch-icon.png">
+    <link rel="apple-touch-icon" href="<?= htmlspecialchars(car_asset_url('/car/assets/apple-touch-icon.png'), ENT_QUOTES, 'UTF-8') ?>">
-    <link rel="manifest" href="/car/assets/site.webmanifest">
+    <link rel="manifest" href="<?= htmlspecialchars(car_asset_url('/car/assets/site.webmanifest'), ENT_QUOTES, 'UTF-8') ?>">
-    <script src="/car/assets/asset-reload.js?v=20260721_nocache1" data-service="car" defer></script>
+    <script src="<?= htmlspecialchars(car_asset_url('/car/assets/asset-reload.js'), ENT_QUOTES, 'UTF-8') ?>" data-service="car" defer></script>
     <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">