Rechercher
Saisissez au moins deux caractères, sans donnée personnelle.

    BibliothèqueArticles et FAQ Votre projetDemander un devis
    LangueFR
    Guides pratiques

    Configurer le cache HTTP sans exposer de données privées

    Un cache accélère un site seulement si la réponse réutilisée convient à la personne et au moment de la visite. Une politique unique appliquée à tous les fichiers peut masquer une mise à jour ou exposer une réponse personnalisée.

    Voir la méthode

    Équipement réseau et ordinateur sur un bureau technique
    Illustration générée par IA

    Classer les réponses avant de fixer une durée

    Faites l’inventaire des pages publiques, fichiers statiques, réponses d’API, comptes et confirmations. Pour chacune, notez si le contenu varie selon la personne, la langue ou un paramètre. Identifiez les caches traversés : navigateur, serveur intermédiaire et CDN. Une page de compte ne doit pas hériter par commodité de la politique d’une photographie publique.

    Distinguez la durée de fraîcheur du droit de conserver une réponse. MDN rappelle que no-cache demande une revalidation, alors que no-store demande de ne pas stocker. private restreint le stockage aux caches privés. La présence d’un cookie ne suffit pas à rendre automatiquement une réponse privée.

    Prévoir comment une modification devient visible

    Rédigez une règle de mise à jour par famille. Pour un fichier versionné, vérifiez que la nouvelle page appelle bien la nouvelle URL. Pour une page publique à adresse stable, décrivez la revalidation ou la purge prévue. Fixer une longue durée sans procédure de remplacement déplace simplement le problème vers le prochain changement.

    Prenez un exemple concret : une correction de prix, un horaire ou un document remplacé. Notez le moment où la source est modifiée, puis observez la réponse depuis une session ayant déjà visité la page. Une vérification depuis un navigateur vierge ne couvre pas le visiteur qui conserve une ancienne réponse.

    Lors d’une revalidation, le navigateur peut envoyer dans If-None-Match la valeur ETag de sa copie. Si la représentation correspond encore, une réponse 304 permet de réutiliser le corps déjà conservé ; elle ne transmet pas un nouveau corps de page. Si la représentation a changé, une réponse complète 200 peut apporter le contenu et son nouveau validateur. Un code isolé ne décrit donc pas ce que voit finalement le visiteur.

    Si la première réponse contient Last-Modified, recopiez exactement cette date dans If-Modified-Since lors d’un second GET sur la même URL. Une réponse 304 indique que la date du serveur n’est pas plus récente. Si deux versions sont diffusées au cours de la même seconde, la date peut être identique malgré le changement. Utilisez un ETag qui distingue les versions lorsque cette précision compte. Si la requête contient les deux champs conditionnels, If-None-Match est prioritaire.

    Le tableau utilise les validateurs fictifs demo-v1 et demo-v2 pour distinguer les étapes, sans mesurer ce site. Conservez ensemble requête conditionnelle, réponse, copie réutilisée et contenu affiché après correction. Un ETag est un identifiant opaque produit par le serveur, pas nécessairement une empreinte ni une date. Vérifiez aussi le retour arrière : l’historique peut restaurer un instantané par un mécanisme distinct du cache HTTP.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Exemple fictif : suivre une revalidation jusqu’au contenu affiché
    Situation d’essaiÉchange à rapprocherPreuve utile
    Première lecture200 avec corps et ETag demo-v1.La copie initiale contient bien la version attendue.
    Revalidation sans modificationIf-None-Match demo-v1, puis 304.Le corps déjà conservé est réutilisé ; aucun nouveau corps n’est reçu.
    Représentation modifiéeIf-None-Match demo-v1, puis 200 avec demo-v2.Le nouveau corps est reçu et la correction est effectivement visible.
    Réponse 304 observée seuleLa réponse doit être rapprochée de la copie conservée.Le seul code ne prouve ni récupération du contenu ni affichage de la bonne variante.

    Tester plusieurs identités et états

    Sur un environnement de test, comparez une visite anonyme, deux comptes distincts, une déconnexion et une navigation de retour. Examinez le contenu réellement affiché et les en-têtes reçus, pas seulement la configuration annoncée par l’hébergeur. N’utilisez aucun document personnel réel dans les jeux d’essai.

    Ajoutez les variantes utiles : langue, appareil, paramètres de filtre et erreur serveur. Conservez pour chaque essai l’URL, l’état de session, la réponse attendue et le résultat. Si une personnalisation passe par un cache partagé, faites examiner la clé et les exclusions par la personne responsable de l’infrastructure.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Lire les directives sans les confondre
    Situation ou réglageCe que cela signifieVérification utile
    no-cacheLe stockage reste possible, mais la réponse doit être validée avant réutilisation.Vérifier la revalidation après modification ; ne pas traiter cette directive comme no-store.
    no-storeDemande aux caches de ne pas stocker la réponse.Contrôler aussi les couches de cache déjà présentes et la politique des pages sensibles.
    privateInterdit le stockage dans un cache partagé ; autorise un cache privé.Tester avec deux comptes séparés, puis en visite anonyme.

    Conserver une procédure de reprise

    Documentez qui peut purger le cache, comment vérifier l’effet et comment rétablir une configuration précédente. Une purge générale peut réduire temporairement le bénéfice du cache ; préparez un contrôle des pages essentielles après l’opération.

    Révisez cette politique lorsqu’un espace client, une boutique, une langue ou un nouveau CDN apparaît. Le livrable utile est une matrice réponse–politique–test–responsable. Une note de performance isolée ne démontre ni la fraîcheur des informations ni l’absence de fuite entre utilisateurs.

    Documentation primaire : MDN : HTTP caching.

    Éviter qu’un cache partage une mauvaise variante entre plusieurs visiteurs.

    Cas fictif : la même URL sert un document dans deux formats selon un en-tête de requête. Testez les deux choix derrière le cache utilisé et contrôlez la clé de variation, notamment Vary lorsque pertinent. Les URL distinctes peuvent être préférables pour les versions éditoriales. Une négociation automatique ne doit pas rendre inaccessible une variante explicitement choisie.

    • Chaque demande reçoit la bonne représentation, y compris après l’autre variante et avec le cache activé.
    • MDN Content Negotiation

      Guide du choix d’une représentation HTTP selon les capacités ou préférences du client, notamment langue, format ou encodage.

    Séparer les réponses publiques et privées

    Deux ordinateurs distingués par des repères colorés près d’un routeur
    Illustration générée par IA · Observer séparément les contenus obtenus dans deux sessions de test.

    Cas proposé : une confirmation personnalisée est testée derrière le même cache que les pages publiques. Son contenu et ses en-têtes doivent être examinés dans ce parcours précis.

    Comparez requête, réponse et conditions de réutilisation avec deux sessions de test isolées. Gardez les en-têtes observés et la séparation des contenus ; une règle globale de cache ne valide pas chaque réponse.

    • Classer la réponse concernée
    • Observer les en-têtes réels
    • Tester des sessions distinctes

    Documents de référence

    Contenu mis à jour le

    Repères documentaires pour ce sujet

    Repères documentaires pour ce sujet
    RéférenceValeur ou syntaxePortée du repère
    HTTP · 304
    If-None-Match → 304Sur une requête GET ou HEAD, une représentation inchangée peut être réutilisée sans renvoyer son corps.
    MDN · Vary
    Vary: Accept-LanguageSi une même URL produit des réponses différentes selon Accept-Language, Vary signale ce critère au cache. Garder une valeur cohérente dans les réponses 200 et 304. Des URL linguistiques distinctes ne nécessitent pas cet en-tête uniquement parce que le site est multilingue.
    HTTP · If-Match
    If-Match: "r7" → 412If-Match compare un validateur fort avant une écriture. Dans le contrat présenté, une version dépassée reçoit 412 ; le brouillon est conservé pour comparer les changements.

    Les dates indiquent la consultation des références. Ces repères ne constituent ni un audit du site ni une déclaration globale de conformité.

    Lire une revalidation de cache

    Comparez un corps remplacé et une copie réutilisée. Les extraits montrent les validateurs et le contenu disponible, pas seulement le code.

    Les extraits sont incomplets et utilisent des adresses de démonstration. L’essai crée une Response en mémoire : il ne contacte aucun serveur et ne simule ni réseau, ni cache, ni traitement métier.

    200Nouvelle représentation complète
    Ce que cela signifie
    Dans cet extrait, le serveur répond au GET conditionnel avec un corps JSON et le validateur demo-v2.
    Contrôle à effectuer
    Rapprochez If-None-Match, ETag et la révision du corps. L’essai local lit le JSON réellement fourni dans cet exemple.
    Point de vigilance
    Un statut 200 ne garantit ni un JSON valide ni un contenu métier correct. Ici, la réussite de l’analyse ne valide pas le schéma de vos propres données.
    Extrait d’échange fictif
    GET /demo/catalogue
    If-None-Match: "demo-v1"
    
    HTTP/1.1 200 OK
    ETag: "demo-v2"
    Content-Type: application/json
    
    {"revision":"demo-v2"}

    304Copie revalidée, aucun nouveau corps
    Ce que cela signifie
    304 répond à une requête conditionnelle : la représentation conservée peut être réutilisée. La réponse 304 ne fournit pas un nouveau corps.
    Contrôle à effectuer
    Rapprochez le validateur envoyé et la copie demo-v2 disponible. La bonne lecture dépend aussi de cette copie déjà conservée.
    Point de vigilance
    L’essai construit une Response 304 isolée, pas un cache HTTP. Lors d’un vrai fetch, le cache du navigateur peut fournir la réponse conservée : statut réseau et statut exposé au script peuvent différer.
    Extrait d’échange fictif
    GET /demo/catalogue
    If-None-Match: "demo-v2"
    
    HTTP/1.1 304 Not Modified
    ETag: "demo-v2"

    Références techniques : RFC 9110 §15 · MDN · Response.ok · MDN · Response.json() · WHATWG · Fetch · .

    Matrice de recette à adapter au projet

    Ces contrôles proposés utilisent des cas fictifs. Décidez du comportement attendu avec l’équipe, notez le résultat et attribuez les écarts non résolus avant publication.

    Faites défiler le tableau horizontalement pour lire toutes les colonnes. Au clavier, placez le focus sur le tableau puis utilisez les flèches.

    Cas de test, résultats attendus et preuves utiles
    CasRésultat attenduPreuve à conserver
    Page publique inchangéeLa politique annoncée et la réponse conditionnelle restent cohérentes.URL publique, Cache-Control, ETag ou Last-Modified et réponse à la requête conditionnelle correspondante.
    Contenu public modifiéLa version corrigée arrive dans les conditions de fraîcheur prévues.Ancienne et nouvelle version, heure et en-têtes reçus.
    Deux comptes de testAucune réponse personnalisée du premier compte ne sert au second.Requêtes isolées et contenu reçu pour chaque compte.
    Déconnexion puis retour arrièreLe comportement des écrans sensibles correspond au besoin de confidentialité défini.Séquence complète dans le navigateur et limites documentées.

    Questions fréquentes

    Comment distinguer no-cache, no-store et private dans un contrôle ?

    Examinez les en-têtes d’une réponse réelle, puis répétez la demande et le changement d’utilisateur dans un environnement autorisé. no-cache permet le stockage mais impose une validation avant réutilisation ; no-store demande de ne pas stocker ; private interdit le stockage par les caches partagés. Vérifiez aussi CDN et intermédiaires : un nom de directive dans la configuration ne prouve pas le comportement de toute la chaîne.

    Comment vérifier la mise à jour d’un prix mis en cache ?

    Publiez un prix fictif dans un environnement de test et notez sa version. Modifiez-le, puis contrôlez page, API éventuelle et cache intermédiaire depuis une session neuve et une session déjà ouverte. Définissez le délai acceptable et la méthode d’invalidation avant publication. Une nouvelle valeur visible pour l’administrateur ne prouve pas que les visiteurs reçoivent déjà la même réponse.