Web et développement

Explication du cache HTTP : Cache-Control, ETag, Images et configuration Apache

HTTP Caching Explained: Cache-Control, ETag, Images and Apache Configuration

Apprenez à configurer le cache du navigateur pour HTML, CSS, JavaScript, images et polices. Comprenez ETag et les réponses 304 avec des exemples pratiques, évitez les fichiers obsolètes et utilisez une configuration complète .htaccess Apache.

Explication du cache HTTP : Cache-Control, ETag, les images et la configuration d'Apache

Vous optimisez vos images, minifiez votre CSS et compressez votre JavaScript. Votre site web se charge plus rapidement. Cependant, lorsque les visiteurs reviennent, leurs navigateurs peuvent télécharger à nouveau les mêmes fichiers.

Vous activez le cache, tout semble alors parfait, jusqu'à ce que vous remplaciez une image et vous rendiez compte que certains visiteurs voient toujours l'ancienne version.

C'est là toute la difficulté du cache HTTP : réutiliser les fichiers qui n'ont pas changé, mais récupérer les nouvelles versions lorsqu'elles sont modifiées.

Dans ce guide, nous allons créer une stratégie de cache pour un site web réel en utilisant Apache, PHP et les outils de développement du navigateur.

1. Explication du cache HTTP avec un exemple simple

Imaginez un site web avec cinq fichiers :

index.html
assets/css/style.css
assets/js/app.js
assets/images/hero.webp
assets/fonts/site.woff2

Lorsqu'un utilisateur visite votre site web pour la première fois, le navigateur télécharge ces fichiers.

Première visite — le navigateur a besoin de tout

Imaginez maintenant que le visiteur revient dix minutes plus tard.

Si le serveur a précédemment indiqué au navigateur que le fichier CSS pouvait être réutilisé pendant une journée, le navigateur n'aura pas besoin de le télécharger à nouveau.

Le navigateur dispose déjà d'une copie.

C'est là le principe de base du cache.

Les instructions proviennent des en-têtes HTTP envoyés avec la réponse du serveur.

Par exemple :

Cache-Control: public, max-age=86400

Cela signifie que la réponse peut être réutilisée tant qu'elle est fraîche pendant 86 400 secondes, soit une journée.

Mais que se passe-t-il si vous mettez à jour le CSS après seulement une heure ?

Le navigateur peut continuer à utiliser l'ancienne version pendant les 23 heures restantes.

C'est pourquoi il ne suffit pas simplement d'augmenter la durée du cache.

2. Cache-Control : les instructions envoyées au navigateur

L'en-tête Cache-Control indique aux navigateurs et aux autres caches HTTP comment gérer une réponse.

Voici les directives que vous utiliserez le plus souvent.

Directive Explication simple
max-age=3600 Réutiliser la réponse pendant une heure maximum
public Les caches partagés, y compris les CDN, peuvent stocker la réponse
private Stocker uniquement dans un cache privé, pas dans un cache partagé
no-cache Stocker si autorisé, mais valider avant réutilisation
no-store Ne pas stocker la réponse
immutable Le contenu n'est pas censé changer tant qu'il est frais
must-revalidate Une fois périmé, ne pas réutiliser sans validation réussie

Une directive particulièrement confuse est no-cache.

Cela ne signifie pas « ne stockez jamais ce fichier. »

Cela signifie « avant d'utiliser une copie stockée, demandez au serveur si elle est toujours valide. »

Pour les réponses qui ne doivent pas être stockées, utilisez no-store.

Cette distinction est importante lors de la configuration des pages HTML et du contenu sensible.

3. Explication de l'ETag : comment le navigateur vérifie si un fichier a changé

Rendons cela concret.

Imaginez que vous avez un fichier appelé logo.webp.

Le navigateur le télécharge le lundi.

Le serveur envoie également un identifiant :

ETag: "logo-version-1"

Considérez cet identifiant comme une étiquette attachée à cette version particulière de l'image.

Le navigateur conserve l'image et se souvient de l'étiquette.

Le mardi, la réponse mise en cache a besoin d'être validée. Au lieu de télécharger immédiatement toute l'image à nouveau, le navigateur demande :

« Hé serveur, j'ai déjà l'image identifiée par logo-version-1. Est-ce toujours la même ? »

Techniquement, il envoie :

GET /images/logo.webp HTTP/1.1
Host: example.com
If-None-Match: "logo-version-1"

Le serveur compare cet identifiant avec la version actuelle.

Requête conditionnelle ETag :  pigé 304 si inchangé, 200 si modifié

Cas A : l'image n'a pas changé

Le serveur répond :

HTTP/1.1 304 Not Modified
ETag: "logo-version-1"

Le navigateur dit, en substance, « Super, je vais continuer à utiliser mon image existante. »

Le serveur ne renvoie pas le corps de l'image à nouveau.

Cas B : l'image a changé

Supposons que vous remplacez le logo par une nouvelle version.

Le serveur l'identifie maintenant comme logo-version-2.

Le navigateur demande toujours à propos de logo-version-1, mais le serveur répond :

HTTP/1.1 200 OK
Content-Type: image/webp
ETag: "logo-version-2"

Cette fois, la réponse inclut la nouvelle image.

Le navigateur remplace sa copie mise en cache.

C'est tout ce que fait l'ETag pour le cache : il aide le navigateur à vérifier si sa copie est toujours actuelle.

L'identifiant n'a pas besoin d'être un hachage ou un numéro de version. Apache peut le générer à partir des métadonnées du fichier, et les applications peuvent générer leurs propres identifiants.

Testez l'ETag vous-même

Tout d'abord, récupérez les en-têtes de réponse :

curl -I https://example.com/images/logo.webp

Trouvez l'ETag :

ETag: "abc123"

Envoyez ensuite une requête conditionnelle :

curl -I \
  -H 'If-None-Match: "abc123"' \
  https://example.com/images/logo.webp

Si la représentation est inchangée, un serveur correctement configuré peut retourner 304 Not Modified.

Si elle a changé, attendez 200 OK avec la représentation mise à jour.

Une limitation importante : L'ETag ne force pas le navigateur à contacter le serveur alors qu'une réponse mise en cache est encore fraîche. Si une image a une durée de fraîcheur d'un an, modifier le fichier sur le serveur ne garantit pas que le navigateur vérifiera son ETag immédiatement.

C'est là que le versionnement des ressources devient essentiel.

4. Le cache des images : la partie qui cause souvent le plus de problèmes

Les images sont souvent parmi les ressources les plus volumineuses sur un site web.

Une page d'accueil peut contenir une image principale, des illustrations de catégories, des miniatures d'articles, des logos, des icônes et des images de produits.

Même lorsqu'elles sont compressées en WebP ou AVIF, les télécharger à plusieurs reprises gaspille de la bande passante.

Examinons trois situations réelles.

Situation A : une image qui ne change jamais

Votre site web a une image décorative :

/images/background-v1.webp

Vous savez que chaque fois que le design change, vous utiliserez un nouveau nom de fichier.

Vous pouvez configurer en toute sécurité :

Cache-Control: public, max-age=31536000, immutable

Le navigateur peut la réutiliser pendant un an sans contacter le serveur tant que la réponse est fraîche.

Situation B : une image remplacée sous le même nom de fichier

Votre article contient :

<img src="/images/article-hero.webp" alt="Article illustration">

Vous remplacez article-hero.webp par une nouvelle image, mais conservez la même URL.

Si le navigateur a une réponse mise en cache fraîche avec une longue durée de vie, il peut continuer à afficher l'ancienne image.

La solution est de changer l'URL lorsque le contenu change.

Par exemple :

<img src="/images/article-hero.webp?v=2" alt="Article illustration">

Ou, mieux, générez un nom de fichier versionné :

<img src="/images/article-hero-a81c.webp" alt="Article illustration">

Maintenant, le navigateur voit une URL de ressource différente et demande la nouvelle image.

L'ancienne image mise en cache est inoffensive car le HTML ne la référence plus.

Remplacer une image sous la même URL versus utiliser une nouvelle URL versionnée

Situation C : des milliers d'images avec des noms de fichiers stables

Imaginez un site web éditorial contenant des milliers d'articles.

Renommer toutes les images manuellement serait fastidieux.

Vous pouvez plutôt choisir une durée de cache modérée, comme un jour ou une semaine, et compter sur la révalidation après expiration.

Par exemple :

Cache-Control: public, max-age=86400

C'est un compromis raisonnable lorsque le versionnement automatique des images n'est pas disponible.

Cependant, les visiteurs peuvent encore voir une image plus ancienne pendant la période de fraîcheur.

Pour les images qui doivent être mises à jour immédiatement, une URL modifiée ou une invalidation explicite du cache est préférable.

Qu'en est-il des formats JPEG, PNG, SVG, WebP et AVIF ?

Le principe de cache est identique pour tous.

Format d'image Utilisation typique Stratégie de cache
JPEG Photos Long cache si URL est versionnée
PNG Graphiques, transparence Même
WebP Images web optimisées Même
AVIF Images hautement compressées Même
SVG Icônes, logos, illustrations Même
GIF Animations simples Même

Le format influence la compression et le décodage, mais ne change pas fondamentalement le comportement du cache HTTP.

N'oubliez pas non plus que les images réactives peuvent produire plusieurs entrées cache indépendantes :

<picture>
  <source
    type="image/avif"
    srcset="/images/hero-640.avif 640w,
            /images/hero-1280.avif 1280w">
  <source
    type="image/webp"
    srcset="/images/hero-640.webp 640w,
            /images/hero-1280.webp 1280w">
  <img
    src="/images/hero-1280.jpg"
    alt="Mountain landscape"
    width="1280"
    height="720">
</picture>

Chaque URL sélectionnée a son propre comportement de cache.

Si vous remplacez l'image, mettez à jour les URL de chaque variante pertinente.

5. Versionner automatiquement CSS, JavaScript et images avec PHP

For PHP websites, you can avoid manually updating version numbers by using the file modification time.

Voici un petit assistant :

<?php

function assetUrl(string $path): string
{
    $file = $_SERVER['DOCUMENT_ROOT'] . $path;

    if(!is_file($file)) {
        return $path;
    }

    return $path . '?v=' . filemtime($file);
}

Use it like this:

<link rel="stylesheet" href="<?= htmlspecialchars(assetUrl('/assets/css/site.css'), ENT_QUOTES, 'UTF-8') ?>">

<img
    src="<?= htmlspecialchars(assetUrl('/assets/images/hero.webp'), ENT_QUOTES, 'UTF-8') ?>"
    alt="Hero image">

Suppose the file's modification timestamp is 1794800000.

The browser receives a URL such as:

/assets/images/hero.webp?v=1794800000

When you update the file and its modification time changes, the URL changes too.

C'est une simple stratégie pour éviter le cache.

For production build pipelines, content hashes are more robust because timestamps can be preserved during deployments or change without the content changing.

Important: If your CDN is configured to ignore query strings in its cache key, ?v= may not produce a distinct cached resource. Verify the CDN configuration or use versioned filenames instead.

6. Ne pas confondre le cache du navigateur, le cache du serveur et le cache du CDN

A website can have several caching layers.

The browser cache stores responses on the visitor's device.

A CDN stores selected responses on servers geographically closer to visitors.

An application cache can store generated HTML, database query results, or other computed data.

Ces couches résolvent différents problèmes.

For example, a CDN may serve an outdated image even after the browser cache is cleared.

Likewise, clearing a CMS cache does not necessarily invalidate an image already stored by a browser or CDN.

When debugging, identify which layer is serving the old content before changing configuration.

7. Performance d'hébergement et cache HTTP

HTTP caching peut réduire considérablement les téléchargements répétés, mais ne peut pas compenser tous les problèmes d'hébergement.

For example, if an uncached PHP page takes two seconds to generate because of slow database queries, browser caching of images will not solve the underlying server response time.

A reliable hosting environment should provide suitable PHP performance, storage, compression, TLS, and support for caching headers.

For small and medium websites, a hosting provider such as PlanetHoster can be part of a practical setup.

For applications requiring more control over server resources, deployment workflows, or caching architecture, Cloudways may also be worth evaluating.

Before changing providers, measure the actual bottleneck: server response time, image weight, PHP execution, database queries, or cache configuration.

8. Comment inspecter le cache dans Firefox et Chrome

Ouvrez les outils de développement de votre navigateur.

Dans Firefox, appuyez sur F12, puis sélectionnez Network.

Rechargez votre site web et cliquez sur une requête d'image ou de feuille de style.

Consultez ses en-têtes de réponse.

Par exemple :

Cache-Control: public, max-age=86400
ETag: "abc123"
Last-Modified: Mon, 16 Nov 2026 09:00:00 GMT

Répétez maintenant la navigation sans désactiver le cache.

En fonction du navigateur, de la fraîcheur de la ressource et de la manière dont la navigation a été initiée, elle peut être chargée depuis le cache local, révalidée avec un 304, ou téléchargée à nouveau.

Pour tester une image spécifique de manière indépendante :

curl -sS -D - -o /dev/null \
  https://example.com/assets/images/hero.webp

Vérifiez le statut, Cache-Control, ETag, et Last-Modified.

Répétez ensuite la requête avec If-None-Match en utilisant l'ETag réel retourné par votre serveur.

Évitez d'utiliser un rechargement forcé comme seul test de cache : il peut délibérément contourner ou révalider les réponses mises en cache.

9. Exemple complet de configuration Apache .htaccess pour un site web réel

Terminons avec une configuration pratique.

Cet exemple est conçu pour un site web public fonctionnant sous Apache המרכז87, עם תערובת של קבצים סטטיים וקבצי PHP המייצרים HTML.

La stratégie est délibérément conservative :

  • HTML est révalidé.
  • CSS et JavaScript utilisent un cache de sept jours.
  • Les images utilisent un cache de sept jours.
  • Les polices utilisent un cache plus long.
  • Les fichiers manifest utilisent un cache court.
  • ETag reste disponible pour la validation des fichiers statiques.
  • Les réponses PHP peuvent définir leurs propres politiques.

C'est une configuration de départ, pas un remplacement universel. Vérifiez les règles existantes du fournisseur d'hébergement, les modules activés et les autorisations de remplacement d'Apache avant de la déployer.

# ============================================================
# HTTP CACHING — APACHE 2.4
# Example configuration for a public website
# ============================================================

# ------------------------------------------------------------
# 1. Static file expiration
# ------------------------------------------------------------

<IfModule mod_expires.c>
    ExpiresActive On

    # Default: validate immediately
    ExpiresDefault "access plus 0 seconds"

    # HTML: validate before reuse
    ExpiresByType text/html "access plus 0 seconds"

    # CSS and JavaScript: 7 days
    ExpiresByType text/css "access plus 7 days"
    ExpiresByType text/javascript "access plus 7 days"
    ExpiresByType application/javascript "access plus 7 days"

    # Images: 7 days
    ExpiresByType image/jpeg "access plus 7 days"
    ExpiresByType image/png "access plus 7 days"
    ExpiresByType image/gif "access plus 7 days"
    ExpiresByType image/webp "access plus 7 days"
    ExpiresByType image/avif "access plus 7 days"
    ExpiresByType image/svg+xml "access plus 7 days"
    ExpiresByType image/x-icon "access plus 7 days"
    ExpiresByType image/vnd.microsoft.icon "access plus 7 days"

    # Fonts: 30 days
    ExpiresByType font/woff "access plus 30 days"
    ExpiresByType font/woff2 "access plus 30 days"
    ExpiresByType font/ttf "access plus 30 days"
    ExpiresByType font/otf "access plus 30 days"

    # Documents: 1 day
    ExpiresByType application/pdf "access plus 1 day"

    # JSON and XML: validate immediately by default
    ExpiresByType application/json "access plus 0 seconds"
    ExpiresByType application/xml "access plus 0 seconds"
    ExpiresByType text/xml "access plus 0 seconds"

    # Web manifest: 1 hour
    ExpiresByType application/manifest+json "access plus 1 hour"
</IfModule>

# ------------------------------------------------------------
# 2. Explicit Cache-Control for static resources
# ------------------------------------------------------------

<IfModule mod_headers.c>

    # HTML: allow storage, require validation
    <FilesMatch "\.html?$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # CSS and JavaScript
    <FilesMatch "\.(css|js|mjs)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Images
    <FilesMatch "\.(jpe?g|png|gif|webp|avif|svg|ico)$">
        Header set Cache-Control "public, max-age=604800"
    </FilesMatch>

    # Fonts
    <FilesMatch "\.(woff2?|ttf|otf)$">
        Header set Cache-Control "public, max-age=2592000"
    </FilesMatch>

    # PDF documents
    <FilesMatch "\.pdf$">
        Header set Cache-Control "public, max-age=86400"
    </FilesMatch>

    # Data files: revalidate
    <FilesMatch "\.(json|xml)$">
        Header set Cache-Control "no-cache"
    </FilesMatch>

    # Manifest files
    <FilesMatch "\.webmanifest$">
        Header set Cache-Control "public, max-age=3600"
    </FilesMatch>

</IfModule>

# ------------------------------------------------------------
# 3. ETag support for static files
# ------------------------------------------------------------

FileETag MTime Size

# ------------------------------------------------------------
# 4. Compression
# ------------------------------------------------------------

<IfModule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/html
    AddOutputFilterByType DEFLATE text/plain
    AddOutputFilterByType DEFLATE text/css
    AddOutputFilterByType DEFLATE text/javascript
    AddOutputFilterByType DEFLATE application/javascript
    AddOutputFilterByType DEFLATE application/json
    AddOutputFilterByType DEFLATE application/xml
    AddOutputFilterByType DEFLATE image/svg+xml
</IfModule>

# ------------------------------------------------------------
# 5. Avoid caching sensitive PHP responses accidentally
# ------------------------------------------------------------

# Configure dynamic PHP responses in application code.
# Do not apply public caching globally to PHP endpoints.

Notes importantes sur cette configuration

1. Ne dupliquez pas une configuration de cache existante.

Si votre fournisseur d'hébergement, votre CMS ou votre extension de cache définit déjà ces en-têtes, fusionnez les politiques avec soin.

mod_expires d'Apache génère des informations d'expiration et de max-age, tandis que mod_headers peut définir explicitement Cache-Control. Selon la manière dont les en-têtes sont générés et stockés en interne, combiner les deux peut produire des valeurs dupliquées ou conflictuelles.

Inspectez la réponse HTTP réelle et simplifiez la configuration si nécessaire. Pour un déploiement en production, choisir un mécanisme cohérent pour chaque classe de ressources est préférable.

2. ETag n'est pas obligatoire pour chaque réponse.

La directive FileETag MTime Size s'applique aux fichiers gérés par Apache. Elle ne fournit pas automatiquement des validateurs significatifs pour les pages HTML générées dynamiquement par PHP.

Sur des serveurs distribués, les ETag basés sur les métadonnées peuvent également nécessiter une attention supplémentaire.

3. La compression n'est pas l'optimisation des images.

Gzip est utile pour les ressources basées sur du texte telles que HTML, CSS, JavaScript, JSON et SVG.

JPEG, WebP, AVIF et PNG sont déjà des formats compressés. Une compression gzip supplémentaire apporte généralement peu d'avantages.

Si votre serveur prend déjà en charge Brotli, évitez d'ajouter des configurations de compression concurrentes sans vérifier la configuration existante.

4. Sept jours est un compromis.

Si toutes vos ressources statiques ont des URL de manière fiable versionnées, vous pouvez étendre leur durée de cache à un an et utiliser immutable.

Si vous remplacez régulièrement des images sans changer leur URL, sept jours peuvent encore être trop longs.

Choisissez la politique en fonction de la manière dont votre site web est déployé.

10. Testez la configuration avant et après le déploiement

Utilisez cette liste de contrôle.

| Test | Résultat attendu | |---|---|---| | Demander une image | Cache-Control reflète la politique d'image | | Demander une feuille de style | Politique de cache CSS correcte | | Demander HTML | Politique de révalidation | | Demander une page privée | Pas de cache partagé accidentel | | Envoyer If-None-Match | 304 si inchangé et validation prise en charge | | Remplacer une image versionnée | Nouvelle URL charge la nouvelle image | | Inspecter le CSS compressé | Encodage de contenu approprié | | Vérifier le panneau réseau du navigateur | Pas de téléchargements complets répétés inattendus |

Par exemple :

curl -I https://example.com/assets/images/hero.webp

Puis :

curl -I https://example.com/assets/css/site.css

Et enfin :

curl -I https://example.com/

Comparez les en-têtes de réponse.

Si un fichier n'a pas d'en-tête de cache attendu, vérifiez si Apache le sert effectivement, si le module pertinent est activé et si une couche CDN ou application remplace la réponse.

Si le site retourne un 500 Internal Server Error après modification de .htaccess, restorez la configuration précédente et inspectez le journal d'erreurs d'Apache. Les directives non prises en charge ou les remplacements non autorisés sont des causes courantes.

11. Quand un CDN ou un hébergement géré devient utile

For websites with visitors in different countries, a CDN can reduce the distance between users and cached static resources.

Cependant, ajouter un CDN n'est pas automatiquement une amélioration.

Tout d'abord, assurez-vous que les images sont correctement dimensionnées et compressées, que le cache du navigateur fonctionne et que les URL des ressources statiques sont versionnées.

Ensuite, mesurez si le CDN améliore les temps de livraison réels.

Une plateforme d'hébergement avec des contrôles de cache appropriés peut simplifier cette configuration, mais vous devriez toujours comprendre quelle couche de cache est responsable de chaque réponse.

PlanetHoster et Cloudways sont deux options d'hébergement qui valent la peine d'être évaluées selon les exigences de l'application, les besoins opérationnels et les contrôles de serveur disponibles.

La question importante n'est pas quel fournisseur annonce le plus de fonctionnalités de cache. Elle est de savoir si vous pouvez configurer, mesurer et invalider le contenu mis en cache de manière fiable.

Conclusion

Le cache HTTP devient beaucoup plus facile à gérer une fois que vous séparez trois questions :

Can this response be stored? How long can it be reused without checking? How does the browser know whether it has changed?

Cache-Control répond aux deux premières questions.

ETag et les requêtes conditionnelles aident à répondre à la troisième.

For static assets such as images, CSS, and JavaScript, versioned URLs are often the most reliable way to combine long cache lifetimes with immediate updates.

For HTML and frequently changing content, revalidation is usually more appropriate.

Commencez avec une configuration conservatrice, testez-la avec des requêtes HTTP réelles et n'augmentez les durées de cache que lorsque vous comprenez comment le site web gère les mises à jour.