<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1484544 -->
+<!-- English Revision : 1598123 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<modulesynopsis metafile="mod_cache_socache.xml.meta">
<name>mod_cache_socache</name>
-<description>Module de stockage à base de cache d'objets partagés
+<description>Module de stockage à base de cache d'objets partagés
(socache) pour le filtre de mise en cache HTTP.</description>
<status>Extension</status>
<sourcefile>mod_cache_socache.c</sourcefile>
<identifier>cache_socache_module</identifier>
<summary>
- <p>Le module <module>mod_cache_socache</module> implémente un
- gestionnaire de stockage à base de cache d'objets partagés (socache)
+ <p>Le module <module>mod_cache_socache</module> implémente un
+ gestionnaire de stockage à base de cache d'objets partagés (socache)
pour le module <module>mod_cache</module>.</p>
- <p>Les en-têtes et corps des réponses mises en cache sont rassemblés
- et stockés sous une même clé dans le cache d'objets partagés. Il est
+ <p>Les en-têtes et corps des réponses mises en cache sont rassemblés
+ et stockés sous une même clé dans le cache d'objets partagés. Il est
possible de choisir entre plusieurs <a
- href="../socache.html">implémentations</a> de caches d'objets
- partagés.</p>
+ href="../socache.html">implémentations</a> de caches d'objets
+ partagés.</p>
- <p>Des réponses avec différents contenus négociés peuvent être
- stockées simultanément ; cependant, la mise en cache de contenus
- partiels n'est pas encore supportée par ce module.</p>
+ <p>Des réponses avec différents contenus négociés peuvent être
+ stockées simultanément ; cependant, la mise en cache de contenus
+ partiels n'est pas encore supportée par ce module.</p>
<highlight language="config">
# Activation de la mise en cache
CacheEnable socache
</Location>
-# Possibilité de se rabattre sur le cache disque
+# Possibilité de se rabattre sur le cache disque
CacheSocache shmcb
CacheSocacheMaxSize 102400
<Location /foo>
<note><title>Note :</title>
<p>Le module <module>mod_cache_socache</module> requiert les
services du module <module>mod_cache</module> qui doit donc avoir
- été préalablement chargé.</p>
+ été préalablement chargé.</p>
</note>
</summary>
<seealso><module>mod_cache</module></seealso>
<directivesynopsis>
<name>CacheSocache</name>
-<description>La racine des répertoires sous lesquels les fichiers de
-cache sont stockés</description>
-<!-- La description ne correspond pas à la directive -->
+<description>L'implémentation du cache d'objets partagés à utiliser</description>
+<!-- La description ne correspond pas à la directive -->
<syntax>CacheSocache <var>type[:args]</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
Apache</compatibility>
<usage>
- <p>La directive <directive>CacheSocache</directive> définit
- l'implémentation du cache d'objets partagés à utiliser,
+ <p>La directive <directive>CacheSocache</directive> définit
+ l'implémentation du cache d'objets partagés à utiliser,
suivie d'arguments optionnels. On peut choisir entre <a
- href="../socache.html">plusieurs implémentations</a> de caches d'objets
- partagés.</p>
+ href="../socache.html">plusieurs implémentations</a> de caches d'objets
+ partagés.</p>
<highlight language="config">
CacheSocache shmcb
<directivesynopsis>
<name>CacheSocacheMaxTime</name>
-<description>La durée maximale de stockage d'un document dans le cache
-avant péremption</description>
+<description>La durée maximale de stockage d'un document dans le cache
+avant péremption</description>
<syntax>CacheSocacheMaxTime <var>secondes</var></syntax>
<default>CacheSocacheMaxTime 86400</default>
<contextlist><context>server config</context>
<context>directory</context>
<context>.htaccess</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
Apache</compatibility>
<usage>
<p>La directive <directive>CacheSocacheMaxTime</directive> permet de
- définir la durée de stockage maximale en secondes d'un document dans
- le cache avant péremption. Cette définition l'emporte sur la durée
- de fraîcheur définie pour le document par le protocole HTTP.</p>
+ définir la durée de stockage maximale en secondes d'un document dans
+ le cache avant péremption. Cette définition l'emporte sur la durée
+ de fraîcheur définie pour le document par le protocole HTTP.</p>
<highlight language="config">
CacheSocacheMaxTime 86400
<directivesynopsis>
<name>CacheSocacheMinTime</name>
-<description>La durée minimale de stockage d'un document dans le cache</description>
+<description>La durée minimale de stockage d'un document dans le cache</description>
<syntax>CacheSocacheMinTime <var>seconds</var></syntax>
<default>CacheSocacheMinTime 600</default>
<contextlist><context>server config</context>
<context>directory</context>
<context>.htaccess</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.5 du serveur HTTP
Apache</compatibility>
<usage>
- <p>La directive <directive>CacheSocacheMinTime</directive> définit
- le nombre de secondes au delà de la durée de fraîcheur de la
- réponse pendant lesquelles cette dernière devra être stockée dans le
- cache d'objets partagés. Si une réponse n'est stockée que
- pour une durée égale à sa durée de fraîcheur, il n'y aura pas lieu
- de la rafraîchir.</p>
+ <p>La directive <directive>CacheSocacheMinTime</directive> définit
+ le nombre de secondes au delà de la durée de fraîcheur de la
+ réponse pendant lesquelles cette dernière devra être stockée dans le
+ cache d'objets partagés. Si une réponse n'est stockée que
+ pour une durée égale à sa durée de fraîcheur, il n'y aura pas lieu
+ de la rafraîchir.</p>
<highlight language="config">
CacheSocacheMinTime 600
<directivesynopsis>
<name>CacheSocacheMaxSize</name>
-<description>La taille maximale d'une entrée pouvant être placée dans le
+<description>La taille maximale d'une entrée pouvant être placée dans le
cache</description>
<syntax>CacheSocacheMaxSize <var>octets</var></syntax>
<default>CacheSocacheMaxSize 102400</default>
<context>directory</context>
<context>.htaccess</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
Apache</compatibility>
<usage>
- <p>La directive <directive>CacheSocacheMaxSize</directive> définit
- la taille maximale, en octets, de la somme des en-têtes et
- du corps d'un document pouvant être stocké dans le cache. Bien
- entendu, plus la taille des en-têtes sera grande, plus la taille
- maximale du corps du document s'en trouvera réduite.</p>
+ <p>La directive <directive>CacheSocacheMaxSize</directive> définit
+ la taille maximale, en octets, de la somme des en-têtes et
+ du corps d'un document pouvant être stocké dans le cache. Bien
+ entendu, plus la taille des en-têtes sera grande, plus la taille
+ maximale du corps du document s'en trouvera réduite.</p>
<p>Le module <module>mod_cache_socache</module> ne tentera de mettre
- en cache que des réponses qui possèdent une taille de contenu
+ en cache que des réponses qui possèdent une taille de contenu
explicite, ou dont la taille est suffisamment petite pour qu'elles
- soient écrites en une seule passe. On pourra ainsi laisser le module
- <module>mod_cache_disk</module> mettre en cache des réponses dont
- la taille est trop importante pour pouvoir être mises en cache par
+ soient écrites en une seule passe. On pourra ainsi laisser le module
+ <module>mod_cache_disk</module> mettre en cache des réponses dont
+ la taille est trop importante pour pouvoir être mises en cache par
<module>mod_cache_socache</module>.</p>
<highlight language="config">
<directivesynopsis>
<name>CacheSocacheReadSize</name>
-<description>La quantité minimale de données du document à lire et
+<description>La quantité minimale de données du document à lire et
mettre en cache avant envoi au client</description>
<syntax>CacheSocacheReadSize <var>octets</var></syntax>
<default>CacheSocacheReadSize 0</default>
<context>directory</context>
<context>.htaccess</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.5 du serveur HTTP
Apache</compatibility>
<usage>
- <p>La directive <directive>CacheSocacheReadSize</directive> définit
- la quantité minimale de données, en octets, à lire depuis
- l'arrière-plan avant envoi au client. Avec la valeur par défaut 0,
- les données sont transmises au client dès leur arrivée et quelle que
- soit leur taille. Si la valeur définie est non nulle, le cache
- disque va mettre en tampon au moins la quantité de données
- correspondante avant envoi au client. Ceci peut améliorer les
+ <p>La directive <directive>CacheSocacheReadSize</directive> définit
+ la quantité minimale de données, en octets, à lire depuis
+ l'arrière-plan avant envoi au client. Avec la valeur par défaut 0,
+ les données sont transmises au client dès leur arrivée et quelle que
+ soit leur taille. Si la valeur définie est non nulle, le cache
+ disque va mettre en tampon au moins la quantité de données
+ correspondante avant envoi au client. Ceci peut améliorer les
performances en cas de mise en cache de contenu en provenance d'un
mandataire inverse lent.</p>
- <p>Cette directive n'a d'effet qu'au moment où les données sont
- stockées dans le cache, et non lorsqu'elles sont servies depuis le
+ <p>Cette directive n'a d'effet qu'au moment où les données sont
+ stockées dans le cache, et non lorsqu'elles sont servies depuis le
cache.</p>
<highlight language="config">
<directivesynopsis>
<name>CacheSocacheReadTime</name>
-<description>La durée minimale de lecture avant l'envoi des données</description>
+<description>La durée minimale de lecture avant l'envoi des données</description>
<syntax>CacheSocacheReadTime <var>millisecondes</var></syntax>
<default>CacheSocacheReadTime 0</default>
<contextlist><context>server config</context>
<context>directory</context>
<context>.htaccess</context>
</contextlist>
-<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
+<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP
Apache</compatibility>
<usage>
- <p>La directive <directive>CacheSocacheReadTime</directive> définit
- le temps minimal qui doit s'écouler avant de tenter
- l'envoi des données au client. Cette durée sera mise à profit pour
- lire et mettre en tampon les données avant leur envoi au client.
- Ceci peut améliorer les performances en cas de mise en cache de
+ <p>La directive <directive>CacheSocacheReadTime</directive> définit
+ le temps minimal qui doit s'écouler avant de tenter
+ l'envoi des données au client. Cette durée sera mise à profit pour
+ lire et mettre en tampon les données avant leur envoi au client.
+ Ceci peut améliorer les performances en cas de mise en cache de
contenu en provenance d'un mandataire inverse.</p>
- <p>La valeur par défaut 0 désactive cette directive.</p>
+ <p>La valeur par défaut 0 désactive cette directive.</p>
- <p>Cette directive n'a d'effet qu'au moment où les données sont
- stockées dans le cache, et non lorsqu'elles sont servies depuis le
- cache. Il est recommandé d'utiliser cette directive en concomitance
+ <p>Cette directive n'a d'effet qu'au moment où les données sont
+ stockées dans le cache, et non lorsqu'elles sont servies depuis le
+ cache. Il est recommandé d'utiliser cette directive en concomitance
avec la directive <directive
module="mod_cache_socache">CacheSocacheReadSize</directive> afin de
- s'assurer que le serveur ne mette pas les données en tampon de
- manière excessive dans le cas où les données arriveraient plus vite
- que prévu.</p>
+ s'assurer que le serveur ne mette pas les données en tampon de
+ manière excessive dans le cas où les données arriveraient plus vite
+ que prévu.</p>
<highlight language="config">
CacheSocacheReadTime 1000