d32fae803076bce020fb9cb595a383f78ea740ebkess<?xml version="1.0"?>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

2772c0bad271d7a345ef7779dd318fa6098a6bfand<?xml-stylesheet type="text/xsl" href="/style/manual.fr.xsl"?>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<modulesynopsis metafile="mod_cache_socache.xml.meta">

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<name>mod_cache_socache</name>

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<description>Module de stockage &agrave; base de cache d'objets partag&eacute;s

f804ec6e56dc58300c256b0fff0f2ca3f226c5b5nd(socache) pour le filtre de mise en cache HTTP.</description>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<status>Extension</status>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<sourcefile>mod_cache_socache.c</sourcefile>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<identifier>cache_socache_module</identifier>

52bc21ad2115333a8295c5f3e4f328d7431e6989nd

2772c0bad271d7a345ef7779dd318fa6098a6bfand<summary>

2772c0bad271d7a345ef7779dd318fa6098a6bfand <p>Le module <module>mod_cache_socache</module> impl&eacute;mente un

2772c0bad271d7a345ef7779dd318fa6098a6bfand gestionnaire de stockage &agrave; base de cache d'objets partag&eacute;s (socache)

2772c0bad271d7a345ef7779dd318fa6098a6bfand pour le module <module>mod_cache</module>.</p>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand <p>Les en-t&ecirc;tes et corps des r&eacute;ponses mises en cache sont rassembl&eacute;s

2772c0bad271d7a345ef7779dd318fa6098a6bfand et stock&eacute;s sous une m&ecirc;me cl&eacute; dans le cache d'objets partag&eacute;s. Il est

2772c0bad271d7a345ef7779dd318fa6098a6bfand possible de choisir entre plusieurs <a

2772c0bad271d7a345ef7779dd318fa6098a6bfand href="/socache.html">impl&eacute;mentations</a> de caches d'objets

2772c0bad271d7a345ef7779dd318fa6098a6bfand partag&eacute;s.</p>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand <p>Des r&eacute;ponses avec diff&eacute;rents contenus n&eacute;goci&eacute;s peuvent &ecirc;tre

2772c0bad271d7a345ef7779dd318fa6098a6bfand stock&eacute;es simultan&eacute;ment ; cependant, la mise en cache de contenus

2772c0bad271d7a345ef7779dd318fa6098a6bfand partiels n'est pas encore support&eacute;e par ce module.</p>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand <highlight language="config">

2772c0bad271d7a345ef7779dd318fa6098a6bfand# Activation de la mise en cache

2772c0bad271d7a345ef7779dd318fa6098a6bfandCacheSocache shmcb

2772c0bad271d7a345ef7779dd318fa6098a6bfandCacheSocacheMaxSize 102400

2772c0bad271d7a345ef7779dd318fa6098a6bfand&lt;Location /foo&gt;

2772c0bad271d7a345ef7779dd318fa6098a6bfand CacheEnable socache

2772c0bad271d7a345ef7779dd318fa6098a6bfand&lt;/Location&gt;

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand# Possibilit&eacute; de se rabattre sur le cache disque

2772c0bad271d7a345ef7779dd318fa6098a6bfandCacheSocache shmcb

2772c0bad271d7a345ef7779dd318fa6098a6bfandCacheSocacheMaxSize 102400

2772c0bad271d7a345ef7779dd318fa6098a6bfand&lt;Location /foo&gt;

2772c0bad271d7a345ef7779dd318fa6098a6bfand CacheEnable socache

2772c0bad271d7a345ef7779dd318fa6098a6bfand CacheEnable disk

2772c0bad271d7a345ef7779dd318fa6098a6bfand&lt;/Location&gt;

2772c0bad271d7a345ef7779dd318fa6098a6bfand </highlight>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand <note><title>Note :</title>

2772c0bad271d7a345ef7779dd318fa6098a6bfand <p>Le module <module>mod_cache_socache</module> requiert les

2772c0bad271d7a345ef7779dd318fa6098a6bfand services du module <module>mod_cache</module> qui doit donc avoir

2772c0bad271d7a345ef7779dd318fa6098a6bfand &eacute;t&eacute; pr&eacute;alablement charg&eacute;.</p>

2772c0bad271d7a345ef7779dd318fa6098a6bfand </note>

2772c0bad271d7a345ef7779dd318fa6098a6bfand</summary>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<seealso><module>mod_cache</module></seealso>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<seealso><module>mod_cache_disk</module></seealso>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<seealso><a href="/caching.html">Guide de la mise en cache</a></seealso>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand<directivesynopsis>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<name>CacheSocache</name>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<description>Impl&eacute;mentation du cache d'objets partag&eacute;s &agrave; utiliser</description>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<syntax>CacheSocache <var>type[:args]</var></syntax>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<contextlist><context>server config</context><context>virtual host</context>

2772c0bad271d7a345ef7779dd318fa6098a6bfand</contextlist>

2772c0bad271d7a345ef7779dd318fa6098a6bfand<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

2772c0bad271d7a345ef7779dd318fa6098a6bfandApache</compatibility>

2772c0bad271d7a345ef7779dd318fa6098a6bfand

2772c0bad271d7a345ef7779dd318fa6098a6bfand<usage>

2772c0bad271d7a345ef7779dd318fa6098a6bfand <p>La directive <directive>CacheSocache</directive>

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd d&eacute;finit l'impl&eacute;mentation du cache d'objets partag&eacute;s &agrave; utiliser,

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd suivie d'arguments optionnels. Il est

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd possible de choisir entre plusieurs <a

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd href="/socache.html">impl&eacute;mentations</a> de caches d'objets

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd partag&eacute;s.</p>

ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd

3b3b7fc78d1f5bfc2769903375050048ff41ff26nd <highlight language="config">

2772c0bad271d7a345ef7779dd318fa6098a6bfand CacheSocache shmcb

2772c0bad271d7a345ef7779dd318fa6098a6bfand </highlight>

2772c0bad271d7a345ef7779dd318fa6098a6bfand</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheSocacheMaxTime</name>

<description>La dur&eacute;e maximale de stockage d'un document dans le cache

avant p&eacute;remption</description>

<syntax>CacheSocacheMaxTime <var>secondes</var></syntax>

<default>CacheSocacheMaxTime 86400</default>

<contextlist><context>server config</context>

<context>virtual host</context>

<context>directory</context>

<context>.htaccess</context>

</contextlist>

<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

Apache</compatibility>

<usage>

<p>La directive <directive>CacheSocacheMaxTime</directive>

d&eacute;finit la dur&eacute;e de stockage maximale en secondes d'un document dans

le cache avant p&eacute;remption. Cette d&eacute;finition l'emporte sur la dur&eacute;e

de fra&icirc;cheur d&eacute;finie pour le document par le protocole HTTP.</p>

<highlight language="config">

CacheSocacheMaxTime 86400

</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheSocacheMinTime</name>

<description>La dur&eacute;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>virtual host</context>

<context>directory</context>

<context>.htaccess</context>

</contextlist>

<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

Apache</compatibility>

<usage>

<p>La directive <directive>CacheSocacheMinTime</directive>

d&eacute;finit le nombre de secondes au del&agrave; de la dur&eacute;e de fra&icirc;cheur de la

r&eacute;ponse pendant lesquelles cette derni&egrave;re devra &ecirc;tre stock&eacute;e dans le

cache d'objets partag&eacute;s. En effet, si une r&eacute;ponse n'est stock&eacute;e que

pour une dur&eacute;e &eacute;gale &agrave; sa dur&eacute;e de fra&icirc;cheur, elle n'a pas besoin

d'&ecirc;tre rafra&icirc;chie.</p>

<highlight language="config">

CacheSocacheMinTime 600

</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheSocacheMaxSize</name>

<description>La taille maximale d'une entr&eacute;e pouvant &ecirc;tre plac&eacute;e dans le

cache</description>

<syntax>CacheSocacheMaxSize <var>octets</var></syntax>

<default>CacheSocacheMaxSize 102400</default>

<contextlist><context>server config</context>

<context>virtual host</context>

<context>directory</context>

<context>.htaccess</context>

</contextlist>

<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

Apache</compatibility>

<usage>

<p>La directive <directive>CacheSocacheMaxSize</directive>

d&eacute;finit la taille maximale, en octets, de la somme des en-t&ecirc;tes et

du corps d'un document pouvant &ecirc;tre stock&eacute; dans le cache. Bien

entendu, plus la taille des en-t&ecirc;tes sera grande, plus la taille

maximale du corps du document s'en trouvera r&eacute;duite.</p>

<p>Le module <module>mod_cache_socache</module> ne tentera de mettre

en cache que des r&eacute;ponses qui poss&egrave;dent une taille de contenu

explicite, ou dont la taille est suffisamment petite pour qu'elles

soient &eacute;crites en une seule passe. Ceci permet au module

<module>mod_cache_disk</module> de mettre en cache des r&eacute;ponses dont

la taille est trop importante pour pouvoir &ecirc;tre mises en cache par

<module>mod_cache_socache</module>.</p>

<highlight language="config">

CacheSocacheMaxSize 102400

</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheSocacheReadSize</name>

<description>La quantit&eacute; minimale de donn&eacute;es du document &agrave; lire et

mettre en cache avant envoi au client</description>

<syntax>CacheSocacheReadSize <var>octets</var></syntax>

<default>CacheSocacheReadSize 0</default>

<contextlist><context>server config</context>

<context>virtual host</context>

<context>directory</context>

<context>.htaccess</context>

</contextlist>

<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

Apache</compatibility>

<usage>

<p>La directive <directive>CacheSocacheReadSize</directive>

d&eacute;finit la quantit&eacute; minimale de donn&eacute;es, en octets, &agrave; lire depuis

l'arri&egrave;re-plan avant envoi au client. Avec la valeur par d&eacute;faut 0,

les donn&eacute;es sont transmises au client d&egrave;s leur arriv&eacute;e et quelle que

soit leur taille. Si la valeur d&eacute;finie est non nulle, le cache

disque va mettre en tampon au moins la quantit&eacute; de donn&eacute;es

correspondante avant envoi au client. Ceci peut am&eacute;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&ugrave; les donn&eacute;es sont

stock&eacute;es dans le cache, et non lorsqu'elles sont servies depuis le

cache.</p>

<highlight language="config">

CacheReadSize 102400

</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>CacheSocacheReadTime</name>

<description>La dur&eacute;e minimale de lecture avant l'envoi des donn&eacute;es</description>

<syntax>CacheSocacheReadTime <var>millisecondes</var></syntax>

<default>CacheSocacheReadTime 0</default>

<contextlist><context>server config</context>

<context>virtual host</context>

<context>directory</context>

<context>.htaccess</context>

</contextlist>

<compatibility>Disponible &agrave; partir de la version 2.5 du serveur HTTP

Apache</compatibility>

<usage>

<p>La directive <directive>CacheSocacheReadTime</directive>

d&eacute;finit le temps minimal qui doit s'&eacute;couler avant de tenter

l'envoi des donn&eacute;es au client. Cette dur&eacute;e sera mise &agrave; profit pour

lire et mettre en tampon les donn&eacute;es avant leur envoi au client.

Ceci peut am&eacute;liorer les performances en cas de mise en cache de

contenu en provenance d'un mandataire inverse.</p>

<p>La valeur par d&eacute;faut 0 d&eacute;sactive cette directive.</p>

<p>Cette directive n'a d'effet qu'au moment o&ugrave; les donn&eacute;es sont

stock&eacute;es dans le cache, et non lorsqu'elles sont servies depuis le

cache. Il est recommand&eacute; 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&eacute;es en tampon de

mani&egrave;re excessive dans le cas o&ugrave; les donn&eacute;es arriveraient plus vite

que pr&eacute;vu.</p>

<highlight language="config">

CacheSocacheReadTime 1000

</highlight>

</usage>

</directivesynopsis>

</modulesynopsis>