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_disk - 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_disk</h1>
29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English"> en </a> |
30 <a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> |
31 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
32 <a href="../ko/mod/mod_cache_disk.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>Module de stockage sur disque pour le filtre de mise en
36 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
37 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_disk_module</td></tr>
38 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_disk.c</td></tr></table>
41 <p><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> implémente un gestionnaire de
42 stockage sur disque pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
44 <p>Les en-têtes et corps des réponses mises en cache sont stockés
45 séparément sur le disque, dans une structure de répertoires basée
46 sur le condensé md5 de l'URL mise en cache.</p>
48 <p>Plusieurs réponses au contenu négocié peuvent être stockées en
49 même temps, mais la mise en cache de contenus partiels n'est pas
50 supportée actuellement par ce module.</p>
52 <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête
53 et de corps peuvent être effectuées sans verrouillage en
54 enregistrant les numéros d'inode et de périphérique du fichier de
55 corps dans le fichier d'en-tête. Ceci implique que les entrées du
56 cache déplacées manuellement dans le cache seront ignorées.</p>
58 <p>L'utilitaire <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et
59 de supprimer les URLs du cache, ou de maintenir le cache en deçà de
60 certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
61 peut être exécuté à la demande, ou automatiquement pour assurer un
62 contrôle continu des tailles des répertoires.</p>
64 <div class="note"><h3>Note :</h3>
65 <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé avant
66 <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> pour que ce dernier puisse
69 <div class="note"><h3>Note :</h3>
70 <p>Lorsque la plate-forme la supporte, et si elle est activée via la
71 directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code>,
72 <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> utilise la fonctionnalité sendfile
73 pour servir les fichiers à partir du cache. Cependant,
74 <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> ignore la configuration de la
75 directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> dans
76 un contexte de répertoire ou de fichier .htaccess, car le module ne
77 dispose pas des définitions correspondantes lorsque la requête est
78 servie depuis le cache.</p>
81 <div id="quickview"><h3 class="directives">Directives</h3>
83 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlength">CacheDirLength</a></li>
84 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlevels">CacheDirLevels</a></li>
85 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxfilesize">CacheMaxFileSize</a></li>
86 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminfilesize">CacheMinFileSize</a></li>
87 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadsize">CacheReadSize</a></li>
88 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadtime">CacheReadTime</a></li>
89 <li><img alt="" src="../images/down.gif" /> <a href="#cacheroot">CacheRoot</a></li>
91 <h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_cache_disk">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_cache_disk">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
93 <li><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></li>
94 <li><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></li>
95 <li><a href="../caching.html">Guide de la mise en cache</a></li>
96 <li><a href="#comments_section">Commentaires</a></li></ul></div>
98 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
99 <div class="directive-section"><h2><a name="cachedirlength" id="cachedirlength">Directive</a> <a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a></h2>
100 <table class="directive">
101 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de caractères des noms des
102 sous-répertoires</td></tr>
103 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>longueur</var></code></td></tr>
104 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLength 2</code></td></tr>
105 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
106 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
107 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
109 <p>la directive <code class="directive">CacheDirLength</code> permet de
110 définir le nombre de caractères que comportera chaque nom de
111 sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
112 conjonction avec <code class="directive">CacheDirLevels</code> pour
113 déterminer une structure approximative de la hiérarchie de
115 <p>Une valeur haute pour <code class="directive">CacheDirLength</code>
116 combinée avec une valeur basse pour
117 <code class="directive">CacheDirLevels</code> générera une hiérarchie
118 relativement peu profonde, avec un grand nombre de sous-répertoires
122 <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
123 <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
124 doit pas dépasser 20.</p>
129 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
130 <div class="directive-section"><h2><a name="cachedirlevels" id="cachedirlevels">Directive</a> <a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a></h2>
131 <table class="directive">
132 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de niveaux de sous-répertoires que comportera le
134 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>niveaux</var></code></td></tr>
135 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLevels 2</code></td></tr>
136 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
137 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
138 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
140 <p>La directive <code class="directive">CacheDirLevels</code> permet de
141 définir le nombre de niveaux de sous-répertoires que comportera le
142 cache. Les données du cache seront stokées au niveau correspondant
143 par rapport au répertoire <code class="directive"><a href="#cacheroot">CacheRoot</a></code>.</p>
144 <p>Une valeur haute pour <code class="directive">CacheDirLevels</code>
145 combinée avec une valeur basse pour
146 <code class="directive">CacheDirLength</code> générera une arborescence
147 très développée, avec un petit nombre de sous-répertoires à chaque
151 <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
152 <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
153 doit pas dépasser 20.</p>
158 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
159 <div class="directive-section"><h2><a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a> <a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a></h2>
160 <table class="directive">
161 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>>La taille maximale (en octets) d'un document pour pouvoir
162 être stocké dans le cache</td></tr>
163 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>octets</var></code></td></tr>
164 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxFileSize 1000000</code></td></tr>
165 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
166 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
167 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
169 <p>La directive <code class="directive">CacheMaxFileSize</code> permet de
170 définir la taille maximale d'un document, en octets, pour que
171 celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
173 <pre class="prettyprint lang-config">CacheMaxFileSize 64000</pre>
177 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
178 <div class="directive-section"><h2><a name="cacheminfilesize" id="cacheminfilesize">Directive</a> <a name="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a></h2>
179 <table class="directive">
180 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille minimale (en octets) d'un document pour pouvoir
181 être stocké dans le cache</td></tr>
182 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinFileSize <var>octets</var></code></td></tr>
183 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinFileSize 1</code></td></tr>
184 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
185 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
186 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
188 <p>La directive <code class="directive">CacheMinFileSize</code> permet de
189 définir la taille minimale d'un document, en octets, pour que
190 celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
192 <pre class="prettyprint lang-config">CacheMinFileSize 64</pre>
196 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
197 <div class="directive-section"><h2><a name="cachereadsize" id="cachereadsize">Directive</a> <a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a></h2>
198 <table class="directive">
199 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale (en octets) de données à lire et à
200 mettre en cache avant de les envoyer au client</td></tr>
201 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadSize <var>octets</var></code></td></tr>
202 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadSize 0</code></td></tr>
203 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
204 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
205 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
207 <p>La directive <code class="directive">CacheReadSize</code> permet de
208 définir la quantité minimale de données, en octets, à lire depuis le
209 serveur d'arrière-plan avant de les envoyer au client. Avec la
210 valeur par défaut zéro, toute donnée de toutes tailles est envoyée
211 au client dès qu'elle est disponible. Avec une valeur non nulle, le
212 cache disque met en tampon au moins la quantité de données
213 correspondante avant d'envoyer la réponse au client. Les
214 performances peuvent s'en trouver améliorées lorsqu'on met en cache
215 du contenu en provenance d'un mandataire inverse.</p>
217 <p>Cette directive ne prend effet que lorsque les données sont
218 enregistrées dans le cache, et non lorsque les données sont servies à
221 <pre class="prettyprint lang-config">CacheReadSize 102400</pre>
225 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
226 <div class="directive-section"><h2><a name="cachereadtime" id="cachereadtime">Directive</a> <a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a></h2>
227 <table class="directive">
228 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le temps minimum (en millisecondes) qui doit s'écouler
229 avant d'envoyer les données au client</td></tr>
230 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadTime <var>millisecondes</var></code></td></tr>
231 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadTime 0</code></td></tr>
232 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
233 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
234 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
236 <p>La directive <code class="directive">CacheReadTime</code> permet de
237 définir le temps minimum qui doit s'écouler avant d'essayer
238 d'envoyer des données au client. Pendant ce temps, les données sont
239 mises en tampon avant de pouvoir être envoyées au client. Les
240 performances peuvent s'en trouver améliorées lorsqu'on met en cache
241 du contenu en provenance d'un mandataire inverse.</p>
243 <p>La valeur par défaut zéro désactive cette option.</p>
245 <p>Cette directive ne prend effet que lorsque les données sont
246 enregistrées dans le cache, et non lorsque les données sont servies à
247 partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
248 directive avec celle de la directive <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code>, afin de s'assurer
249 que le serveur n'effectue pas une mise en tampon excessive au cas
250 où les données arriveraient plus vite que prévu.</p>
252 <pre class="prettyprint lang-config">CacheReadTime 1000</pre>
256 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
257 <div class="directive-section"><h2><a name="cacheroot" id="cacheroot">Directive</a> <a name="CacheRoot" id="CacheRoot">CacheRoot</a></h2>
258 <table class="directive">
259 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La racine du répertoire dans lequel les fichiers du cache
260 seront stockés</td></tr>
261 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>répertoire</var></code></td></tr>
262 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
263 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
264 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
266 <p>La directive <code class="directive">CacheRoot</code> permet de définir
267 le nom du répertoire sur disque qui contiendra les fichiers du
268 cache. Si le module <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> a été chargé ou
269 compilé dans le serveur Apache, cette directive <em>doit</em> être
270 définie. L'absence de définition de la directive
271 <code class="directive">CacheRoot</code> provoquera une erreur de traitement
272 du fichier de configuration. Les directives <code class="directive"><a href="#cachedirlevels">CacheDirLevels</a></code> et <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> permettent de
273 définir la structure des sous-répertoires du répertoire racine
276 <pre class="prettyprint lang-config">CacheRoot c:/cacheroot</pre>
281 <div class="bottomlang">
282 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English"> en </a> |
283 <a href="../fr/mod/mod_cache_disk.html" title="Français"> fr </a> |
284 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
285 <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
286 </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>
287 <script type="text/javascript"><!--//--><![CDATA[//><!--
288 var comments_shortname = 'httpd';
289 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_disk.html';
291 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
292 d.write('<div id="comments_thread"><\/div>');
293 var s = d.createElement('script');
294 s.type = 'text/javascript';
296 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
297 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
300 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
302 })(window, document);
303 //--><!]]></script></div><div id="footer">
304 <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>
305 <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[//><!--
306 if (typeof(prettyPrint) !== 'undefined') {