Add file-based API cache — monitor and arrs pages now serve from /tmp/vv_cache instead of making live HTTP calls on every page load

2026-06-03 16:15:35 -04:00
parent 9655a30d25
commit 65075ed599
5 changed files with 107 additions and 0 deletions
@@ -291,3 +291,24 @@ function vv_unraid_api_query(string $hostId, string $gql, int $timeoutSec = 5, s
    // data key present (even if null means query ran but returned nothing useful).
    return array_key_exists('data', $decoded ?? []) ? $decoded['data'] : null;
 }
+
+// ── File-based API cache (/tmp/vv_cache — tmpfs, cleared on reboot) ───────────
+
+define('VV_CACHE_DIR', '/tmp/vv_cache');
+
+// Read a cached payload. Returns null if missing or older than $maxAge seconds.
+function vv_cache_read(string $key, int $maxAge = 90): ?array {
+    $f = VV_CACHE_DIR . '/' . $key . '.json';
+    if (!file_exists($f) || (time() - filemtime($f)) > $maxAge) return null;
+    $raw = file_get_contents($f);
+    return $raw ? (json_decode($raw, true) ?: null) : null;
+}
+
+// Write a payload atomically (tmp + rename) so readers never see a partial file.
+function vv_cache_write(string $key, array $data): void {
+    if (!is_dir(VV_CACHE_DIR)) @mkdir(VV_CACHE_DIR, 0755, true);
+    $f   = VV_CACHE_DIR . '/' . $key . '.json';
+    $tmp = $f . '.tmp';
+    file_put_contents($tmp, json_encode($data));
+    rename($tmp, $f);
+}