Accueil › Déploiement & mise en production › Cache, versions et déploiements sans casse
Cache, versions et déploiements sans casse
Déployer un frontdebutant
Deux natures de fichiers, deux politiques opposées.
| Fichier | Nom | Cache |
|---|---|---|
main-A7F3C2.js |
change à chaque build | un an, immutable |
index.html |
ne change jamais | no-cache |
location ~* \.(js|css|woff2)$ {
add_header Cache-Control "public, max-age=31536000, immutable";
}
location = /index.html {
add_header Cache-Control "no-cache";
}
La logique tient en une phrase : ce dont le nom change peut être gardé pour toujours ; ce dont le nom ne change pas doit être revérifié à chaque fois.
index.html est le point d'entrée : c'est lui qui dit quels fichiers charger. Le mettre en cache gèle l'application sur l'ancienne version — et l'utilisateur ne voit aucun des correctifs déployés, parfois pendant des jours.
Attention au vocabulaire : no-cache ne veut pas dire « ne garde rien ». Il veut dire « demande-moi avant de réutiliser ». Le fichier est conservé, et le serveur répond 304 s'il n'a pas bougé : un aller-retour, pas un téléchargement.
Les termes à connaître
- Empreinte de contenu (hashing)
Nom de fichier incluant une empreinte de son contenu (
main-A7F3C2.js). Produit automatiquement par le build : un changement de contenu change le nom, donc l'URL.- Cache-Control
En-tête qui dicte combien de temps une réponse peut être réutilisée sans redemander.
max-age=31536000, immutablepour un fichier à empreinte,no-cachepourindex.html.- immutable
Directive qui promet au navigateur que le contenu de cette URL ne changera jamais. Il cesse alors même de revalider. À ne poser que sur des fichiers à empreinte.
- no-cache
Ne signifie pas « ne pas mettre en cache » mais « revalider avant chaque réutilisation ». Le navigateur garde le fichier et demande au serveur s'il a changé — réponse
304s'il n'a pas bougé.- Purge de cache
Invalidation forcée des copies détenues par un CDN. Nécessaire pour les fichiers sans empreinte ; inutile pour les autres, dont l'URL change à chaque version.
- Erreur de chunk manquant
Panne classique d'une SPA : l'utilisateur a chargé l'ancienne page, un déploiement supprime les anciens fichiers, et la navigation suivante demande un morceau de code qui n'existe plus. Message typique :
ChunkLoadError: Loading chunk 5 failed.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.