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" />
  12 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  13 <body>
  14 <div id="page-header">
  15 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  16 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  17 <img alt="" src="../images/feather.gif" /></div>
  18 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  19 <div id="path">
  20 <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>
  21 <div id="page-content">
  22 <div id="preamble"><h1>Module Apache mod_cache_disk</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/mod/mod_cache_disk.html" title="Français">&nbsp;fr&nbsp;</a> |
  26 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  27 <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  28 </div>
  29 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
  30             anglaise pour les changements récents.</div>
  31 <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
  32 cache HTTP.</td></tr>
  33 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  34 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>cache_disk_module</td></tr>
  35 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_disk.c</td></tr></table>
  36 <h3>Sommaire</h3>
  37
  38     <p><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> implémente un gestionnaire de
  39     stockage sur disque pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
  40
  41     <p>Les en-têtes et corps des réponses mises en cache sont stockés
  42     séparément sur le disque, dans une structure de répertoires basée
  43     sur le condensé md5 de l'URL mise en cache.</p>
  44
  45     <p>Plusieurs réponses au contenu négocié peuvent être stockées en
  46     même temps, mais la mise en cache de contenus partiels n'est pas
  47     supportée actuellement par ce module.</p>
  48
  49     <p>Les mises à jour atomiques du cache pour les fichiers d'en-tête
  50     et de corps peuvent être effectuées sans verrouillage en
  51     enregistrant les numéros d'inode et de périphérique du fichier de
  52     corps dans le fichier d'en-tête. Ceci implique que les entrées du
  53     cache déplacées manuellement dans le cache seront ignorées.</p>
  54
  55     <p>L'utilitaire <code class="program"><a href="../programs/htcacheclean.html">htcacheclean</a></code> permet de lister et
  56     de supprimer les URLs du cache, ou de maintenir le cache en deçà de
  57     certaines limites de taille et/ou de nombre d'inodes. L'utilitaire
  58     peut être exécuté à la demande, ou automatiquement pour assurer un
  59     contrôle continu des tailles des répertoires.</p>
  60
  61     <div class="note"><h3>Note :</h3>
  62       <p><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> doit être chargé avant
  63       <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> pour que ce dernier puisse
  64       fonctionner.</p>
  65     </div>
  66     <p>Lorsque la plate-forme la supporte, et si elle est activée via la
  67     directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code>,
  68     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> utilise la fonctionnalité sendfile
  69     pour servir les fichiers à partir du cache. Cependant,
  70     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> ignore la configuration de la
  71     directive <code class="directive"><a href="../mod/core.html#enablesendfile">EnableSendfile</a></code> dans
  72     un contexte de répertoire ou de fichier .htaccess, car le module ne
  73     dispose pas des définitions correspondantes lorsque la requête est
  74     servie depuis le cache.</p>
  75 </div>
  76 <div id="quickview"><h3 class="directives">Directives</h3>
  77 <ul id="toc">
  78 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlength">CacheDirLength</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#cachedirlevels">CacheDirLevels</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#cachemaxfilesize">CacheMaxFileSize</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#cacheminfilesize">CacheMinFileSize</a></li>
  82 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadsize">CacheReadSize</a></li>
  83 <li><img alt="" src="../images/down.gif" /> <a href="#cachereadtime">CacheReadTime</a></li>
  84 <li><img alt="" src="../images/down.gif" /> <a href="#cacheroot">CacheRoot</a></li>
  85 </ul>
  86 </div>
  87
  88 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  89 <div class="directive-section"><h2><a name="CacheDirLength" id="CacheDirLength">CacheDirLength</a> <a name="cachedirlength" id="cachedirlength">Directive</a></h2>
  90 <table class="directive">
  91 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de caractères des noms des
  92 sous-répertoires</td></tr>
  93 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLength <var>longueur</var></code></td></tr>
  94 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLength 2</code></td></tr>
  95 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
  96 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
  97 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
  98 </table>
  99     <p>la directive <code class="directive">CacheDirLength</code> permet de
 100     définir le nombre de caractères que comportera chaque nom de
 101     sous-répertoire de la hiérarchie du cache. On peut l'utiliser en
 102     conjonction avec <code class="directive">CacheDirLevels</code> pour
 103     déterminer une structure approximative de la hiérarchie de
 104     cache.</p>
 105     <p>Une valeur haute pour <code class="directive">CacheDirLength</code>
 106     combinée avec une valeur basse pour
 107     <code class="directive">CacheDirLevels</code> générera une hiérarchie
 108     relativement peu profonde, avec un grand nombre de sous-répertoires
 109     à chaque niveau.</p>
 110
 111     <div class="note">
 112       <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
 113       <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
 114       doit pas dépasser 20.</p>
 115     </div>
 116
 117
 118 </div>
 119 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 120 <div class="directive-section"><h2><a name="CacheDirLevels" id="CacheDirLevels">CacheDirLevels</a> <a name="cachedirlevels" id="cachedirlevels">Directive</a></h2>
 121 <table class="directive">
 122 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le nombre de niveaux de sous-répertoires que comportera le
 123 cache.</td></tr>
 124 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheDirLevels <var>niveaux</var></code></td></tr>
 125 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheDirLevels 2</code></td></tr>
 126 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 127 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 128 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 129 </table>
 130     <p>La directive <code class="directive">CacheDirLevels</code> permet de
 131     définir le nombre de niveaux de sous-répertoires que comportera le
 132     cache. Les données du cache seront stokées au niveau correspondant
 133     par rapport au répertoire <code class="directive"><a href="#cacheroot">CacheRoot</a></code>.</p>
 134     <p>Une valeur haute pour <code class="directive">CacheDirLevels</code>
 135     combinée avec une valeur basse pour
 136     <code class="directive">CacheDirLength</code> générera une arborescence
 137     très développée, avec un petit nombre de sous-répertoires à chaque
 138     niveau.</p>
 139
 140     <div class="note">
 141       <p>La valeur du produit <code class="directive">CacheDirLevels</code> *
 142       <code class="directive"><a href="#cachedirlength">CacheDirLength</a></code> ne
 143       doit pas dépasser 20.</p>
 144     </div>
 145
 146
 147 </div>
 148 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 149 <div class="directive-section"><h2><a name="CacheMaxFileSize" id="CacheMaxFileSize">CacheMaxFileSize</a> <a name="cachemaxfilesize" id="cachemaxfilesize">Directive</a></h2>
 150 <table class="directive">
 151 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>&gt;La taille maximale (en octets) d'un document pour pouvoir
 152 être stocké dans le cache</td></tr>
 153 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMaxFileSize <var>octets</var></code></td></tr>
 154 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMaxFileSize 1000000</code></td></tr>
 155 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 156 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 157 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 158 </table>
 159     <p>La directive <code class="directive">CacheMaxFileSize</code> permet de
 160     définir la taille maximale d'un document, en octets, pour que
 161     celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
 162
 163     <div class="example"><p><code>
 164       CacheMaxFileSize 64000
 165     </code></p></div>
 166
 167 </div>
 168 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 169 <div class="directive-section"><h2><a name="CacheMinFileSize" id="CacheMinFileSize">CacheMinFileSize</a> <a name="cacheminfilesize" id="cacheminfilesize">Directive</a></h2>
 170 <table class="directive">
 171 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille minimale (en octets) d'un document pour pouvoir
 172 être stocké dans le cache</td></tr>
 173 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheMinFileSize <var>octets</var></code></td></tr>
 174 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheMinFileSize 1</code></td></tr>
 175 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 176 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 177 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 178 </table>
 179     <p>La directive <code class="directive">CacheMinFileSize</code> permet de
 180     définir la taille minimale d'un document, en octets, pour que
 181     celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
 182
 183     <div class="example"><p><code>
 184       CacheMinFileSize 64
 185     </code></p></div>
 186
 187 </div>
 188 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 189 <div class="directive-section"><h2><a name="CacheReadSize" id="CacheReadSize">CacheReadSize</a> <a name="cachereadsize" id="cachereadsize">Directive</a></h2>
 190 <table class="directive">
 191 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale (en octets) de données à lire et à
 192 mettre en cache avant de les envoyer au client</td></tr>
 193 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadSize <var>octets</var></code></td></tr>
 194 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadSize 0</code></td></tr>
 195 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 196 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 197 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 198 </table>
 199     <p>La directive <code class="directive">CacheReadSize</code> permet de
 200     définir la quantité minimale de données, en octets, à lire depuis le
 201     serveur d'arrière-plan avant de les envoyer au client. Avec la
 202     valeur par défaut zéro, toute donnée de toutes tailles est envoyée
 203     au client dès qu'elle est disponible. Avec une valeur non nulle, le
 204     cache disque met en tampon au moins la quantité de données
 205     correspondante avant d'envoyer la réponse au client. Les
 206     performances peuvent s'en trouver améliorées lorsqu'on met en cache
 207     du contenu en provenance d'un mandataire inverse.</p>
 208
 209     <p>Cette directive ne prend effet que lorsque les données sont
 210     enregistrées dans le cache, et non lorsque les données sont servies à
 211     partir du cache.</p>
 212
 213     <div class="example"><p><code>
 214       CacheReadSize 102400
 215     </code></p></div>
 216
 217 </div>
 218 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 219 <div class="directive-section"><h2><a name="CacheReadTime" id="CacheReadTime">CacheReadTime</a> <a name="cachereadtime" id="cachereadtime">Directive</a></h2>
 220 <table class="directive">
 221 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Le temps minimum (en millisecondes) qui doit s'écouler
 222 avant d'envoyer les données au client</td></tr>
 223 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheReadTime <var>millisecondes</var></code></td></tr>
 224 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheReadTime 0</code></td></tr>
 225 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 226 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 227 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 228 </table>
 229     <p>La directive <code class="directive">CacheReadTime</code> permet de
 230     définir le temps minimum qui doit s'écouler avant d'essayer
 231     d'envoyer des données au client. Pendant ce temps, les données sont
 232     mises en tampon avant de pouvoir être envoyées au client. Les
 233     performances peuvent s'en trouver améliorées lorsqu'on met en cache
 234     du contenu en provenance d'un mandataire inverse.</p>
 235
 236     <p>La valeur par défaut zéro désactive cette option.</p>
 237
 238     <p>Cette directive ne prend effet que lorsque les données sont
 239     enregistrées dans le cache, et non lorsque les données sont servies à
 240     partir du cache. Il est recommandé d'harmoniser l'utilisation de cette
 241     directive avec celle de la directive <code class="directive"><a href="#cachereadsize">CacheReadSize</a></code>, afin de s'assurer
 242     que le serveur n'effectue pas une mise en tampon excessive au cas
 243     où les données arriveraient plus vite que prévu.</p>
 244
 245     <div class="example"><p><code>
 246       CacheReadTime 1000
 247     </code></p></div>
 248
 249 </div>
 250 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 251 <div class="directive-section"><h2><a name="CacheRoot" id="CacheRoot">CacheRoot</a> <a name="cacheroot" id="cacheroot">Directive</a></h2>
 252 <table class="directive">
 253 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La racine du répertoire dans lequel les fichiers du cache
 254 seront stockés</td></tr>
 255 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheRoot <var>répertoire</var></code></td></tr>
 256 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
 257 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 258 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_disk</td></tr>
 259 </table>
 260     <p>La directive <code class="directive">CacheRoot</code> permet de définir
 261     le nom du répertoire sur disque qui contiendra les fichiers du
 262     cache. Si le module <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> a été chargé ou
 263     compilé dans le serveur Apache, cette directive <em>doit</em> être
 264     définie. L'absence de définition de la directive
 265     <code class="directive">CacheRoot</code> provoquera une erreur de traitement
 266     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
 267     définir la structure des sous-répertoires du répertoire racine
 268     spécifié.</p>
 269
 270     <div class="example"><p><code>
 271       CacheRoot c:/cacheroot
 272     </code></p></div>
 273
 274 </div>
 275 </div>
 276 <div class="bottomlang">
 277 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_disk.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 278 <a href="../fr/mod/mod_cache_disk.html" title="Français">&nbsp;fr&nbsp;</a> |
 279 <a href="../ja/mod/mod_cache_disk.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 280 <a href="../ko/mod/mod_cache_disk.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 281 </div><div id="footer">
 282 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 283 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
 284 </body></html>