mirror of
https://codeberg.org/PostERG/xamxam.git
synced 2026-05-06 19:19:19 +02:00
c86781b9be
Status (services, PHP env, disk) is now always visible above the log/config tab bar rather than being one of the tab targets: - Status section rendered unconditionally above <nav class="sys-tabs">. - Services grid, PHP info grid and disk bar grouped inside a collapsible <section> with a header row containing the cache-freshness badge and a toggle button (▲ Réduire / ▼ Développer). - Collapse state persisted in localStorage so the preference survives page reloads (e.g. when switching log tabs). - Tab bar now only contains the three log tabs + nginx config; the 'Statut' tab is removed. Legacy ?tab=status URLs fall through to nginx_access. - PHP/disk sub-sections laid out in a 2-col grid inside the status panel; responsive single-col below 700px. - system.css: new .sys-status-section / .sys-status-header / .sys-status-toggle / .sys-status-meta rules added. - aria-current="page" added to active tab links. - todo/03-system-cache.md: all items marked done; notes added explaining why log caching was deliberately omitted.
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# System Page Caching - Database-Backed Status Cache
|
||
|
||
## Problem
|
||
|
||
The admin system page (`/admin/system.php`) runs expensive operations on every load:
|
||
- `systemctl` subprocess calls (~4 checks × ~100ms each)
|
||
- `curl` HTTP self-check (~200-500ms)
|
||
- `disk_total_space()`/`disk_free_space()` (fast but unnecessary per-request)
|
||
- Log file `tail` + `filesize` + `filemtime` (I/O bound)
|
||
- Nginx config file reading
|
||
|
||
## Solution: `system_cache` table + background refresh
|
||
|
||
- [x] **Add `system_cache` table** to schema: `CREATE TABLE system_cache (key TEXT PRIMARY KEY, value TEXT NOT NULL, updated_at INTEGER NOT NULL)`
|
||
- [x] **Add migration** `storage/migrations/007_system_cache.sql`
|
||
- [x] **Add `SystemCache` class** (`src/SystemCache.php`) with methods:
|
||
- `get(string $key, int $maxAgeSec = 60): ?array`
|
||
- `set(string $key, array $data): void`
|
||
- `isStale(string $key, int $maxAgeSec = 60): bool`
|
||
- [x] **Refactor `system.php` status section**:
|
||
1. Check `SystemCache::get('system_status', 120)` — 2-minute TTL
|
||
2. If cache hit → render from cache, show “mis en cache il y a X sec” label
|
||
3. If cache miss → run checks, store in cache, render
|
||
4. Add `?refresh=1` GET param to force-bypass cache
|
||
- [x] **Refactor `system.php` log sections** — avoid re-reading on every tab switch; only read the active tab’s log
|
||
- [x] **Cache disk info** separately with 5-minute TTL: `SystemCache::get('disk_info', 300)`
|
||
- [x] **Cache PHP info** separately with 1-hour TTL: `SystemCache::get('php_info', 3600)`
|
||
|
||
## Notes
|
||
|
||
- Log caching deliberately omitted: `tail` output is inherently real-time and caching even 30s would show stale data during the moments it matters most (deploys, errors). The existing tab guard already ensures only the active log file is read.
|
||
- nginx config could be cached but `file()` on a small static config file is negligible; not worth the added complexity.
|
||
- A future improvement could stream log tabs via `fetch()` to avoid full-page reloads on tab switch.
|