diff options
| author | Lucien Gentis <lgentis@apache.org> | 2012-05-08 17:57:48 +0200 |
|---|---|---|
| committer | Lucien Gentis <lgentis@apache.org> | 2012-05-08 17:57:48 +0200 |
| commit | 3957fea2d9288f8ef1648d77bb365c0472d3c10c (patch) | |
| tree | 093ff26400dbd0593fcc36bb6a3e6c21a6c836c5 /docs/manual/mod/mod_cache.xml.fr | |
| parent | That should be !=, not == :\ moar rebuilding inc! (diff) | |
| download | apache2-3957fea2d9288f8ef1648d77bb365c0472d3c10c.tar.xz apache2-3957fea2d9288f8ef1648d77bb365c0472d3c10c.zip | |
Updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1335603 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mod_cache.xml.fr')
| -rw-r--r-- | docs/manual/mod/mod_cache.xml.fr | 298 |
1 files changed, 156 insertions, 142 deletions
diff --git a/docs/manual/mod/mod_cache.xml.fr b/docs/manual/mod/mod_cache.xml.fr index b85ef58b3c..7780f12283 100644 --- a/docs/manual/mod/mod_cache.xml.fr +++ b/docs/manual/mod/mod_cache.xml.fr @@ -1,7 +1,7 @@ <?xml version="1.0"?> <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd"> <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?> -<!-- English Revision: 1305167:1330964 (outdated) --> +<!-- English Revision : 1330964 --> <!-- French translation : Lucien GENTIS --> <!-- Reviewed by : Vincent Deffontaines --> @@ -166,28 +166,25 @@ cache</a></seealso> <section id="sampleconf"><title>Exemple de configuration</title> <example><title>Extrait de httpd.conf</title> - #<br /> - # Exemple de configuration du cache<br /> - #<br /> - LoadModule cache_module modules/mod_cache.so<br /> - <br /> - <IfModule mod_cache.c><br /> - <indent> - LoadModule disk_cache_module modules/mod_cache_disk.so<br /> - <IfModule mod_cache_disk.c><br /> - <indent> - CacheRoot c:/cacheroot<br /> - CacheEnable disk /<br /> - CacheDirLevels 5<br /> - CacheDirLength 3<br /> - </indent> - </IfModule> <br /> - <br /> - # Lorsqu'on sert de mandataire, on ne met pas en cache la liste - # des mises à jour de sécurité<br /> - CacheDisable http://security.update.server/update-list/<br /> - </indent> - </IfModule> + <highlight language="config"> +# +# Exemple de configuration du cache +# +LoadModule cache_module modules/mod_cache.so +<IfModule mod_cache.c> + LoadModule cache_disk_module modules/mod_cache_disk.so + <IfModule mod_cache_disk.c> + CacheRoot c:/cacheroot + CacheEnable disk / + CacheDirLevels 5 + CacheDirLength 3 + </IfModule> + + # Lorsqu'on sert de mandataire, on ne met pas en cache la liste +# des mises à jour de sécurité + CacheDisable http://security.update.server/update-list/ +</IfModule> + </highlight> </example> </section> @@ -253,16 +250,16 @@ cache</a></seealso> <section> <title>Exemple de configuration</title> <example><title>Activation du verrouillage du cache</title> - #<br /> - # Active le verrouillage du cache<br /> - #<br /> - <IfModule mod_cache.c><br /> - <indent> - CacheLock on<br /> - CacheLockPath /tmp/mod_cache-lock<br /> - CacheLockMaxAge 5<br /> - </indent> - </IfModule> + <highlight language="config"> +# +# Active le verrouillage du cache +# +<IfModule mod_cache.c> + CacheLock on + CacheLockPath /tmp/mod_cache-lock + CacheLockMaxAge 5 +</IfModule> + </highlight> </example> </section> </section> @@ -302,11 +299,11 @@ cache</a></seealso> avant le filtre <strong>DEFLATE</strong> comme dans l'exemple suivant :</p> - <example> - # Mise en cache du contenu avant la compression optionnelle<br /> - CacheQuickHandler off<br /> - AddOutputFilterByType CACHE;DEFLATE text/plain<br /><br /> - </example> + <highlight language="config"> +# Mise en cache du contenu avant la compression optionnelle +CacheQuickHandler off +AddOutputFilterByType CACHE;DEFLATE text/plain + </highlight> <p>Une autre possibilité consiste à mettre en cache le contenu avant l'ajout de contenu personnalisé via <module>mod_include</module> (ou @@ -315,24 +312,24 @@ cache</a></seealso> <module>mod_include</module> sont mis en cache avant d'être interprétés :</p> - <example> - # Mise en cache du contenu avant l'intervention de mod_include et - # mod_deflate<br /> - CacheQuickHandler off<br /> - AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html<br /><br /> - </example> + <highlight language="config"> +# Mise en cache du contenu avant l'intervention de mod_include et + # mod_deflate +CacheQuickHandler off +AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html + </highlight> <p>Vous pouvez insérer le filtre <strong>CACHE</strong> en tout point de la chaîne de filtrage. Dans l'exemple suivant, le contenu est mis en cache après avoir été interprété par <module>mod_include</module>, mais avant d'être traité par <module>mod_deflate</module> :</p> - <example> - # Mise en cache du contenu entre les interventions de mod_include et - # mod_deflate<br /> - CacheQuickHandler off<br /> - AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html<br /><br /> - </example> + <highlight language="config"> +# Mise en cache du contenu entre les interventions de mod_include et + # mod_deflate +CacheQuickHandler off +AddOutputFilterByType INCLUDES;CACHE;DEFLATE text/html + </highlight> <note type="warning"><title>Avertissement :</title>Si pour une raison ou pour une autre, le point d'insertion du filtre @@ -351,9 +348,9 @@ cache</a></seealso> Cette information peut être journalisée via la directive <directive module="mod_log_config">LogFormat</directive> comme suit :</p> - <example> + <highlight language="config"> LogFormat "%{cache-status}e ..." - </example> + </highlight> <p>En fonction de la décision prise, l'information est aussi écrite dans l'environnement du sous-processus sous une des quatre clés @@ -373,12 +370,12 @@ cache</a></seealso> du traitement des requêtes par rapport au cache comme dans l'exemple suivant :</p> - <example> - CustomLog requetes-depuis-cache.log common env=cache-hit<br /> - CustomLog requetes-hors-cache.log common env=cache-miss<br /> - CustomLog requetes-avec-mise-a-jour-du-cache.log common env=cache-revalidate<br /> - CustomLog requetes-avec-invalidation.log common env=cache-invalidate<br /> - </example> + <highlight language="config"> +CustomLog cached-requests.log common env=cache-hit +CustomLog uncached-requests.log common env=cache-miss +CustomLog revalidated-requests.log common env=cache-revalidate +CustomLog invalidated-requests.log common env=cache-invalidate + </highlight> <p>Pour les concepteurs de modules, une accroche (hook) nommée <var>cache_status</var> est disponible et permet aux modules de @@ -434,26 +431,26 @@ URL</var>]</syntax> et des protocoles de mandat pour lesquels la mise en cache devra être activée.</p> - <example> - # Mise en cache de contenu<br /> - <Location /foo><br /> - <indent> - CacheEnable disk<br /> - </indent> - </Location><br /><br /> - # Mise en cache via une expression rationnelle<br /> - <LocationMatch foo$><br /> - <indent> - CacheEnable disk<br /> - </indent> - </LocationMatch><br /><br /> - # Mise en cache des URLs mandatées<br /> - CacheEnable disk /<br /><br /> - # Mise en cache des URLs FTP mandatées<br /> - CacheEnable disk ftp://<br /><br /> - # Mise en cache des contenus situés dans www.example.org<br /> - CacheEnable disk http://www.example.org/<br /> - </example> + <highlight language="config"> +# Mise en cache de contenu +<Location /foo> + CacheEnable disk +</Location> + +# Mise en cache via une expression rationnelle +<LocationMatch foo$> + CacheEnable disk +</LocationMatch> + +# Mise en cache des URLs mandatées +CacheEnable disk / + +# Mise en cache des URLs FTP mandatées +CacheEnable disk ftp:// + +# Mise en cache des contenus situés dans www.example.org +CacheEnable disk http://www.example.org/ + </highlight> <p>Un nom d'hôte commençant par un caractère <strong>"*"</strong> correspondra à tout nom d'hôte se terminant par le suffixe @@ -461,12 +458,12 @@ URL</var>]</syntax> <strong>"."</strong> correspondra à tout nom d'hôte contenant le composant de nom de domaine qui suit ce caractère.</p> - <example> - # Correspond à www.example.org et fooexample.org<br /> - CacheEnable disk http://*example.org/<br /> - # Correspond à www.example.org, mais pas à fooexample.org<br /> - CacheEnable disk http://.example.org/<br /> - </example> + <highlight language="config"> +# Correspond à www.example.org et fooexample.org +CacheEnable disk http://*example.org/ +# Correspond à www.example.org, mais pas à fooexample.org +CacheEnable disk http://.example.org/ + </highlight> <p>Depuis la version 2.2.12, on peut définir la variable d'environnement <code>no-cache</code> pour une définition plus fine @@ -493,7 +490,9 @@ spécifiées</description> inférieurs.</p> <example><title>Exemple</title> + <highlight language="config"> CacheDisable /fichiers_locaux + </highlight> </example> <p>Si la directive se trouve à l'intérieur d'une section <directive @@ -503,11 +502,11 @@ spécifiées</description> par la section Location.</p> <example><title>Exemple</title> - <Location /foo><br /> - <indent> - CacheDisable on<br /> - </indent> - </Location><br /> + <highlight language="config"> +<Location /foo> + CacheDisable on +</Location> + </highlight> </example> <p>Avec les versions 2.2.12 et ultérieures, on peut définir la @@ -536,9 +535,10 @@ document</description> sera pas à jour. L'utilisation de cette valeur maximale est forcée, même si le document possède une date d'expiration.</p> - <example> + <highlight language="config"> CacheMaxExpire 604800 - </example> + </highlight> + </usage> </directivesynopsis> @@ -560,9 +560,9 @@ document</description> que dans le cas où le document ne possède aucune date d'expiration valide.</p> - <example> + <highlight language="config"> CacheMinExpire 3600 - </example> + </highlight> </usage> </directivesynopsis> @@ -585,9 +585,9 @@ lorsqu'aucune date d'expiration n'a été spécifiée.</ <directive>CacheMaxExpire</directive> si cette dernière est utilisée.</p> - <example> + <highlight language="config"> CacheDefaultExpire 86400 - </example> + </highlight> </usage> </directivesynopsis> @@ -616,9 +616,9 @@ Modified.</description> d'expiration. </p> - <example> + <highlight language="config"> CacheIgnoreNoLastMod On - </example> + </highlight> </usage> </directivesynopsis> @@ -642,9 +642,9 @@ le contenu au client depuis le cache</description> Les ressources qui requièrent une autorisation ne seront <em>jamais</em> mises en cache.</p> - <example> + <highlight language="config"> CacheIgnoreCacheControl On - </example> + </highlight> <note type="warning"><title>Avertissement :</title> Cette directive permet de servir des ressources depuis le cache, @@ -678,9 +678,9 @@ cache</description> traitée comme si elle ne possèdait pas de chaîne de paramètres lorsque cette directive est activée.</p> - <example> + <highlight language="config"> CacheIgnoreQueryString On - </example> + </highlight> </usage> </directivesynopsis> @@ -717,9 +717,9 @@ fonction de la date de dernière modification.</description> directive <directive>CacheMaxExpire</directive>, c'est ce dernier qui l'emporte.</p> - <example> + <highlight language="config"> CacheLastModifiedFactor 0.5 - </example> + </highlight> </usage> </directivesynopsis> @@ -764,11 +764,15 @@ fonction de la date de dernière modification.</description> <code>None</code>.</p> <example><title>Exemple 1</title> + <highlight language="config"> CacheIgnoreHeaders Set-Cookie + </highlight> </example> <example><title>Exemple 2</title> + <highlight language="config"> CacheIgnoreHeaders None + </highlight> </example> <note type="warning"><title>Avertissement :</title> @@ -812,11 +816,15 @@ l'URL lors de la mise en cache ajouté à la liste.</p> <example><title>Exemple 1</title> + <highlight language="config"> CacheIgnoreURLSessionIdentifiers jsessionid + </highlight> </example> <example><title>Exemple 2</title> + <highlight language="config"> CacheIgnoreURLSessionIdentifiers None + </highlight> </example> </usage> @@ -842,9 +850,10 @@ considère comme arrivées à expiration</description> de la part du serveur d'origine, et la réponse sera renvoyée à partir du cache si la ressource d'arrière-plan n'a pas été modifiée.</p> - <example> + <highlight language="config"> CacheStoreExpired On - </example> + </highlight> + </usage> </directivesynopsis> @@ -869,9 +878,11 @@ marquées comme privées</description> nécessitant une autorisation ne sont <em>jamais</em> mises en cache.</p> - <example> + + <highlight language="config"> CacheStorePrivate On - </example> + </highlight> + <note type="warning"><title>Avertissement :</title> Cette directive autorise la mise en cache même si le serveur @@ -905,9 +916,11 @@ l'entête Cache-Control: a pour valeur no-store.</description> nécessitant une autorisation ne sont <em>jamais</em> mises en cache.</p> - <example> + + <highlight language="config"> CacheStoreNoStore On - </example> + </highlight> + <note type="warning"><title>Avertissement :</title> Selon la RFC 2616, la valeur d'en-tête no-store est censée @@ -940,10 +953,10 @@ l'entête Cache-Control: a pour valeur no-store.</description> tempêtes de requêtes dans le répertoire temp par défaut du système est la suivante :</p> - <example> - # Active le verrouillage du cache<br /> - CacheLock on<br /><br /> - </example> + <highlight language="config"> +# Active le verrouillage du cache +CacheLock on + </highlight> </usage> </directivesynopsis> @@ -1016,22 +1029,22 @@ l'entête Cache-Control: a pour valeur no-store.</description> traitement complet de la requête est nécessaire, comme par exemple lorsque le contenu est soumis à autorisation.</p> - <example> - # Exécute le cache comme un gestionnaire normal<br /> - CacheQuickHandler off<br /><br /> - </example> + <highlight language="config"> +# Exécute le cache comme un gestionnaire normal +CacheQuickHandler off + </highlight> <p>Lorsque le gestionnaire rapide est désactivé, l'administrateur a aussi la possibilité de choisir avec précision le point de la chaîne de filtrage où la mise en cache sera effectuée, en utilisant le filtre <strong>CACHE</strong>.</p> - <example> - # Mise en cache du contenu avant l'intervention de mod_include et - # mod_deflate<br /> - CacheQuickHandler off<br /> - AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html<br /><br /> - </example> + <highlight language="config"> +# Mise en cache du contenu avant l'intervention de mod_include et + # mod_deflate +CacheQuickHandler off +AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html + </highlight> <p>Si le filtre CACHE est spécifié plusieurs fois, c'est la dernière instance qui sera prise en compte.</p> @@ -1072,14 +1085,15 @@ l'entête Cache-Control: a pour valeur no-store.</description> depuis le cache, mais directement depuis le serveur demandé.</dd> </dl> - <example> - # Active l'en-tête X-Cache<br /> - CacheHeader on<br /> - </example> + <highlight language="config"> +# Active l'en-tête X-Cache +CacheHeader on + </highlight> - <example> - X-Cache: HIT from localhost<br /> - </example> + <highlight language="config"> + X-Cache: HIT from localhost + </highlight> + </usage> </directivesynopsis> @@ -1117,10 +1131,10 @@ l'entête Cache-Control: a pour valeur no-store.</description> rapide qui est utilisé, elle doit se situer dans un contexte de serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p> - <example> - # Active l'en-tête X-Cache-Detail<br /> - CacheDetailHeader on<br /> - </example> + <highlight language="config"> +# Active l'en-tête X-Cache-Detail +CacheDetailHeader on + </highlight> <example> X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost<br /> @@ -1150,10 +1164,10 @@ inverse</description> machines, si toutes les entrées du cache doivent posséder la même clé, cette directive permet de spécifier une nouvelle URL de base.</p> - <example> - # Remplace l'URL de base de la clé de cache.<br /> - CacheKeyBaseURL http://www.example.com/<br /> - </example> + <highlight language="config"> +# Remplace l'URL de base de la clé de cache. +CacheKeyBaseURL http://www.example.com/ + </highlight> <note type="warning">Prenez garde en définissant cette directive. Si deux serveurs virtuels distincts possèdent accidentellement la même @@ -1186,10 +1200,10 @@ inverse</description> réponse 5xx renvoyée au client n'invalidera pas le contenu dans le cache. </p> - <example> - # Sert des données non mises à jour en cas d'erreur.<br /> - CacheStaleOnError on<br /> - </example> + <highlight language="config"> +# Sert des données non mises à jour en cas d'erreur. +CacheStaleOnError on + </highlight> </usage> </directivesynopsis> |