granicus.if.org Git - apache/blob - docs/manual/mod/mod_file_cache.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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_file_cache - 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">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <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>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Module Apache mod_file_cache</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_file_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_file_cache.html" title="Français">&nbsp;fr&nbsp;</a> |
  31 <a href="../ko/mod/mod_file_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
  32 </div>
  33 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Mise en cache mémoire d'une liste statique de
  34 fichiers</td></tr>
  35 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
  36 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>file_cache_module</td></tr>
  37 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_file_cache.c</td></tr></table>
  38 <h3>Sommaire</h3>
  39
  40
  41     <div class="warning">
  42       Ce module doit être utilisé avec précautions. Il est recommandé de
  43       lire attentivement ce document, car une mauvaise utilisation de
  44       <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> peut facilement conduire à la
  45       création d'un site inopérant.
  46     </div>
  47
  48     <p>La mise en cache de fichiers souvent demandés mais rarement
  49     modifiés est une technique qui peut réduire la charge du
  50     serveur. <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> met en oeuvre deux
  51     techniques de mise en cache de fichiers <em>statiques</em>
  52     fréquemment demandés. Des directives de configuration vous
  53     permettent d'indiquer à <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> soit
  54     d'ouvrir et de charger une image en mémoire d'un fichier avec
  55     <code>mmap()</code>, soit de pré-ouvrir un fichier et de maintenir en
  56     service le <em>gestionnaire</em> du fichier. Chacune de ces techniques
  57     amène à réduire la charge du serveur lors du traitement des
  58     requêtes concernant ces fichiers, en accomplissant une partie du
  59     travail nécessaire à la mise à disposition de ces fichiers (en
  60     particulier les opérations d'entrées/sorties sur les fichiers) au
  61     démarrage du serveur, plutôt qu'au cours de chaque requête.</p>
  62
  63     <p>Note : ces techniques sont inutilisables pour accélérer des
  64     programmes CGI ou d'autres fichiers servis par des gestionnaires de
  65     contenu spéciaux. Elles ne peuvent être utilisées que pour des
  66     fichiers standards en général servis par le gestionnaire de contenu
  67     de base d'Apache.</p>
  68
  69     <p>Ce module est une extension et s'inspire fortement du module
  70     d'Apache 1.3 <code>mod_mmap_static</code>.</p>
  71 </div>
  72 <div id="quickview"><h3>Sujets</h3>
  73 <ul id="topics">
  74 <li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de mod_file_cache</a></li>
  75 </ul><h3 class="directives">Directives</h3>
  76 <ul id="toc">
  77 <li><img alt="" src="../images/down.gif" /> <a href="#cachefile">CacheFile</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#mmapfile">MMapFile</a></li>
  79 </ul>
  80 <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__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_file_cache">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_file_cache">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  81 <ul class="seealso">
  82 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  83 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  84 <div class="section">
  85 <h2><a name="using" id="using">Utilisation de mod_file_cache</a><a title="Lien permanent" href="#using" class="permalink">&para;</a></h2>
  86
  87     <p><code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> gère la mise en cache d'une liste
  88     de fichiers définie de manière statique via une des directives
  89     <code class="directive"><a href="#mmapfile">MMapFile</a></code> ou
  90     <code class="directive"><a href="#cachefile">CacheFile</a></code> au niveau
  91     de la configuration du serveur principal.</p>
  92
  93     <p>Les deux directives ne sont pas supportées par toutes les
  94     plates-formes. Par exemple, Apache pour Windows ne supporte pas
  95     actuellement la directive <code class="directive"><a href="#mmapfile">MMapFile</a></code>, alors que d'autres
  96     plates-formes, comme AIX, supportent les deux. Vous recevrez un
  97     message d'erreur dans le journal des erreurs du serveur si vous
  98     essayez d'utiliser une directive non supportée. Si vous utilisez une
  99     directive non supportée, le serveur démarrera, mais les fichiers ne
 100     seront pas mis en cache. Sur les plates-formes qui supportent les
 101     deux directives, vous devez faire des essais afin de déterminer
 102     quelle directive vous convient le mieux.</p>
 103
 104     <h3>Directive MMapFile</h3>
 105
 106       <p>La directive <code class="directive"><a href="#mmapfile">MMapFile</a></code> du module
 107       <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> permet de transférer en mémoire
 108       une liste statique de fichiers à l'aide de l'appel système
 109       <code>mmap()</code>. Cet appel système est disponible sur la
 110       plupart des plates-formes de style Unix, mais pas sur toutes. Il
 111       existe parfois des limites spécifiques au système quant à la
 112       taille et au nombre de fichiers qui peuvent être
 113       <code>mmap()</code>és, et l'expérimentation est probablement la
 114       méthode la plus simple pour déterminer ces limites.</p>
 115
 116       <p>Ce <code>mmap()</code>age n'est effectué qu'une seul fois au
 117       démarrage ou redémarrage du serveur. Ainsi, chaque fois qu'un des
 118       fichiers chargés en mémoire est modifié au niveau du système de
 119       fichiers, vous <em>devez</em> redémarrer le serveur (voir la
 120       documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>). Pour bien
 121       insister sur ce point, si des fichiers sont modifiés <em>sur
 122       disque</em>, et si vous ne redémarrez pas le serveur, vous allez
 123       finir par servir des contenus complètement obsolètes. Vous devez
 124       mettre à jour les fichiers en renommant l'ancienne version et en
 125       enregistrant la nouvelle sur disque. Pour y parvenir, on peut
 126       utiliser des outils comme <code>rdist</code> et <code>mv</code>.
 127       La raison pour laquelle ce module ne prend pas en compte les
 128       modifications de fichiers réside dans le fait que cette
 129       vérification nécessiterait un appel à <code>stat()</code> à chaque
 130       accès, et en fin de compte, l'augmentation de la consommation de
 131       ressources finirait par aller contre le but initial de
 132       réduire les entrées/sorties.</p>
 133
 134
 135     <h3>Directive CacheFile</h3>
 136
 137       <p>La directive <code class="directive"><a href="#cachefile">CacheFile</a></code> du module
 138       <code class="module"><a href="../mod/mod_file_cache.html">mod_file_cache</a></code> permet d'associer un
 139       <em>gestionnaire</em> ou <em>descripteur de fichier</em> à chaque
 140       fichier énuméré dans la directive de configuration et place ces
 141       gestionnaires de fichiers ouverts dans le cache. Lorsqu'un des
 142       fichier est demandé, le serveur sélectionne son gestionnaire dans
 143       le cache et le transmet à l'API <code>sendfile()</code> (ou
 144       <code>TransmitFile()</code> sous Windows).</p>
 145
 146
 147
 148       <p>Cette mise en cache des gestionnaire n'est effectuée qu'une
 149       seule fois au démarrage ou redémarrage du système. Ainsi, chaque
 150       fois qu'un des fichiers chargés en mémoire est modifié au niveau
 151       du système de fichiers, vous <em>devez</em> redémarrer le serveur
 152       (voir la documentation sur l'<a href="../stopping.html">Arrêt et redémarrage</a>).
 153       Pour bien
 154       insister sur ce point, si des fichiers sont modifiés <em>sur
 155       disque</em>, et si vous ne redémarrez pas le serveur, vous allez
 156       finir par servir des contenus complètement obsolètes. Vous devez
 157       mettre à jour les fichiers en renommant l'ancienne version et en
 158       enregistrant la nouvelle sur disque. Pour y parvenir, on peut
 159       utiliser des outils comme <code>rdist</code> et
 160       <code>mv</code>.</p>
 161
 162
 163     <div class="note"><h3>Note</h3>
 164       <p>Ne cherchez pas de directive qui met tous les
 165       fichiers d'un répertoire en cache, de manière récursive. Pour y
 166       parvenir, vous pouvez vous reporter à la directive <code class="directive"><a href="../mod/core.html#include">Include</a></code>, et considérer cette
 167       commande :</p>
 168
 169       <div class="example"><p><code>
 170         find /www/htdocs -type f -print \<br />
 171         | sed -e 's/.*/mmapfile &amp;/' &gt; /www/conf/mmap.conf
 172       </code></p></div>
 173     </div>
 174 </div>
 175 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 176 <div class="directive-section"><h2><a name="cachefile" id="cachefile">Directive</a> <a name="CacheFile" id="CacheFile">CacheFile</a><a title="Lien permanent" href="#cachefile" class="permalink">&para;</a></h2>
 177 <table class="directive">
 178 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Met en cache une liste de gestionnaires de fichiers au
 179 démarrage</td></tr>
 180 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheFile <var>chemin_fichier</var> [<var>chemin fichier</var>] ...</code></td></tr>
 181 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
 182 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
 183 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_file_cache</td></tr>
 184 </table>
 185     <p>La directive <code class="directive">CacheFile</code> associe
 186     des gestionnaires à un ou plusieurs fichiers (séparés par des
 187     espaces), et place ceux-ci dans le cache au démarrage du
 188     serveur. Les gestionnaires des fichiers mis en cache sont
 189     automatiquement fermés à l'arrêt du serveur. Lorsqu'un ou plusieurs
 190     fichiers ont été modifiés sur disque, le serveur doit être redémarré
 191     afin que les modifications soient prises en compte par le cache.</p>
 192
 193     <p>Soyez prudent avec les arguments <var>chemin_fichier</var> : ils
 194     doivent correspondre exactement au chemin du système de fichier que
 195     créent les gestionnaires de traduction URL-vers-nom-fichier
 196     d'Apache. On ne peut pas comparer des inodes ou autres identifiants
 197     pour mettre en correspondance des chemins à l'aide de liens
 198     symboliques <em>(etc...)</em>, car là encore, ceci nécessiterait un
 199     appel à <code>stat()</code> supplémentaire, ce qui est inacceptable.
 200     Il n'est pas garanti que ce module fonctionne avec des noms de
 201     fichiers réécrits par <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> ou
 202     <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
 203
 204     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">CacheFile /usr/local/apache/htdocs/index.html</pre>
 205 </div>
 206
 207 </div>
 208 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 209 <div class="directive-section"><h2><a name="mmapfile" id="mmapfile">Directive</a> <a name="MMapFile" id="MMapFile">MMapFile</a><a title="Lien permanent" href="#mmapfile" class="permalink">&para;</a></h2>
 210 <table class="directive">
 211 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Charge au démarrage une liste de fichiers en
 212 mémoire</td></tr>
 213 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>MMapFile <var>chemin fichier</var> [<var>chemin_fichier</var>] ...</code></td></tr>
 214 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
 215 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Expérimental</td></tr>
 216 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_file_cache</td></tr>
 217 </table>
 218     <p>La directive <code class="directive">MMapFile</code> provoque le chargement d'un
 219     ou plusieurs fichiers (séparés par des espaces) en mémoire au
 220     démarrage du serveur. Ceux-ci sont automatiquement déchargés de la
 221     mémoire à l'arrêt du serveur. Lorsqu'un ou plusieurs fichiers ont
 222     été modifiés sur disque, on doit au minimum envoyer un signal
 223     <code>HUP</code> ou <code>USR1</code> au serveur afin de les
 224     re<code>mmap()</code>er.</p>
 225
 226     <p>Soyez prudent avec les arguments <var>chemin_fichier</var> : ils
 227     doivent correspondre exactement au chemin du système de fichier que
 228     créent les gestionnaires de traduction URL-vers-nom-fichier
 229     d'Apache. On ne peut pas comparer des inodes ou autres identifiants
 230     pour mettre en correspondance des chemins à l'aide de liens
 231     symboliques <em>(etc...)</em>, car là encore, ceci nécessiterait un
 232     appel à <code>stat()</code> supplémentaire, ce qui est inacceptable.
 233     Il n'est pas garanti que ce module fonctionne avec des noms de
 234     fichiers réécrits par <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> ou
 235     <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
 236
 237     <div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">MMapFile /usr/local/apache/htdocs/index.html</pre>
 238 </div>
 239
 240 </div>
 241 </div>
 242 <div class="bottomlang">
 243 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_file_cache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 244 <a href="../fr/mod/mod_file_cache.html" title="Français">&nbsp;fr&nbsp;</a> |
 245 <a href="../ko/mod/mod_file_cache.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
 246 </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>
 247 <script type="text/javascript"><!--//--><![CDATA[//><!--
 248 var comments_shortname = 'httpd';
 249 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_file_cache.html';
 250 (function(w, d) {
 251     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 252         d.write('<div id="comments_thread"><\/div>');
 253         var s = d.createElement('script');
 254         s.type = 'text/javascript';
 255         s.async = true;
 256         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 257         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 258     }
 259     else {
 260         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 261     }
 262 })(window, document);
 263 //--><!]]></script></div><div id="footer">
 264 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 265 <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[//><!--
 266 if (typeof(prettyPrint) !== 'undefined') {
 267     prettyPrint();
 268 }
 269 //--><!]]></script>
 270 </body></html>