]> granicus.if.org Git - apache/blob - docs/manual/caching.xml.fr
Updates.
[apache] / docs / manual / caching.xml.fr
1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="style/manual.fr.xsl"?>
4 <!-- French translation : Lucien GENTIS -->
5 <!-- Reviewed by : Vincent Deffontaines -->
6 <!-- English Revision : 1291840 -->
7
8 <!--
9  Licensed to the Apache Software Foundation (ASF) under one or more
10  contributor license agreements.  See the NOTICE file distributed with
11  this work for additional information regarding copyright ownership.
12  The ASF licenses this file to You under the Apache License, Version 2.0
13  (the "License"); you may not use this file except in compliance with
14  the License.  You may obtain a copy of the License at
15
16      http://www.apache.org/licenses/LICENSE-2.0
17
18  Unless required by applicable law or agreed to in writing, software
19  distributed under the License is distributed on an "AS IS" BASIS,
20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21  See the License for the specific language governing permissions and
22  limitations under the License.
23 -->
24
25 <manualpage metafile="caching.xml.meta">
26
27   <title>Guide de la mise en cache</title>
28
29   <summary>
30     <p>Ce document compl&egrave;te la documentation de r&eacute;f&eacute;rence des modules
31     <module>mod_cache</module>, <module>mod_cache_disk</module>,
32     <module>mod_file_cache</module> et du programme <a
33     href="programs/htcacheclean.html">htcacheclean</a>.
34     Il d&eacute;crit l'utilisation des fonctionnalit&eacute;s de mise en
35     cache du serveur HTTP Apache
36     pour acc&eacute;l&eacute;rer les services web et proxy, tout en &eacute;vitant les probl&egrave;mes
37     courants et les erreurs de configuration.</p>
38   </summary>
39
40   <section id="introduction">
41     <title>Introduction</title>
42
43     <p>Le serveur HTTP Apache offre tout un ensemble de fonctionnalit&eacute;s
44     de mise en cache qui ont &eacute;t&eacute; con&ccedil;ues pour am&eacute;liorer les performances
45     du serveur de diff&eacute;rentes mani&egrave;res.</p>
46
47     <dl>
48         <dt>Mise en cache HTTP &agrave; trois &eacute;tats RFC2616</dt>
49         <dd><module>mod_cache</module> et son module de fournisseur
50         <module>mod_cache_disk</module> proposent une mise en cache
51         intelligente de niveau HTTP. Le contenu proprement dit est
52         stock&eacute; dans le cache, et mod_cache vise &agrave; respecter tous les
53         en-t&ecirc;tes HTTP, ainsi que les options qui contr&ocirc;lent la mise en
54         cache du contenu comme d&eacute;crit dans la <a
55         href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
56         13 de la RFC2616</a>. <module>mod_cache</module> peut g&eacute;rer des
57         configurations de mise en cache simples, mais aussi complexes
58         comme dans les cas o&ugrave; vous avez &agrave; faire &agrave; des contenus mandat&eacute;s,
59         &agrave; des contenus locaux dynamiques, ou lorsque vous avez besoin
60         d'acc&eacute;l&eacute;rer l'acc&egrave;s aux fichiers locaux situ&eacute;s sur disque
61         suppos&eacute; lent.
62         </dd>
63
64         <dt>Mise en cache d'objets partag&eacute;s de forme cl&eacute;/valeur &agrave; deux
65         &eacute;tats</dt>
66         <dd>
67             L'<a href="socache.html">API du cache d'objets partag&eacute;s</a> (socache)
68             et ses modules de fournisseurs
69             proposent une mise en cache d'objets partag&eacute;s &agrave; base de
70             couples cl&eacute;/valeur de niveau serveur. Ces modules sont
71             con&ccedil;us pour la mise en cache de donn&eacute;es de bas niveau comme
72             les sessions SSL et les donn&eacute;es d'authentification. les
73             serveurs d'arri&egrave;re-plan permettent le stockage des donn&eacute;es
74             au niveau serveur en m&eacute;moire partag&eacute;e, ou au niveau
75             datacenter dans un cache comme memcache ou distcache.
76         </dd>
77
78         <dt>Mise en cache de fichiers sp&eacute;cialis&eacute;e</dt>
79         <dd>
80             <module>mod_file_cache</module> offre la possibilit&eacute; de
81             pr&eacute;charger des fichiers en m&eacute;moire au d&eacute;marrage du serveur,
82             et peut am&eacute;liorer les temps d'acc&egrave;s et sauvegarder les
83             gestionnaires de fichiers pour les fichiers qui font l'objet
84             d'acc&egrave;s fr&eacute;quents, &eacute;vitant ainsi d'avoir &agrave; acc&eacute;der au disque
85             &agrave; chaque requ&ecirc;te.
86         </dd>
87     </dl>
88
89     <p>Pour tirer parti efficacement de ce document, les bases de HTTP doivent
90     vous &ecirc;tre famili&egrave;res, et vous devez avoir lu les sections
91     <a href="urlmapping.html">Mise en correspondance des
92     URLs avec le syst&egrave;me de fichiers</a> et
93     <a href="content-negotiation.html">N&eacute;gociation sur le contenu</a>
94     du guide de l'utilisateur.</p>
95
96   </section>
97
98   <section id="http-caching">
99
100     <title>Mise en cache HTTP &agrave; trois &eacute;tats RFC2616</title>
101
102     <related>
103       <modulelist>
104         <module>mod_cache</module>
105         <module>mod_cache_disk</module>
106       </modulelist>
107       <directivelist>
108         <directive module="mod_cache">CacheEnable</directive>
109         <directive module="mod_cache">CacheDisable</directive>
110         <directive module="core">UseCanonicalName</directive>
111         <directive module="mod_negotiation">CacheNegotiatedDocs</directive>
112       </directivelist>
113     </related>
114
115     <p>Le module <module>mod_cache</module> permet de tirer avantage du
116     m&eacute;canisme de mise en cache en ligne faisant partie
117     int&eacute;grante du protocole HTTP, et d&eacute;crit dans la <a
118     href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">section
119     13 de la RFC2616</a>.</p>
120
121     <p>A la diff&eacute;rence d'un cache simple cl&eacute;/valeur &agrave; deux &eacute;tats o&ugrave; le
122     contenu est supprim&eacute; lorsqu'il est p&eacute;rim&eacute;, un cache HTTP comporte un
123     m&eacute;canisme permettant de conserver temporairement un contenu p&eacute;rim&eacute;,
124     de demander au serveur original si ce contenu p&eacute;rim&eacute; a &eacute;t&eacute; modifi&eacute;,
125     et dans le cas contraire de le rendre &agrave; nouveau valide.</p>
126
127     <p>Une entr&eacute;e d'un cache HTTP peut se pr&eacute;senter sous un de ces trois
128     &eacute;tats :</p>
129
130     <dl>
131     <dt>Frais</dt>
132     <dd>
133         Si un contenu est suffisamment r&eacute;cent (plus jeune que sa
134         <strong>dur&eacute;e de fra&icirc;cheur</strong>), il est consid&eacute;r&eacute; comme
135         <strong>frais</strong>. Un cache HTTP peut servir un contenu
136         frais sans avoir &agrave; demander quoi que ce soit au serveur
137         d'origine.
138     </dd>
139     <dt>P&eacute;rim&eacute;</dt>
140     <dd>
141         <p>Si le contenu est trop ancien (plus vieux que sa
142         <strong>dur&eacute;e de fra&icirc;cheur</strong>), il est consid&eacute;r&eacute; comme
143         <strong>p&eacute;rim&eacute;</strong>. Un cache HTTP doit contacter le serveur
144         original pour v&eacute;rifier si le contenu, m&ecirc;me s'il est p&eacute;rim&eacute;, est
145         encore &agrave; jour avant de le servir au client. Soit le serveur
146         original va r&eacute;pondre en envoyant un contenu de remplacement si
147         le contenu p&eacute;rim&eacute; n'est plus &agrave; jour, soit dans le cas id&eacute;al il
148         renverra un code pour signaler au cache que le contenu est
149         encore &agrave; jour, et qu'il est inutile de le g&eacute;n&eacute;rer ou de
150         l'envoyer &agrave; nouveau. Le contenu repasse &agrave; l'&eacute;tat "frais" et le
151         cycle continue.</p>
152
153         <p>Le protocole HTTP permet au cache de servir des donn&eacute;es
154         p&eacute;rim&eacute;es dans certaines circonstances, comme lorsqu'une
155         tentative de rafra&icirc;chir une entr&eacute;e depuis un serveur original
156         se solde par un &eacute;chec avec un code d'erreur 5xx, ou lorsqu'une
157         autre requ&ecirc;te est d&eacute;j&agrave; en train d'essayer de rafra&icirc;chir la m&ecirc;me
158         entr&eacute;e. Dans ces cas, un en-t&ecirc;te <code>Warning</code> est ajout&eacute;
159         &agrave; la r&eacute;ponse.</p>
160     </dd>
161     <dt>Non Existent</dt>
162     <dd>
163         Si le cache est plein, il se r&eacute;serve la possibilit&eacute; de supprimer
164         des entr&eacute;es pour faire de la place. Une entr&eacute;e peut &ecirc;tre
165         supprim&eacute;e &agrave; tout moment, qu'elle soit fra&icirc;che ou p&eacute;rim&eacute;e.
166         L'outil <a href="programs/htcacheclean.html">htcacheclean</a>
167         peut &ecirc;tre utilis&eacute; &agrave; la demande, ou lanc&eacute; en tant que d&eacute;mon afin
168         de conserver la taille du cache ou le nombre d'inodes en de&ccedil;&agrave; de
169         valeurs sp&eacute;cifi&eacute;es. Cet outil essaie cependant de
170         supprimer les entr&eacute;es p&eacute;rim&eacute;es avant les entr&eacute;es fra&icirc;ches.
171     </dd>
172     </dl>
173
174     <p>Le fonctionnement d&eacute;taill&eacute; d'un cache HTTP est d&eacute;crit dans la <a
175     href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html">Section
176     13 de la RFC2616</a>.</p>
177
178     <section>
179       <title>Interaction avec le serveur</title>
180
181       <p>Le module <module>mod_cache</module> interagit avec le serveur
182       &agrave; deux niveaux possibles en fonction de la directive <directive
183       module="mod_cache">CacheQuickHandler</directive> :
184       </p>
185
186       <dl>
187         <dt>Phase du gestionnaire rapide</dt>
188         <dd>
189           <p>Cette phase se d&eacute;roule tr&egrave;s t&ocirc;t au cours du traitement de
190           la requ&ecirc;te, juste apr&egrave;s l'interpr&eacute;tation de cette derni&egrave;re. Si
191           le contenu se trouve dans le cache, il est servi imm&eacute;diatement
192           et pratiquement tout le reste du traitement de la requ&ecirc;te est
193           court-circuit&eacute;.</p>
194
195               <p>Dans ce sc&eacute;nario, le cache se comporte comme s'il avait
196               &eacute;t&eacute; "boulonn&eacute;" &agrave; l'entr&eacute;e du serveur.</p>
197               
198               <p>Ce mode poss&egrave;de les meilleures performances car la
199               majorit&eacute; des traitements au niveau du serveur sont
200               court-circuit&eacute;s. Cependant, il court-circuite aussi les
201               phases d'authentification et d'autorisation du traitement
202               au niveau du serveur, et il doit donc &ecirc;tre utilis&eacute; avec
203               prudence lorsque que ces phases sont importantes.</p>
204           </dd>
205           <dt>Phase du gestionnaire normal</dt>
206           <dd>
207               <p>Cette phase se d&eacute;roule tr&egrave;s tard au cours du traitement
208               de la requ&ecirc;te, en fait apr&egrave;s toutes les phases de ce
209               traitement.</p>
210
211               <p>Dans ce sc&eacute;nario, le cache se comporte comme s'il avait
212               &eacute;t&eacute; "boulonn&eacute;" &agrave; la sortie du serveur.</p>
213
214               <p>Ce mode offre la plus grande souplesse, car il permet
215               de faire intervenir la mise en cache en un point
216               pr&eacute;cis&eacute;ment sp&eacute;cifi&eacute; de la cha&icirc;ne de filtrage, et le
217               contenu issu du cache peut &ecirc;tre filtr&eacute; ou personnalis&eacute;
218               avant d'&ecirc;tre servi au client.</p>
219           </dd>
220         </dl>
221
222         <p>Si l'URL ne se trouve pas dans le cache,
223         <module>mod_cache</module> ajoutera un <a
224         href="filter.html">filtre</a> &agrave; la cha&icirc;ne de filtrage afin
225         d'enregistrer la r&eacute;ponse dans le cache, puis passera la main
226         pour permettre le d&eacute;roulement normal de la suite du traitement
227         de la requ&ecirc;te. Si la mise en cache du contenu est autoris&eacute;e, il
228         sera enregistr&eacute; dans le cache pour pouvoir &ecirc;tre servi &agrave; nouveau
229         ; dans le cas contraire, le contenu sera ignor&eacute;.</p>
230
231         <p>Si le contenu trouv&eacute; dans le cache est p&eacute;rim&eacute;, le module
232         <module>mod_cache</module> convertit la requ&ecirc;te en
233         <strong>requ&ecirc;te conditionnelle</strong>. Si le serveur original
234         renvoie une r&eacute;ponse normale, elle est enregistr&eacute;e dans le cache
235         en lieu et place du contenu p&eacute;rim&eacute;. Si le serveur original
236         renvoie une r&eacute;ponse "304 Not Modified", le contenu repasse &agrave;
237         l'&eacute;tat "frais" et est servi par le filtre au lieu d'&ecirc;tre
238         sauvegard&eacute;.</p>
239     </section>
240
241     <section>
242       <title>Am&eacute;lioration du taux de pr&eacute;sence dans le cache</title>
243
244       <p>Lorsqu'un serveur virtuel est connu sous la forme d'un des
245       nombreux alias du serveur, la d&eacute;finition de la directive
246       <directive module="core">UseCanonicalName</directive> &agrave;
247       <code>On</code> peut augmenter de mani&egrave;re significative le nombre
248       de correspondances positives dans le cache. Ceci est du au fait
249       que la cl&eacute; du cache contient le nom d'h&ocirc;te du serveur virtuel.     
250       Avec <directive module="core">UseCanonicalName</directive> positionn&eacute;e
251       &agrave; <code>On</code>,
252       les h&ocirc;tes virtuels poss&eacute;dant plusieurs noms de serveur ou alias ne
253       g&eacute;n&eacute;reront pas d'entit&eacute;s de cache diff&eacute;rentes, et le contenu sera mis en
254       cache en faisant r&eacute;f&eacute;rence au nom d'h&ocirc;te canonique.</p>
255
256     </section>
257
258     <section>
259       <title>Dur&eacute;e de fra&icirc;cheur</title>
260
261        <p>Un contenu bien form&eacute; destin&eacute; &agrave; &ecirc;tre mis en cache doit d&eacute;clarer
262        explicitement une dur&eacute;e de fra&icirc;cheur via les champs
263        <code>max-age</code> ou <code>s-maxage</code> de l'en-t&ecirc;te
264        <code>Cache-Control</code>, ou en incluant un en-t&ecirc;te
265        <code>Expires</code>.</p>
266       
267       <p>De plus, un client peut passer outre la dur&eacute;e de fra&icirc;cheur
268       d&eacute;finie pour le serveur original en ajoutant son propre en-t&ecirc;te
269       <code>Cache-Control</code> &agrave; la requ&ecirc;te. Dans ce cas, c'est la
270       dur&eacute;e de fra&icirc;cheur la plus basse entre la requ&ecirc;te et la r&eacute;ponse
271       qui l'emporte.</p>
272
273       <p>Lorsque cette dur&eacute;e de fra&icirc;cheur est absente de la requ&ecirc;te ou
274       de la r&eacute;ponse, une dur&eacute;e de fra&icirc;cheur par d&eacute;faut s'applique. La
275       dur&eacute;e de fra&icirc;cheur par d&eacute;faut des entr&eacute;es du cache est d'une heure
276       ; elle peut cependant &ecirc;tre facilement modifi&eacute;e &agrave; l'aide de
277       la directive <directive
278       module="mod_cache">CacheDefaultExpire</directive>.</p>
279
280       <p>Si une r&eacute;ponse ne contient pas d'en-t&ecirc;te <code>Expires</code> mais
281       inclut un en-t&ecirc;te <code>Last-Modified</code>, <module>mod_cache</module>
282       peut d&eacute;duire une dur&eacute;e de fra&icirc;cheur en se basant sur une
283       heuristique, qui peut &ecirc;tre contr&ocirc;l&eacute;e via la directive <directive
284       module="mod_cache">CacheLastModifiedFactor</directive>.</p>
285
286       <p>Pour les contenus locaux, ou les contenus distants qui ne
287       sp&eacute;cifient pas leur propre en-t&ecirc;te <code>Expires</code>,
288       <module>mod_expires</module> permet de r&eacute;gler finement la dur&eacute;e de
289       fra&icirc;cheur via les param&egrave;tres <code>max-age</code> et
290       <code>Expires</code>.</p>
291
292       <p>On peut aussi contr&ocirc;ler la dur&eacute;e de fra&icirc;cheur maximale en utilisant
293       la directive <directive module="mod_cache">CacheMaxExpire</directive>.</p>
294
295     </section>
296
297     <section>
298       <title>Guide succinct des requ&ecirc;tes conditionnelles</title>
299
300      <p>Lorsqu'un contenu du cache est p&eacute;rim&eacute;, httpd modifie la requ&ecirc;te
301      pour en faire une requ&ecirc;te conditionnelle</p>
302
303       <p>Lorsque la r&eacute;ponse originale du cache contient un en-t&ecirc;te
304       <code>ETag</code>, <module>mod_cache</module> ajoute un en-t&ecirc;te
305       <code>If-None-Match</code> &agrave; la requ&ecirc;te envoy&eacute;e au serveur
306       d'origine. Lorsque la r&eacute;ponse originale du cache contient un en-t&ecirc;te
307       <code>Last-Modified</code>, <module>mod_cache</module> ajoute un en-t&ecirc;te
308       <code>If-Modified-Since</code> &agrave; la requ&ecirc;te envoy&eacute;e au serveur
309       d'origine. Dans ces deux cas, la requ&ecirc;te devient une requ&ecirc;te
310       <strong>conditionnelle</strong>.</p>
311
312       <p>Lorsqu'un serveur d'origine re&ccedil;oit une requ&ecirc;te conditionnelle,
313       il v&eacute;rifie si le param&egrave;tre Etag ou Last-Modified a &eacute;t&eacute; modifi&eacute; en
314       fonction des param&egrave;tres de la requ&ecirc;te. Si ce n'est pas le cas, il
315       r&eacute;pondra avec le message lapidaire "304 Not Modified". Ceci
316       informe le cache que le contenu est p&eacute;rim&eacute; mais encore &agrave; jour, et
317       peut &ecirc;tre utilis&eacute; tel quel pour les prochaines requ&ecirc;tes jusqu'&agrave; ce
318       qu'il atteigne &agrave; nouveau sa date de p&eacute;remption.</p>
319
320       <p>Si le contenu a &eacute;t&eacute; modifi&eacute;, il est servi comme s'il s'agissait
321       d'une requ&ecirc;te normale et non conditionnelle.</p>
322
323       <p>Les requ&ecirc;tes conditionnelles offrent deux avantages. D'une
324       part, il est facile de d&eacute;terminer si le contenu du serveur
325       d'origine correspond &agrave; celui situ&eacute;
326       dans le cache, et ainsi d'&eacute;conomiser la consommation de ressources
327       n&eacute;cessaire au transfert du contenu dans son ensemble.</p>
328
329       <p>D'autre part, un serveur d'origine bien con&ccedil;u sera configur&eacute; de
330       telle mani&egrave;re que les requ&ecirc;tes conditionnelles n&eacute;cessitent pour
331       leur production bien moins de ressources qu'une r&eacute;ponse compl&egrave;te.
332       Dans le cas des fichiers statiques, il suffit en g&eacute;n&eacute;ral d'un
333       appel syst&egrave;me de type <code>stat()</code> ou similaire pour
334       d&eacute;terminer si la taille ou la date de modification du fichier a
335       &eacute;t&eacute; modifi&eacute;e. Ainsi, m&ecirc;me un contenu local pourra &ecirc;tre servi plus
336       rapidement depuis le cache s'il n'a pas &eacute;t&eacute; modifi&eacute;.</p>
337       
338       <p>Il serait souhaitable que tous les serveurs d'origine
339       supportent les requ&ecirc;tes conditionnelles, car dans le cas
340       contraire, ils r&eacute;pondent comme s'il s'agissait d'une requ&ecirc;te
341       normale, et le cache r&eacute;pond comme si le contenu avait &eacute;t&eacute;
342       modifi&eacute; et enregistre ce dernier. Le cache se comporte alors
343       comme un simple cache &agrave; deux &eacute;tat, o&ugrave; le contenu est servi s'il
344       est &agrave; jour, ou supprim&eacute; dans le cas contraire.</p>
345     </section>
346
347     <section>
348       <title>Que peut-on mettre en cache ?</title>
349
350       <p>La liste compl&egrave;te des conditions n&eacute;cessaires pour qu'une
351       r&eacute;ponse puisse &ecirc;tre enregistr&eacute;e dans un cache HTTP est fournie
352       dans la <a
353       href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec13.html#sec13.4">section
354       13.4 Response Cacheability de la RFC2616</a>, et peut se r&eacute;sumer
355       ainsi :</p>
356
357       <ol>
358         <li>La mise en cache doit &ecirc;tre activ&eacute;e pour cette URL. Voir les
359         directives <directive
360         module="mod_cache">CacheEnable</directive> et <directive
361         module="mod_cache">CacheDisable</directive>.</li>
362
363         <li>La reponse doit avoir un code de statut HTTP de 200, 203, 300, 301
364         ou 410.</li>
365
366         <li>La requ&ecirc;te doit &ecirc;tre de type HTTP GET.</li>
367
368         <li>Si la r&eacute;ponse contient un en-t&ecirc;te "Authorization:", elle doit aussi
369         contenir une option "s-maxage", "must-revalidate" ou "public"
370         dans l'en-t&ecirc;te "Cache-Control:".</li>
371
372         <li>Si l'URL contient une cha&icirc;ne de requ&ecirc;te
373         (provenant par exemple d'une m&eacute;thode GET de formulaire HTML), elle ne
374         sera pas mise en cache, &agrave; moins que la r&eacute;ponse ne
375         sp&eacute;cifie explicitement un d&eacute;lai d'expiration via un
376         en-t&ecirc;te "Expires:" ou une directive max-age ou s-maxage de
377         l'en-t&ecirc;te "Cache-Control:" comme indiqu&eacute; dans les
378         sections 13.2.1. et 13.9 de la RFC2616.</li>
379
380         <li>Si la r&eacute;ponse a un statut de 200 (OK), elle doit aussi contenir
381         au moins un des en-t&ecirc;tes "Etag", "Last-Modified" ou
382         "Expires", ou une directive max-age ou s-maxage de
383         l'en-t&ecirc;te "Cache-Control:", &agrave; moins que la directive
384         <directive module="mod_cache">CacheIgnoreNoLastMod</directive>
385         ne pr&eacute;cise d'autres contraintes.</li>
386
387         <li>Si la r&eacute;ponse contient l'option "private" dans un en-t&ecirc;te
388         "Cache-Control:", elle ne sera pas mise en cache &agrave; moins que la
389         directive
390         <directive module="mod_cache">CacheStorePrivate</directive>
391         ne pr&eacute;cise d'autres contraintes.</li>
392
393         <li>De m&ecirc;me, si la r&eacute;ponse contient l'option "no-store" dans un en-t&ecirc;te
394         "Cache-Control:", elle ne sera pas mise en cache &agrave; moins que la
395         directive
396         <directive module="mod_cache">CacheStoreNoStore</directive>
397         n'ait &eacute;t&eacute; utilis&eacute;e.</li>
398
399         <li>Une r&eacute;ponse ne sera pas mise en cache si elle comporte un en-t&ecirc;te
400         "Vary:" contenant le caract&egrave;re "*" qui correspond &agrave; toute
401         cha&icirc;ne de caract&egrave;res.</li>
402       </ol>
403     </section>
404
405     <section>
406       <title>Qu'est ce qui ne doit pas &ecirc;tre mis en cache ?</title>
407
408       <p>Le client qui cr&eacute;e la requ&ecirc;te ou le serveur d'origine qui
409       g&eacute;n&egrave;re la r&eacute;ponse doit &ecirc;tre &agrave; m&ecirc;me de d&eacute;terminer si le contenu
410       doit pouvoir &ecirc;tre mis en cache ou non en d&eacute;finissant correctement
411       l'en-t&ecirc;te <code>Cache-Control</code>, et
412       <module>mod_cache</module> sera alors en mesure de satisfaire les
413       souhaits du client ou du serveur de mani&egrave;re appropri&eacute;e.
414       </p>
415
416       <p>Les contenus qui varient au cours du temps, ou en fonction de
417       particularit&eacute;s de la requ&ecirc;te non prises en compte par la
418       n&eacute;gociation HTTP ne doivent pas &ecirc;tre mis en cache. Ce type de
419       contenu doit se d&eacute;clarer lui-m&ecirc;me "&agrave; ne pas mettre en cache" via
420       l'en-t&ecirc;te <code>Cache-Control</code>.</p>
421       
422       <p>Si le contenu change souvent, suite par exemple &agrave; une dur&eacute;e de
423       fra&icirc;cheur de l'ordre de la minute ou de la seconde, il peut tout
424       de m&ecirc;me &ecirc;tre mis en cache, mais il est alors fortement souhaitable
425       que le serveur d'origine supporte correctement les
426       <strong>requ&ecirc;tes conditionnelles</strong> afin que des r&eacute;ponses
427       compl&egrave;tes ne soient pas syst&eacute;matiquement g&eacute;n&eacute;r&eacute;es.</p>
428
429       <p>Un contenu qui varie en fonction d'en-t&ecirc;tes de requ&ecirc;te fournis
430       par le client peut &ecirc;tre mis en cache, sous r&eacute;serve d'une
431       utilisation appropri&eacute;e de l'en-t&ecirc;te de r&eacute;ponse <code>Vary</code>.</p>
432     </section>
433
434     <section>
435       <title>Contenu variable et/ou n&eacute;goci&eacute;</title>
436
437       <p>Lorsque le serveur d'origine est configur&eacute; pour servir des
438       contenus diff&eacute;rents en fonction de la valeur de certains en-t&ecirc;tes
439       de la requ&ecirc;te, par exemple pour servir une ressource en plusieurs
440       langages &agrave; partir d'une seule URL, le m&eacute;canisme de mise en cache
441       d'HTTP permet de mettre en cache plusieurs variantes de la m&ecirc;me
442       page &agrave; partir d'une seule URL.</p>
443       
444       <p>Pour y parvenir, le serveur d'origine ajoute un en-t&ecirc;te
445       <code>Vary</code> pour indiquer quels en-t&ecirc;tes doivent &ecirc;tre pris
446       en compte par un cache pour d&eacute;terminer si deux variantes sont
447       diff&eacute;rentes l'une de l'autre.</p>
448
449       <p>Si par exemple, une r&eacute;ponse est re&ccedil;ue avec l'en-t&ecirc;te Vary suivant,</p>
450
451       <example>
452 Vary: negotiate,accept-language,accept-charset
453       </example>
454
455       <p><module>mod_cache</module> ne servira aux demandeurs que le contenu
456       mis en cache qui correspond au contenu des en-t&ecirc;tes accept-language et
457       accept-charset de la requ&ecirc;te originale.</p>
458
459       <p>Plusieurs variantes d'un contenu peuvent &ecirc;tre mises en cache
460       simultan&eacute;ment ; <module>mod_cache</module> utilise l'en-t&ecirc;te
461       <code>Vary</code> et les valeurs correspondantes des en-t&ecirc;tes de
462       la requ&ecirc;te sp&eacute;cifi&eacute;s dans ce dernier pour
463       d&eacute;terminer quelle variante doit &ecirc;tre servie au client.</p>
464           
465     </section>
466
467     <section id="disk">
468       <title>Mise en cache sur disque</title>
469
470       <p>Le module <module>mod_cache</module> s'appuie sur des
471       impl&eacute;mentations de stockage en arri&egrave;re-plan sp&eacute;cifiques pour g&eacute;rer
472       le cache ; &agrave; ce titre, <module>mod_cache_disk</module> fournit le
473       support de la mise en cache sur disque.</p>
474
475       <p>En g&eacute;n&eacute;ral, le module se configure comme suit :</p>
476
477       <example>    
478 CacheRoot   /var/cache/apache/<br />
479 CacheEnable disk /<br />
480 CacheDirLevels 2<br />
481 CacheDirLength 1
482     </example>
483
484     <p>Il est important de savoir que, les fichiers mis en cache &eacute;tant stock&eacute;s
485     localement, la mise en cache par l'interm&eacute;diaire du syst&egrave;me d'exploitation
486     sera en g&eacute;n&eacute;ral aussi appliqu&eacute;e &agrave; leurs acc&egrave;s. Si bien que m&ecirc;me si les
487     fichiers sont stock&eacute;s sur disque, s'il font l'objet d'acc&egrave;s fr&eacute;quents,
488     il est probable que le syst&egrave;me d'exploitation s'appliquera &agrave; ce qu'ils
489     soient servis &agrave; partir de la m&eacute;moire.</p>
490
491     </section>
492
493     <section>
494       <title>Comprendre le stockage dans le cache</title>
495
496       <p>Pour stocker des entit&eacute;s dans le cache,
497       le module <module>mod_cache_disk</module> cr&eacute;e une empreinte (hash) de 22
498       caract&egrave;res de l'URL qui a fait l'objet d'une requ&ecirc;te. Cette empreinte
499       comprend le nom d'h&ocirc;te, le protocole, le port, le chemin et tout argument
500       de type CGI associ&eacute; &agrave; l'URL, ainsi que les &eacute;l&eacute;ments
501       sp&eacute;cifi&eacute;s dans l'en-t&ecirc;te Vary afin d'&ecirc;tre sur que plusieurs URLs
502       n'interf&egrave;rent pas entre elles.</p>
503
504       <p>Chaque position de l'empreinte peut contenir un caract&egrave;re
505       choisi parmi 64 caract&egrave;res diff&eacute;rents, il y a donc
506       64^22 possibilit&eacute;s pour une empreinte. Par exemple, une URL peut poss&eacute;der
507       l'empreinte <code>xyTGxSMO2b68mBCykqkp1w</code>. Cette empreinte est
508       utilis&eacute;e pour pr&eacute;fixer les noms de fichiers sp&eacute;cifiques &agrave; cette URL &agrave;
509       l'int&eacute;rieur du cache; cependant, elle est tout d'abord plac&eacute;e dans les
510       r&eacute;pertoires du cache selon les directives
511       <directive module="mod_cache_disk">CacheDirLevels</directive> et
512       <directive module="mod_cache_disk">CacheDirLength</directive>.</p>
513
514       <p>La directive
515       <directive module="mod_cache_disk">CacheDirLevels</directive>
516       d&eacute;finit le nombre de niveaux de sous-r&eacute;pertoires, et
517       <directive module="mod_cache_disk">CacheDirLength</directive>
518       le nombre de caract&egrave;res composant le nom des sous-r&eacute;pertoires. Dans
519       l'exemple donn&eacute; plus haut, l'empreinte se trouvera &agrave; :
520       <code>/var/cache/apache/x/y/TGxSMO2b68mBCykqkp1w</code>.</p>
521
522       <p>Cette technique a pour but principal de r&eacute;duire le nombre de
523       sous-r&eacute;pertoires ou de fichiers contenus dans un r&eacute;pertoire particulier,
524       car le fonctionnement de la plupart des syst&egrave;mes de fichiers est ralenti
525       quand ce nombre augmente. Avec la valeur "1" pour la directive
526       <directive module="mod_cache_disk">CacheDirLength</directive>,
527       il peut y avoir au plus 64 sous-r&eacute;pertoires &agrave; un niveau quelconque.
528       Avec la valeur "2", il peut y en avoir 64 * 64, etc...
529       A moins d'avoir une bonne raison pour ne pas le faire, l'utilisation de
530       la valeur "1" pour la directive
531       <directive module="mod_cache_disk">CacheDirLength</directive>
532       est recommand&eacute;e.</p>
533
534       <p>Le param&eacute;trage de la directive
535       <directive module="mod_cache_disk">CacheDirLevels</directive>
536       d&eacute;pend du nombre de fichiers que vous pensez stocker dans le cache.
537       Avec une valeur de "2" comme dans l'exemple donn&eacute; plus haut,
538       4096 sous-r&eacute;pertoires peuvent &ecirc;tre cr&eacute;&eacute;s au total. Avec 1 million de
539       fichiers dans le cache, cela &eacute;quivaut &agrave; environ 245 URLs mises en cache
540       dans chaque r&eacute;pertoire.</p>
541
542       <p>Chaque URL n&eacute;cessite au moins deux fichiers dans le cache. Ce sont en
543       g&eacute;n&eacute;ral un fichier ".header", qui contient des meta-informations &agrave; propos
544       de l'URL, comme la date de son arriv&eacute;e &agrave; expiration,
545       et un fichier ".data" qui est la copie exacte du contenu &agrave; servir.</p>
546
547       <p>Dans le cas d'un contenu n&eacute;goci&eacute; via l'en-t&ecirc;te "Vary", un r&eacute;pertoire
548       ".vary" sera cr&eacute;&eacute; pour l'URL en question. Ce r&eacute;pertoire contiendra de
549       multiples fichiers ".data" correspondant aux diff&eacute;rents contenus
550       n&eacute;goci&eacute;s.</p>
551     </section>
552
553     <section>
554       <title>Maintenance du cache sur disque</title>
555
556       <p>Le module <module>mod_cache_disk</module> n'effectue aucune
557       r&eacute;gulation de l'espace disque utilis&eacute; par le cache, mais s'il
558       s'arr&ecirc;te en douceur en cas d'erreur disque et se comporte alors
559       comme si le cache n'avait jamais exist&eacute;.</p>
560
561       <p>Par contre l'utilitaire
562       <a href="programs/htcacheclean.html">htcacheclean</a> fourni avec
563       httpd
564       vous permet de nettoyer le cache p&eacute;riodiquement.
565       D&eacute;terminer la fr&eacute;quence &agrave; laquelle lancer <a
566       href="programs/htcacheclean.html">htcacheclean</a> et la taille souhait&eacute;e
567       pour le cache est une t&acirc;che relativement complexe et il vous faudra de
568       nombreux essais et erreurs pour arriver &agrave; s&eacute;lectionner des valeurs
569       optimales.</p>
570
571       <p><a href="programs/htcacheclean.html">htcacheclean</a> op&egrave;re selon deux
572       modes. Il peut s'ex&eacute;cuter comme d&eacute;mon r&eacute;sident, ou &ecirc;tre lanc&eacute;
573       p&eacute;riodiquement par cron. <a
574       href="programs/htcacheclean.html">htcacheclean</a> peut mettre une heure
575       ou plus pour traiter de tr&egrave;s grands caches (plusieurs dizaines de
576       Gigaoctets) et si vous l'ex&eacute;cutez &agrave; partir de cron, il vous est
577       conseill&eacute; de d&eacute;terminer la dur&eacute;e typique d'un traitement, afin d'&eacute;viter
578       d'ex&eacute;cuter plusieurs instances &agrave; la fois.</p>
579
580       <p>Il est aussi conseill&eacute; d'attribuer un niveau de priorit&eacute; "nice"
581       appropri&eacute; &agrave; htcacheclean de fa&ccedil;on &agrave; ce qu'il n'effectue pas trop
582       d'acc&egrave;s disque pendant le fonctionnement du serveur.</p>
583
584       <p class="figure">
585       <img src="images/caching_fig1.gif" alt="" width="600"
586           height="406" /><br />
587       <a id="figure1" name="figure1"><dfn>Figure 1</dfn></a>: Croissance
588       typique du cache / s&eacute;quence de nettoyage.</p>
589
590       <p>Comme <module>mod_cache_disk</module> ne tient pas compte de l'espace
591       utilis&eacute; dans le cache, vous devez vous assurer que
592       <a href="programs/htcacheclean.html">htcacheclean</a> est configur&eacute; de
593       fa&ccedil;on &agrave; laisser suffisamment d'"espace de croissance"
594       &agrave; la suite d'un nettoyage.</p>
595     </section>
596
597   </section>
598
599   <section id="socache-caching">
600
601     <title>Mise en cache d'objets partag&eacute;s &agrave; deux &eacute;tats de forme
602     cl&eacute;/valeur</title>
603
604     <related>
605       <modulelist>
606         <module>mod_authn_socache</module>
607         <module>mod_socache_dbm</module>
608         <module>mod_socache_dc</module>
609         <module>mod_socache_memcache</module>
610         <module>mod_socache_shmcb</module>
611         <module>mod_ssl</module>
612       </modulelist>
613         <directivelist>
614           <directive module="mod_authn_socache">AuthnCacheSOCache</directive>
615           <directive module="mod_ssl">SSLSessionCache</directive>
616           <directive module="mod_ssl">SSLStaplingCache</directive>
617         </directivelist>
618     </related>
619     
620     <p>Le serveur HTTP Apache fournit un cache d'objets partag&eacute;s de bas
621     niveau pour la mise en cache d'informations comme les sessions SSL
622     ou les donn&eacute;es d'authentification dans l'interface <a
623     href="socache.html">socache</a>.</p>
624
625     <p>Pour chaque impl&eacute;mentation un module suppl&eacute;mentaire est fourni
626     qui offre les services d'arri&egrave;re-plan suivants :</p>
627
628     <dl>
629     <dt><module>mod_socache_dbm</module></dt>
630     <dd>Cache d'objets partag&eacute;s bas&eacute; sur DBM.</dd>
631     <dt><module>mod_socache_dc</module></dt>
632     <dd>Cache d'objets partag&eacute;s bas&eacute; sur Distcache.</dd>
633     <dt><module>mod_socache_memcache</module></dt>
634     <dd>Cache d'objets partag&eacute;s bas&eacute; sur Memcache.</dd>
635     <dt><module>mod_socache_shmcb</module></dt>
636     <dd>Cache d'objets partag&eacute;s bas&eacute; sur la m&eacute;moire partag&eacute;e.</dd>
637     </dl>
638
639     <section id="mod_authn_socache-caching">
640       <title>Mise en cache des donn&eacute;es d'authentification</title>
641
642       <related>
643         <modulelist>
644           <module>mod_authn_socache</module>
645         </modulelist>
646         <directivelist>
647           <directive module="mod_authn_socache">AuthnCacheSOCache</directive>
648         </directivelist>
649       </related>
650
651       <p>Le module <module>mod_authn_socache</module> permet la mise en
652       cache des donn&eacute;es issues d'une authentification, diminuant ainsi
653       la charge des serveurs d'authentification en arri&egrave;re-plan.</p>
654
655     </section>
656
657     <section id="mod_ssl-caching">
658       <title>Mise en cache des sessions SSL</title>
659
660       <related>
661         <modulelist>
662           <module>mod_ssl</module>
663         </modulelist>
664         <directivelist>
665           <directive module="mod_ssl">SSLSessionCache</directive>
666           <directive module="mod_ssl">SSLStaplingCache</directive>
667         </directivelist>
668       </related>
669
670       <p>Le module <module>mod_ssl</module> utilise l'interface
671       <code>socache</code> pour fournir un cache de session et un cache
672       de base.</p>
673
674     </section>
675
676   </section>
677
678   <section id="file-caching">
679
680     <title>Mise en cache &agrave; base de fichiers sp&eacute;cialis&eacute;s</title>
681
682     <related>
683       <modulelist>
684         <module>mod_file_cache</module>
685       </modulelist>
686       <directivelist>
687         <directive module="mod_file_cache">CacheFile</directive>
688         <directive module="mod_file_cache">MMapFile</directive>
689       </directivelist>
690     </related>
691
692     <p>Sur les plateformes o&ugrave; le syst&egrave;me de fichiers peut &ecirc;tre lent, ou
693     lorsque les descripteurs de fichiers sont gourmands en ressources,
694     il est possible de pr&eacute;charger des fichiers en m&eacute;moire au d&eacute;marrage
695     du serveur.</p>
696
697     <p>Sur les syst&egrave;mes o&ugrave; l'ouverture des fichiers est lente, il est
698     possible d'ouvrir le fichier au d&eacute;marrage du serveur et de mettre en
699     cache le descripteur de fichier. Ces options peuvent vous aider sur
700     les syst&egrave;mes o&ugrave; l'acc&egrave;s aux fichiers statiques est lent.</p>
701
702     <section id="filehandle">
703       <title>Mise en cache des descripteurs de fichier</title>
704
705       <p>Le processus d'ouverture d'un fichier peut &ecirc;tre en soi une
706       source de ralentissement, en particulier sur les syst&egrave;mes de
707       fichiers sur le r&eacute;seau. httpd permet d'&eacute;viter ce ralentissement en
708       maintenant un cache des descripteurs de fichiers ouverts pour les
709       fichiers souvent servis. Actuellement, httpd fournit une seule
710       impl&eacute;mentation de mise en cache des descripteurs de fichiers.</p>
711
712       <section>
713         <title>CacheFile</title>
714
715         <p>La forme la plus basique de mise en cache que propose httpd
716         est la mise en cache des descripteurs de fichiers fournie par le
717         module <module>mod_file_cache</module>. Plut&ocirc;t que de mettre en
718         cache le contenu des fichiers, ce cache maintient une table des
719         descripteurs de fichiers ouverts. Les fichiers devant faire
720         l'objet d'une mise en cache de ce type sont sp&eacute;cifi&eacute;s dans le
721         fichier de configuration via la directive <directive
722         module="mod_file_cache">CacheFile</directive>.</p>
723
724         <p>La directive <directive
725         module="mod_file_cache">CacheFile</directive> informe httpd
726         qu'il doit ouvrir le fichier lors de son d&eacute;marrage et qu'il doit
727         r&eacute;utiliser le descripteur de fichier mis en cache pour tous les
728         acc&egrave;s futurs &agrave; ce fichier.</p>
729
730         <example>
731         CacheFile /usr/local/apache2/htdocs/index.html
732         </example>
733
734         <p>Si vous d&eacute;sirez mettre en cache un grand nombre de fichiers
735         de cette mani&egrave;re, vous devez vous assurer que le nombre maximal
736         de fichiers ouverts pour votre syst&egrave;me d'exploitation est d&eacute;fini
737         &agrave; une valeur suffisante.</p>
738
739         <p>Bien que l'utilisation de la directive <directive
740         module="mod_file_cache">CacheFile</directive> n'entra&icirc;ne pas de
741         mise en cache du contenu du fichier proprement dit, elle
742         implique que si le fichier est modifi&eacute; pendant l'ex&eacute;cution du
743         serveur, ces modifications ne seront pas prises en compte. Le
744         fichier sera toujours servi dans l'&eacute;tat o&ugrave; il se trouvait au
745         moment du d&eacute;marrage du serveur.</p>
746
747         <p>Si le fichier est supprim&eacute; pendant l'ex&eacute;cution du serveur, ce
748         dernier conservera le descripteur de fichier ouvert associ&eacute; et
749         servira le fichier dans l'&eacute;tat o&ugrave; il se trouvait au
750         moment du d&eacute;marrage du serveur. Cela signifie aussi que m&ecirc;me si
751         le fichier a &eacute;t&eacute; supprim&eacute;, et n'appara&icirc;t donc plus dans le
752         syst&egrave;me de fichiers, l'espace disque lib&eacute;r&eacute; ne sera disponible
753         qu'une fois le serveur httpd arr&ecirc;t&eacute; et donc le descripteur de
754         fichier ferm&eacute;.</p>
755       </section>
756
757     </section>
758
759     <section id="inmemory">
760       <title>In-Memory Caching</title>
761
762     <p>Servir un contenu directement depuis la m&eacute;moire syst&egrave;me est
763     universellement reconnu comme la m&eacute;thode la plus rapide. Lire des fichiers
764     depuis un contr&ocirc;leur de disque ou pire, depuis un r&eacute;seau distant est plus
765     lent de plusieurs ordres de grandeur. Les contr&ocirc;leurs de disque r&eacute;alisent
766     en g&eacute;n&eacute;ral des op&eacute;rations m&eacute;caniques, et l'acc&egrave;s au r&eacute;seau est limit&eacute; par la
767     bande passante dont vous disposez. Par contre, les temps d'acc&egrave;s &agrave; la
768     m&eacute;moire sont de l'ordre de la nano-seconde.</p>
769
770     <p>Cependant la m&eacute;moire syst&egrave;me n'est pas bon march&eacute;; &agrave; capacit&eacute; &eacute;gale,
771     c'est de loin le type de stockage le plus co&ucirc;teux et il est important de
772     s'assurer qu'elle est utilis&eacute;e efficacement. Le fait de mettre en cache
773     des fichiers en m&eacute;moire diminue d'autant la quantit&eacute; de m&eacute;moire syst&egrave;me
774     disponible. Comme nous le verrons plus loin, ce n'est pas un probl&egrave;me en
775     soi dans le cas de la mise en cache par l'interm&eacute;diaire du syst&egrave;me
776     d'exploitation, mais si l'on utilise la mise en cache en m&eacute;moire propre &agrave;
777     httpd, il faut prendre garde &agrave; ne pas allouer trop de m&eacute;moire au cache.
778     Sinon le syst&egrave;me sera contraint d'utiliser le swap, ce qui d&eacute;gradera
779     sensiblement les performances.</p>
780
781       <section>
782       <title>Mise en cache par l'interm&eacute;diaire du syst&egrave;me d'exploitation</title>
783
784       <p>Dans la plupart des syst&egrave;mes d'exploitation modernes, c'est le noyau
785       qui g&egrave;re directement la mise en cache en m&eacute;moire des donn&eacute;es relatives
786       aux fichiers. C'est une fonctionnalit&eacute; puissante, et les syst&egrave;mes
787       d'exploitation s'en acquittent fort bien pour la plus grande partie.
788       Consid&eacute;rons par exemple, dans le cas de Linux, la diff&eacute;rence entre le
789       temps n&eacute;cessaire &agrave; la premi&egrave;re lecture d'un fichier et le temps
790       n&eacute;cessaire &agrave; sa deuxi&egrave;me lecture;</p>
791
792         <example><pre>
793 colm@coroebus:~$ time cat testfile &gt; /dev/null
794 real    0m0.065s
795 user    0m0.000s
796 sys     0m0.001s
797 colm@coroebus:~$ time cat testfile &gt; /dev/null
798 real    0m0.003s
799 user    0m0.003s
800 sys     0m0.000s</pre>
801         </example>
802
803       <p>M&ecirc;me pour ce petit fichier, il y a une grande diff&eacute;rence entre les
804       temps n&eacute;cessaires pour lire le fichier. Ceci est du au fait que le
805       noyau a mis en cache le contenu du fichier en m&eacute;moire.</p>
806
807       <p>Du fait de toujours pouvoir disposer de m&eacute;moire syst&egrave;me, vous pouvez
808       &ecirc;tre assur&eacute; qu'il y aura de plus en plus de contenus de fichiers stock&eacute;s
809       dans ce cache. Ceci peut s'av&eacute;rer une m&eacute;thode de mise en cache en m&eacute;moire
810       tr&egrave;s efficace, et ne n&eacute;cessite aucune configuration suppl&eacute;mentaire
811       de httpd.</p>
812
813       <p>De plus, comme le syst&egrave;me d'exploitation sait si des fichiers
814       ont &eacute;t&eacute;
815       supprim&eacute;s ou modifi&eacute;s, il peut effacer automatiquement des contenus de
816       fichiers du cache lorsque cela s'av&egrave;re n&eacute;cessaire. Ceci constitue un gros
817       avantage par rapport &agrave; la mise en cache en m&eacute;moire
818       de httpd qui n'a
819       aucune possibilit&eacute; de savoir si un fichier a &eacute;t&eacute; modifi&eacute;.</p>
820       </section>
821
822     <p>En d&eacute;pit des performances et des avantages de la mise en cache
823     automatique par le syst&egrave;me d'exploitation, la mise en cache en m&eacute;moire
824     peut &ecirc;tre effectu&eacute;e plus efficacement par httpd dans certaines
825     circonstances.</p>
826
827     <section>
828       <title>Mise en cache &agrave; l'aide de la directive MMapFile</title>
829
830       <p>La directive <directive module="mod_file_cache">MMapFile</directive>
831       fournie par le module <module>mod_file_cache</module> vous permet de
832       demander &agrave; httpd de charger un contenu de fichier statique en m&eacute;moire
833       lors de son d&eacute;marrage (&agrave; l'aide de l'appel
834       syst&egrave;me mmap). httpd
835       utilisera le contenu charg&eacute; en m&eacute;moire pour satisfaire ult&eacute;rieurement
836       toutes les demandes d'acc&egrave;s &agrave; ce fichier.</p>
837
838         <example>
839         MMapFile /usr/local/apache2/htdocs/index.html
840         </example>
841
842       <p>Comme dans le cas de la directive
843       <directive module="mod_file_cache">CacheFile</directive>, toute
844       modification du fichier ne sera plus prise en compte par httpd une fois
845       ce dernier d&eacute;marr&eacute;.</p>
846
847       <p> La directive
848       <directive module="mod_file_cache">MMapFile</directive> ne gardant
849       pas la trace de la quantit&eacute; de m&eacute;moire qu'elle alloue, vous devez prendre
850       garde de ne pas en abuser. Chaque processus enfant de httpd utilisant
851       sa propre r&eacute;plique de la m&eacute;moire allou&eacute;e, il est donc d'une importance
852       critique de s'assurer que les fichiers charg&eacute;s ne sont pas d'une taille
853       trop importante afin d'&eacute;pargner au syst&egrave;me l'utilisation du swap.</p>
854       </section>
855     </section>
856
857   </section>
858
859   <section id="security">
860     <title>Consid&eacute;rations sur la s&eacute;curit&eacute;</title>
861
862     <section>
863       <title>Autorisation et contr&ocirc;le d'acc&egrave;s</title>
864
865       <p>Utiliser <module>mod_cache</module> revient sensiblement &agrave; la m&ecirc;me
866       chose qu'avoir un mandataire inverse int&eacute;gr&eacute; (reverse-proxy). Les requ&ecirc;tes
867       seront servies par le module de mise en cache sauf si ce dernier
868       d&eacute;termine qu'un processus d'arri&egrave;re-plan doit &ecirc;tre appel&eacute;. La mise en
869       cache de ressources locales modifie consid&eacute;rablement le mod&egrave;le de
870       s&eacute;curit&eacute; de httpd.</p>
871
872       <p>Comme le parcours de la hi&eacute;rarchie d'un syst&egrave;me de fichiers pour
873       examiner le contenu d'&eacute;ventuels fichiers
874       <code>.htaccess</code> serait une op&eacute;ration tr&egrave;s co&ucirc;teuse en ressources,
875       annulant partiellement de ce fait l'int&eacute;r&ecirc;t de la mise en cache
876       (acc&eacute;l&eacute;rer le traitement des requ&ecirc;tes),
877       <module>mod_cache</module> ne se pr&eacute;occupe pas de savoir s'il a
878       l'autorisation de servir une entit&eacute; mise en cache. En d'autres termes,
879       si <module>mod_cache</module> a mis en cache un certain contenu, ce
880       dernier sera servi &agrave; partir du cache tant qu'il ne sera pas arriv&eacute; &agrave;
881       expiration.</p>
882
883       <p>Si par exemple, votre configuration autorise l'acc&egrave;s &agrave; une ressource
884       en fonction de l'adresse IP, vous devez vous assurer que ce contenu n'est
885       pas mis en cache. Ceci est possible en utilisant la directive
886       <directive module="mod_cache">CacheDisable</directive>, ou le module
887       <module>mod_expires</module>. Livr&eacute; &agrave; lui-m&ecirc;me,
888       <module>mod_cache</module> - pratiquement comme un mandataire inverse -
889       mettrait en cache le contenu lors de son service, et le servirait ensuite
890       &agrave; tout client, vers n'importe quelle adresse IP.</p>
891
892       <p>Lorsque la directive <directive
893       module="mod_cache">CacheQuickHandler</directive> est d&eacute;finie &agrave;
894       <code>Off</code>, toutes les phases du traitement de la requ&ecirc;te
895       sont ex&eacute;cut&eacute;es et le mod&egrave;le de s&eacute;curit&eacute; reste le m&ecirc;me.</p>
896
897     </section>
898
899     <section>
900       <title>Piratages locaux</title>
901
902       <p>Etant donn&eacute; que les requ&ecirc;tes des utilisateurs finaux peuvent &ecirc;tre
903       servies depuis le cache, ce dernier est une cible potentielle pour ceux
904       qui veulent d&eacute;figurer un contenu ou interf&eacute;rer avec lui. Il est important
905       de garder &agrave; l'esprit que l'utilisateur sous lequel tourne
906       httpd doit
907       toujours avoir l'acc&egrave;s en &eacute;criture dans le cache. Ceci est en contraste
908       total avec la recommandation usuelle d'interdire &agrave; l'utilisateur sous
909       lequel tourne Apache
910       l'acc&egrave;s en &eacute;criture &agrave; tout contenu.</p>
911
912       <p>Si l'utilisateur sous lequel tourne Apache est compromis,
913       par exemple &agrave; cause d'une
914       faille de s&eacute;curit&eacute; dans un processus CGI, il est possible que le cache
915       fasse l'objet d'une attaque. Il est relativement ais&eacute; d'ins&eacute;rer ou de
916       modifier une entit&eacute; dans le cache en utilisant le module
917       <module>mod_cache_disk</module>.</p>
918
919       <p>Cela repr&eacute;sente un risque relativement &eacute;l&eacute;v&eacute; par rapport aux autres
920       types d'attaques qu'il est possible de mener sous l'utilisateur apache.
921       Si vous utilisez <module>mod_cache_disk</module>, vous devez garder ceci
922       &agrave; l'esprit : effectuez toujours les mises &agrave; jour de
923       httpdquand des
924       correctifs de s&eacute;curit&eacute; sont annonc&eacute;s et ex&eacute;cutez les processus CGI sous
925       un utilisateur autre qu'apache en utilisant
926       <a href="suexec.html">suEXEC</a> dans la mesure du possible.</p>
927
928     </section>
929
930     <section>
931       <title>Empoisonnement du cache (Cache Poisoning)</title>
932
933       <p>Si vous utilisez httpd comme serveur mandataire avec mise en cache,
934       vous vous exposez aussi &agrave; un &eacute;ventuel "Empoisonnement du
935       cache" (Cache poisoning). L'empoisonnement du cache est un terme g&eacute;n&eacute;ral
936       pour d&eacute;signer les attaques au cours desquelles l'attaquant fait en sorte
937       que le serveur mandataire renvoie &agrave; un contenu incorrect (et souvent
938       ind&eacute;sirable) suite &agrave; en provenance du serveur d'arri&egrave;re-plan.
939       </p>
940
941       <p>Par exemple, si les serveur DNS qu'utilise votre syst&egrave;me o&ugrave; tourne
942       httpd sont vuln&eacute;rables &agrave; l'empoisonnement du cache des DNS, un attaquant
943       pourra contr&ocirc;ler vers o&ugrave; httpd se connecte lorsqu'il demande un contenu
944       depuis le serveur d'origine.
945       Un autre exemple est constitu&eacute; par les attaques ainsi nomm&eacute;es
946       "Dissimulation de requ&ecirc;tes HTTP" (HTTP request-smuggling).</p>
947
948       <p>Ce document n'est pas le bon endroit pour une discussion approfondie
949       &agrave; propos de la Dissimulation de requ&ecirc;tes HTTP (utilisez plut&ocirc;t votre
950       moteur de recherche favori); il est cependant important de savoir qu'il
951       est possible d'&eacute;laborer une s&eacute;rie de requ&ecirc;tes, et d'exploiter une
952       vuln&eacute;rabilit&eacute; d'un serveur web d'origine de telle fa&ccedil;on que l'attaquant
953       puisse contr&ocirc;ler enti&egrave;rement le contenu renvoy&eacute; par le mandataire.</p>
954     </section>
955
956     <section>
957       <title>D&eacute;ni de Service / Cachebusting</title>
958
959       <p>Le m&eacute;canisme utilis&eacute; via l'en-t&ecirc;te Vary permet de mettre en
960       cache simultan&eacute;ment plusieurs variantes d'une ressource avec la
961       m&ecirc;me URL. Le cache s&eacute;lectionne la variante correcte &agrave; envoyer au
962       client en fonction des valeurs d'en-t&ecirc;te fournies par ce dernier.
963       Ce m&eacute;canisme peut devenir un probl&egrave;me lorsqu'on tente d'appliquer
964       le m&eacute;canisme des variantes &agrave; un en-t&ecirc;te connu pour pouvoir
965       poss&eacute;der un grand nombre de valeurs
966       possibles en utilisation normal, comme par exemple l'en-t&ecirc;te
967       <code>User-Agent</code>. En fonction de la popularit&eacute; du site web,
968       des milliers ou m&ecirc;me des millions d'entr&eacute;es de cache dupliqu&eacute;es
969       peuvent &ecirc;tre cr&eacute;&eacute;es pour la m&ecirc;me URL, submergeant les autres
970       entr&eacute;es du cache.</p>
971       
972       <p>Dans d'autres cas, il peut &ecirc;tre n&eacute;cessaire de modifier l'URL
973       d'une ressource particuli&egrave;re &agrave; chaque requ&ecirc;te, en g&eacute;n&eacute;ral en lui
974       ajoutant une cha&icirc;ne "cachebuster". Si ce contenu est d&eacute;clar&eacute; comme
975       pouvant &ecirc;tre mis en cache par un serveur avec une dur&eacute;e de
976       fra&icirc;cheur significative, ces entr&eacute;es peuvent submerger les entr&eacute;es
977       l&eacute;gitimes du cache. Alors que <module>mod_cache</module> fournit
978       une directive <directive
979       module="mod_cache">CacheIgnoreURLSessionIdentifiers</directive>,
980       cette derni&egrave;re doit &ecirc;tre utilis&eacute;e avec prudence pour s'assurer que
981       les caches du navigateur ou du mandataire le plus proche
982       (downstream proxy) ne sont pas victimes du m&ecirc;me probl&egrave;me de D&eacute;ni de
983       service.</p>
984     </section>
985   </section>
986
987
988 </manualpage>