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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>mod_cache_disk - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  12 <script src="../style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  17 <div id="page-header">
  18 <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>
  19 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  20 <img alt="" src="../images/feather.gif" /></div>
  21 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Module Apache mod_cache_disk</h1>
  26 <div class="toplang">
  27 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  28 <a href="../fr/mod/mod_cache_disk.html" title="Français">&nbsp;fr&nbsp;</a> |
  29 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  30 <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  31 </div>
  32 <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
  33 cache HTTP.</td></tr>
  34 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  35 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_disk_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_disk.c</td></tr></table>
  37 <h3>Sommaire</h3>
  38
  39     <p><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> implémente un gestionnaire de
  40     stockage sur disque pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
  41
  42     <p>Les en-têtes et corps des réponses mises en cache sont stockés
  43     séparément sur le disque, dans une structure de répertoires basée
  44     sur le condensé md5 de l'URL mise en cache.</p>
  45
  46     <p>Plusieurs réponses au contenu négocié peuvent être stockées en
  47     même temps, mais la mise en cache de contenus partiels n'est pas
  48     supportée actuellement par ce module.</p>
  49
  50     <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête
  51     et de corps peuvent être effectuées sans verrouillage en
  52     enregistrant les numéros d'inode et de périphérique du fichier de
  53     corps dans le fichier d'en-tête. Ceci implique que les entrées du
  54     cache déplacées manuellement dans le cache seront ignorées.</p>
  55
  56     <p>L'utilitaire <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et
  57     de supprimer les URLs du cache, ou de maintenir le cache en deçà de
  58     certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
  59     peut être exécuté à la demande, ou automatiquement pour assurer un
  60     contrôle continu des tailles des répertoires.</p>
  61
  62     <div class="note"><h3>Note :</h3>
  63       <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé avant
  64       <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> pour que ce dernier puisse
  65       fonctionner.</p>
  66     </div>
  67     <div class="note"><h3>Note :</h3>
  68     <p>Lorsque la plate-forme la supporte, et si elle est activée via la
  69     directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code>,
  70     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> utilise la fonctionnalité sendfile
  71     pour servir les fichiers à partir du cache. Cependant,
  72     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> ignore la configuration de la
  73     directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> dans
  74     un contexte de répertoire ou de fichier .htaccess, car le module ne
  75     dispose pas des définitions correspondantes lorsque la requête est
  76     servie depuis le cache.</p>
  77     </div>
  78 </div>
  79 <div id="quickview"><h3 class="directives">Directives</h3>
  80 <ul id="toc">
  81 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlength">CacheDirLength</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlevels">CacheDirLevels</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxfilesize">CacheMaxFileSize</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminfilesize">CacheMinFileSize</a></li>
  85 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadsize">CacheReadSize</a></li>
  86 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadtime">CacheReadTime</a></li>
  87 <li><img alt="" src="../images/down.gif" /> <a href="#cacheroot">CacheRoot</a></li>
  88 </ul>
  89 <h3>Voir aussi</h3>
  90 <ul class="seealso">
  91 <li><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></li>
  92 <li><code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code></li>
  93 <li><a href="../caching.html">Guide de la mise en cache</a></li>
  94 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  95
  96 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  97 <div class="directive-section"><h2><a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a> <a name="cachedirlength" id="cachedirlength">Directive</a></h2>
  98 <table class="directive">
  99 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de caractères des noms des
 100 sous-répertoires</td></tr>
 101 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>longueur</var></code></td></tr>
 102 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLength 2</code></td></tr>
 103 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 104 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 105 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 106 </table>
 107     <p>la directive <code class="directive">CacheDirLength</code> permet de
 108     définir le nombre de caractères que comportera chaque nom de
 109     sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
 110     conjonction avec <code class="directive">CacheDirLevels</code> pour
 111     déterminer une structure approximative de la hiérarchie de
 112     cache.</p>
 113     <p>Une valeur haute pour <code class="directive">CacheDirLength</code>
 114     combinée avec une valeur basse pour
 115     <code class="directive">CacheDirLevels</code> générera une hiérarchie
 116     relativement peu profonde, avec un grand nombre de sous-répertoires
 117     à chaque niveau.</p>
 118
 119     <div class="note">
 120       <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
 121       <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
 122       doit pas dépasser 20.</p>
 123     </div>
 124
 125
 126 </div>
 127 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 128 <div class="directive-section"><h2><a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a> <a name="cachedirlevels" id="cachedirlevels">Directive</a></h2>
 129 <table class="directive">
 130 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de niveaux de sous-répertoires que comportera le
 131 cache.</td></tr>
 132 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>niveaux</var></code></td></tr>
 133 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLevels 2</code></td></tr>
 134 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 135 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 136 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 137 </table>
 138     <p>La directive <code class="directive">CacheDirLevels</code> permet de
 139     définir le nombre de niveaux de sous-répertoires que comportera le
 140     cache. Les données du cache seront stokées au niveau correspondant
 141     par rapport au répertoire <code class="directive"><a href="#cacheroot">CacheRoot</a></code>.</p>
 142     <p>Une valeur haute pour <code class="directive">CacheDirLevels</code>
 143     combinée avec une valeur basse pour
 144     <code class="directive">CacheDirLength</code> générera une arborescence
 145     très développée, avec un petit nombre de sous-répertoires à chaque
 146     niveau.</p>
 147
 148     <div class="note">
 149       <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
 150       <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
 151       doit pas dépasser 20.</p>
 152     </div>
 153
 154
 155 </div>
 156 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 157 <div class="directive-section"><h2><a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a> <a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a></h2>
 158 <table class="directive">
 159 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>&gt;La taille maximale (en octets) d'un document pour pouvoir
 160 être stocké dans le cache</td></tr>
 161 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>octets</var></code></td></tr>
 162 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxFileSize 1000000</code></td></tr>
 163 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 164 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 165 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 166 </table>
 167     <p>La directive <code class="directive">CacheMaxFileSize</code> permet de
 168     définir la taille maximale d'un document, en octets, pour que
 169     celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
 170
 171     <pre class="prettyprint lang-config">
 172       CacheMaxFileSize 64000
 173     </pre>
 174
 175
 176 </div>
 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">CacheMinFileSize</a> <a name="cacheminfilesize" id="cacheminfilesize">Directive</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>
 187 </table>
 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>
 191
 192     <pre class="prettyprint lang-config">
 193       CacheMinFileSize 64
 194     </pre>
 195
 196
 197 </div>
 198 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 199 <div class="directive-section"><h2><a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a> <a name="cachereadsize" id="cachereadsize">Directive</a></h2>
 200 <table class="directive">
 201 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale (en octets) de données à lire et à
 202 mettre en cache avant de les envoyer au client</td></tr>
 203 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadSize <var>octets</var></code></td></tr>
 204 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadSize 0</code></td></tr>
 205 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 206 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 207 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 208 </table>
 209     <p>La directive <code class="directive">CacheReadSize</code> permet de
 210     définir la quantité minimale de données, en octets, à lire depuis le
 211     serveur d'arrière-plan avant de les envoyer au client. Avec la
 212     valeur par défaut zéro, toute donnée de toutes tailles est envoyée
 213     au client dès qu'elle est disponible. Avec une valeur non nulle, le
 214     cache disque met en tampon au moins la quantité de données
 215     correspondante avant d'envoyer la réponse au client. Les
 216     performances peuvent s'en trouver améliorées lorsqu'on met en cache
 217     du contenu en provenance d'un mandataire inverse.</p>
 218
 219     <p>Cette directive ne prend effet que lorsque les données sont
 220     enregistrées dans le cache, et non lorsque les données sont servies à
 221     partir du cache.</p>
 222
 223     <pre class="prettyprint lang-config">
 224       CacheReadSize 102400
 225     </pre>
 226
 227
 228 </div>
 229 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 230 <div class="directive-section"><h2><a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a> <a name="cachereadtime" id="cachereadtime">Directive</a></h2>
 231 <table class="directive">
 232 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le temps minimum (en millisecondes) qui doit s'écouler
 233 avant d'envoyer les données au client</td></tr>
 234 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadTime <var>millisecondes</var></code></td></tr>
 235 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadTime 0</code></td></tr>
 236 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 237 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 238 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 239 </table>
 240     <p>La directive <code class="directive">CacheReadTime</code> permet de
 241     définir le temps minimum qui doit s'écouler avant d'essayer
 242     d'envoyer des données au client. Pendant ce temps, les données sont
 243     mises en tampon avant de pouvoir être envoyées au client. Les
 244     performances peuvent s'en trouver améliorées lorsqu'on met en cache
 245     du contenu en provenance d'un mandataire inverse.</p>
 246
 247     <p>La valeur par défaut zéro désactive cette option.</p>
 248
 249     <p>Cette directive ne prend effet que lorsque les données sont
 250     enregistrées dans le cache, et non lorsque les données sont servies à
 251     partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
 252     directive avec celle de la directive <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code>, afin de s'assurer
 253     que le serveur n'effectue pas une mise en tampon excessive au cas
 254     où les données arriveraient plus vite que prévu.</p>
 255
 256     <pre class="prettyprint lang-config">
 257       CacheReadTime 1000
 258     </pre>
 259
 260
 261 </div>
 262 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 263 <div class="directive-section"><h2><a name="CacheRoot" id="CacheRoot">CacheRoot</a> <a name="cacheroot" id="cacheroot">Directive</a></h2>
 264 <table class="directive">
 265 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La racine du répertoire dans lequel les fichiers du cache
 266 seront stockés</td></tr>
 267 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>répertoire</var></code></td></tr>
 268 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 269 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 270 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 271 </table>
 272     <p>La directive <code class="directive">CacheRoot</code> permet de définir
 273     le nom du répertoire sur disque qui contiendra les fichiers du
 274     cache. Si le module <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> a été chargé ou
 275     compilé dans le serveur Apache, cette directive <em>doit</em> être
 276     définie. L'absence de définition de la directive
 277     <code class="directive">CacheRoot</code> provoquera une erreur de traitement
 278     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
 279     définir la structure des sous-répertoires du répertoire racine
 280     spécifié.</p>
 281
 282     <pre class="prettyprint lang-config">
 283       CacheRoot c:/cacheroot
 284     </pre>
 285
 286
 287 </div>
 288 </div>
 289 <div class="bottomlang">
 290 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 291 <a href="../fr/mod/mod_cache_disk.html" title="Français">&nbsp;fr&nbsp;</a> |
 292 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 293 <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 294 </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&amp;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>
 295 <script type="text/javascript"><!--//--><![CDATA[//><!--
 296 var comments_shortname = 'httpd';
 297 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_disk.html';
 298 (function(w, d) {
 299     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 300         d.write('<div id="comments_thread"><\/div>');
 301         var s = d.createElement('script');
 302         s.type = 'text/javascript';
 303         s.async = true;
 304         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 305         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 306     }
 307     else {
 308         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 309     }
 310 })(window, document);
 311 //--><!]]></script></div><div id="footer">
 312 <p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 313 <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[//><!--
 314 if (typeof(prettyPrint) !== 'undefined') {
 315     prettyPrint();
 316 }
 317 //--><!]]></script>
 318 </body></html>