granicus.if.org Git - apache/blob - docs/manual/mod/mod_cache_socache.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_cache_socache - 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_cache_socache</h1>
  28 <div class="toplang">
  29 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_socache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_cache_socache.html" title="Français">&nbsp;fr&nbsp;</a></p>
  31 </div>
  32 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module de stockage à base de cache d'objets partagés
  33 (socache) pour le filtre de mise en 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_socache_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_cache_socache.c</td></tr></table>
  37 <h3>Sommaire</h3>
  38
  39     <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> implémente un
  40     gestionnaire de stockage à base de cache d'objets partagés (socache)
  41     pour le module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>.</p>
  42
  43     <p>Les en-têtes et corps des réponses mises en cache sont rassemblés
  44     et stockés sous une même clé dans le cache d'objets partagés. Il est
  45     possible de choisir entre plusieurs <a href="../socache.html">implémentations</a> de caches d'objets
  46     partagés.</p>
  47
  48     <p>Des réponses avec différents contenus négociés peuvent être
  49     stockées simultanément ; cependant, la mise en cache de contenus
  50     partiels n'est pas encore supportée par ce module.</p>
  51
  52     <pre class="prettyprint lang-config"># Activation de la mise en cache
  53 CacheSocache shmcb
  54 CacheSocacheMaxSize 102400
  55 &lt;Location "/foo"&gt;
  56     CacheEnable socache
  57 &lt;/Location&gt;
  58
  59 # Possibilité de se rabattre sur le cache disque
  60 CacheSocache shmcb
  61 CacheSocacheMaxSize 102400
  62 &lt;Location "/foo"&gt;
  63     CacheEnable socache
  64     CacheEnable disk
  65 &lt;/Location&gt;</pre>
  66
  67
  68     <div class="note"><h3>Note :</h3>
  69       <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> requiert les
  70       services du module <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> qui doit donc avoir
  71       été préalablement chargé.</p>
  72     </div>
  73 </div>
  74 <div id="quickview"><h3 class="directives">Directives</h3>
  75 <ul id="toc">
  76 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocache">CacheSocache</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocachemaxsize">CacheSocacheMaxSize</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocachemaxtime">CacheSocacheMaxTime</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocachemintime">CacheSocacheMinTime</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocachereadsize">CacheSocacheReadSize</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#cachesocachereadtime">CacheSocacheReadTime</a></li>
  82 </ul>
  83 <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_cache_socache">Problèmes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_cache_socache">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
  84 <ul class="seealso">
  85 <li><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></li>
  86 <li><code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code></li>
  87 <li><a href="../caching.html">Guide de la mise en cache</a></li>
  88 <li><a href="#comments_section">Commentaires</a></li></ul></div>
  89
  90 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  91 <div class="directive-section"><h2><a name="cachesocache" id="cachesocache">Directive</a> <a name="CacheSocache" id="CacheSocache">CacheSocache</a></h2>
  92 <table class="directive">
  93 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Implémentation du cache d'objets partagés à utiliser</td></tr>
  94 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocache <var>type[:args]</var></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_socache</td></tr>
  98 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
  99 Apache</td></tr>
 100 </table>
 101     <p>La directive <code class="directive">CacheSocache</code>
 102     définit l'implémentation du cache d'objets partagés à utiliser,
 103     suivie d'arguments optionnels. Il est
 104     possible de choisir entre plusieurs <a href="../socache.html">implémentations</a> de caches d'objets
 105     partagés.</p>
 106
 107     <pre class="prettyprint lang-config">CacheSocache shmcb</pre>
 108
 109
 110 </div>
 111 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 112 <div class="directive-section"><h2><a name="cachesocachemaxsize" id="cachesocachemaxsize">Directive</a> <a name="CacheSocacheMaxSize" id="CacheSocacheMaxSize">CacheSocacheMaxSize</a></h2>
 113 <table class="directive">
 114 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La taille maximale d'une entrée pouvant être placée dans le
 115 cache</td></tr>
 116 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxSize <var>octets</var></code></td></tr>
 117 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMaxSize 102400</code></td></tr>
 118 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 119 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 120 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
 121 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
 122 Apache</td></tr>
 123 </table>
 124     <p>La directive <code class="directive">CacheSocacheMaxSize</code>
 125     définit la taille maximale, en octets, de la somme des en-têtes et
 126     du corps d'un document pouvant être stocké dans le cache. Bien
 127     entendu, plus la taille des en-têtes sera grande, plus la taille
 128     maximale du corps du document s'en trouvera réduite.</p>
 129
 130     <p>Le module <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code> ne tentera de mettre
 131     en cache que des réponses qui possèdent une taille de contenu
 132     explicite, ou dont la taille est suffisamment petite pour qu'elles
 133     soient écrites en une seule passe. Ceci permet au module
 134     <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code> de mettre en cache des réponses dont
 135     la taille est trop importante pour pouvoir être mises en cache par
 136     <code class="module"><a href="../mod/mod_cache_socache.html">mod_cache_socache</a></code>.</p>
 137
 138     <pre class="prettyprint lang-config">CacheSocacheMaxSize 102400</pre>
 139
 140
 141 </div>
 142 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 143 <div class="directive-section"><h2><a name="cachesocachemaxtime" id="cachesocachemaxtime">Directive</a> <a name="CacheSocacheMaxTime" id="CacheSocacheMaxTime">CacheSocacheMaxTime</a></h2>
 144 <table class="directive">
 145 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée maximale de stockage d'un document dans le cache
 146 avant péremption</td></tr>
 147 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMaxTime <var>secondes</var></code></td></tr>
 148 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMaxTime 86400</code></td></tr>
 149 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 150 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 151 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
 152 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
 153 Apache</td></tr>
 154 </table>
 155     <p>La directive <code class="directive">CacheSocacheMaxTime</code>
 156     définit la durée de stockage maximale en secondes d'un document dans
 157     le cache avant péremption. Cette définition l'emporte sur la durée
 158     de fraîcheur définie pour le document par le protocole HTTP.</p>
 159
 160     <pre class="prettyprint lang-config">CacheSocacheMaxTime 86400</pre>
 161
 162
 163 </div>
 164 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 165 <div class="directive-section"><h2><a name="cachesocachemintime" id="cachesocachemintime">Directive</a> <a name="CacheSocacheMinTime" id="CacheSocacheMinTime">CacheSocacheMinTime</a></h2>
 166 <table class="directive">
 167 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale de stockage d'un document dans le cache</td></tr>
 168 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheMinTime <var>seconds</var></code></td></tr>
 169 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheMinTime 600</code></td></tr>
 170 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 171 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 172 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
 173 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
 174 Apache</td></tr>
 175 </table>
 176     <p>La directive <code class="directive">CacheSocacheMinTime</code>
 177     définit le nombre de secondes au delà de la durée de fraîcheur de la
 178     réponse pendant lesquelles cette dernière devra être stockée dans le
 179     cache d'objets partagés. En effet, si une réponse n'est stockée que
 180     pour une durée égale à sa durée de fraîcheur, elle n'a pas besoin
 181     d'être rafraîchie.</p>
 182
 183     <pre class="prettyprint lang-config">CacheSocacheMinTime 600</pre>
 184
 185
 186 </div>
 187 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 188 <div class="directive-section"><h2><a name="cachesocachereadsize" id="cachesocachereadsize">Directive</a> <a name="CacheSocacheReadSize" id="CacheSocacheReadSize">CacheSocacheReadSize</a></h2>
 189 <table class="directive">
 190 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La quantité minimale de données du document à lire et
 191 mettre en cache avant envoi au client</td></tr>
 192 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadSize <var>octets</var></code></td></tr>
 193 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheReadSize 0</code></td></tr>
 194 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 195 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 196 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
 197 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
 198 Apache</td></tr>
 199 </table>
 200     <p>La directive <code class="directive">CacheSocacheReadSize</code>
 201     définit la quantité minimale de données, en octets, à lire depuis
 202     l'arrière-plan avant envoi au client. Avec la valeur par défaut 0,
 203     les données sont transmises au client dès leur arrivée et quelle que
 204     soit leur taille. Si la valeur définie est non nulle, le cache
 205     disque va mettre en tampon au moins la quantité de données
 206     correspondante avant envoi au client. Ceci peut améliorer les
 207     performances en cas de mise en cache de contenu en provenance d'un
 208     mandataire inverse lent.</p>
 209
 210     <p>Cette directive n'a d'effet qu'au moment où les données sont
 211     stockées dans le cache, et non lorsqu'elles sont servies depuis le
 212     cache.</p>
 213
 214     <pre class="prettyprint lang-config">CacheSocacheReadSize 102400</pre>
 215
 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="cachesocachereadtime" id="cachesocachereadtime">Directive</a> <a name="CacheSocacheReadTime" id="CacheSocacheReadTime">CacheSocacheReadTime</a></h2>
 220 <table class="directive">
 221 <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>La durée minimale de lecture avant l'envoi des données</td></tr>
 222 <tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>CacheSocacheReadTime <var>millisecondes</var></code></td></tr>
 223 <tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>CacheSocacheReadTime 0</code></td></tr>
 224 <tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
 225 <tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
 226 <tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_cache_socache</td></tr>
 227 <tr><th><a href="directive-dict.html#Compatibility">Compatibilité:</a></th><td>Disponible à partir de la version 2.4.5 du serveur HTTP
 228 Apache</td></tr>
 229 </table>
 230     <p>La directive <code class="directive">CacheSocacheReadTime</code>
 231     définit le temps minimal qui doit s'écouler avant de tenter
 232     l'envoi des données au client. Cette durée sera mise à profit pour
 233     lire et mettre en tampon les données avant leur envoi au client.
 234     Ceci peut améliorer les performances en cas de mise en cache de
 235     contenu en provenance d'un mandataire inverse.</p>
 236
 237     <p>La valeur par défaut 0 désactive cette directive.</p>
 238
 239     <p>Cette directive n'a d'effet qu'au moment où les données sont
 240     stockées dans le cache, et non lorsqu'elles sont servies depuis le
 241     cache. Il est recommandé d'utiliser cette directive en concomitance
 242     avec la directive <code class="directive"><a href="#cachesocachereadsize">CacheSocacheReadSize</a></code> afin de
 243     s'assurer que le serveur ne mette pas les données en tampon de
 244     manière excessive dans le cas où les données arriveraient plus vite
 245     que prévu.</p>
 246
 247     <pre class="prettyprint lang-config">CacheSocacheReadTime 1000</pre>
 248
 249
 250 </div>
 251 </div>
 252 <div class="bottomlang">
 253 <p><span>Langues Disponibles: </span><a href="../en/mod/mod_cache_socache.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 254 <a href="../fr/mod/mod_cache_socache.html" title="Français">&nbsp;fr&nbsp;</a></p>
 255 </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>
 256 <script type="text/javascript"><!--//--><![CDATA[//><!--
 257 var comments_shortname = 'httpd';
 258 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_cache_socache.html';
 259 (function(w, d) {
 260     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 261         d.write('<div id="comments_thread"><\/div>');
 262         var s = d.createElement('script');
 263         s.type = 'text/javascript';
 264         s.async = true;
 265         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 266         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 267     }
 268     else {
 269         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 270     }
 271 })(window, document);
 272 //--><!]]></script></div><div id="footer">
 273 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 274 <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[//><!--
 275 if (typeof(prettyPrint) !== 'undefined') {
 276     prettyPrint();
 277 }
 278 //--><!]]></script>
 279 </body></html>