2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1029833:1174747 (outdated) -->
5 <!-- French translation : Lucien GENTIS -->
6 <!-- Reviewed by : Vincent Deffontaines -->
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
16 http://www.apache.org/licenses/LICENSE-2.0
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.
25 <modulesynopsis metafile="mod_cache_disk.xml.meta">
27 <name>mod_cache_disk</name>
28 <description>Module de stockage sur disque pour le filtre de mise en
29 cache HTTP.</description>
30 <status>Extension</status>
31 <sourcefile>mod_cache_disk.c</sourcefile>
32 <identifier>cache_disk_module</identifier>
35 <p><module>mod_cache_disk</module> implémente un gestionnaire de
36 stockage sur disque pour le module <module>mod_cache</module>.</p>
38 <p>Les en-têtes et corps des réponses mises en cache sont stockés
39 séparément sur le disque, dans une structure de répertoires basée
40 sur le condensé md5 de l'URL mise en cache.</p>
42 <p>Plusieurs réponses au contenu négocié peuvent être stockées en
43 même temps, mais la mise en cache de contenus partiels n'est pas
44 supportée actuellement par ce module.</p>
46 <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête
47 et de corps peuvent être effectuées sans verrouillage en
48 enregistrant les numéros d'inode et de périphérique du fichier de
49 corps dans le fichier d'en-tête. Ceci implique que les entrées du
50 cache déplacées manuellement dans le cache seront ignorées.</p>
52 <p>L'utilitaire <program>htcacheclean</program> permet de lister et
53 de supprimer les URLs du cache, ou de maintenir le cache en deçà de
54 certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
55 peut être exécuté à la demande, ou automatiquement pour assurer un
56 contrôle continu des tailles des répertoires.</p>
58 <note><title>Note :</title>
59 <p><module>mod_cache</module> doit être chargé avant
60 <module>mod_cache_disk</module> pour que ce dernier puisse
63 <p>Lorsque la plate-forme la supporte, et si elle est activée via la
64 directive <directive module="core">EnableSendfile</directive>,
65 <module>mod_cache_disk</module> utilise la fonctionnalité sendfile
66 pour servir les fichiers à partir du cache. Cependant,
67 <module>mod_cache_disk</module> ignore la configuration de la
68 directive <directive module="core">EnableSendfile</directive> dans
69 un contexte de répertoire ou de fichier .htaccess, car le module ne
70 dispose pas des définitions correspondantes lorsque la requête est
71 servie depuis le cache.</p>
75 <name>CacheRoot</name>
76 <description>La racine du répertoire dans lequel les fichiers du cache
77 seront stockés</description>
78 <syntax>CacheRoot <var>répertoire</var></syntax>
79 <contextlist><context>server config</context><context>virtual host</context>
83 <p>La directive <directive>CacheRoot</directive> permet de définir
84 le nom du répertoire sur disque qui contiendra les fichiers du
85 cache. Si le module <module>mod_cache_disk</module> a été chargé ou
86 compilé dans le serveur Apache, cette directive <em>doit</em> être
87 définie. L'absence de définition de la directive
88 <directive>CacheRoot</directive> provoquera une erreur de traitement
89 du fichier de configuration. Les directives <directive
90 module="mod_cache_disk">CacheDirLevels</directive> et <directive
91 module="mod_cache_disk">CacheDirLength</directive> permettent de
92 définir la structure des sous-répertoires du répertoire racine
93 spécifié.</p>
96 CacheRoot c:/cacheroot
102 <name>CacheDirLevels</name>
103 <description>Le nombre de niveaux de sous-répertoires que comportera le
105 <syntax>CacheDirLevels <var>niveaux</var></syntax>
106 <default>CacheDirLevels 2</default>
107 <contextlist><context>server config</context><context>virtual host</context>
111 <p>La directive <directive>CacheDirLevels</directive> permet de
112 définir le nombre de niveaux de sous-répertoires que comportera le
113 cache. Les données du cache seront stokées au niveau correspondant
114 par rapport au répertoire <directive module="mod_cache_disk"
115 >CacheRoot</directive>.</p>
116 <p>Une valeur haute pour <directive>CacheDirLevels</directive>
117 combinée avec une valeur basse pour
118 <directive>CacheDirLength</directive> générera une arborescence
119 très développée, avec un petit nombre de sous-répertoires à chaque
123 <p>La valeur du produit <directive>CacheDirLevels</directive> *
124 <directive module="mod_cache_disk">CacheDirLength</directive> ne
125 doit pas dépasser 20.</p>
132 <name>CacheDirLength</name>
133 <description>Le nombre de caractères des noms des
134 sous-répertoires</description>
135 <syntax>CacheDirLength <var>longueur</var></syntax>
136 <default>CacheDirLength 2</default>
137 <contextlist><context>server config</context><context>virtual host</context>
141 <p>la directive <directive>CacheDirLength</directive> permet de
142 définir le nombre de caractères que comportera chaque nom de
143 sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
144 conjonction avec <directive>CacheDirLevels</directive> pour
145 déterminer une structure approximative de la hiérarchie de
147 <p>Une valeur haute pour <directive>CacheDirLength</directive>
148 combinée avec une valeur basse pour
149 <directive>CacheDirLevels</directive> générera une hiérarchie
150 relativement peu profonde, avec un grand nombre de sous-répertoires
151 à chaque niveau.</p>
154 <p>La valeur du produit <directive>CacheDirLevels</directive> *
155 <directive module="mod_cache_disk">CacheDirLength</directive> ne
156 doit pas dépasser 20.</p>
163 <name>CacheMinFileSize</name>
164 <description>La taille minimale (en octets) d'un document pour pouvoir
165 être stocké dans le cache</description>
166 <syntax>CacheMinFileSize <var>octets</var></syntax>
167 <default>CacheMinFileSize 1</default>
168 <contextlist><context>server config</context><context>virtual host</context>
169 <context>directory</context><context>.htaccess</context>
173 <p>La directive <directive>CacheMinFileSize</directive> permet de
174 définir la taille minimale d'un document, en octets, pour que
175 celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
184 <name>CacheMaxFileSize</name>
185 <description>>La taille maximale (en octets) d'un document pour pouvoir
186 être stocké dans le cache</description>
187 <syntax>CacheMaxFileSize <var>octets</var></syntax>
188 <default>CacheMaxFileSize 1000000</default>
189 <contextlist><context>server config</context><context>virtual host</context>
190 <context>directory</context><context>.htaccess</context>
194 <p>La directive <directive>CacheMaxFileSize</directive> permet de
195 définir la taille maximale d'un document, en octets, pour que
196 celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
199 CacheMaxFileSize 64000
204 <name>CacheReadSize</name>
205 <description>La quantité minimale (en octets) de données à lire et à
206 mettre en cache avant de les envoyer au client</description>
207 <syntax>CacheReadSize <var>octets</var></syntax>
208 <default>CacheReadSize 0</default>
209 <contextlist><context>server config</context>
210 <context>virtual host</context>
211 <context>directory</context>
212 <context>.htaccess</context>
216 <p>La directive <directive>CacheReadSize</directive> permet de
217 définir la quantité minimale de données, en octets, à lire depuis le
218 serveur d'arrière-plan avant de les envoyer au client. Avec la
219 valeur par défaut zéro, toute donnée de toutes tailles est envoyée
220 au client dès qu'elle est disponible. Avec une valeur non nulle, le
221 cache disque met en tampon au moins la quantité de données
222 correspondante avant d'envoyer la réponse au client. Les
223 performances peuvent s'en trouver améliorées lorsqu'on met en cache
224 du contenu en provenance d'un mandataire inverse.</p>
226 <p>Cette directive ne prend effet que lorsque les données sont
227 enregistrées dans le cache, et non lorsque les données sont servies à
237 <name>CacheReadTime</name>
238 <description>Le temps minimum (en millisecondes) qui doit s'écouler
239 avant d'envoyer les données au client</description>
240 <syntax>CacheReadTime <var>millisecondes</var></syntax>
241 <default>CacheReadTime 0</default>
242 <contextlist><context>server config</context>
243 <context>virtual host</context>
244 <context>directory</context>
245 <context>.htaccess</context>
249 <p>La directive <directive>CacheReadTime</directive> permet de
250 définir le temps minimum qui doit s'écouler avant d'essayer
251 d'envoyer des données au client. Pendant ce temps, les données sont
252 mises en tampon avant de pouvoir être envoyées au client. Les
253 performances peuvent s'en trouver améliorées lorsqu'on met en cache
254 du contenu en provenance d'un mandataire inverse.</p>
256 <p>La valeur par défaut zéro désactive cette option.</p>
258 <p>Cette directive ne prend effet que lorsque les données sont
259 enregistrées dans le cache, et non lorsque les données sont servies à
260 partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
261 directive avec celle de la directive <directive
262 module="mod_cache_disk">CacheReadSize</directive>, afin de s'assurer
263 que le serveur n'effectue pas une mise en tampon excessive au cas
264 où les données arriveraient plus vite que prévu.</p>