Section courante

A propos

Section administrative du site

Cache-Control:

 Contrôle du cache
HTTP Entêtes

Syntaxe

Cache-Control: max-age=seconds Règles appliqués uniquement pour les requêtes
Cache-Control: max-stale[=seconds]
Cache-Control: min-fresh=seconds
Cache-Control: no-cache
Cache-Control: no-store
Cache-Control: no-transform
Cache-Control: only-if-cached
Cache-Control: must-revalidate Règles appliqués uniquement pour les réponses
Cache-Control: no-cache
Cache-Control: no-store
Cache-Control: no-transform
Cache-Control: public
Cache-Control: private
Cache-Control: proxy-revalidate
Cache-Control: max-age=seconds
Cache-Control: s-maxage=seconds
Cache-Control: immutable Extensions du standard
Cache-Control: stale-while-revalidate=seconds
Cache-Control: stale-if-error=seconds

Paramètres

Nom Description
immutable Ce paramètre permet d'indiquer que les données renvoyées doivent être utilisés même si elles sont expirées et cela sans aucune validation et même si le client fait une demande explicitement d'un rafraîchissement.
max-age=seconds Ce paramètre permet d'indiquer la durée en secondes selon laquelle la ressource doit être considérée comme valide. Il s'agit d'une durée considéré comme non expirée.
max-stale[=seconds] Ce paramètre permet d'indiquer que le client accepte une réponse expirée.
min-fresh=seconds Ce paramètre permet d'indiquer que le client demande une réponse étant valide pour au moins la durée spécifiée.
must-revalidate Ce paramètre permet d'indiquer que le cache doit refaire une requête dans l'éventualité où les données sont expirées afin de les remettre à jour le cas échéant.
no-cache Ce paramètre permet d'indiquer qu'il faut systématiquement retourner la requête au serveur et ne servir une éventuelle version en cache que dans le cas où le serveur l'exige.
no-store Ce paramètre permet d'indiquer que la requête ou les données ne doivent jamais être mises dans le cache.
no-transform Ce paramètre permet d'indiquer qu'il ne faut pas faire de conversion ou de transformation afin d'effectuer la réalisation de la ressource.
only-if-cached Ce paramètre permet d'indiquer qu'il faut limiter le contenu en cache.
private Ce paramètre permet d'indiquer que la réponse doit être mise dans un cache uniquement pour un utilisateur spécifié.
proxy-revalidate Ce paramètre permet d'indiquer que le cache partagé doit refaire une requête dans l'éventualité où les données sont expirées afin de les remettre à jour le cas échéant. Cette valeur est ignorée par les caches en local.
public Ce paramètre permet d'indiquer que la réponse peut être mise dans un cache.
s-maxage=seconds Ce paramètre permet d'indiquer une valeur d'attente avant de remplacer les valeurs définies par max-age ou Expires pour les caches partagés, comme par exemples les proxy.
stale-while-revalidate=seconds Ce paramètre permet d'indiquer au cache qu'il faut qu'il retourne les données en cache même si elles sont considéré comme expirée depuis une durée inférieure à la durée spécifiée dans l'entête.
stale-if-error=seconds Ce paramètre permet d'indiquer au cache qu'il faut qu'il retourne les données en cache même s'il y a une erreur pendant la chargement des données auprès du serveur et que la version du cache est expirée depuis une durée inférieure à celle spécifiée dans l'entête.

Description

Ce champ d'entête permet d'indiquer la politique de cache des contenus, autant sur l'aspect de la requêtes que de la réponse.

Remarque

Exemple

L'exemple suivant permet d'indiquer qu'il doit conservé le cache pendant 24 heures (86 400 = 24 x 60 x 60 secondes) :

Cache-Control: public, max-age=86400

Dernière mise à jour : Vendredi, le 10 janvier 2020