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