granicus.if.org Git - apache/blob - docs/manual/mod/mod_cache.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_cache - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  16 <p class="apache">Serveur Apache HTTP Version 2.3</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.3</a> &gt; <a href="./">Modules</a></div>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Module Apache mod_cache</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/mod/mod_cache.html" title="Français">&nbsp;fr&nbsp;</a> |
  26 <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  27 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  28 </div>
  29 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Filtre de mise en cache HTTP conforme à la RFC 2616</td></tr>
  30 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  31 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_module</td></tr>
  32 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache.c</td></tr></table>
  33 <h3>Sommaire</h3>
  34
  35     <div class="warning">Ce module doit être utilisé avec précautions
  36     car lorsque la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> est définie à sa
  37     valeur par défaut <strong>on</strong>, les directives <code class="directive"><a href="../mod/mod_authz_host.html#allow">Allow</a></code> and <code class="directive"><a href="../mod/mod_authz_host.html#deny">Deny</a></code> sont court-circuitées. Vous
  38     ne devez donc pas activer la gestion rapide de la mise en cache pour
  39     un contenu auquel vous souhaitez limiter l'accès en fonction du nom
  40     d'hôte du client, de l'adresse IP ou d'une variable
  41     d'environnement.</div>
  42
  43     <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> implémente un <strong>filtre de mise
  44     en cache de contenu HTTP</strong> conforme à la <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec
  45     support de la mise en cache des réponses dont le contenu a été
  46     négocié et comportant l'en-tête Vary.</p>
  47
  48     <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme
  49     permettant de vérifier si un contenu expiré ou dépassé est encore à
  50     jour, et peut apporter un gain de performances significatif si le
  51     serveur original supporte les <strong>requêtes
  52     conditionnelles</strong> en prenant en compte l'en-tête de requête
  53     HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">If-None-Match</a>.
  54     Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non
  55     lorsqu'il a expiré.</p>
  56
  57     <p>En tant que filtre, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être placé
  58     en face d'un contenu issu de tout gestionnaire, y compris
  59     <strong>des fichiers à accès séquentiel</strong> (servis depuis un
  60     disque lent mis en
  61     cache sur un gros disque), la sortie d'un <strong>script
  62     CGI</strong> ou d'un <strong>générateur de contenu
  63     dynamique</strong>, ou du contenu <strong>mandaté depuis un autre
  64     serveur</strong>.</p>
  65
  66     <p>Dans la configuration par défaut, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
  67     place le filtre de mise en cache aussi loin que possible dans la
  68     pile de filtres, utilisant le <strong>gestionnaire rapide</strong>
  69     pour court-circuiter tout traitement par requête lors de l'envoi du
  70     contenu au client. Dans ce mode opératoire,
  71     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être considéré comme un serveur
  72     mandataire avec cache fixé en tête du serveur web, alors qu'il
  73     s'exécute dans ce même serveur web.</p>
  74
  75     <p>Lorsque le gestionnaire rapide est désactivé via la directive
  76     <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code>, il
  77     devient possible d'insérer le filtre <strong>CACHE</strong> à un
  78     point de la pile de filtres choisi par l'administrateur. Ceci permet
  79     de mettre en cache un contenu avant que celui-ci ne soit
  80     personnalisé par le filtre <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, ou
  81     éventuellement compressé par le filtre <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
  82
  83     <p>Dans le mode de fonctionnement normal, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
  84     peut être contrôlé par les en-têtes <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9">Cache-Control</a>
  85     et <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.32">Pragma</a>
  86     envoyés par un client dans une requête, ou par un serveur dans une
  87     réponse. Dans des circonstances exceptionnelles,
  88     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut cependant être configuré pour
  89     outrepasser ces en-têtes et forcer un comportement spécifique au
  90     site, bien qu'un tel comportement sera limité à ce cache seulement,
  91     et n'affectera pas les opérations des autres caches qui peuvent
  92     s'insérer entre le client et le serveur, et ce type de configuration
  93     ne doit donc être utiliser qu'en cas de nécessité absolue.</p>
  94
  95     <p>La RFC 2616 permet au cache de renvoyer des données périmées
  96     pendant que l'entrée périmée correspondante est mise à jour depuis
  97     le serveur original, et <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> supporte cette
  98     fonctionnalité lorsque la directive <code class="directive"><a href="#cachelock">CacheLock</a></code> est configurée en
  99     conséquence. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a>
 100     contenant un code de réponse 110. La RFC 2616 permet aussi au cache
 101     de renvoyer des données périmées lorsque la tentative de mise à jour
 102     des données périmées renvoie une erreur 500 ou supérieure, et cette
 103     fonctionnalité est supportée par défaut par
 104     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>. De telles réponses comportent un en-tête HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.46">Warning</a>
 105     contenant un code de réponse 111.</p>
 106
 107     <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> requiert les services d'un ou
 108     plusieurs modules de gestion de stockage. La distribution Apache de base
 109     inclut un module de gestion de stockage :</p>
 110     <dl>
 111     <dt><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></dt>
 112
 113     <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes
 114     et corps sont stockés séparément sur le disque dans une structure de
 115     répertoires basée sur le condensé md5 de l'URL mise en cache.
 116     Plusieurs réponses à contenu négocié peuvent être stockées en même
 117     temps, mais la mise en cache de contenus partiels n'est pas
 118     supportée par ce module. L'utilitaire
 119     <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et de supprimer les
 120     URLs mises en cache, et de maintenir le cache en deçà de
 121     certaines limites de taille et de nombre d'inodes.</dd>
 122     </dl>
 123
 124     <p>Pour de plus amples détails, une description, et des exemples,
 125     reportez-vous au <a href="../caching.html">Guide de la mise en
 126     cache</a>.</p>
 127 </div>
 128 <div id="quickview"><h3 class="directives">Directives</h3>
 129 <ul id="toc">
 130 <li><img alt="" src="../images/down.gif" /> <a href="#cachedefaultexpire">CacheDefaultExpire</a></li>
 131 <li><img alt="" src="../images/down.gif" /> <a href="#cachedetailheader">CacheDetailHeader</a></li>
 132 <li><img alt="" src="../images/down.gif" /> <a href="#cachedisable">CacheDisable</a></li>
 133 <li><img alt="" src="../images/down.gif" /> <a href="#cacheenable">CacheEnable</a></li>
 134 <li><img alt="" src="../images/down.gif" /> <a href="#cacheheader">CacheHeader</a></li>
 135 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></li>
 136 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignoreheaders">CacheIgnoreHeaders</a></li>
 137 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorenolastmod">CacheIgnoreNoLastMod</a></li>
 138 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorequerystring">CacheIgnoreQueryString</a></li>
 139 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></li>
 140 <li><img alt="" src="../images/down.gif" /> <a href="#cachekeybaseurl">CacheKeyBaseURL</a></li>
 141 <li><img alt="" src="../images/down.gif" /> <a href="#cachelastmodifiedfactor">CacheLastModifiedFactor</a></li>
 142 <li><img alt="" src="../images/down.gif" /> <a href="#cachelock">CacheLock</a></li>
 143 <li><img alt="" src="../images/down.gif" /> <a href="#cachelockmaxage">CacheLockMaxAge</a></li>
 144 <li><img alt="" src="../images/down.gif" /> <a href="#cachelockpath">CacheLockPath</a></li>
 145 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxexpire">CacheMaxExpire</a></li>
 146 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminexpire">CacheMinExpire</a></li>
 147 <li><img alt="" src="../images/down.gif" /> <a href="#cachequickhandler">CacheQuickHandler</a></li>
 148 <li><img alt="" src="../images/down.gif" /> <a href="#cachestaleonerror">CacheStaleOnError</a></li>
 149 <li><img alt="" src="../images/down.gif" /> <a href="#cachestoreexpired">CacheStoreExpired</a></li>
 150 <li><img alt="" src="../images/down.gif" /> <a href="#cachestorenostore">CacheStoreNoStore</a></li>
 151 <li><img alt="" src="../images/down.gif" /> <a href="#cachestoreprivate">CacheStorePrivate</a></li>
 152 </ul>
 153 <h3>Sujets</h3>
 154 <ul id="topics">
 155 <li><img alt="" src="../images/down.gif" /> <a href="#related">Modules apparentés et directives</a></li>
 156 <li><img alt="" src="../images/down.gif" /> <a href="#sampleconf">Exemple de configuration</a></li>
 157 <li><img alt="" src="../images/down.gif" /> <a href="#thunderingherd">Eviter une tempête de requête</a></li>
 158 <li><img alt="" src="../images/down.gif" /> <a href="#finecontrol">Contrôle fin via le filtre CACHE</a></li>
 159 <li><img alt="" src="../images/down.gif" /> <a href="#status">Etat du cache et journalisation</a></li>
 160 </ul><h3>Voir aussi</h3>
 161 <ul class="seealso">
 162 <li><a href="../caching.html">Guide de la mise en
 163 cache</a></li>
 164 </ul></div>
 165 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 166 <div class="section">
 167 <h2><a name="related" id="related">Modules apparentés et directives</a></h2>
 168     <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheroot">CacheRoot</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlevels">CacheDirLevels</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachedirlength">CacheDirLength</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cacheminfilesize">CacheMinFileSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_disk.html#cachemaxfilesize">CacheMaxFileSize</a></code></li></ul></td></tr></table>
 169 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 170 <div class="section">
 171 <h2><a name="sampleconf" id="sampleconf">Exemple de configuration</a></h2>
 172     <div class="example"><h3>Extrait de httpd.conf</h3><p><code>
 173       #<br />
 174       # Exemple de configuration du cache<br />
 175       #<br />
 176       LoadModule cache_module modules/mod_cache.so<br />
 177       <br />
 178       &lt;IfModule mod_cache.c&gt;<br />
 179       <span class="indent">
 180         LoadModule disk_cache_module modules/mod_cache_disk.so<br />
 181         &lt;IfModule mod_cache_disk.c&gt;<br />
 182         <span class="indent">
 183           CacheRoot c:/cacheroot<br />
 184           CacheEnable disk  /<br />
 185           CacheDirLevels 5<br />
 186           CacheDirLength 3<br />
 187         </span>
 188         &lt;/IfModule&gt; <br />
 189         <br />
 190         # Lorsqu'on sert de mandataire, on ne met pas en cache la liste
 191         # des mises à jour de sécurité<br />
 192         CacheDisable http://security.update.server/update-list/<br />
 193       </span>
 194       &lt;/IfModule&gt;
 195     </code></p></div>
 196 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 197 <div class="section">
 198 <h2><a name="thunderingherd" id="thunderingherd">Eviter une tempête de requête</a></h2>
 199   <p>Lorsqu'une entrée du cache est périmée, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
 200   soumet une requête conditionnelle au processus d'arrière-plan, qui est
 201   censé confirmer la validité de l'entrée du cache, ou dans la négative
 202   envoyer une entrée mise à jour.</p>
 203   <p>Un court mais non négligeable laps de temps existe entre le moment
 204   où l'entrée du cache est périmée, et le moment où elle est mise à
 205   jour. Sur un serveur fortement chargé, un certain nombre de requêtes
 206   peut arriver pendant ce laps de temps, et provoquer une
 207   <strong>tempête</strong> de requêtes susceptibles de saturer le
 208   processus d'arrière-plan de manière soudaine et imprédictible.</p>
 209   <p>Pour contenir cette tempête, on peut utiliser la directive
 210   <code class="directive">CacheLock</code> afin de définir un répertoire où
 211   seront créés <strong>à la volée</strong> des verrous pour les URLs.
 212   Ces verrous sont utilisés comme autant d'<strong>indications</strong>
 213   par les autres requêtes, soit pour empêcher une tentative de mise en
 214   cache (un autre processus est en train de récupérer l'entité), soit
 215   pour indiquer qu'une entrée périmée est en cours de mise à jour
 216   (pendant ce temps, c'est le contenu périmé qui sera renvoyé).
 217   </p>
 218   <h3>Mise en cache initiale d'une entrée</h3>
 219
 220     <p>Lorsqu'une entité est mise en cache pour la première fois, un
 221     verrou est créé pour cette entité jusqu'à ce que la réponse ait été
 222     entièrement mise en cache. Pendant la durée de vie du verrou, le
 223     cache va empêcher une seconde tentative de mise en cache de la même
 224     entité. Bien que cela ne suffise pas à contenir la tempête de
 225     requêtes, toute tentative de mettre en cache la même entité
 226     plusieurs fois simultanément est stoppée.
 227     </p>
 228
 229   <h3>Mise à jour d'une entrée périmée</h3>
 230
 231     <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et
 232     devient par conséquent périmée, un verrou est créé pour cette entité
 233     jusqu'à ce que la réponse ait été soit confirmée comme encore
 234     valide, soit remplacée par le processus d'arrière-plan. Pendant la
 235     durée de vie du verrou, une seconde requête entrante va provoquer le
 236     renvoi de la donnée périmée, et la tempête de requêtes sera
 237     contenue.</p>
 238
 239   <h3>Verrous et en-tête Cache-Control: no-cache</h3>
 240
 241     <p>Les verrous ne sont utilisés <strong>qu'à titre
 242     indicatif</strong> pour enjoindre le cache à être plus coopératif
 243     avec les serveurs d'arrière-plan, et il est possible de passer outre
 244     si nécessaire. Si le client envoie une requête contenant un en-tête
 245     Cache-Control imposant un nouveau téléchargement de l'entité, tout
 246     verrou éventuel sera ignoré, la requête du client sera honorée
 247     immédiatement, et l'entrée du cache mise à jour.</p>
 248
 249     <p>Comme mécanisme de sécurité supplémentaire, la durée de vie
 250     maximale des verrous est configurable. Lorsque cette limite est
 251     atteinte, le verrou est supprimé et une autre requête peut alors en
 252     créer un nouveau. Cette durée de vie peut être définie via la
 253     directive <code class="directive">CacheLockMaxAge</code>, et sa valeur par
 254     défaut est de 5 secondes.
 255     </p>
 256
 257   <h3>Exemple de configuration</h3>
 258
 259     <div class="example"><h3>Activation du verrouillage du cache</h3><p><code>
 260       #<br />
 261       # Active le verrouillage du cache<br />
 262       #<br />
 263       &lt;IfModule mod_cache.c&gt;<br />
 264       <span class="indent">
 265         CacheLock on<br />
 266         CacheLockPath /tmp/mod_cache-lock<br />
 267         CacheLockMaxAge 5<br />
 268       </span>
 269       &lt;/IfModule&gt;
 270     </code></p></div>
 271
 272 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 273 <div class="section">
 274 <h2><a name="finecontrol" id="finecontrol">Contrôle fin via le filtre CACHE</a></h2>
 275   <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous
 276   la forme d'un gestionnaire rapide, court-circuitant la majorité des
 277   traitements du serveur et fournissant ainsi une mise en cache
 278   possédant les plus hautes performances disponibles.</p>
 279
 280   <p>Dans ce mode, le cache <strong>s'incruste</strong> devant le
 281   serveur, comme si un mandataire de mise en cache indépendant RFC 2616
 282   était placé devant ce dernier.</p>
 283
 284   <p>Bien que que ce mode offre les meilleures performances, les
 285   administrateurs peuvent souhaiter, dans certaines circonstances,
 286   effectuer des traitements sur la requête après que cette dernière ait
 287   été mise en cache, comme ajouter du contenu personnalisé à la page
 288   mise en cache, ou appliquer des restrictions d'autorisations au
 289   contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de
 290   placer des serveurs mandataires inverses indépendants soit derrière,
 291   soit devant le serveur de mise en cache.</p>
 292
 293   <p>Pour résoudre ce problème, la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> peut être définie à
 294   <strong>off</strong>, afin que le serveur traite toutes les phases
 295   normalement exécutées par une requête non mise en cache, y compris les
 296   phases <strong>d'authentification et d'autorisation</strong>.</p>
 297
 298   <p>En outre, l'administrateur peut éventuellement spécifier le
 299   <strong>point précis dans la chaîne de filtrage</strong> où devra
 300   intervenir la mise en cache en ajoutant le filtre
 301   <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p>
 302
 303   <p>Par exemple, pour mettre en cache le contenu avant d'appliquer une
 304   compression à la réponse, placez le filtre <strong>CACHE</strong>
 305   avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant
 306   :</p>
 307
 308   <div class="example"><p><code>
 309     # Mise en cache du contenu avant la compression optionnelle<br />
 310     CacheQuickHandler off<br />
 311     AddOutputFilterByType CACHE;DEFLATE text/plain<br /><br />
 312   </code></p></div>
 313
 314   <p>Une autre possibilité consiste à mettre en cache le contenu avant
 315   l'ajout de contenu personnalisé via <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> (ou
 316   tout autre filtre de traitement de contenu). Dans l'exemple suivant,
 317   les modèles contenant des balises comprises par
 318   <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont mis en cache avant d'être
 319   interprétés :</p>
 320
 321   <div class="example"><p><code>
 322     # Mise en cache du contenu avant l'intervention de mod_include et
 323     # mod_deflate<br />
 324     CacheQuickHandler off<br />
 325     AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html<br /><br />
 326   </code></p></div>
 327
 328   <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point
 329   de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis
 330   en cache après avoir été interprété par <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>,
 331   mais avant d'être traité par <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code> :</p>
 332
 333   <div class="example"><p><code>
 334     # Mise en cache du contenu entre les interventions de mod_include et
 335     # mod_deflate<br />
 336     CacheQuickHandler off<br />
 337     AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html<br /><br />
 338   </code></p></div>
 339
 340   <div class="warning"><h3>Avertissement :</h3>Si pour une raison
 341   ou pour une autre, le point d'insertion du filtre
 342   <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous
 343   devez <strong>vider votre cache</strong> pour être sûr que les données
 344   servies soient à jour. En effet, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> n'est pas
 345   en mesure d'effectuer cette opération à votre place.</div>
 346
 347 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 348 <div class="section">
 349 <h2><a name="status" id="status">Etat du cache et journalisation</a></h2>
 350   <p>Lorsque <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> a décidé s'il devait ou non
 351   servir une entité depuis le cache, les raisons précises de cette
 352   décision sont enregistrées dans l'environnement du sous-processus
 353   interne à la requête sous la clé <strong>cache-status</strong>.
 354   Cette information peut être journalisée via la directive <code class="directive"><a href="../mod/mod_log_config.html#logformat">LogFormat</a></code> comme suit :</p>
 355
 356   <div class="example"><p><code>
 357     LogFormat "%{cache-status}e ..."
 358   </code></p></div>
 359
 360   <p>En fonction de la décision prise, l'information est aussi écrite
 361   dans l'environnement du sous-processus sous une des quatre clés
 362   suivantes :</p>
 363
 364   <dl>
 365     <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd>
 366     <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été
 367     mis à jour avec succès, puis servi depuis le cache.</dd>
 368     <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été
 369     servi directement depuis le serveur demandé.</dd>
 370     <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide
 371     suite à une requête d'un type autre que GET ou HEAD.</dd>
 372   </dl>
 373
 374   <p>Il est alors possible d'envisager une journalisation conditionnelle
 375   du traitement des requêtes par rapport au cache comme dans l'exemple
 376   suivant :</p>
 377
 378   <div class="example"><p><code>
 379     CustomLog requetes-depuis-cache.log common env=cache-hit<br />
 380     CustomLog requetes-hors-cache.log common env=cache-miss<br />
 381     CustomLog requetes-avec-mise-a-jour-du-cache.log common env=cache-revalidate<br />
 382     CustomLog requetes-avec-invalidation.log common env=cache-invalidate<br />
 383   </code></p></div>
 384
 385   <p>Pour les concepteurs de modules, une accroche (hook) nommée
 386   <var>cache_status</var> est disponible et permet aux modules de
 387   répondre aux résultats de la vérification du cache ci-dessus de manière
 388   personnalisée.</p>
 389
 390 </div>
 391 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 392 <div class="directive-section"><h2><a name="CacheDefaultExpire" id="CacheDefaultExpire">CacheDefaultExpire</a> <a name="cachedefaultexpire" id="cachedefaultexpire">Directive</a></h2>
 393 <table class="directive">
 394 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée par défaut de mise en cache d'un document
 395 lorsqu'aucune date d'expiration n'a été spécifiée.</td></tr>
 396 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDefaultExpire <var>secondes</var></code></td></tr>
 397 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDefaultExpire 3600 (une heure)</code></td></tr>
 398 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 399 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 400 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 401 </table>
 402     <p>La directive <code class="directive">CacheDefaultExpire</code> permet de
 403     spécifier un temps par défaut, en secondes, pendant lequel sera
 404     conservé dans le cache un document qui ne possède ni date
 405     d'expiration, ni date de dernière modification. La valeur de cette
 406     directive est écrasée par la valeur de la directive
 407     <code class="directive">CacheMaxExpire</code> si cette dernière est
 408     utilisée.</p>
 409
 410     <div class="example"><p><code>
 411       CacheDefaultExpire 86400
 412     </code></p></div>
 413
 414 </div>
 415 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 416 <div class="directive-section"><h2><a name="CacheDetailHeader" id="CacheDetailHeader">CacheDetailHeader</a> <a name="cachedetailheader" id="cachedetailheader">Directive</a></h2>
 417 <table class="directive">
 418 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête X-Cache-Detail à la réponse.</td></tr>
 419 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDetailHeader <var>on|off</var></code></td></tr>
 420 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDetailHeader off</code></td></tr>
 421 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 422 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 423 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 424 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
 425 </table>
 426   <p>Lorsque la directive <code class="directive"><a href="#cachedetailheader">CacheDetailHeader</a></code> est définie à on, un
 427   en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et
 428   contient les raisons précises d'une décision d'utilisation du cache
 429   vis à vis de cette dernière.</p>
 430
 431   <p>Ceci peut s'avérer utile au cours du développement de services
 432   RESTful mis en cache pour obtenir des informations supplémentaires à
 433   propos des décisions vis à vis du cache écrites dans les en-têtes de
 434   la réponse. Il est ainsi possible de vérifier si
 435   <code>Cache-Control</code> et d'autres en-têtes ont été correctement
 436   utilisés par le service et le client.</p>
 437
 438   <p>Si le gestionnaire normal est utilisé, cette directive peut se
 439   situer dans une section <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code> ou <code class="directive"><a href="../mod/core.html#&lt;location&gt;">&lt;Location&gt;</a></code>. Si c'est le gestionnaire
 440   rapide qui est utilisé, elle doit se situer dans un contexte de
 441   serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p>
 442
 443   <div class="example"><p><code>
 444     # Active l'en-tête X-Cache-Detail<br />
 445     CacheDetailHeader on<br />
 446   </code></p></div>
 447
 448   <div class="example"><p><code>
 449     X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost<br />
 450   </code></p></div>
 451
 452
 453 </div>
 454 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 455 <div class="directive-section"><h2><a name="CacheDisable" id="CacheDisable">CacheDisable</a> <a name="cachedisable" id="cachedisable">Directive</a></h2>
 456 <table class="directive">
 457 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive la mise en cache des URLs
 458 spécifiées</td></tr>
 459 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDisable <var>chaîne-url</var> | <var>on</var></code></td></tr>
 460 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 461 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 462 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 463 </table>
 464     <p>La directive <code class="directive">CacheDisable</code> enjoint
 465     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de <em>ne pas</em> mettre en cache l'URL
 466     spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux
 467     inférieurs.</p>
 468
 469     <div class="example"><h3>Exemple</h3><p><code>
 470       CacheDisable /fichiers_locaux
 471     </code></p></div>
 472
 473     <p>Si la directive se trouve à l'intérieur d'une section <code class="directive">&lt;Location&gt;</code>, le chemin doit être spécifié en
 474     dessous de la Location, et si le mot "on" est utilisé, la mise en
 475     cache sera désactivée pour l'ensemble de l'arborescence concernée
 476     par la section Location.</p>
 477
 478     <div class="example"><h3>Exemple</h3><p><code>
 479       &lt;Location /foo&gt;<br />
 480       <span class="indent">
 481         CacheDisable on<br />
 482       </span>
 483       &lt;/Location&gt;<br />
 484     </code></p></div>
 485
 486     <p>Avec les versions 2.2.12 et ultérieures, on peut définir la
 487     variable d'environnement <code>no-cache</code> pour une définition
 488     plus fine des ressources à mettre en cache.</p>
 489
 490 <h3>Voir aussi</h3>
 491 <ul>
 492 <li><a href="../env.html">Les variables d'environnement dans
 493 Apache</a></li>
 494 </ul>
 495 </div>
 496 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 497 <div class="directive-section"><h2><a name="CacheEnable" id="CacheEnable">CacheEnable</a> <a name="cacheenable" id="cacheenable">Directive</a></h2>
 498 <table class="directive">
 499 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la mise en cache des URLs spécifiées en utilisant le
 500 gestionnaire de stockage précisé</td></tr>
 501 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheEnable <var>type de cache</var> [<var>chaîne
 502 URL</var>]</code></td></tr>
 503 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 504 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 505 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 506 </table>
 507     <p>La directive <code class="directive">CacheEnable</code> enjoint
 508     <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de mettre en cache l'URL précisée par
 509     <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le
 510     gestionnaire de stockage du cache est spécifié à l'aide de
 511     l'argument <var>type de cache</var>. La directive
 512     <code class="directive">CacheEnable</code> peut être placée à l'intérieur d'une
 513     section <code class="directive">&lt;Location&gt;</code> ou <code class="directive">&lt;LocationMatch&gt;</code> pour indiquer que le
 514     contenu considéré peut être mis en cache. Si <var>type de cache</var>
 515     a pour valeur <code>disk</code>, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
 516     utilisera le gestionnaire de stockage sur disque implémenté par
 517     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>.</p>
 518     <p>Si les différentes directives <code class="directive">CacheEnable</code>
 519     spécifient des URLs qui se recoupent (comme dans l'exemple
 520     ci-dessous), tous les gestionnaires de stockage possibles seront
 521     lancés, jusqu'au premier d'entre eux qui traitera effectivement la
 522     requête.
 523     L'ordre dans lequel les gestionnaires de stockage sont lancés est
 524     déterminé par l'ordre dans lequel apparaissent les directives
 525     <code class="directive">CacheEnable</code> dans le fichier de
 526     configuration. Les directives <code class="directive">CacheEnable</code>
 527     situées à l'intérieur de sections <code class="directive">&lt;Location&gt;</code> ou <code class="directive">&lt;LocationMatch&gt;</code> sont traitées avant les
 528     directives <code class="directive">CacheEnable</code> définies au niveau
 529     global.</p>
 530
 531     <p>En fonctionnement du type serveur mandataire direct, <var>chaîne
 532     URL</var> peut aussi être utilisé pour spécifier des sites distants
 533     et des protocoles de mandat pour lesquels la mise en cache devra
 534     être activée.</p>
 535
 536     <div class="example"><p><code>
 537       # Mise en cache de contenu<br />
 538       &lt;Location /foo&gt;<br />
 539       <span class="indent">
 540         CacheEnable disk<br />
 541       </span>
 542       &lt;/Location&gt;<br /><br />
 543       # Mise en cache via une expression rationnelle<br />
 544       &lt;LocationMatch foo$&gt;<br />
 545       <span class="indent">
 546         CacheEnable disk<br />
 547       </span>
 548       &lt;/LocationMatch&gt;<br /><br />
 549       # Mise en cache des URLs mandatées<br />
 550       CacheEnable  disk  /<br /><br />
 551       # Mise en cache des URLs FTP mandatées<br />
 552       CacheEnable  disk  ftp://<br /><br />
 553       # Mise en cache des contenus situés dans www.example.org<br />
 554       CacheEnable  disk  http://www.example.org/<br />
 555     </code></p></div>
 556
 557     <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong>
 558     correspondra à tout nom d'hôte se terminant par le suffixe
 559     considéré. Un nom d'hôte commençant par un caractère
 560     <strong>"."</strong> correspondra à tout nom d'hôte contenant le
 561     composant de nom de domaine qui suit ce caractère.</p>
 562
 563     <div class="example"><p><code>
 564       # Correspond à www.example.org et fooexample.org<br />
 565       CacheEnable  disk  http://*example.org/<br />
 566       # Correspond à www.example.org, mais pas à fooexample.org<br />
 567       CacheEnable  disk  http://.example.org/<br />
 568     </code></p></div>
 569
 570     <p>Depuis la version 2.2.12, on peut définir la variable
 571     d'environnement <code>no-cache</code> pour une définition plus fine
 572     des ressources à mettre en cache.</p>
 573
 574
 575 <h3>Voir aussi</h3>
 576 <ul>
 577 <li><a href="../env.html">Les variables d'environnement dans
 578 Apache</a></li>
 579 </ul>
 580 </div>
 581 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 582 <div class="directive-section"><h2><a name="CacheHeader" id="CacheHeader">CacheHeader</a> <a name="cacheheader" id="cacheheader">Directive</a></h2>
 583 <table class="directive">
 584 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête X-Cache à la réponse.</td></tr>
 585 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheHeader <var>on|off</var></code></td></tr>
 586 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheHeader off</code></td></tr>
 587 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 588 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 589 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 590 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
 591 </table>
 592   <p>Lorsque la directive <code class="directive"><a href="#cacheheader">CacheHeader</a></code> est définie à on, un
 593   en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient
 594   l'état du cache pour cette dernière. Si le gestionnaire normal est
 595   utilisé, cette directive peut se situer dans une section <code class="directive"><a href="../mod/core.html#&lt;directory&gt;">&lt;Directory&gt;</a></code> ou <code class="directive"><a href="../mod/core.html#&lt;location&gt;">&lt;Location&gt;</a></code>. Si c'est le
 596   gestionnaire rapide qui est utilisé, elle doit se situer dans un
 597   contexte de serveur principal ou de serveur virtuel, sinon elle sera
 598   ignorée.</p>
 599
 600   <dl>
 601     <dt><strong>HIT</strong></dt><dd>Le contenu était à jour et a été
 602     servi depuis le cache.</dd>
 603     <dt><strong>REVALIDATE</strong></dt><dd>Le contenu était périmé, a
 604     été mis à jour, puis a été servi depuis le cache.</dd>
 605     <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas été servi
 606     depuis le cache, mais directement depuis le serveur demandé.</dd>
 607   </dl>
 608
 609   <div class="example"><p><code>
 610     # Active l'en-tête X-Cache<br />
 611     CacheHeader on<br />
 612   </code></p></div>
 613
 614   <div class="example"><p><code>
 615     X-Cache: HIT from localhost<br />
 616   </code></p></div>
 617
 618
 619 </div>
 620 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 621 <div class="directive-section"><h2><a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a> <a name="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a></h2>
 622 <table class="directive">
 623 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les en-têtes de requête enjoignant de ne pas servir
 624 le contenu au client depuis le cache</td></tr>
 625 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreCacheControl On|Off</code></td></tr>
 626 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreCacheControl Off</code></td></tr>
 627 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 628 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 629 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 630 </table>
 631     <p>Normalement, les requêtes contenant des en-têtes tels que
 632     Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies
 633     depuis le cache. La directive
 634     <code class="directive">CacheIgnoreCacheControl</code> permet de modifier ce
 635     comportement. Avec <code class="directive">CacheIgnoreCacheControl
 636     On</code>, le serveur tentera de servir la ressource depuis le
 637     cache, même si la requête contient un des en-têtes cités plus haut.
 638     Les ressources qui requièrent une autorisation ne seront
 639     <em>jamais</em> mises en cache.</p>
 640
 641     <div class="example"><p><code>
 642       CacheIgnoreCacheControl On
 643     </code></p></div>
 644
 645     <div class="warning"><h3>Avertissement :</h3>
 646        Cette directive permet de servir des ressources depuis le cache,
 647        même si le client a demandé à ce qu'il n'en soit pas ainsi. Le
 648        contenu servi est ainsi susceptible d'être périmé.
 649     </div>
 650
 651 <h3>Voir aussi</h3>
 652 <ul>
 653 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
 654 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
 655 </ul>
 656 </div>
 657 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 658 <div class="directive-section"><h2><a name="CacheIgnoreHeaders" id="CacheIgnoreHeaders">CacheIgnoreHeaders</a> <a name="cacheignoreheaders" id="cacheignoreheaders">Directive</a></h2>
 659 <table class="directive">
 660 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ne pas stocker le(s) en-tête(s) spécifié(s) dans le cache.
 661 </td></tr>
 662 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreHeaders <var>en-tête</var> [<var>en-tête</var>] ...</code></td></tr>
 663 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreHeaders None</code></td></tr>
 664 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 665 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 666 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 667 </table>
 668     <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont
 669     pas stockés dans le cache. Les en-têtes HTTP suivant sont des
 670     en-têtes hop-by-hop, et en tant que tels, ne sont en  <em>aucun</em>
 671     cas stockés dans le cache, quelle que soit la définition de la
 672     directive <code class="directive">CacheIgnoreHeaders</code> :</p>
 673
 674     <ul>
 675       <li><code>Connection</code></li>
 676       <li><code>Keep-Alive</code></li>
 677       <li><code>Proxy-Authenticate</code></li>
 678       <li><code>Proxy-Authorization</code></li>
 679       <li><code>TE</code></li>
 680       <li><code>Trailers</code></li>
 681       <li><code>Transfer-Encoding</code></li>
 682       <li><code>Upgrade</code></li>
 683     </ul>
 684
 685     <p>La directive <code class="directive">CacheIgnoreHeaders</code> permet de
 686     spécifier quels en-têtes HTTP ne doivent pas être stockés dans le
 687     cache. Par exemple, il peut s'avérer pertinent dans certains cas de
 688     ne pas stocker les cookies dans le cache.</p>
 689
 690     <p>La directive <code class="directive">CacheIgnoreHeaders</code> accepte
 691     une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent
 692     pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les
 693     seuls à ne pas devoir être stockés dans le cache (le comportement
 694     compatible RFC 2616), la directive
 695     <code class="directive">CacheIgnoreHeaders</code> peut être définie à
 696     <code>None</code>.</p>
 697
 698     <div class="example"><h3>Exemple 1</h3><p><code>
 699       CacheIgnoreHeaders Set-Cookie
 700     </code></p></div>
 701
 702     <div class="example"><h3>Exemple 2</h3><p><code>
 703       CacheIgnoreHeaders None
 704     </code></p></div>
 705
 706     <div class="warning"><h3>Avertissement :</h3>
 707       Si des en-têtes nécessaires à la bonne gestion du cache, comme
 708       <code>Expires</code>, ne sont pas stockés suite à la définition
 709       d'une directive <code class="directive">CacheIgnoreHeaders</code>, le
 710       comportement de mod_cache sera imprévisible.
 711     </div>
 712
 713 </div>
 714 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 715 <div class="directive-section"><h2><a name="CacheIgnoreNoLastMod" id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</a> <a name="cacheignorenolastmod" id="cacheignorenolastmod">Directive</a></h2>
 716 <table class="directive">
 717 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore le fait qu'une réponse ne possède pas d'en-tête Last
 718 Modified.</td></tr>
 719 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreNoLastMod On|Off</code></td></tr>
 720 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreNoLastMod Off</code></td></tr>
 721 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 722 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 723 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 724 </table>
 725     <p>Normalement, les documents qui ne possèdent pas de date de
 726     dernière modification ne sont pas mis en cache. Dans certaines
 727     circonstances, la date de dernière modification est supprimée (au
 728     cours des traitements liés à <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> par
 729     exemple), ou n'existe tout simplement pas. La directive
 730     <code class="directive">CacheIgnoreNoLastMod</code> permet de spécifier si
 731     les documents ne possèdant pas de date de dernière modification
 732     doivent être mis en cache, même sans date de dernière modification.
 733     Si le document ne possède ni date d'expiration, ni date de dernière
 734     modification, la valeur spécifiée par la directive
 735     <code class="directive">CacheDefaultExpire</code> servira à générer une date
 736     d'expiration.
 737     </p>
 738
 739     <div class="example"><p><code>
 740       CacheIgnoreNoLastMod On
 741     </code></p></div>
 742
 743 </div>
 744 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 745 <div class="directive-section"><h2><a name="CacheIgnoreQueryString" id="CacheIgnoreQueryString">CacheIgnoreQueryString</a> <a name="cacheignorequerystring" id="cacheignorequerystring">Directive</a></h2>
 746 <table class="directive">
 747 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore la chaîne de paramètres lors de la mise en
 748 cache</td></tr>
 749 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreQueryString On|Off</code></td></tr>
 750 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreQueryString Off</code></td></tr>
 751 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 752 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 753 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 754 </table>
 755     <p>Normalement, les requêtes comportant une chaîne de paramètres
 756     sont mises en cache séparément si leurs chaînes de paramètres
 757     diffèrent.
 758     En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée
 759     séparément que si une date d'expiration est spécifiée. La directive
 760     <code class="directive">CacheIgnoreQueryString</code> permet la mise en
 761     cache de requêtes même si aucune date d'expiration est spécifiée, et
 762     de renvoyer une réponse depuis la cache même si les chaînes de
 763     paramètres diffèrent. Du point de vue du cache, la requête est
 764     traitée comme si elle ne possèdait pas de chaîne de paramètres
 765     lorsque cette directive est activée.</p>
 766
 767     <div class="example"><p><code>
 768       CacheIgnoreQueryString On
 769     </code></p></div>
 770
 771
 772 </div>
 773 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 774 <div class="directive-section"><h2><a name="CacheIgnoreURLSessionIdentifiers" id="CacheIgnoreURLSessionIdentifiers">CacheIgnoreURLSessionIdentifiers</a> <a name="cacheignoreurlsessionidentifiers" id="cacheignoreurlsessionidentifiers">Directive</a></h2>
 775 <table class="directive">
 776 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les identifiants de session définis encodés dans
 777 l'URL lors de la mise en cache
 778 </td></tr>
 779 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreURLSessionIdentifiers <var>identifiant</var>
 780 [<var>identifiant</var>] ...</code></td></tr>
 781 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreURLSessionIdentifiers None</code></td></tr>
 782 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 783 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 784 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 785 </table>
 786     <p>Certaines applications encodent l'identifiant de session dans
 787     l'URL comme dans l'exemple suivant :
 788     </p>
 789     <ul>
 790       <li><code>/une-application/image.gif;jsessionid=123456789</code></li>
 791       <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li>
 792     </ul>
 793     <p>Ceci implique la mise en cache des ressources séparément pour
 794     chaque session, ce qui n'est en général pas souhaité. La directive
 795     <code class="directive">CacheIgnoreURLSessionIdentifiers</code> permet de
 796     définir une liste d'identifiants qui seront supprimés de la clé
 797     utilisée pour identifier une entité dans le cache, de façon à ce que
 798     les ressources ne soient pas stockées séparément pour chaque
 799     session.
 800     </p>
 801     <p><code>CacheIgnoreURLSessionIdentifiers None</code> vide la liste
 802     des identifiants ignorés. Autrement, chaque identifiant spécifié est
 803     ajouté à la liste.</p>
 804
 805     <div class="example"><h3>Exemple 1</h3><p><code>
 806       CacheIgnoreURLSessionIdentifiers jsessionid
 807     </code></p></div>
 808
 809     <div class="example"><h3>Exemple 2</h3><p><code>
 810       CacheIgnoreURLSessionIdentifiers None
 811     </code></p></div>
 812
 813
 814 </div>
 815 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 816 <div class="directive-section"><h2><a name="CacheKeyBaseURL" id="CacheKeyBaseURL">CacheKeyBaseURL</a> <a name="cachekeybaseurl" id="cachekeybaseurl">Directive</a></h2>
 817 <table class="directive">
 818 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Remplace l'URL de base des clés du cache mandatées en
 819 inverse</td></tr>
 820 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheKeyBaseURL <var>URL</var></code></td></tr>
 821 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheKeyBaseURL http://example.com</code></td></tr>
 822 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 823 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 824 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 825 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
 826 </table>
 827   <p>Lorsque la directive <code class="directive"><a href="#cachekeybaseurl">CacheKeyBaseURL</a></code> est utilisée, l'URL
 828   spécifiée sera utilisée comme URL de base pour calculer l'URL des clés
 829   du cache dans la configuration du mandataire inverse. Par défaut,
 830   c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera
 831   utilisé pour construire la clé de cache. Dans le cas d'un cluster de
 832   machines, si toutes les entrées du cache doivent posséder la même clé,
 833   cette directive permet de spécifier une nouvelle URL de base.</p>
 834
 835   <div class="example"><p><code>
 836     # Remplace l'URL de base de la clé de cache.<br />
 837     CacheKeyBaseURL http://www.example.com/<br />
 838   </code></p></div>
 839
 840   <div class="warning">Prenez garde en définissant cette directive. Si
 841   deux serveurs virtuels distincts possèdent accidentellement la même
 842   URL de base, les entrées en provenance d'un serveur virtuel seront
 843   servies par l'autre.</div>
 844
 845
 846 </div>
 847 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 848 <div class="directive-section"><h2><a name="CacheLastModifiedFactor" id="CacheLastModifiedFactor">CacheLastModifiedFactor</a> <a name="cachelastmodifiedfactor" id="cachelastmodifiedfactor">Directive</a></h2>
 849 <table class="directive">
 850 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le facteur utilisé pour générer une date d'expiration en
 851 fonction de la date de dernière modification.</td></tr>
 852 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLastModifiedFactor <var>flottant</var></code></td></tr>
 853 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLastModifiedFactor 0.1</code></td></tr>
 854 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 855 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 856 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 857 </table>
 858     <p>Si un document ne possède pas de date d'expiration, elle peut
 859     être calculée en fonction de la date de dernière modification, si
 860     elle existe. La directive
 861     <code class="directive">CacheLastModifiedFactor</code> permet de spécifier
 862     un <var>facteur</var> à utiliser pour la génération de cette date
 863     d'expiration au sein de la formule suivante :
 864
 865     <code>délai-expiration = durée-depuis-date-dernière-modification *
 866     <var>facteur</var>
 867     date-expiration = date-courante + délai-expiration</code>
 868
 869     Par exemple, si la dernière modification du document date de 10
 870     heures, et si <var>facteur</var> a pour valeur 0.1, le délai
 871     d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est
 872     3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =
 873     4:00pm.
 874
 875     Si le délai d'expiration est supérieur à celui spécifié par la
 876     directive <code class="directive">CacheMaxExpire</code>, c'est ce dernier
 877     qui l'emporte.</p>
 878
 879     <div class="example"><p><code>
 880       CacheLastModifiedFactor 0.5
 881     </code></p></div>
 882
 883 </div>
 884 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 885 <div class="directive-section"><h2><a name="CacheLock" id="CacheLock">CacheLock</a> <a name="cachelock" id="cachelock">Directive</a></h2>
 886 <table class="directive">
 887 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la protection contre les tempêtes de requêtes.</td></tr>
 888 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLock <var>on|off</var></code></td></tr>
 889 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLock off</code></td></tr>
 890 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 891 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 892 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 893 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.2.15 d'Apache</td></tr>
 894 </table>
 895   <p>La directive <code class="directive">CacheLock</code> active la protection
 896   contre les tempêtes de requêtes pour l'espace d'adressage donné.</p>
 897
 898   <p>La configuration minimale pour activer le verrouillage contre les
 899   tempêtes de requêtes dans le répertoire temp par défaut du système est
 900   la suivante :</p>
 901
 902   <div class="example"><p><code>
 903     # Active le verrouillage du cache<br />
 904     CacheLock on<br /><br />
 905   </code></p></div>
 906
 907
 908 </div>
 909 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 910 <div class="directive-section"><h2><a name="CacheLockMaxAge" id="CacheLockMaxAge">CacheLockMaxAge</a> <a name="cachelockmaxage" id="cachelockmaxage">Directive</a></h2>
 911 <table class="directive">
 912 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit la durée de vie maximale d'un verrou de cache.</td></tr>
 913 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockMaxAge <var>entier</var></code></td></tr>
 914 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockMaxAge 5</code></td></tr>
 915 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 916 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 917 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 918 </table>
 919   <p>La directive <code class="directive">CacheLockMaxAge</code> permet de
 920   spécifier la durée de vie maximale d'un verrou de cache.</p>
 921
 922   <p>Un verrou plus ancien que cette valeur exprimée en secondes sera
 923   ignoré, et la prochaine requête entrante sera alors en mesure de
 924   recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop
 925   longues initiées par des clients lents.</p>
 926
 927
 928 </div>
 929 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 930 <div class="directive-section"><h2><a name="CacheLockPath" id="CacheLockPath">CacheLockPath</a> <a name="cachelockpath" id="cachelockpath">Directive</a></h2>
 931 <table class="directive">
 932 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le répertoire des verrous.</td></tr>
 933 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockPath <var>répertoire</var></code></td></tr>
 934 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockPath /tmp/mod_cache-lock</code></td></tr>
 935 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 936 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 937 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 938 </table>
 939   <p>La directive <code class="directive">CacheLockPath</code> permet de
 940   spécifier le répertoire dans lequel les verrous sont créés. Par
 941   défaut, c'est le répertoire temporaire du système qui est utilisé. Les
 942   verrous sont des fichiers vides qui n'existent que pour les URLs
 943   périmées en cours de mise à jour, et consomment donc bien moins de
 944   ressources que le traditionnel cache sur disque.</p>
 945
 946
 947 </div>
 948 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 949 <div class="directive-section"><h2><a name="CacheMaxExpire" id="CacheMaxExpire">CacheMaxExpire</a> <a name="cachemaxexpire" id="cachemaxexpire">Directive</a></h2>
 950 <table class="directive">
 951 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée maximale en secondes de mise en cache d'un
 952 document</td></tr>
 953 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxExpire <var>secondes</var></code></td></tr>
 954 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxExpire 86400 (une journée)</code></td></tr>
 955 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 956 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 957 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 958 </table>
 959     <p>La directive <code class="directive">CacheMaxExpire</code> permet de
 960     spécifier le nombre maximum de secondes pendant lequel les documents
 961     HTTP suceptibles d'être mis en cache seront conservés sans vérifier
 962     leur contenu sur le serveur d'origine. Ce nombre de secondes
 963     correspond donc à la durée maximale pendant laquelle un document ne
 964     sera pas à jour. L'utilisation de cette valeur maximale est forcée,
 965     même si le document possède une date d'expiration.</p>
 966
 967     <div class="example"><p><code>
 968       CacheMaxExpire 604800
 969     </code></p></div>
 970
 971 </div>
 972 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 973 <div class="directive-section"><h2><a name="CacheMinExpire" id="CacheMinExpire">CacheMinExpire</a> <a name="cacheminexpire" id="cacheminexpire">Directive</a></h2>
 974 <table class="directive">
 975 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale en secondes de mise en cache d'un
 976 document</td></tr>
 977 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinExpire <var>secondes</var></code></td></tr>
 978 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinExpire 0</code></td></tr>
 979 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 980 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 981 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
 982 </table>
 983     <p>La directive <code class="directive">CacheMaxExpire</code> permet de
 984     spécifier le nombre maximum de secondes pendant lequel les documents
 985     HTTP suceptibles d'être mis en cache seront conservés sans vérifier
 986     leur contenu sur le serveur d'origine. Elle n'est prise en compte
 987     que dans le cas où le document ne possède aucune date d'expiration
 988     valide.</p>
 989
 990     <div class="example"><p><code>
 991       CacheMinExpire 3600
 992     </code></p></div>
 993
 994 </div>
 995 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 996 <div class="directive-section"><h2><a name="CacheQuickHandler" id="CacheQuickHandler">CacheQuickHandler</a> <a name="cachequickhandler" id="cachequickhandler">Directive</a></h2>
 997 <table class="directive">
 998 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Exécute le cache à partir d'un gestionnaire rapide.</td></tr>
 999 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheQuickHandler <var>on|off</var></code></td></tr>
1000 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheQuickHandler on</code></td></tr>
1001 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
1002 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1003 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1004 </table>
1005     <p>La directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> permet de contrôler
1006     la phase au cours de laquelle la mise en cache est effectuée.</p>
1007
1008     <p>Avec la configuration par défaut, le cache agit au cours de la
1009     phase du gestionnaire rapide. Cette phase court-circuite la majorité
1010     des traitements du serveur, et constitue le mode d'opération le plus
1011     performant pour un serveur typique. Le cache
1012     <strong>s'incruste</strong> devant le serveur, et la majorité des
1013     traitements du serveur est court-circuitée.</p>
1014
1015     <p>Lorsque cette directive est définie à off, le cache agit comme un
1016     gestionnaire normal, et est concerné par toutes les phases de
1017     traitement d'une requête. Bien que ce mode soit moins performant que
1018     le mode par défaut, il permet d'utiliser le cache dans les cas où un
1019     traitement complet de la requête est nécessaire, comme par exemple
1020     lorsque le contenu est soumis à autorisation.</p>
1021
1022     <div class="example"><p><code>
1023       # Exécute le cache comme un gestionnaire normal<br />
1024       CacheQuickHandler off<br /><br />
1025     </code></p></div>
1026
1027     <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a
1028     aussi la possibilité de choisir avec précision le point de la chaîne
1029     de filtrage où la mise en cache sera effectuée, en utilisant le
1030     filtre <strong>CACHE</strong>.</p>
1031
1032     <div class="example"><p><code>
1033       # Mise en cache du contenu avant l'intervention de mod_include et
1034       # mod_deflate<br />
1035       CacheQuickHandler off<br />
1036       AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html<br /><br />
1037     </code></p></div>
1038
1039     <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière
1040     instance qui sera prise en compte.</p>
1041
1042
1043 </div>
1044 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1045 <div class="directive-section"><h2><a name="CacheStaleOnError" id="CacheStaleOnError">CacheStaleOnError</a> <a name="cachestaleonerror" id="cachestaleonerror">Directive</a></h2>
1046 <table class="directive">
1047 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Sert du contenu non à jour à la place de réponses 5xx.</td></tr>
1048 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStaleOnError <var>on|off</var></code></td></tr>
1049 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStaleOnError on</code></td></tr>
1050 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1051 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1052 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1053 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
1054 </table>
1055   <p>Lorsque la directive <code class="directive"><a href="#cachestaleonerror">CacheStaleOnError</a></code> est définie à on, et
1056   si des données non mises à jour sont disponibles dans le cache, ce
1057   dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en
1058   provenance du serveur d'arrière-plan. Alors que l'en-tête
1059   Cache-Control envoyé par les clients sera respecté, et que les clients
1060   recevront donc dans ce cas la réponse 5xx brute à leur requête, cette
1061   réponse 5xx renvoyée au client n'invalidera pas le contenu dans le
1062   cache.  </p>
1063
1064   <div class="example"><p><code>
1065     # Sert des données non mises à jour en cas d'erreur.<br />
1066     CacheStaleOnError on<br />
1067   </code></p></div>
1068
1069
1070 </div>
1071 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1072 <div class="directive-section"><h2><a name="CacheStoreExpired" id="CacheStoreExpired">CacheStoreExpired</a> <a name="cachestoreexpired" id="cachestoreexpired">Directive</a></h2>
1073 <table class="directive">
1074 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les réponses que le serveur
1075 considère comme arrivées à expiration</td></tr>
1076 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreExpired On|Off</code></td></tr>
1077 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreExpired Off</code></td></tr>
1078 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1079 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1080 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1081 </table>
1082     <p>Depuis la version 2.2.4, les réponses qui sont arrivées à
1083     expiration ne sont pas stockées dans le cache. La directive
1084     <code class="directive">CacheStoreExpired</code> permet de modifier ce
1085     comportement. Avec <code class="directive">CacheStoreExpired</code> On, le
1086     serveur tente de mettre en cache la ressource si elle est périmée.
1087     Les requêtes suivantes vont déclencher une requête si-modifié-depuis
1088     de la part du serveur d'origine, et la réponse sera renvoyée à
1089     partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p>
1090
1091     <div class="example"><p><code>
1092       CacheStoreExpired On
1093     </code></p></div>
1094
1095 </div>
1096 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1097 <div class="directive-section"><h2><a name="CacheStoreNoStore" id="CacheStoreNoStore">CacheStoreNoStore</a> <a name="cachestorenostore" id="cachestorenostore">Directive</a></h2>
1098 <table class="directive">
1099 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les requêtes ou réponses dont
1100 l'entête Cache-Control: a pour valeur no-store.</td></tr>
1101 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreNoStore On|Off</code></td></tr>
1102 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreNoStore Off</code></td></tr>
1103 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1104 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1105 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1106 </table>
1107     <p>Normalement, les requêtes ou réponses dont l'en-tête
1108     Cache-Control: a pour valeur no-store ne sont pas stockées dans le
1109     cache. La directive <code class="directive">CacheStoreNoCache</code> permet
1110     de modifier ce comportement. Si
1111     <code class="directive">CacheStoreNoCache</code> est définie à On, le
1112     serveur tente de mettre la ressource en cache même si elle contient
1113     des en-têtes ayant pour valeur no-store. Les ressources
1114     nécessitant une autorisation ne sont <em>jamais</em> mises en
1115     cache.</p>
1116
1117     <div class="example"><p><code>
1118       CacheStoreNoStore On
1119     </code></p></div>
1120
1121     <div class="warning"><h3>Avertissement :</h3>
1122        Selon la RFC 2616, la valeur d'en-tête no-store est censée
1123        "prévenir la suppression ou la rétention par inadvertance
1124        d'informations sensibles (par exemple, sur des bandes de
1125        sauvegarde)". Autrement dit, l'activation de la directive
1126        <code class="directive">CacheStoreNoCache</code> pourrait provoquer le
1127        stockage d'informations sensibles dans le cache. Vous avez donc
1128        été prévenus.
1129     </div>
1130
1131 <h3>Voir aussi</h3>
1132 <ul>
1133 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
1134 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
1135 </ul>
1136 </div>
1137 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1138 <div class="directive-section"><h2><a name="CacheStorePrivate" id="CacheStorePrivate">CacheStorePrivate</a> <a name="cachestoreprivate" id="cachestoreprivate">Directive</a></h2>
1139 <table class="directive">
1140 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache des réponses que le serveur a
1141 marquées comme privées</td></tr>
1142 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStorePrivate On|Off</code></td></tr>
1143 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStorePrivate Off</code></td></tr>
1144 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1145 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1146 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1147 </table>
1148     <p>Normalement, les réponse comportant un en-tête Cache-Control:
1149     dont la valeur est private ne seront pas stockées dans le cache. La
1150     directive <code class="directive">CacheStorePrivate</code> permet de
1151     modifier ce comportement. Si
1152     <code class="directive">CacheStorePrivate</code> est définie à On, le
1153     serveur tentera de mettre la ressource en cache, même si elle
1154     contient des en-têtes ayant pour valeur private. Les ressources
1155     nécessitant une autorisation ne sont <em>jamais</em> mises en
1156     cache.</p>
1157
1158     <div class="example"><p><code>
1159       CacheStorePrivate On
1160     </code></p></div>
1161
1162     <div class="warning"><h3>Avertissement :</h3>
1163        Cette directive autorise la mise en cache même si le serveur
1164        indique que la ressource ne doit pas être mise en cache. Elle
1165        n'est de ce fait appropriée que dans le cas d'un cache
1166        'privé'.
1167     </div>
1168
1169 <h3>Voir aussi</h3>
1170 <ul>
1171 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
1172 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
1173 </ul>
1174 </div>
1175 </div>
1176 <div class="bottomlang">
1177 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
1178 <a href="../fr/mod/mod_cache.html" title="Français">&nbsp;fr&nbsp;</a> |
1179 <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
1180 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
1181 </div><div id="footer">
1182 <p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
1183 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
1184 </body></html>