Perf : en-têtes HTTP de cache pour les assets et les articles #18

New Issue

2026-05-13T22:09:32Z

cedricAbonnel commented

2026-05-13 22:09:32 +00:00

Problème

Les assets statiques (CSS, JS, images) et les pages d'articles ne disposent d'aucun en-tête HTTP de cache. Le navigateur refetch tout à chaque navigation, même si rien n'a changé.

Localisation

public/index.php — aucun en-tête Cache-Control / ETag / Last-Modified émis
server/apache/lan.acegrp.varlog.conf — pas de directive ExpiresActive ni mod_headers pour les assets

Solution proposée

1. Assets statiques (Apache)

Dans la config Apache, ajouter des en-têtes longs pour les fichiers immuables :

<LocationMatch "\.(css|js|svg|png|webp|woff2)$">
    Header set Cache-Control "public, max-age=31536000, immutable"
</LocationMatch>

Conditionné à l'ajout d'un fingerprint de version dans les URLs (style.css?v=abc123) pour invalider le cache lors des mises à jour — sinon max-age long est dangereux.

2. Pages articles (PHP)

Émettre Last-Modified et ETag basés sur filemtime() de index.md + meta.json, et répondre 304 Not Modified si le navigateur envoie If-Modified-Since / If-None-Match.

$lastModified = max(filemtime($mdFile), filemtime($metaFile));
header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $lastModified) . ' GMT');
header('Cache-Control: public, max-age=300'); // 5 min

3. Fingerprinting des assets

Dans layout.php, générer le hash du fichier CSS/JS pour le suffixer dans l'URL :

$cssVersion = substr(md5_file(BASE_PATH . /public/assets/css/style.css), 0, 8);

<link href="/assets/css/style.css?v=<?= $cssVersion ?>" rel="stylesheet">

Critères d'acceptation

Les assets statiques retournent Cache-Control: public, max-age=31536000 avec fingerprint dans l'URL
layout.php génère les URLs d'assets avec hash de contenu
Les pages articles retournent Last-Modified et répondent 304 si rien n'a changé
Les pages de brouillons ne sont pas mises en cache (Cache-Control: no-store)

Migré depuis varlog#28

## Problème Les assets statiques (CSS, JS, images) et les pages d'articles ne disposent d'aucun en-tête HTTP de cache. Le navigateur refetch tout à chaque navigation, même si rien n'a changé. ## Localisation - `public/index.php` — aucun en-tête `Cache-Control` / `ETag` / `Last-Modified` émis - `server/apache/lan.acegrp.varlog.conf` — pas de directive `ExpiresActive` ni `mod_headers` pour les assets ## Solution proposée ### 1. Assets statiques (Apache) Dans la config Apache, ajouter des en-têtes longs pour les fichiers immuables : ```apache <LocationMatch "\.(css|js|svg|png|webp|woff2)$"> Header set Cache-Control "public, max-age=31536000, immutable" </LocationMatch> ``` Conditionné à l'ajout d'un **fingerprint de version** dans les URLs (`style.css?v=abc123`) pour invalider le cache lors des mises à jour — sinon `max-age` long est dangereux. ### 2. Pages articles (PHP) Émettre `Last-Modified` et `ETag` basés sur `filemtime()` de `index.md` + `meta.json`, et répondre `304 Not Modified` si le navigateur envoie `If-Modified-Since` / `If-None-Match`. ```php $lastModified = max(filemtime($mdFile), filemtime($metaFile)); header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $lastModified) . ' GMT'); header('Cache-Control: public, max-age=300'); // 5 min ``` ### 3. Fingerprinting des assets Dans `layout.php`, générer le hash du fichier CSS/JS pour le suffixer dans l'URL : ```php $cssVersion = substr(md5_file(BASE_PATH . /public/assets/css/style.css), 0, 8); ``` ```html <link href="/assets/css/style.css?v=<?= $cssVersion ?>" rel="stylesheet"> ``` ## Critères d'acceptation - [ ] Les assets statiques retournent `Cache-Control: public, max-age=31536000` avec fingerprint dans l'URL - [ ] `layout.php` génère les URLs d'assets avec hash de contenu - [ ] Les pages articles retournent `Last-Modified` et répondent `304` si rien n'a changé - [ ] Les pages de brouillons ne sont pas mises en cache (`Cache-Control: no-store`) --- *Migré depuis [varlog#28](https://git.abonnel.fr/cedricAbonnel/varlog/issues/28)*

cedricAbonnel referenced this issue from cedricAbonnel/varlog

2026-05-13 22:09:32 +00:00

Perf : en-têtes HTTP de cache pour les assets et les articles #28

cedricAbonnel closed this issue

2026-05-16 08:44:51 +00:00

cedricAbonnel referenced this issue from a commit

2026-05-16 12:06:32 +00:00

perf & ux : cache getAll, fingerprint assets, Last-Modified, 404 log, row-click bulk (v1.6.19)

Sign in to join this conversation.