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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>mod_cache - Serveur Apache HTTP Version 2.5</title>
11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
19 <div id="page-header">
20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
21 <p class="apache">Serveur Apache HTTP Version 2.5</p>
22 <img alt="" src="../images/feather.png" /></div>
23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
25 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
26 <div id="page-content">
27 <div id="preamble"><h1>Module Apache mod_cache</h1>
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_cache.html" title="Français"> fr </a> |
31 <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
32 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
34 <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>
35 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
36 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_module</td></tr>
37 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache.c</td></tr></table>
40 <div class="warning">Ce module doit être utilisé avec précautions
41 car lorsque la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> est définie à sa
42 valeur par défaut <strong>on</strong>, les directives <code class="directive"><a href="../mod/mod_access_compat.html#allow">Allow</a></code> and <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code> sont court-circuitées. Vous
43 ne devez donc pas activer la gestion rapide de la mise en cache pour
44 un contenu auquel vous souhaitez limiter l'accès en fonction du nom
45 d'hôte du client, de l'adresse IP ou d'une variable
46 d'environnement.</div>
48 <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> implémente un <strong>filtre de mise
49 en cache de contenu HTTP</strong> conforme à la <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a>, avec
50 support de la mise en cache des réponses dont le contenu a été
51 négocié et comportant l'en-tête Vary.</p>
53 <p>La mise en cache conforme à la RFC 2616 fournit un mécanisme
54 permettant de vérifier si un contenu expiré ou dépassé est encore à
55 jour, et peut apporter un gain de performances significatif si le
56 serveur original supporte les <strong>requêtes
57 conditionnelles</strong> en prenant en compte l'en-tête de requête
58 HTTP <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.26">If-None-Match</a>.
59 Le contenu n'est ainsi régénéré que lorsqu'il a été modifié, et non
60 lorsqu'il a expiré.</p>
62 <p>En tant que filtre, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être placé
63 en face d'un contenu issu de tout gestionnaire, y compris
64 <strong>des fichiers à accès séquentiel</strong> (servis depuis un
66 cache sur un gros disque), la sortie d'un <strong>script
67 CGI</strong> ou d'un <strong>générateur de contenu
68 dynamique</strong>, ou du contenu <strong>mandaté depuis un autre
71 <p>Dans la configuration par défaut, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
72 place le filtre de mise en cache aussi loin que possible dans la
73 pile de filtres, utilisant le <strong>gestionnaire rapide</strong>
74 pour court-circuiter tout traitement par requête lors de l'envoi du
75 contenu au client. Dans ce mode opératoire,
76 <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut être considéré comme un serveur
77 mandataire avec cache fixé en tête du serveur web, alors qu'il
78 s'exécute dans ce même serveur web.</p>
80 <p>Lorsque le gestionnaire rapide est désactivé via la directive
81 <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code>, il
82 devient possible d'insérer le filtre <strong>CACHE</strong> à un
83 point de la pile de filtres choisi par l'administrateur. Ceci permet
84 de mettre en cache un contenu avant que celui-ci ne soit
85 personnalisé par le filtre <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, ou
86 éventuellement compressé par le filtre <code class="module"><a href="../mod/mod_deflate.html">mod_deflate</a></code>.</p>
88 <p>Dans le mode de fonctionnement normal, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
89 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>
90 et <a href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.32">Pragma</a>
91 envoyés par un client dans une requête, ou par un serveur dans une
92 réponse. Dans des circonstances exceptionnelles,
93 <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> peut cependant être configuré pour
94 outrepasser ces en-têtes et forcer un comportement spécifique au
95 site, bien qu'un tel comportement sera limité à ce cache seulement,
96 et n'affectera pas les opérations des autres caches qui peuvent
97 s'insérer entre le client et le serveur, et ce type de configuration
98 ne doit donc être utiliser qu'en cas de nécessité absolue.</p>
100 <p>La RFC 2616 permet au cache de renvoyer des données périmées
101 pendant que l'entrée périmée correspondante est mise à jour depuis
102 le serveur original, et <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> supporte cette
103 fonctionnalité lorsque la directive <code class="directive"><a href="#cachelock">CacheLock</a></code> est configurée en
104 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>
105 contenant un code de réponse 110. La RFC 2616 permet aussi au cache
106 de renvoyer des données périmées lorsque la tentative de mise à jour
107 des données périmées renvoie une erreur 500 ou supérieure, et cette
108 fonctionnalité est supportée par défaut par
109 <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>
110 contenant un code de réponse 111.</p>
112 <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> requiert les services d'un ou
113 plusieurs modules de gestion de stockage. La distribution Apache de base
114 inclut les modules de gestion de stockage suivants :</p>
116 <dt><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></dt>
118 <dd>implémente un gestionnaire de stockage sur disque. Les en-têtes
119 et corps sont stockés séparément sur le disque dans une structure de
120 répertoires basée sur le condensé md5 de l'URL mise en cache.
121 Plusieurs réponses à contenu négocié peuvent être stockées en même
122 temps, mais la mise en cache de contenus partiels n'est pas
123 supportée par ce module. L'utilitaire
124 <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et de supprimer les
125 URLs mises en cache, et de maintenir le cache en deçà de
126 certaines limites de taille et de nombre d'inodes.</dd>
127 <dt><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></dt>
128 <dd>Implémente un gestionnaire de stockage basé sur un cache d'objets
129 partagés. Les en-têtes et corps sont stockés ensemble sous une seule
130 clé basée sur l'URL de la réponse mise en cache. Des réponses à
131 contenus multiples négociés peuvent être stockées simultanément, mais
132 ce module ne supporte pas la mise en cache de contenus partiels.</dd>
135 <p>Pour de plus amples détails, une description, et des exemples,
136 reportez-vous au <a href="../caching.html">Guide de la mise en
139 <div id="quickview"><h3>Sujets</h3>
141 <li><img alt="" src="../images/down.gif" /> <a href="#related">Modules apparentés et directives</a></li>
142 <li><img alt="" src="../images/down.gif" /> <a href="#sampleconf">Exemple de configuration</a></li>
143 <li><img alt="" src="../images/down.gif" /> <a href="#thunderingherd">Eviter une tempête de requête</a></li>
144 <li><img alt="" src="../images/down.gif" /> <a href="#finecontrol">Contrôle fin via le filtre CACHE</a></li>
145 <li><img alt="" src="../images/down.gif" /> <a href="#status">Etat du cache et journalisation</a></li>
146 </ul><h3 class="directives">Directives</h3>
148 <li><img alt="" src="../images/down.gif" /> <a href="#cachedefaultexpire">CacheDefaultExpire</a></li>
149 <li><img alt="" src="../images/down.gif" /> <a href="#cachedetailheader">CacheDetailHeader</a></li>
150 <li><img alt="" src="../images/down.gif" /> <a href="#cachedisable">CacheDisable</a></li>
151 <li><img alt="" src="../images/down.gif" /> <a href="#cacheenable">CacheEnable</a></li>
152 <li><img alt="" src="../images/down.gif" /> <a href="#cacheheader">CacheHeader</a></li>
153 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></li>
154 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignoreheaders">CacheIgnoreHeaders</a></li>
155 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorenolastmod">CacheIgnoreNoLastMod</a></li>
156 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignorequerystring">CacheIgnoreQueryString</a></li>
157 <li><img alt="" src="../images/down.gif" /> <a href="#cacheignoreurlsessionidentifiers">CacheIgnoreURLSessionIdentifiers</a></li>
158 <li><img alt="" src="../images/down.gif" /> <a href="#cachekeybaseurl">CacheKeyBaseURL</a></li>
159 <li><img alt="" src="../images/down.gif" /> <a href="#cachelastmodifiedfactor">CacheLastModifiedFactor</a></li>
160 <li><img alt="" src="../images/down.gif" /> <a href="#cachelock">CacheLock</a></li>
161 <li><img alt="" src="../images/down.gif" /> <a href="#cachelockmaxage">CacheLockMaxAge</a></li>
162 <li><img alt="" src="../images/down.gif" /> <a href="#cachelockpath">CacheLockPath</a></li>
163 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxexpire">CacheMaxExpire</a></li>
164 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminexpire">CacheMinExpire</a></li>
165 <li><img alt="" src="../images/down.gif" /> <a href="#cachequickhandler">CacheQuickHandler</a></li>
166 <li><img alt="" src="../images/down.gif" /> <a href="#cachestaleonerror">CacheStaleOnError</a></li>
167 <li><img alt="" src="../images/down.gif" /> <a href="#cachestoreexpired">CacheStoreExpired</a></li>
168 <li><img alt="" src="../images/down.gif" /> <a href="#cachestorenostore">CacheStoreNoStore</a></li>
169 <li><img alt="" src="../images/down.gif" /> <a href="#cachestoreprivate">CacheStorePrivate</a></li>
173 <li><a href="../caching.html">Guide de la mise en
175 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
176 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
177 <div class="section">
178 <h2><a name="related" id="related">Modules apparentés et directives</a></h2>
179 <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_socache.html">mod_cache_socache</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><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocache">CacheSocache</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxtime">CacheSocacheMaxTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemintime">CacheSocacheMinTime</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachemaxsize">CacheSocacheMaxSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadsize">CacheSocacheReadSize</a></code></li><li><code class="directive"><a href="../mod/mod_cache_socache.html#cachesocachereadtime">CacheSocacheReadTime</a></code></li></ul></td></tr></table>
180 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
181 <div class="section">
182 <h2><a name="sampleconf" id="sampleconf">Exemple de configuration</a></h2>
183 <div class="example"><h3>Extrait de httpd.conf</h3><pre class="prettyprint lang-config">#
184 # Exemple de configuration du cache
186 LoadModule cache_module modules/mod_cache.so
187 <IfModule mod_cache.c>
188 LoadModule cache_disk_module modules/mod_cache_disk.so
189 <IfModule mod_cache_disk.c>
190 CacheRoot c:/cacheroot
196 # Lorsqu'on sert de mandataire, on ne met pas en cache la liste
197 # des mises à jour de sécurité
198 CacheDisable http://security.update.server/update-list/
199 </IfModule></pre>
201 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
202 <div class="section">
203 <h2><a name="thunderingherd" id="thunderingherd">Eviter une tempête de requête</a></h2>
204 <p>Lorsqu'une entrée du cache est périmée, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
205 soumet une requête conditionnelle au processus d'arrière-plan, qui est
206 censé confirmer la validité de l'entrée du cache, ou dans la négative
207 envoyer une entrée mise à jour.</p>
208 <p>Un court mais non négligeable laps de temps existe entre le moment
209 où l'entrée du cache est périmée, et le moment où elle est mise à
210 jour. Sur un serveur fortement chargé, un certain nombre de requêtes
211 peut arriver pendant ce laps de temps, et provoquer une
212 <strong>tempête</strong> de requêtes susceptibles de saturer le
213 processus d'arrière-plan de manière soudaine et imprédictible.</p>
214 <p>Pour contenir cette tempête, on peut utiliser la directive
215 <code class="directive">CacheLock</code> afin de définir un répertoire où
216 seront créés <strong>à la volée</strong> des verrous pour les URLs.
217 Ces verrous sont utilisés comme autant d'<strong>indications</strong>
218 par les autres requêtes, soit pour empêcher une tentative de mise en
219 cache (un autre processus est en train de récupérer l'entité), soit
220 pour indiquer qu'une entrée périmée est en cours de mise à jour
221 (pendant ce temps, c'est le contenu périmé qui sera renvoyé).
223 <h3>Mise en cache initiale d'une entrée</h3>
225 <p>Lorsqu'une entité est mise en cache pour la première fois, un
226 verrou est créé pour cette entité jusqu'à ce que la réponse ait été
227 entièrement mise en cache. Pendant la durée de vie du verrou, le
228 cache va empêcher une seconde tentative de mise en cache de la même
229 entité. Bien que cela ne suffise pas à contenir la tempête de
230 requêtes, toute tentative de mettre en cache la même entité
231 plusieurs fois simultanément est stoppée.
234 <h3>Mise à jour d'une entrée périmée</h3>
236 <p>Lorsqu'une entrée atteint la limite de sa durée de vie, et
237 devient par conséquent périmée, un verrou est créé pour cette entité
238 jusqu'à ce que la réponse ait été soit confirmée comme encore
239 valide, soit remplacée par le processus d'arrière-plan. Pendant la
240 durée de vie du verrou, une seconde requête entrante va provoquer le
241 renvoi de la donnée périmée, et la tempête de requêtes sera
244 <h3>Verrous et en-tête Cache-Control: no-cache</h3>
246 <p>Les verrous ne sont utilisés <strong>qu'à titre
247 indicatif</strong> pour enjoindre le cache à être plus coopératif
248 avec les serveurs d'arrière-plan, et il est possible de passer outre
249 si nécessaire. Si le client envoie une requête contenant un en-tête
250 Cache-Control imposant un nouveau téléchargement de l'entité, tout
251 verrou éventuel sera ignoré, la requête du client sera honorée
252 immédiatement, et l'entrée du cache mise à jour.</p>
254 <p>Comme mécanisme de sécurité supplémentaire, la durée de vie
255 maximale des verrous est configurable. Lorsque cette limite est
256 atteinte, le verrou est supprimé et une autre requête peut alors en
257 créer un nouveau. Cette durée de vie peut être définie via la
258 directive <code class="directive">CacheLockMaxAge</code>, et sa valeur par
259 défaut est de 5 secondes.
262 <h3>Exemple de configuration</h3>
264 <div class="example"><h3>Activation du verrouillage du cache</h3><pre class="prettyprint lang-config">#
265 # Active le verrouillage du cache
267 <IfModule mod_cache.c>
269 CacheLockPath /tmp/mod_cache-lock
271 </IfModule></pre>
274 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
275 <div class="section">
276 <h2><a name="finecontrol" id="finecontrol">Contrôle fin via le filtre CACHE</a></h2>
277 <p>Dans son mode de fonctionnement par défaut, le cache s'exécute sous
278 la forme d'un gestionnaire rapide, court-circuitant la majorité des
279 traitements du serveur et fournissant ainsi une mise en cache
280 possédant les plus hautes performances disponibles.</p>
282 <p>Dans ce mode, le cache <strong>s'incruste</strong> devant le
283 serveur, comme si un mandataire de mise en cache indépendant RFC 2616
284 était placé devant ce dernier.</p>
286 <p>Bien que que ce mode offre les meilleures performances, les
287 administrateurs peuvent souhaiter, dans certaines circonstances,
288 effectuer des traitements sur la requête après que cette dernière ait
289 été mise en cache, comme ajouter du contenu personnalisé à la page
290 mise en cache, ou appliquer des restrictions d'autorisations au
291 contenu. Pour y parvenir, l'administrateur sera alors souvent forcé de
292 placer des serveurs mandataires inverses indépendants soit derrière,
293 soit devant le serveur de mise en cache.</p>
295 <p>Pour résoudre ce problème, la directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> peut être définie à
296 <strong>off</strong>, afin que le serveur traite toutes les phases
297 normalement exécutées par une requête non mise en cache, y compris les
298 phases <strong>d'authentification et d'autorisation</strong>.</p>
300 <p>En outre, l'administrateur peut éventuellement spécifier le
301 <strong>point précis dans la chaîne de filtrage</strong> où devra
302 intervenir la mise en cache en ajoutant le filtre
303 <strong>CACHE</strong> à la chaîne de filtrage en sortie.</p>
305 <p>Par exemple, pour mettre en cache le contenu avant d'appliquer une
306 compression à la réponse, placez le filtre <strong>CACHE</strong>
307 avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant
310 <pre class="prettyprint lang-config"># Mise en cache du contenu avant la compression optionnelle
311 CacheQuickHandler off
312 AddOutputFilterByType CACHE;DEFLATE text/plain</pre>
315 <p>Une autre possibilité consiste à mettre en cache le contenu avant
316 l'ajout de contenu personnalisé via <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> (ou
317 tout autre filtre de traitement de contenu). Dans l'exemple suivant,
318 les modèles contenant des balises comprises par
319 <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> sont mis en cache avant d'être
322 <pre class="prettyprint lang-config"># Mise en cache du contenu avant l'intervention de mod_include et
324 CacheQuickHandler off
325 AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre>
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>
333 <pre class="prettyprint lang-config"># Mise en cache du contenu entre les interventions de mod_include et
335 CacheQuickHandler off
336 AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html</pre>
339 <div class="warning"><h3>Avertissement :</h3>Si pour une raison
340 ou pour une autre, le point d'insertion du filtre
341 <strong>CACHE</strong> dans la chaîne de filtrage est modifié, vous
342 devez <strong>vider votre cache</strong> pour être sûr que les données
343 servies soient à jour. En effet, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> n'est pas
344 en mesure d'effectuer cette opération à votre place.</div>
346 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
347 <div class="section">
348 <h2><a name="status" id="status">Etat du cache et journalisation</a></h2>
349 <p>Lorsque <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> a décidé s'il devait ou non
350 servir une entité depuis le cache, les raisons précises de cette
351 décision sont enregistrées dans l'environnement du sous-processus
352 interne à la requête sous la clé <strong>cache-status</strong>.
353 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 <pre class="prettyprint lang-config">LogFormat "%{cache-status}e ..."</pre>
358 <p>En fonction de la décision prise, l'information est aussi écrite
359 dans l'environnement du sous-processus sous une des quatre clés
363 <dt>cache-hit</dt><dd>Le contenu a été servi depuis le cache.</dd>
364 <dt>cache-revalidate</dt><dd>Le contenu du cache était périmé, a été
365 mis à jour avec succès, puis servi depuis le cache.</dd>
366 <dt>cache-miss</dt><dd>Le contenu n'était pas dans le cache et a été
367 servi directement depuis le serveur demandé.</dd>
368 <dt>cache-invalidate</dt><dd>L'entité du cache est devenue invalide
369 suite à une requête d'un type autre que GET ou HEAD.</dd>
372 <p>Il est alors possible d'envisager une journalisation conditionnelle
373 du traitement des requêtes par rapport au cache comme dans l'exemple
376 <pre class="prettyprint lang-config">CustomLog "cached-requests.log" common env=cache-hit
377 CustomLog "uncached-requests.log" common env=cache-miss
378 CustomLog "revalidated-requests.log" common env=cache-revalidate
379 CustomLog "invalidated-requests.log" common env=cache-invalidate</pre>
382 <p>Pour les concepteurs de modules, une accroche (hook) nommée
383 <var>cache_status</var> est disponible et permet aux modules de
384 répondre aux résultats de la vérification du cache ci-dessus de manière
388 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
389 <div class="directive-section"><h2><a name="cachedefaultexpire" id="cachedefaultexpire">Directive</a> <a name="CacheDefaultExpire" id="CacheDefaultExpire">CacheDefaultExpire</a></h2>
390 <table class="directive">
391 <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
392 lorsqu'aucune date d'expiration n'a été spécifiée.</td></tr>
393 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDefaultExpire <var>secondes</var></code></td></tr>
394 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDefaultExpire 3600 (une heure)</code></td></tr>
395 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
396 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
397 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
399 <p>La directive <code class="directive">CacheDefaultExpire</code> permet de
400 spécifier un temps par défaut, en secondes, pendant lequel sera
401 conservé dans le cache un document qui ne possède ni date
402 d'expiration, ni date de dernière modification. La valeur de cette
403 directive est écrasée par la valeur de la directive
404 <code class="directive">CacheMaxExpire</code> si cette dernière est
407 <pre class="prettyprint lang-config">CacheDefaultExpire 86400</pre>
411 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
412 <div class="directive-section"><h2><a name="cachedetailheader" id="cachedetailheader">Directive</a> <a name="CacheDetailHeader" id="CacheDetailHeader">CacheDetailHeader</a></h2>
413 <table class="directive">
414 <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>
415 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDetailHeader <var>on|off</var></code></td></tr>
416 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDetailHeader off</code></td></tr>
417 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
418 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
419 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
420 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
422 <p>Lorsque la directive <code class="directive"><a href="#cachedetailheader">CacheDetailHeader</a></code> est définie à on, un
423 en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et
424 contient les raisons précises d'une décision d'utilisation du cache
425 vis à vis de cette dernière.</p>
427 <p>Ceci peut s'avérer utile au cours du développement de services
428 RESTful mis en cache pour obtenir des informations supplémentaires à
429 propos des décisions vis à vis du cache écrites dans les en-têtes de
430 la réponse. Il est ainsi possible de vérifier si
431 <code>Cache-Control</code> et d'autres en-têtes ont été correctement
432 utilisés par le service et le client.</p>
434 <p>Si le gestionnaire normal est utilisé, cette directive peut se
435 situer dans une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Si c'est le gestionnaire
436 rapide qui est utilisé, elle doit se situer dans un contexte de
437 serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p>
439 <pre class="prettyprint lang-config"># Active l'en-tête X-Cache-Detail
440 CacheDetailHeader on</pre>
443 <div class="example"><p><code>
444 X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost<br />
449 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
450 <div class="directive-section"><h2><a name="cachedisable" id="cachedisable">Directive</a> <a name="CacheDisable" id="CacheDisable">CacheDisable</a></h2>
451 <table class="directive">
452 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Désactive la mise en cache des URLs
454 <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>
455 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
456 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
457 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
459 <p>La directive <code class="directive">CacheDisable</code> enjoint
460 <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de <em>ne pas</em> mettre en cache l'URL
461 spécifiée par <var>chaîne URL</var>, ainsi que les URLs de niveaux
464 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">CacheDisable /fichiers_locaux</pre>
467 <p>Si la directive se trouve à l'intérieur d'une section <code class="directive"><Location></code>, le chemin doit être spécifié en
468 dessous de la Location, et si le mot "on" est utilisé, la mise en
469 cache sera désactivée pour l'ensemble de l'arborescence concernée
470 par la section Location.</p>
472 <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config"><Location "/foo">
474 </Location></pre>
477 <p>Avec les versions 2.2.12 et ultérieures, on peut définir la
478 variable d'environnement <code>no-cache</code> pour une définition
479 plus fine des ressources à mettre en cache.</p>
483 <li><a href="../env.html">Les variables d'environnement dans
487 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
488 <div class="directive-section"><h2><a name="cacheenable" id="cacheenable">Directive</a> <a name="CacheEnable" id="CacheEnable">CacheEnable</a></h2>
489 <table class="directive">
490 <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
491 gestionnaire de stockage précisé</td></tr>
492 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheEnable <var>type de cache</var> [<var>chaîne
493 URL</var>]</code></td></tr>
494 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire</td></tr>
495 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
496 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
497 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Une chaîne URL telle que '/' s'appliquait à tout contenu
498 en mandat direct dans les versions 2.2 et antérieures.</td></tr>
500 <p>La directive <code class="directive">CacheEnable</code> enjoint
501 <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> de mettre en cache l'URL précisée par
502 <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le
503 gestionnaire de stockage du cache est spécifié à l'aide de
504 l'argument <var>type de cache</var>. La directive
505 <code class="directive">CacheEnable</code> peut être placée à l'intérieur d'une
506 section <code class="directive"><Location></code> ou <code class="directive"><LocationMatch></code> pour indiquer que le
507 contenu considéré peut être mis en cache. Si <var>type de cache</var>
508 a pour valeur <code>disk</code>, <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
509 utilisera le gestionnaire de stockage sur disque implémenté par
510 <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. Pour que <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
511 utilise le gestionnaire de stockage basé sur le cache d'objets
512 partagés implémenté par <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>,
513 spécifiez <code>socache</code> comme valeur du paramètre <var>type
515 <p>Si les différentes directives <code class="directive">CacheEnable</code>
516 spécifient des URLs qui se recoupent (comme dans l'exemple
517 ci-dessous), tous les gestionnaires de stockage possibles seront
518 lancés, jusqu'au premier d'entre eux qui traitera effectivement la
520 L'ordre dans lequel les gestionnaires de stockage sont lancés est
521 déterminé par l'ordre dans lequel apparaissent les directives
522 <code class="directive">CacheEnable</code> dans le fichier de
523 configuration. Les directives <code class="directive">CacheEnable</code>
524 situées à l'intérieur de sections <code class="directive"><Location></code> ou <code class="directive"><LocationMatch></code> sont traitées avant les
525 directives <code class="directive">CacheEnable</code> définies au niveau
528 <p>En fonctionnement du type serveur mandataire direct, <var>chaîne
529 URL</var> doit au moins débuter par un protocole pour lequel la mise
530 en cache doit être activée.</p>
532 <pre class="prettyprint lang-config"># Mise en cache de contenu (gestionnaire normal seulement)
533 CacheQuickHandler off
534 <Location "/foo">
538 # Mise en cache via une expression rationnelle (gestionnaire normal seulement)
539 CacheQuickHandler off
540 <LocationMatch "foo$">
542 </LocationMatch>
544 # Mise en cache de tous les contenus, à l'exception des URLs
545 # mandatées en direct (gestionnaire normal ou rapide)
548 # Mise en cache des URLs FTP mandatées (gestionnaire normal ou rapide)
549 CacheEnable disk ftp://
551 # Mise en cache des contenus mandatés en direct depuis www.example.org (gestionnaire normal ou rapide)
552 CacheEnable disk http://www.example.org/</pre>
555 <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong>
556 correspondra à tout nom d'hôte se terminant par le suffixe
557 considéré. Un nom d'hôte commençant par un caractère
558 <strong>"."</strong> correspondra à tout nom d'hôte contenant le
559 composant de nom de domaine qui suit ce caractère.</p>
561 <pre class="prettyprint lang-config"># Correspond à www.example.org et fooexample.org
562 CacheEnable disk http://*example.org/
563 # Correspond à www.example.org, mais pas à fooexample.org
564 CacheEnable disk http://.example.org/</pre>
567 <p>Depuis la version 2.2.12, on peut définir la variable
568 d'environnement <code>no-cache</code> pour une définition plus fine
569 des ressources à mettre en cache.</p>
574 <li><a href="../env.html">Les variables d'environnement dans
578 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
579 <div class="directive-section"><h2><a name="cacheheader" id="cacheheader">Directive</a> <a name="CacheHeader" id="CacheHeader">CacheHeader</a></h2>
580 <table class="directive">
581 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute un en-tête X-Cache à la réponse.</td></tr>
582 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheHeader <var>on|off</var></code></td></tr>
583 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheHeader off</code></td></tr>
584 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
585 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
586 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
587 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
589 <p>Lorsque la directive <code class="directive"><a href="#cacheheader">CacheHeader</a></code> est définie à on, un
590 en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient
591 l'état du cache pour cette dernière. Si le gestionnaire normal est
592 utilisé, cette directive peut se situer dans une section
593 <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou
594 <code class="directive"><a href="../mod/core.html#location"><Location></a></code>. Si c'est
596 gestionnaire rapide qui est utilisé, elle doit se situer dans un
597 contexte de serveur principal ou de serveur virtuel, sinon elle sera
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>
609 <pre class="prettyprint lang-config"># Active l'en-tête X-Cache
613 <pre class="prettyprint lang-config">X-Cache: HIT from localhost</pre>
619 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
620 <div class="directive-section"><h2><a name="cacheignorecachecontrol" id="cacheignorecachecontrol">Directive</a> <a name="CacheIgnoreCacheControl" id="CacheIgnoreCacheControl">CacheIgnoreCacheControl</a></h2>
621 <table class="directive">
622 <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
623 le contenu au client depuis le cache</td></tr>
624 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreCacheControl On|Off</code></td></tr>
625 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreCacheControl Off</code></td></tr>
626 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
627 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
628 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
630 <p>Normalement, les requêtes contenant des en-têtes tels que
631 Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies
632 depuis le cache. La directive
633 <code class="directive">CacheIgnoreCacheControl</code> permet de modifier ce
634 comportement. Avec <code class="directive">CacheIgnoreCacheControl
635 On</code>, le serveur tentera de servir la ressource depuis le
636 cache, même si la requête contient un en-tête
639 <pre class="prettyprint lang-config">CacheIgnoreCacheControl On</pre>
642 <div class="warning"><h3>Avertissement :</h3>
643 Cette directive permet de servir des ressources depuis le cache,
644 même si le client a demandé à ce qu'il n'en soit pas ainsi. Le
645 contenu servi est ainsi susceptible d'être périmé.
650 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
651 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
654 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
655 <div class="directive-section"><h2><a name="cacheignoreheaders" id="cacheignoreheaders">Directive</a> <a name="CacheIgnoreHeaders" id="CacheIgnoreHeaders">CacheIgnoreHeaders</a></h2>
656 <table class="directive">
657 <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.
659 <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>
660 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreHeaders None</code></td></tr>
661 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
662 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
663 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
665 <p>En accord avec la RFC 2616, les en-têtes HTTP hop-by-hop ne sont
666 pas stockés dans le cache. Les en-têtes HTTP suivant sont des
667 en-têtes hop-by-hop, et en tant que tels, ne sont en <em>aucun</em>
668 cas stockés dans le cache, quelle que soit la définition de la
669 directive <code class="directive">CacheIgnoreHeaders</code> :</p>
672 <li><code>Connection</code></li>
673 <li><code>Keep-Alive</code></li>
674 <li><code>Proxy-Authenticate</code></li>
675 <li><code>Proxy-Authorization</code></li>
676 <li><code>TE</code></li>
677 <li><code>Trailers</code></li>
678 <li><code>Transfer-Encoding</code></li>
679 <li><code>Upgrade</code></li>
682 <p>La directive <code class="directive">CacheIgnoreHeaders</code> permet de
683 spécifier quels en-têtes HTTP ne doivent pas être stockés dans le
684 cache. Par exemple, il peut s'avérer pertinent dans certains cas de
685 ne pas stocker les cookies dans le cache.</p>
687 <p>La directive <code class="directive">CacheIgnoreHeaders</code> accepte
688 une liste d'en-têtes HTTP séparés par des espaces, qui ne doivent
689 pas être stockés dans le cache. Si les en-têtes hop-by-hop sont les
690 seuls à ne pas devoir être stockés dans le cache (le comportement
691 compatible RFC 2616), la directive
692 <code class="directive">CacheIgnoreHeaders</code> peut être définie à
693 <code>None</code>.</p>
695 <div class="example"><h3>Exemple 1</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders Set-Cookie</pre>
698 <div class="example"><h3>Exemple 2</h3><pre class="prettyprint lang-config">CacheIgnoreHeaders None</pre>
701 <div class="warning"><h3>Avertissement :</h3>
702 Si des en-têtes nécessaires à la bonne gestion du cache, comme
703 <code>Expires</code>, ne sont pas stockés suite à la définition
704 d'une directive <code class="directive">CacheIgnoreHeaders</code>, le
705 comportement de mod_cache sera imprévisible.
709 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
710 <div class="directive-section"><h2><a name="cacheignorenolastmod" id="cacheignorenolastmod">Directive</a> <a name="CacheIgnoreNoLastMod" id="CacheIgnoreNoLastMod">CacheIgnoreNoLastMod</a></h2>
711 <table class="directive">
712 <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
714 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreNoLastMod On|Off</code></td></tr>
715 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreNoLastMod Off</code></td></tr>
716 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
717 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
718 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
720 <p>Normalement, les documents qui ne possèdent pas de date de
721 dernière modification ne sont pas mis en cache. Dans certaines
722 circonstances, la date de dernière modification est supprimée (au
723 cours des traitements liés à <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> par
724 exemple), ou n'existe tout simplement pas. La directive
725 <code class="directive">CacheIgnoreNoLastMod</code> permet de spécifier si
726 les documents ne possèdant pas de date de dernière modification
727 doivent être mis en cache, même sans date de dernière modification.
728 Si le document ne possède ni date d'expiration, ni date de dernière
729 modification, la valeur spécifiée par la directive
730 <code class="directive">CacheDefaultExpire</code> servira à générer une date
734 <pre class="prettyprint lang-config">CacheIgnoreNoLastMod On</pre>
738 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
739 <div class="directive-section"><h2><a name="cacheignorequerystring" id="cacheignorequerystring">Directive</a> <a name="CacheIgnoreQueryString" id="CacheIgnoreQueryString">CacheIgnoreQueryString</a></h2>
740 <table class="directive">
741 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore la chaîne de paramètres lors de la mise en
743 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreQueryString On|Off</code></td></tr>
744 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreQueryString Off</code></td></tr>
745 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
746 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
747 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
749 <p>Normalement, les requêtes comportant une chaîne de paramètres
750 sont mises en cache séparément si leurs chaînes de paramètres
752 En accord avec la RFC 2616/13.9, cette mise en cache n'est effectuée
753 séparément que si une date d'expiration est spécifiée. La directive
754 <code class="directive">CacheIgnoreQueryString</code> permet la mise en
755 cache de requêtes même si aucune date d'expiration est spécifiée, et
756 de renvoyer une réponse depuis la cache même si les chaînes de
757 paramètres diffèrent. Du point de vue du cache, la requête est
758 traitée comme si elle ne possèdait pas de chaîne de paramètres
759 lorsque cette directive est activée.</p>
761 <pre class="prettyprint lang-config">CacheIgnoreQueryString On</pre>
766 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
767 <div class="directive-section"><h2><a name="cacheignoreurlsessionidentifiers" id="cacheignoreurlsessionidentifiers">Directive</a> <a name="CacheIgnoreURLSessionIdentifiers" id="CacheIgnoreURLSessionIdentifiers">CacheIgnoreURLSessionIdentifiers</a></h2>
768 <table class="directive">
769 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ignore les identifiants de session définis encodés dans
770 l'URL lors de la mise en cache
772 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheIgnoreURLSessionIdentifiers <var>identifiant</var>
773 [<var>identifiant</var>] ...</code></td></tr>
774 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheIgnoreURLSessionIdentifiers None</code></td></tr>
775 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
776 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
777 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
779 <p>Certaines applications encodent l'identifiant de session dans
780 l'URL comme dans l'exemple suivant :
783 <li><code>/une-application/image.gif;jsessionid=123456789</code></li>
784 <li><code>/une-application/image.gif?PHPSESSIONID=12345678</code></li>
786 <p>Ceci implique la mise en cache des ressources séparément pour
787 chaque session, ce qui n'est en général pas souhaité. La directive
788 <code class="directive">CacheIgnoreURLSessionIdentifiers</code> permet de
789 définir une liste d'identifiants qui seront supprimés de la clé
790 utilisée pour identifier une entité dans le cache, de façon à ce que
791 les ressources ne soient pas stockées séparément pour chaque
794 <p><code>CacheIgnoreURLSessionIdentifiers None</code> vide la liste
795 des identifiants ignorés. Autrement, chaque identifiant spécifié est
796 ajouté à la liste.</p>
798 <div class="example"><h3>Exemple 1</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers jsessionid</pre>
801 <div class="example"><h3>Exemple 2</h3><pre class="prettyprint lang-config">CacheIgnoreURLSessionIdentifiers None</pre>
806 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
807 <div class="directive-section"><h2><a name="cachekeybaseurl" id="cachekeybaseurl">Directive</a> <a name="CacheKeyBaseURL" id="CacheKeyBaseURL">CacheKeyBaseURL</a></h2>
808 <table class="directive">
809 <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
811 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheKeyBaseURL <var>URL</var></code></td></tr>
812 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheKeyBaseURL http://example.com</code></td></tr>
813 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
814 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
815 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
816 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
818 <p>Lorsque la directive <code class="directive"><a href="#cachekeybaseurl">CacheKeyBaseURL</a></code> est utilisée, l'URL
819 spécifiée sera utilisée comme URL de base pour calculer l'URL des clés
820 du cache dans la configuration du mandataire inverse. Par défaut,
821 c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera
822 utilisé pour construire la clé de cache. Dans le cas d'un cluster de
823 machines, si toutes les entrées du cache doivent posséder la même clé,
824 cette directive permet de spécifier une nouvelle URL de base.</p>
826 <pre class="prettyprint lang-config"># Remplace l'URL de base de la clé de cache.
827 CacheKeyBaseURL http://www.example.com/</pre>
830 <div class="warning">Prenez garde en définissant cette directive. Si
831 deux serveurs virtuels distincts possèdent accidentellement la même
832 URL de base, les entrées en provenance d'un serveur virtuel seront
833 servies par l'autre.</div>
837 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
838 <div class="directive-section"><h2><a name="cachelastmodifiedfactor" id="cachelastmodifiedfactor">Directive</a> <a name="CacheLastModifiedFactor" id="CacheLastModifiedFactor">CacheLastModifiedFactor</a></h2>
839 <table class="directive">
840 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le facteur utilisé pour générer une date d'expiration en
841 fonction de la date de dernière modification.</td></tr>
842 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLastModifiedFactor <var>flottant</var></code></td></tr>
843 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLastModifiedFactor 0.1</code></td></tr>
844 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
845 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
846 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
848 <p>Si un document ne possède pas de date d'expiration, elle peut
849 être calculée en fonction de la date de dernière modification, si
850 elle existe. La directive
851 <code class="directive">CacheLastModifiedFactor</code> permet de spécifier
852 un <var>facteur</var> à utiliser pour la génération de cette date
853 d'expiration au sein de la formule suivante :
855 <code>délai-expiration = durée-depuis-date-dernière-modification *
857 date-expiration = date-courante + délai-expiration</code>
859 Par exemple, si la dernière modification du document date de 10
860 heures, et si <var>facteur</var> a pour valeur 0.1, le délai
861 d'expiration sera de 10*0.1 = 1 heure. Si l'heure courante est
862 3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =
865 Si le délai d'expiration est supérieur à celui spécifié par la
866 directive <code class="directive">CacheMaxExpire</code>, c'est ce dernier
869 <pre class="prettyprint lang-config">CacheLastModifiedFactor 0.5</pre>
873 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
874 <div class="directive-section"><h2><a name="cachelock" id="cachelock">Directive</a> <a name="CacheLock" id="CacheLock">CacheLock</a></h2>
875 <table class="directive">
876 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active la protection contre les tempêtes de requêtes.</td></tr>
877 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLock <var>on|off</var></code></td></tr>
878 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLock off</code></td></tr>
879 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
880 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
881 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
883 <p>La directive <code class="directive">CacheLock</code> active la protection
884 contre les tempêtes de requêtes pour l'espace d'adressage donné.</p>
886 <p>La configuration minimale pour activer le verrouillage contre les
887 tempêtes de requêtes dans le répertoire par
888 défaut des fichiers run-time est
891 <pre class="prettyprint lang-config"># Active le verrouillage du cache
895 <p>Les verrous sont des fichiers vides qui n'existent que pour les
896 URLs présentes dont le contenu est périmé ; ils consomment dont bien
897 moins de ressources que le cache disque traditionnel.</p>
901 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
902 <div class="directive-section"><h2><a name="cachelockmaxage" id="cachelockmaxage">Directive</a> <a name="CacheLockMaxAge" id="CacheLockMaxAge">CacheLockMaxAge</a></h2>
903 <table class="directive">
904 <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>
905 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockMaxAge <var>entier</var></code></td></tr>
906 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockMaxAge 5</code></td></tr>
907 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
908 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
909 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
911 <p>La directive <code class="directive">CacheLockMaxAge</code> permet de
912 spécifier la durée de vie maximale d'un verrou de cache.</p>
914 <p>Un verrou plus ancien que cette valeur exprimée en secondes sera
915 ignoré, et la prochaine requête entrante sera alors en mesure de
916 recréer le verrou. Ce mécanisme permet d'éviter les mises à jour trop
917 longues initiées par des clients lents.</p>
921 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
922 <div class="directive-section"><h2><a name="cachelockpath" id="cachelockpath">Directive</a> <a name="CacheLockPath" id="CacheLockPath">CacheLockPath</a></h2>
923 <table class="directive">
924 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit le répertoire des verrous.</td></tr>
925 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheLockPath <var>répertoire</var></code></td></tr>
926 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheLockPath mod_cache-lock</code></td></tr>
927 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
928 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
929 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
931 <p>La directive <code class="directive">CacheLockPath</code> permet de
932 spécifier le répertoire dans lequel les verrous sont
933 créés. Si <var>répertoire</var> n'est pas un
934 chemin absolu, il sera relatif au répertoire défini par la directive
935 <code class="directive"><a href="../mod/core.html#defaultruntimedir">DefaultRuntimeDir</a></code>.</p>
939 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
940 <div class="directive-section"><h2><a name="cachemaxexpire" id="cachemaxexpire">Directive</a> <a name="CacheMaxExpire" id="CacheMaxExpire">CacheMaxExpire</a></h2>
941 <table class="directive">
942 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée maximale en secondes de mise en cache d'un
944 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxExpire <var>secondes</var></code></td></tr>
945 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxExpire 86400 (une journée)</code></td></tr>
946 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
947 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
948 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
950 <p>La directive <code class="directive">CacheMaxExpire</code> permet de
951 spécifier le nombre maximum de secondes pendant lequel les documents
952 HTTP suceptibles d'être mis en cache seront conservés sans vérifier
953 leur contenu sur le serveur d'origine. Ce nombre de secondes
954 correspond donc à la durée maximale pendant laquelle un document ne
955 sera pas à jour. L'utilisation de cette valeur maximale est forcée,
956 même si le document possède une date d'expiration.</p>
958 <pre class="prettyprint lang-config">CacheMaxExpire 604800</pre>
963 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
964 <div class="directive-section"><h2><a name="cacheminexpire" id="cacheminexpire">Directive</a> <a name="CacheMinExpire" id="CacheMinExpire">CacheMinExpire</a></h2>
965 <table class="directive">
966 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale en secondes de mise en cache d'un
968 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinExpire <var>secondes</var></code></td></tr>
969 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinExpire 0</code></td></tr>
970 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
971 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
972 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
974 <p>La directive <code class="directive">CacheMaxExpire</code> permet de
975 spécifier le nombre maximum de secondes pendant lequel les documents
976 HTTP suceptibles d'être mis en cache seront conservés sans vérifier
977 leur contenu sur le serveur d'origine. Elle n'est prise en compte
978 que dans le cas où le document ne possède aucune date d'expiration
981 <pre class="prettyprint lang-config">CacheMinExpire 3600</pre>
985 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
986 <div class="directive-section"><h2><a name="cachequickhandler" id="cachequickhandler">Directive</a> <a name="CacheQuickHandler" id="CacheQuickHandler">CacheQuickHandler</a></h2>
987 <table class="directive">
988 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Exécute le cache à partir d'un gestionnaire rapide.</td></tr>
989 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheQuickHandler <var>on|off</var></code></td></tr>
990 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheQuickHandler on</code></td></tr>
991 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
992 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
993 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
994 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.3.3 du serveur HTTP
997 <p>La directive <code class="directive"><a href="#cachequickhandler">CacheQuickHandler</a></code> permet de contrôler
998 la phase au cours de laquelle la mise en cache est effectuée.</p>
1000 <p>Avec la configuration par défaut, le cache agit au cours de la
1001 phase du gestionnaire rapide. Cette phase court-circuite la majorité
1002 des traitements du serveur, et constitue le mode d'opération le plus
1003 performant pour un serveur typique. Le cache
1004 <strong>s'incruste</strong> devant le serveur, et la majorité des
1005 traitements du serveur est court-circuitée.</p>
1007 <p>Lorsque cette directive est définie à off, le cache agit comme un
1008 gestionnaire normal, et est concerné par toutes les phases de
1009 traitement d'une requête. Bien que ce mode soit moins performant que
1010 le mode par défaut, il permet d'utiliser le cache dans les cas où un
1011 traitement complet de la requête est nécessaire, comme par exemple
1012 lorsque le contenu est soumis à autorisation.</p>
1014 <pre class="prettyprint lang-config"># Exécute le cache comme un gestionnaire normal
1015 CacheQuickHandler off</pre>
1018 <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a
1019 aussi la possibilité de choisir avec précision le point de la chaîne
1020 de filtrage où la mise en cache sera effectuée, en utilisant le
1021 filtre <strong>CACHE</strong>.</p>
1023 <pre class="prettyprint lang-config"># Mise en cache du contenu avant l'intervention de mod_include et
1025 CacheQuickHandler off
1026 AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html</pre>
1029 <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière
1030 instance qui sera prise en compte.</p>
1034 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1035 <div class="directive-section"><h2><a name="cachestaleonerror" id="cachestaleonerror">Directive</a> <a name="CacheStaleOnError" id="CacheStaleOnError">CacheStaleOnError</a></h2>
1036 <table class="directive">
1037 <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>
1038 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStaleOnError <var>on|off</var></code></td></tr>
1039 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStaleOnError on</code></td></tr>
1040 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1041 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1042 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1043 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible depuis la version 2.3.9 d'Apache</td></tr>
1045 <p>Lorsque la directive <code class="directive"><a href="#cachestaleonerror">CacheStaleOnError</a></code> est définie à on, et
1046 si des données non mises à jour sont disponibles dans le cache, ce
1047 dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en
1048 provenance du serveur d'arrière-plan. Alors que l'en-tête
1049 Cache-Control envoyé par les clients sera respecté, et que les clients
1050 recevront donc dans ce cas la réponse 5xx brute à leur requête, cette
1051 réponse 5xx renvoyée au client n'invalidera pas le contenu dans le
1054 <pre class="prettyprint lang-config"># Sert des données non mises à jour en cas d'erreur.
1055 CacheStaleOnError on</pre>
1060 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1061 <div class="directive-section"><h2><a name="cachestoreexpired" id="cachestoreexpired">Directive</a> <a name="CacheStoreExpired" id="CacheStoreExpired">CacheStoreExpired</a></h2>
1062 <table class="directive">
1063 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les réponses que le serveur
1064 considère comme arrivées à expiration</td></tr>
1065 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreExpired On|Off</code></td></tr>
1066 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreExpired Off</code></td></tr>
1067 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1068 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1069 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1071 <p>Depuis la version 2.2.4, les réponses qui sont arrivées à
1072 expiration ne sont pas stockées dans le cache. La directive
1073 <code class="directive">CacheStoreExpired</code> permet de modifier ce
1074 comportement. Avec <code class="directive">CacheStoreExpired</code> On, le
1075 serveur tente de mettre en cache la ressource si elle est périmée.
1076 Les requêtes suivantes vont déclencher une requête si-modifié-depuis
1077 de la part du serveur d'origine, et la réponse sera renvoyée à
1078 partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p>
1080 <pre class="prettyprint lang-config">CacheStoreExpired On</pre>
1085 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1086 <div class="directive-section"><h2><a name="cachestorenostore" id="cachestorenostore">Directive</a> <a name="CacheStoreNoStore" id="CacheStoreNoStore">CacheStoreNoStore</a></h2>
1087 <table class="directive">
1088 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache les requêtes ou réponses dont
1089 l'entête Cache-Control: a pour valeur no-store.</td></tr>
1090 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStoreNoStore On|Off</code></td></tr>
1091 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStoreNoStore Off</code></td></tr>
1092 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1093 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1094 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1096 <p>Normalement, les requêtes ou réponses dont l'en-tête
1097 Cache-Control: a pour valeur no-store ne sont pas stockées dans le
1098 cache. La directive <code class="directive">CacheStoreNoStore</code> permet
1099 de modifier ce comportement. Si
1100 <code class="directive">CacheStoreNoStore</code> est définie à On, le
1101 serveur tente de mettre la ressource en cache même si elle contient
1102 un en-tête no-store.</p>
1105 <pre class="prettyprint lang-config">CacheStoreNoStore On</pre>
1109 <div class="warning"><h3>Avertissement :</h3>
1110 Selon la RFC 2616, la valeur d'en-tête no-store est censée
1111 "prévenir la suppression ou la rétention par inadvertance
1112 d'informations sensibles (par exemple, sur des bandes de
1113 sauvegarde)". Autrement dit, l'activation de la directive
1114 <code class="directive">CacheStoreNoCache</code> pourrait provoquer le
1115 stockage d'informations sensibles dans le cache. Vous avez donc
1121 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
1122 <li><code class="directive"><a href="#cachestoreprivate">CacheStorePrivate</a></code></li>
1125 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1126 <div class="directive-section"><h2><a name="cachestoreprivate" id="cachestoreprivate">Directive</a> <a name="CacheStorePrivate" id="CacheStorePrivate">CacheStorePrivate</a></h2>
1127 <table class="directive">
1128 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Tente de mettre en cache des réponses que le serveur a
1129 marquées comme privées</td></tr>
1130 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheStorePrivate On|Off</code></td></tr>
1131 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheStorePrivate Off</code></td></tr>
1132 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
1133 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
1134 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache</td></tr>
1136 <p>Normalement, les réponse comportant un en-tête Cache-Control:
1137 dont la valeur est private ne seront pas stockées dans le cache. La
1138 directive <code class="directive">CacheStorePrivate</code> permet de
1139 modifier ce comportement. Si
1140 <code class="directive">CacheStorePrivate</code> est définie à On, le
1141 serveur tentera de mettre la ressource en cache, même si elle
1142 contient un en-tête private.</p>
1145 <pre class="prettyprint lang-config">CacheStorePrivate On</pre>
1149 <div class="warning"><h3>Avertissement :</h3>
1150 Cette directive autorise la mise en cache même si le serveur
1151 indique que la ressource ne doit pas être mise en cache. Elle
1152 n'est de ce fait appropriée que dans le cas d'un cache
1158 <li><code class="directive"><a href="#cacheignorecachecontrol">CacheIgnoreCacheControl</a></code></li>
1159 <li><code class="directive"><a href="#cachestorenostore">CacheStoreNoStore</a></code></li>
1163 <div class="bottomlang">
1164 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache.html" hreflang="en" rel="alternate" title="English"> en </a> |
1165 <a href="../fr/mod/mod_cache.html" title="Français"> fr </a> |
1166 <a href="../ja/mod/mod_cache.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
1167 <a href="../ko/mod/mod_cache.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
1168 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
1169 <script type="text/javascript"><!--//--><![CDATA[//><!--
1170 var comments_shortname = 'httpd';
1171 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache.html';
1173 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
1174 d.write('<div id="comments_thread"><\/div>');
1175 var s = d.createElement('script');
1176 s.type = 'text/javascript';
1178 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
1179 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
1182 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
1184 })(window, document);
1185 //--><!]]></script></div><div id="footer">
1186 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
1187 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
1188 if (typeof(prettyPrint) !== 'undefined') {