httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From lgen...@apache.org
Subject svn commit: r1023474 [5/5] - in /httpd/httpd/trunk/docs/manual: ./ howto/ misc/ mod/
Date Sun, 17 Oct 2010 12:26:39 GMT
Modified: httpd/httpd/trunk/docs/manual/mod/mod_authz_host.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_authz_host.xml.fr?rev=1023474&r1=1023473&r2=1023474&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_authz_host.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_authz_host.xml.fr Sun Oct 17 12:26:38 2010
@@ -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 : 906266 -->
+<!-- English Revision : 1001207 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -43,10 +43,7 @@ d'Apache</compatibility>
     module="core" type="section">Location</directive> ou de fichiers
     <code><a href="core.html#accessfilename">.htaccess</a> </code>
pour
     contr&ocirc;ler l'acc&egrave;s &agrave; certaines zones du serveur. Le contr&ocirc;le
d'acc&egrave;s
-    peut &ecirc;tre effectu&eacute; en fonction du nom d'h&ocirc;te, de l'adresse
IP, ou
-    d'autres caract&eacute;ristiques de la requ&ecirc;te client, telles qu'elles
sont
-    enregistr&eacute;es dans des <a href="../env.html">variables
-    d'environnement</a>.</p>
+    peut &ecirc;tre effectu&eacute; en fonction du nom d'h&ocirc;te ou de l'adresse
IP.</p>
 
     <p>En g&eacute;n&eacute;ral, les directives de restriction d'acc&egrave;s
s'appliquent &agrave;
     toutes les m&eacute;thodes d'acc&egrave;s (<code>GET</code>, <code>PUT</code>,
@@ -67,47 +64,15 @@ contr&ocirc;le d'acc&egrave;s</a></seeal
     module="mod_authz_core">Require</directive> est utilis&eacute;e au cours
de
     la phase d'autorisation pour v&eacute;rifier si un utilisateur se voit
     accorder ou refuser l'acc&egrave;s &agrave; une ressource. mod_authz_host fournit
-    les types d'autorisation <code>env</code>, <code>ip</code>,
-    <code>host</code> et <code>all</code>. D'autres types d'autorisation
+    les types d'autorisation <code>ip</code>, <code>host</code. D'autres
+    types d'autorisation
     sont aussi disponibles, mais n&eacute;cessitent le chargement des modules
     d'autorisation appropri&eacute;s.</p>
 
     <p>Ces fournisseurs d'autorisation permettent de d&eacute;terminer quels
     h&ocirc;tes peuvent acc&eacute;der &agrave; une zone du serveur. On peut
contr&ocirc;ler
-    l'acc&egrave;s en fonction du nom d'h&ocirc;te, de l'adresse IP, d'un intervalle
-    d'adresses IP, ou d'autres caract&eacute;ristiques de la requ&ecirc;te client
-    enregistr&eacute;es dans des variables d'environnement.</p>
-
-<section id="reqenv"><title>Require env</title>
-
-    <p>Le fournisseur <code>env</code> permet de contr&ocirc;ler l'acc&egrave;s
au
-    serveur en fonction de l'existence d'une <a
-    href="../env.html">variable d'environnement</a>. Lorsque
-    <code>Require env <var>env-var</var></code> est sp&eacute;cifi&eacute;,
la
-    requ&ecirc;te est autoris&eacute;e si la variable d'environnement
-    <var>env-var</var> existe. Le serveur fournit la possibilit&eacute;
-    de d&eacute;finir des variables d'environnement avec une grande souplesse
-    en fonction des caract&eacute;ristiques de la requ&ecirc;te client &agrave;
l'aide des
-    directives fournies par le module <module>mod_setenvif</module>. On
-    peut ainsi utiliser cette directive pour contr&ocirc;ler l'acc&egrave;s en
-    fonction de certains en-t&ecirc;tes comme <code>User-Agent</code> (type
de
-    navigateur), <code>Referer</code>, etc...</p>
-
-    <example><title>Exemple :</title>
-      SetEnvIf User-Agent ^KnockKnock/2\.0 laisse_moi_entrer<br />
-      &lt;Directory /docroot&gt;<br />
-      <indent>
-        Require env laisse_moi_entrer<br />
-      </indent>
-      &lt;/Directory&gt;
-    </example>
-
-    <p>Dans cet exemple, les navigateurs dont la cha&icirc;ne de description
-    de l'en-t&ecirc;te user-agent commence par <code>KnockKnock/2.0</code>
se
-    verront accorder l'acc&egrave;s, alors que tous les autres se le verront
-    refuser.</p>
-
-</section>
+    l'acc&egrave;s en fonction du nom d'h&ocirc;te, de l'adresse IP, ou d'un intervalle
+    d'adresses IP.</p>
 
 <section id="reqip"><title>Require ip</title>
 
@@ -195,27 +160,24 @@ contr&ocirc;le d'acc&egrave;s</a></seeal
 
 </section>
 
-<section id="reqall"><title>Require all</title>
+<section id="reqlocal"><title>Require local</title>
+    <p>Le fournisseur <code>local</code> autorise l'acc&egrave;s au
serveur si
+    l'une au moins de ces conditions est satisfaite :</p>
 
-    <p>Le fournisseur <code>all</code> imite la fonctionnalit&eacute;
-    pr&eacute;c&eacute;demment fournie par les directives 'Allow from all' et 'Deny
-    from all'. Le fournisseur accepte un des deux arguments 'granted' ou
-    'denied'. Dans les exemples suivants, le premier
-    accorde l'acc&egrave;s &agrave; toutes les requ&ecirc;tes, alors que le second
le
-    refuse.</p>
+    <ul>
+        <li>l'adresse IP du client correspond &agrave; 127.0.0.0/8</li>
+        <li>l'adresse IP du client est ::1</li>
+        <li>les adresses IP du client et du serveur sont identiques</li>
+    </ul>
 
-    <example>
-    Require all granted<br />
-    </example>
+    <p>L'exemple suivant montre une m&eacute;thode simple pour s&eacute;lectionner
les
+    connexions en provenance de l'h&ocirc;te local :</p>
 
     <example>
-    Require all denied<br />
+    Require local
     </example>
-
 </section>
 
-
 </section>
 
-
 </modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_cache.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_cache.xml.fr?rev=1023474&r1=1023473&r2=1023474&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_cache.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_cache.xml.fr Sun Oct 17 12:26:38 2010
@@ -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 : 924915 -->
+<!-- English Revision : 1021546 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -259,7 +259,41 @@ cache</a></seealso>
 
 </section>
 
+<section id="status"><title>Etat du cache et journalisation</title>
+  <p>Lorsque <module>mod_cache</module> a d&eacute;cid&eacute;
s'il devait ou non
+  servir une entit&eacute; depuis le cache, les raisons pr&eacute;cises de cette
+  d&eacute;cision sont enregistr&eacute;es dans l'environnement du sous-processus
+  interne &agrave; la requ&ecirc;te sous la cl&eacute; <strong>cache-status</strong>.
+  Cette information peut &ecirc;tre journalis&eacute;e via la directive <directive
+  module="mod_log_config">LogFormat</directive> comme suit :</p>
 
+  <example>
+    LogFormat "%{cache-status}e ..."
+  </example>
+
+  <p>En fonction de la d&eacute;cision prise, l'information est aussi &eacute;crite
+  dans l'environnement du sous-processus sous une des trois cl&eacute;s
+  suivantes :</p>
+
+  <dl>
+    <dt>cache-hit</dt><dd>Le contenu a &eacute;t&eacute; servi
depuis le cache.</dd>
+    <dt>cache-revalidate</dt><dd>Le contenu du cache &eacute;tait p&eacute;rim&eacute;,
a &eacute;t&eacute;
+    mis &agrave; jour avec succ&egrave;s, puis servi depuis le cache.</dd>
+    <dt>cache-miss</dt><dd>Le contenu n'&eacute;tait pas dans le cache
et a &eacute;t&eacute;
+    servi directement depuis le serveur demand&eacute;.</dd>
+  </dl>
+
+  <p>Il est alors possible d'envisager une journalisation conditionnelle
+  du traitement des requ&ecirc;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 />
+  </example>
+
+</section>
 
 <directivesynopsis>
 <name>CacheEnable</name>
@@ -371,6 +405,7 @@ document</description>
 <syntax>CacheMaxExpire <var>secondes</var></syntax>
 <default>CacheMaxExpire 86400 (une journ&eacute;e)</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -395,6 +430,7 @@ document</description>
 <syntax>CacheMinExpire <var>secondes</var></syntax>
 <default>CacheMinExpire 0</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -418,6 +454,7 @@ lorsqu'aucune date d'expiration n'a &eac
 <syntax>CacheDefaultExpire <var>secondes</var></syntax>
 <default>CacheDefaultExpire 3600 (une heure)</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -442,6 +479,7 @@ Modified.</description>
 <syntax>CacheIgnoreNoLastMod On|Off</syntax>
 <default>CacheIgnoreNoLastMod Off</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -535,6 +573,7 @@ fonction de la date de derni&egrave;re m
 <syntax>CacheLastModifiedFactor <var>flottant</var></syntax>
 <default>CacheLastModifiedFactor 0.1</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -665,12 +704,39 @@ l'URL lors de la mise en cache
 </directivesynopsis>
 
 <directivesynopsis>
+<name>CacheStoreExpired</name>
+<description>Tente de mettre en cache les r&eacute;ponses que le serveur
+consid&egrave;re comme arriv&eacute;es &agrave; expiration</description>
+<syntax>CacheStoreExpired On|Off</syntax>
+<default>CacheStoreExpired Off</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+
+<usage>
+    <p>Depuis la version 2.2.4, les r&eacute;ponses qui sont arriv&eacute;es
&agrave;
+    expiration ne sont pas stock&eacute;es dans le cache. La directive
+    <directive>CacheStoreExpired</directive> permet de modifier ce
+    comportement. Avec <directive>CacheStoreExpired</directive> On, le
+    serveur tente de mettre en cache la ressource si elle est p&eacute;rim&eacute;e.
+    Les requ&ecirc;tes suivantes vont d&eacute;clencher une requ&ecirc;te si-modifi&eacute;-depuis
+    de la part du serveur d'origine, et la r&eacute;ponse sera renvoy&eacute;e &agrave;
+    partir du cache si la ressource d'arri&egrave;re-plan n'a pas &eacute;t&eacute;
modifi&eacute;e.</p>
+
+    <example>
+      CacheStoreExpired On
+    </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
 <name>CacheStorePrivate</name>
 <description>Tente de mettre en cache des r&eacute;ponses que le serveur a
 marqu&eacute;es comme priv&eacute;es</description>
 <syntax>CacheStorePrivate On|Off</syntax>
 <default>CacheStorePrivate Off</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -706,6 +772,7 @@ l'ent&ecirc;te Cache-Control: a pour val
 <syntax>CacheStoreNoStore On|Off</syntax>
 <default>CacheStoreNoStore Off</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -851,5 +918,159 @@ l'ent&ecirc;te Cache-Control: a pour val
   </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>CacheHeader</name>
+<description>Ajoute un en-t&ecirc;te X-Cache &agrave; la r&eacute;ponse.</description>
+<syntax>CacheHeader <var>on|off</var></syntax>
+<default>CacheHeader off</default>
+<contextlist><context>server config</context>
+    <context>virtual host</context>
+    <context>directory</context>
+    <context>.htaccess</context>
+</contextlist>
+<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
+  
+<usage>
+  <p>Lorsque la directive <directive
+  module="mod_cache">CacheHeader</directive> est d&eacute;finie &agrave;
on, un
+  en-t&ecirc;te <strong>X-Cache</strong> est ajout&eacute; &agrave;
la r&eacute;ponse et contient
+  l'&eacute;tat du cache pour cette derni&egrave;re. Si le gestionnaire normal est
+  utilis&eacute;, cette directive peut se situer dans une section <directive
+  module="core">&lt;Directory&gt;</directive> ou <directive
+  module="core">&lt;Location&gt;</directive>. Si c'est le
+  gestionnaire rapide qui est utilis&eacute;, elle doit se situer dans un
+  contexte de serveur principal ou de serveur virtuel, sinon elle sera
+  ignor&eacute;e.</p>
+
+  <dl>
+    <dt><strong>HIT</strong></dt><dd>Le contenu &eacute;tait
&agrave; jour et a &eacute;t&eacute;
+    servi depuis le cache.</dd>
+    <dt><strong>REVALIDATE</strong></dt><dd>Le contenu &eacute;tait
p&eacute;rim&eacute;, a
+    &eacute;t&eacute; mis &agrave; jour, puis a &eacute;t&eacute; servi
depuis le cache.</dd>
+    <dt><strong>MISS</strong></dt><dd>Le contenu n'a pas &eacute;t&eacute;
servi
+    depuis le cache, mais directement depuis le serveur demand&eacute;.</dd>
+  </dl>
+
+  <example>
+    # Active l'en-t&ecirc;te X-Cache<br />
+    CacheHeader on<br />
+  </example>
+
+  <example>
+    X-Cache: HIT from localhost<br />
+  </example>
+
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>CacheDetailHeader</name>
+<description>Ajoute un en-t&ecirc;te X-Cache-Detail &agrave; la r&eacute;ponse.</description>
+<syntax>CacheDetailHeader <var>on|off</var></syntax>
+<default>CacheDetailHeader off</default>
+<contextlist><context>server config</context>
+      <context>virtual host</context>
+      <context>directory</context>
+      <context>.htaccess</context>
+</contextlist>
+<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
+    
+<usage>
+  <p>Lorsque la directive <directive
+  module="mod_cache">CacheDetailHeader</directive> est d&eacute;finie &agrave;
on, un
+  en-t&ecirc;te <strong>X-Cache-Detail</strong> est ajout&eacute; &agrave;
la r&eacute;ponse et
+  contient les raisons pr&eacute;cises d'une d&eacute;cision d'utilisation du cache
+  vis &agrave; vis de cette derni&egrave;re.</p>
+   
+  <p>Ceci peut s'av&eacute;rer utile au cours du d&eacute;veloppement de services
+  RESTful mis en cache pour obtenir des informations suppl&eacute;mentaires &agrave;
+  propos des d&eacute;cisions vis &agrave; vis du cache &eacute;crites dans les
en-t&ecirc;tes de
+  la r&eacute;ponse. Il est ainsi possible de v&eacute;rifier si
+  <code>Cache-Control</code> et d'autres en-t&ecirc;tes ont &eacute;t&eacute;
correctement
+  utilis&eacute;s par le service et le client.</p>
+  
+  <p>Si le gestionnaire normal est utilis&eacute;, cette directive peut se
+  situer dans une section <directive
+  module="core">&lt;Directory&gt;</directive> ou <directive
+  module="core">&lt;Location&gt;</directive>. Si c'est le gestionnaire
+  rapide qui est utilis&eacute;, elle doit se situer dans un contexte de
+  serveur principal ou de serveur virtuel, sinon elle sera ignor&eacute;e.</p>
+
+  <example>
+    # Active l'en-t&ecirc;te X-Cache-Detail<br />
+    CacheDetailHeader on<br />
+  </example>
+
+  <example>
+    X-Cache-Detail: "conditional cache hit: entity refreshed" from localhost<br />
+  </example>
+
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>CacheKeyBaseURL</name>
+<description>Remplace l'URL de base des cl&eacute;s du cache mandat&eacute;es
en
+inverse</description>
+<syntax>CacheKeyBaseURL <var>URL</var></syntax>
+<default>CacheKeyBaseURL http://example.com</default>
+<contextlist><context>server config</context>
+<context>virtual host</context>
+</contextlist>
+<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
+
+<usage>
+  <p>Lorsque la directive <directive
+  module="mod_cache">CacheKeyBaseURL</directive> est utilis&eacute;e, l'URL
+  sp&eacute;cifi&eacute;e sera utilis&eacute;e comme URL de base pour calculer
l'URL des cl&eacute;s
+  du cache dans la configuration du mandataire inverse. Par d&eacute;faut,
+  c'est le protocole/nom d'h&ocirc;te/port du serveur virtuel courant qui sera
+  utilis&eacute; pour construire la cl&eacute; de cache. Dans le cas d'un cluster
de
+  machines, si toutes les entr&eacute;es du cache doivent poss&eacute;der la m&ecirc;me
cl&eacute;,
+  cette directive permet de sp&eacute;cifier une nouvelle URL de base.</p>
+
+  <example>
+    # Remplace l'URL de base de la cl&eacute; de cache.<br />
+    CacheKeyBaseURL http://www.example.com/<br />
+  </example>
+
+  <note type="warning">Prenez garde en d&eacute;finissant cette directive. Si
+  deux serveurs virtuels distincts poss&egrave;dent accidentellement la m&ecirc;me
+  URL de base, les entr&eacute;es en provenance d'un serveur virtuel seront
+  servies par l'autre.</note>
+
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>CacheStaleOnError</name>
+<description>Sert du contenu non &agrave; jour &agrave; la place de r&eacute;ponses
5xx.</description>
+<syntax>CacheStaleOnError <var>on|off</var></syntax>
+<default>CacheStaleOnError on</default>
+<contextlist><context>server config</context>
+    <context>virtual host</context>
+    <context>directory</context>
+    <context>.htaccess</context>
+</contextlist>
+<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>
+
+<usage>
+  <p>Lorsque la directive <directive
+  module="mod_cache">CacheStaleOnError</directive> est d&eacute;finie &agrave;
on, et
+  si des donn&eacute;es non mises &agrave; jour sont disponibles dans le cache, ce
+  dernier renverra ces donn&eacute;es, plut&ocirc;t qu'une &eacute;ventuelle
r&eacute;ponse 5xx en
+  provenance du serveur d'arri&egrave;re-plan. Alors que l'en-t&ecirc;te
+  Cache-Control envoy&eacute; par les clients sera respect&eacute;, et que les clients
+  recevront donc dans ce cas la r&eacute;ponse 5xx brute &agrave; leur requ&ecirc;te,
cette
+  r&eacute;ponse 5xx renvoy&eacute;e au client n'invalidera pas le contenu dans le
+  cache.  </p>
+
+  <example>
+    # Sert des donn&eacute;es non mises &agrave; jour en cas d'erreur.<br />
+    CacheStaleOnError on<br />
+  </example>
+
+</usage>
+</directivesynopsis>
 
 </modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_disk_cache.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_disk_cache.xml.fr?rev=1023474&r1=1023473&r2=1023474&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_disk_cache.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_disk_cache.xml.fr Sun Oct 17 12:26:38 2010
@@ -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 : 746668 -->
+<!-- English Revision : 1003839 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -153,6 +153,7 @@ sous-r&eacute;pertoires</description>
 <syntax>CacheMinFileSize <var>octets</var></syntax>
 <default>CacheMinFileSize 1</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -173,6 +174,7 @@ sous-r&eacute;pertoires</description>
 <syntax>CacheMaxFileSize <var>octets</var></syntax>
 <default>CacheMaxFileSize 1000000</default>
 <contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
 </contextlist>
 
 <usage>
@@ -185,5 +187,73 @@ sous-r&eacute;pertoires</description>
     </example>
 </usage>
 </directivesynopsis>
+<directivesynopsis>
+<name>CacheReadSize</name>
+<description>La quantit&eacute; minimale (en octets) de donn&eacute;es &agrave;
lire et &agrave;
+mettre en cache avant de les envoyer au client</description>
+<syntax>CacheReadSize <var>octets</var></syntax>
+<default>CacheReadSize 0</default>
+<contextlist><context>server config</context>
+    <context>virtual host</context>
+    <context>directory</context>
+    <context>.htaccess</context>
+</contextlist>
+    
+<usage>
+    <p>La directive <directive>CacheReadSize</directive> permet de
+    d&eacute;finir la quantit&eacute; minimale de donn&eacute;es, en octets,
&agrave; lire depuis le
+    serveur d'arri&egrave;re-plan avant de les envoyer au client. Avec la
+    valeur par d&eacute;faut z&eacute;ro, toute donn&eacute;e de toutes tailles
est envoy&eacute;e
+    au client d&egrave;s qu'elle est disponible. Avec une valeur non nulle, le
+    cache disque met en tampon au moins la quantit&eacute; de donn&eacute;es
+    correspondante avant d'envoyer la r&eacute;ponse au client. Les
+    performances peuvent s'en trouver am&eacute;lior&eacute;es lorsqu'on met en cache
+    du contenu en provenance d'un mandataire inverse.</p>
+
+    <p>Cette directive ne prend effet que lorsque les donn&eacute;es sont
+    enregistr&eacute;es dans le cache, et non lorsque les donn&eacute;es sont servies
&agrave;
+    partir du cache.</p>
+  
+    <example>
+      CacheReadSize 102400
+    </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>CacheReadTime</name>
+<description>Le temps minimum (en millisecondes) qui doit s'&eacute;couler
+avant d'envoyer les donn&eacute;es au client</description>
+<syntax>CacheReadTime <var>millisecondes</var></syntax>
+<default>CacheReadTime 0</default>
+<contextlist><context>server config</context>
+  <context>virtual host</context>
+  <context>directory</context>
+  <context>.htaccess</context>
+</contextlist>
+
+<usage>
+    <p>La directive <directive>CacheReadTime</directive> permet de
+    d&eacute;finir le temps minimum qui doit s'&eacute;couler avant d'essayer
+    d'envoyer des donn&eacute;es au client. Pendant ce temps, les donn&eacute;es
sont
+    mises en tampon avant de pouvoir &ecirc;tre envoy&eacute;es au client. Les
+    performances peuvent s'en trouver am&eacute;lior&eacute;es lorsqu'on met en cache
+    du contenu en provenance d'un mandataire inverse.</p>
+
+    <p>La valeur par d&eacute;faut z&eacute;ro d&eacute;sactive cette option.</p>
+
+    <p>Cette directive ne prend effet que lorsque les donn&eacute;es sont
+    enregistr&eacute;es dans le cache, et non lorsque les donn&eacute;es sont servies
&agrave;
+    partir du cache. Il est recommand&eacute; d'harmoniser l'utilisation de cette
+    directive avec celle de la directive <directive
+    module="mod_disk_cache">CacheReadSize</directive>, afin de s'assurer
+    que le serveur n'effectue pas une mise en tampon excessive au cas
+    o&ugrave; les donn&eacute;es arriveraient plus vite que pr&eacute;vu.</p>
+
+    <example>
+      CacheReadTime 1000
+    </example>
+</usage>
+</directivesynopsis>
 
 </modulesynopsis>

Modified: httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr?rev=1023474&r1=1023473&r2=1023474&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_proxy.xml.fr Sun Oct 17 12:26:38 2010
@@ -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 : 987858 -->
+<!-- English Revision : 1021468 -->
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
 
@@ -849,24 +849,26 @@ l'espace d'URLs du serveur local</descri
     <code>cl&eacute;=valeur</code> dont la description fait l'objet du tableau
     ci-dessous.</p>
 
-    <p>La d&eacute;finition du param&egrave;tre <code>min</code>
permet de d&eacute;terminer
-    le nombre de connexions vers le serveur d'arri&egrave;re-plan qui seront
-    conserv&eacute;es apr&egrave;s usage. Il sera possible de cr&eacute;er jusqu'&agrave;
-    <code>smax</code> (Soft Maximum) connexions &agrave; la demande. Toute
-    connexion en surnombre par rapport &agrave; <code>smax</code> aura une
-    dur&eacute;e de vie limit&eacute;e, ou <code>ttl</code>. En tout
&eacute;tat de cause,
-    Apache httpd ne cr&eacute;era jamais plus de <code>max</code> (Hard
-    Maximum) connexions vers le serveur d'arri&egrave;re-plan.</p>
+    <p>Par d&eacute;faut, mod_proxy permet et met en r&eacute;serve le nombre
maximum
+    de connexions pouvant &ecirc;tre utilis&eacute;es simultan&eacute;ment par
le processus
+    enfant concern&eacute; du serveur web. Le param&egrave;tre <code>max</code>
permet
+    de r&eacute;duire cette valeur par d&eacute;faut. Le param&egrave;tre <code>ttl</code>,
+    quant &agrave; lui, permet de d&eacute;finir une dur&eacute;e de vie optionnelle
; les
+    connexions qui n'ont pas &eacute;t&eacute; utilis&eacute;es pendant au moins
+    <code>ttl</code> secondes seront ferm&eacute;es. <code>ttl</code>
permet
+    aussi d'emp&ecirc;cher l'utilisation d'une connexion susceptible d'&ecirc;tre
+    ferm&eacute;e suite &agrave; une fin de vie de connexion persistante sur le
+    serveur d'arri&egrave;re-plan.</p>
 
     <p>Le groupement de connexions est maintenu au niveau de chaque
-    processus enfant du serveur web, et les d&eacute;finitions de
-    <code>min</code>, <code>max</code>, et <code>smax</code>
ne font
+    processus enfant du serveur web, et <code>max</code>, ainsi que les
+    autres param&egrave;tres, ne font
     l'objet d'aucune coordination entre les diff&eacute;rents processus
     enfants, sauf si un seul processus enfant est autoris&eacute; par la
     configuration ou la conception du module multi-processus (MPM).</p>
 
     <example><title>Exemple</title>
-        ProxyPass /exemple http://backend.example.com smax=5 max=20 ttl=120 retry=300
+        ProxyPass /example http://backend.example.com max=20 ttl=120 retry=300
     </example>
 
     <table>
@@ -875,25 +877,30 @@ l'espace d'URLs du serveur local</descri
         <th>Description</th></tr>
     <tr><td>min</td>
         <td>0</td>
-        <td>Nombre minimum de connexions vers le serveur
-	d'arri&egrave;re-plan qui seront conserv&eacute;es apr&egrave;s usage.</td></tr>
+        <td>Nombre minimum d'entr&eacute;es dans le pool de connexions,
+	distinct du nombre de connexions effectif. La valeur par d&eacute;faut
+	ne doit &ecirc;tre modifi&eacute;e que dans des circonstances particuli&egrave;res
+	o&ugrave; la m&eacute;moire associ&eacute;e aux connexions avec le serveur
+	d'arri&egrave;re-plan doit &ecirc;tre pr&eacute;allou&eacute;e ou r&eacute;serv&eacute;e
dans le tas.</td></tr>
     <tr><td>max</td>
         <td>1...n</td>
-        <td>Nombre maximum absolu de connexions autoris&eacute;es vers le
-	serveur d'arri&egrave;re-plan. La valeur par d&eacute;faut du nombre maximum
-	absolu de connexions correspond au nombre de threads par
-	processus pour le MPM utilis&eacute;. Pour le MPM Prefork, la valeur
-	est toujours 1, alors que pour le MPM Worker, elle est contr&ocirc;l&eacute;e
-	par la directive <directive>ThreadsPerChild</directive>. Apache
-	httpd ne cr&eacute;era jamais plus de connexions vers le serveur
-	d'arri&egrave;re-plan que le maximum absolu.</td></tr>
+        <td>Nombre maximum de connexions autoris&eacute;es vers le serveur
+	d'arri&egrave;re-plan. La valeur par d&eacute;faut correspond au nombre de
+	threads par processus pour le MPM (Module Multi Processus)
+	actif. La valeur sera toujours 1 pour le MPM Prefork, alors
+	qu'elle d&eacute;pendra de la d&eacute;finition de la directive
+	<directive>ThreadsPerChild</directive> pour les autres MPMs.</td></tr>
     <tr><td>smax</td>
         <td>max</td>
-        <td>Des connexions pourront &ecirc;tre cr&eacute;&eacute;es &agrave;
la demande jusqu'au
-	maximum relatif. Toute connexion en surnombre par rapport au
-	maximum relatif se verra attribuer une dur&eacute;e de vie
-	<code>ttl</code>.
-    </td></tr>
+        <td>Les entr&eacute;es du pool de connexions conserv&eacute;es au del&agrave;
de
+	cette limite sont lib&eacute;r&eacute;es au cours de certaines op&eacute;rations
si
+	elles n'ont pas &eacute;t&eacute; utilis&eacute;es au cours de leur dur&eacute;e
de vie,
+	d&eacute;finie par le param&egrave;tre <code>ttl</code>. Si l'entr&eacute;e
du pool
+	de connexions est associ&eacute;e &agrave; une connexion, cette derni&egrave;re
sera
+	ferm&eacute;e. La valeur par d&eacute;faut ne doit &ecirc;tre modifi&eacute;e
que dans des
+	circonstances particuli&egrave;res o&ugrave; les entr&eacute;es du pool de connexions
+	et toutes connexions associ&eacute;es qui ont d&eacute;pass&eacute; leur dur&eacute;e
de vie
+	doivent &ecirc;tre lib&eacute;r&eacute;es ou ferm&eacute;es de mani&egrave;re
plus autoritaire.</td></tr>
     <tr><td>acquire</td>
         <td>-</td>
         <td>Cette cl&eacute; permet de d&eacute;finir le d&eacute;lai maximum
d'attente pour
@@ -1041,10 +1048,10 @@ l'espace d'URLs du serveur local</descri
     </td></tr>
     <tr><td>ttl</td>
         <td>-</td>
-        <td>Dur&eacute;e de vie des connexions inactives en surnombre par
-	rapport aux <code>smax</code> premi&egrave;res connexions en secondes.
-	Apache httpd fermera toutes les connexions qui n'ont pas &eacute;t&eacute; utilis&eacute;es
-	pendant ce laps de temps.
+        <td>Dur&eacute;e de vie des connexions inactives et des entr&eacute;es
du pool
+	de connexions associ&eacute;es en secondes. Celles qui n'ont pas &eacute;t&eacute;
+	utilis&eacute;es au bout de <code>ttl</code> secondes seront lib&eacute;r&eacute;es
+	ou ferm&eacute;es.
     </td></tr>
 
     </table>
@@ -1176,7 +1183,12 @@ l'espace d'URLs du serveur local</descri
     section <directive type="section" module="core"
     >Location</directive>, le premier argument est omis et le r&eacute;pertoire
     local est obtenu &agrave; partir de la section <directive type="section"
-    module="core">Location</directive>.</p>
+    module="core">Location</directive>. Il en sera de m&ecirc;me dans une
+    section <directive type="section"
+    module="core">LocationMatch</directive> ; cependant, ProxyPass
+    n'interpr&egrave;te pas les expressions rationnelles, et il sera ici
+    n&eacute;cessaire d'utiliser la directive
+    <directive>ProxyPassMatch</directive> &agrave; la place.</p>
 
     <p>Si vous avez besoin d'un configuration de mandataire inverse plus
     souple, reportez-vous &agrave; la documentaion de la directive <directive
@@ -1235,6 +1247,16 @@ du serveur local en utilisant des expres
 
     <p>Le drapeau <code>!</code> vous permet de ne pas mandater un
     sous-r&eacute;pertoire donn&eacute;.</p>
+
+    <p>Dans une section <directive type="section"
+    module="core">LocationMatch</directive>, le premier argument est
+    omis et l'expression rationnelle est obtenue &agrave; partir de la directive
+    <directive type="section" module="core">LocationMatch</directive>.</p>
+
+    <p>Si vous avez besoin d'une configuration du mandataire inverse
+    plus flexible, voyez la directive <directive
+    module="mod_rewrite">RewriteRule</directive> avec le drapeau
+    <code>[P]</code>.</p>
 </usage>
 </directivesynopsis>
 
@@ -1315,7 +1337,14 @@ par un serveur mandat&eacute; en inverse
     type="section" module="core">Location</directive>, le premier
     argument est omis et le r&eacute;pertoire local est obtenu &agrave; partir de
     l'argument de la directive <directive type="section"
-    module="core">Location</directive>.</p>
+    module="core">Location</directive>. Il en est de m&ecirc;me &agrave;
l'int&eacute;rieur
+    d'une section <directive type="section"
+    module="core">LocationMatch</directive>, mais le r&eacute;sultat ne sera
+    probablement pas celui attendu car ProxyPassReverse va interpr&eacute;ter
+    l'expression rationnelle litt&eacute;ralement comme un chemin ; si besoin
+    est dans ce cas, d&eacute;finissez la directive ProxyPassReverse en dehors
+    de la section, ou dans une section <directive type="section"
+    module="core">Location</directive> s&eacute;par&eacute;e.</p>
 </usage>
 </directivesynopsis>
 

Modified: httpd/httpd/trunk/docs/manual/new_features_2_4.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/new_features_2_4.xml.fr?rev=1023474&r1=1023473&r2=1023474&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/new_features_2_4.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/new_features_2_4.xml.fr Sun Oct 17 12:26:38 2010
@@ -3,7 +3,7 @@
 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
 <!-- French translation : Lucien GENTIS -->
 <!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision : 734691 -->
+<!-- English Revision : 1022232 -->
 
 <!--
  Licensed to the Apache Software Foundation (ASF) under one or more
@@ -24,7 +24,8 @@
 
 <manualpage metafile="new_features_2_4.xml.meta">
 
-<title>Vue d'ensemble des nouvelles fonctionnalit&eacute;s d'Apache 2.4</title>
+<title>Vue d'ensemble des nouvelles fonctionnalit&eacute;s de la version 2.4 du
+serveur HTTP Apache</title>
 
 <summary>
   <p>Ce document d&eacute;crit certaines modifications majeures entre les versions
@@ -41,16 +42,32 @@
 
       <dd>La directive <directive module="core"
       >KeepAliveTimeout</directive> permet dor&eacute;navant de
-      >pr&eacute;ciser une dur&eacute;e de vie en millisecondes.
+      pr&eacute;ciser une dur&eacute;e de vie en millisecondes.
       </dd>
+ 
+      <dt>Simple MPM</dt>
+      <dd>Une impl&eacute;mentation de MPM en "salle blanche" avec gestion
+      avanc&eacute;e du jeu de threads.</dd>
+      
+      <dt>MPMs chargeables</dt>
+      <dd>On peut maintenant compiler plusieurs MPMs en tant que modules
+      chargeables. La configuration du MPM choisi s'effectue &agrave;
+      l'ex&eacute;cution.</dd>
+
+      <dt>Configuration du niveau de journalisation (LogLevel) par
+      module et par r&eacute;pertoire</dt>
+      <dd>La directive <directive module="core">LogLevel</directive>
+      peut maintenant &ecirc;tre d&eacute;finie par module et par r&eacute;pertoire.
Les
+      nouveaux niveaux <code>trace1</code> &agrave; <code>trace8</code>
ont &eacute;t&eacute;
+      ajout&eacute;s au dessus du niveau de journalisation <code>debug</code>.</dd>
+
     </dl>
   </section>
 
   <section id="module">
     <title>Am&eacute;liorations des modules</title>
     <dl>
-      <dt><module>mod_ssl</module>: support de la validation OCSP des
-      certificats clients</dt>
+      <dt><module>mod_ssl</module></dt>
 
       <dd><module>mod_ssl</module> peut maintenant v&eacute;rifier
la
       validit&eacute; des certificats clients en se connectant &agrave;
@@ -58,14 +75,67 @@
       r&eacute;pondeur par d&eacute;faut, et de choisir si l'on
       pr&eacute;f&egrave;re le r&eacute;pondeur d&eacute;sign&eacute;
       dans le certificat client lui-m&ecirc;me.</dd>
+
+	<dd><module>mod_ssl</module> supporte aussi maintenant le lien
+	OCSP, par lequel le serveur obtient activement une v&eacute;rification
+	OCSP de son certificat et la transmet au client durant la phase
+	de n&eacute;gociation de la connexion.</dd>
+      
+      <dd>On peut maintenant configurer <module>mod_ssl</module> pour
+      que celui-ci partage les donn&eacute;es de session SSL entre les serveurs
+      via memcached.</dd>
+ 
+      <dt><module>mod_lua</module></dt>
+
+      <dd>Embarque le langage <a href="http://www.lua.org/">Lua</a> dans
+      httpd, pour la configuration et des fonctions logiques simples.</dd>
+ 
+      <dt><module>mod_proxy_fcgi</module></dt>
+
+      <dd>Support du protocole FastCGI pour <module>mod_proxy</module></dd>
+
+      <dt><module>mod_cache</module></dt>
+
+      <dd><module>mod_cache</module> peut maintenant mettre en cache des
+      requ&ecirc;tes HEAD.</dd>
+
+      <dd>Chaque fois que cela est possible, les directives de
+      <module>mod_cache</module> peuvent maintenant &ecirc;tre d&eacute;finies
au
+      niveau du r&eacute;pertoire, et non plus seulement au niveau du serveur
+      principal.</dd>
+
+      <dd>L'URL de base des URLs en cache peut &ecirc;tre personnalis&eacute;e
de
+      fa&ccedil;on &agrave; ce qu'un cluster de caches puisse partager le m&ecirc;me
pr&eacute;fixe
+      d'URL.</dd>
+
+      <dd><module>mod_cache</module> peut maintenant servir du contenu
+      non mis &agrave; jour lorsqu'un serveur d'arri&egrave;re-plan n'est pas
+      disponible (erreur 5xx).</dd>
+
+      <dd><module>mod_cache</module> peut maintenant ins&eacute;rer
+      HIT/MISS/REVALIDATE dans un en-t&ecirc;te X-Cache.</dd>
+      
     </dl>
   </section>
 
   <section id="programs">
     <title>Am&eacute;liorations des programmes</title>
-    <!-- <dl>
-    </dl> -->
-  </section>
+    <dl>
+        <dt>fcgistarter</dt>
+        <dd>Utilitaire pour le d&eacute;marrage des d&eacute;mons FastCGI</dd>
+	<dt>htcacheclean</dt>
+        <dd>Les URLs pr&eacute;sentes dans le cache peuvent maintenant &ecirc;tre
+	affich&eacute;es, accompagn&eacute;es &eacute;ventuellement de leurs m&eacute;tadonn&eacute;es.</dd>
+        <dd>Permet d'effacer explicitement des URLs individuelles
+	pr&eacute;sentes dans le cache.</dd>
+        <dd>Les tailles de fichiers peuvent maintenant &ecirc;tre arrondies au
+	multiple de la taille de bloc donn&eacute;e, les limites de taille
+	collant de ce fait d'avantage &agrave; la taille r&eacute;elle sur disque.</dd>
+        <dd>La taille du cache peut maintenant &ecirc;tre limit&eacute;e par
le
+	nombre d'inodes, en plus de la possibilit&eacute; de limitation par la
+	taille des fichiers.</dd>
+    </dl>
+    </section>
 
   <section id="developer">
     <title>Modifications pour le d&eacute;veloppeur de modules</title>
@@ -100,15 +170,27 @@
       <dt>Interface de mise en cache des petits objets</dt>
 
       <dd>Le fichier d'en-t&ecirc;tes <var>ap_socache.h</var> fournit
une
-      interface à base de fournisseur pour la mise en cache des petits
+      interface &agrave; base de fournisseur pour la mise en cache des petits
       objets de donn&eacute;es, en s'inspirant de
       l'impl&eacute;mentation pr&eacute;c&eacute;dente
       du cache de session par <module>mod_ssl</module>. Sont support&eacute;s
       actuellement : les fournisseurs utilisant un tampon cyclique en
       m&eacute;moire partag&eacute;e, les fichiers dbm sur disque, et les caches
-      distribu&eacute;s de type memcache.</dd>
+      distribu&eacute;s de type memcache./dd>
+
+      <dt>Ajout du point d'ancrage Cache Status</dt>
+      
+      <dd>Le module <module>mod_cache</module> inclut maintenant un
+      nouveau point d'ancrage, <code>cache_status</code>, qui est appel&eacute;
+      lorsque la d&eacute;cision &agrave; propos de la mise en cache est connue.
Il en
+      existe une impl&eacute;mentation par d&eacute;faut qui ajoute les en-t&ecirc;tes
+      optionnels <code>X-Cache</code> et <code>X-Cache-Detail</code>
&agrave;
+      la r&eacute;ponse.</dd>
 
       
     </dl>
+    <p>La documentation du d&eacute;veloppeur contient une <a
+    href="developer/new_api_2_4.html">liste d&eacute;taill&eacute;e des modifications
+    de l'API</a>.</p>
   </section>
 </manualpage>



Mime
View raw message