Commit d6266780 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML fr doc update. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1851175 13f79535-47bb-0310-9956-ffa450edef68
parent e805b573

docs/manual/mod/mod_cache.xml.fr

+83 −93
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8"?>

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

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

<!-- English Revision: 1780218 -->

<!-- English Revision: 1851174 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -199,14 +199,14 @@ LoadModule cache_module modules/mod_cache.so 
  peut arriver pendant ce laps de temps, et provoquer une

  <strong>tempête</strong> de requêtes susceptibles de saturer le

  processus d'arrière-plan de manière soudaine et imprédictible.</p>

  <p>Pour contenir cette tempête, on peut utiliser la directive

  <directive>CacheLock</directive> afin de définir un répertoire où

  seront créés <strong>à la volée</strong> des verrous pour les URLs.

  Ces verrous sont utilisés comme autant d'<strong>indications</strong>

  par les autres requêtes, soit pour empêcher une tentative de mise en

  cache (un autre processus est en train de récupérer l'entité), soit

  pour indiquer qu'une entrée périmée est en cours de mise à jour

  (pendant ce temps, c'est le contenu périmé qui sera renvoyé).

  <p>Pour contenir cette tempête, on peut utiliser la directive <directive

  module="mod_cache">CacheLock</directive> afin de définir un répertoire où

  seront créés <strong>à la volée</strong> des verrous pour les URLs.  Ces

  verrous sont utilisés comme autant d'<strong>indications</strong> par les

  autres requêtes, soit pour empêcher une tentative de mise en cache (un autre

  processus est en train de récupérer l'entité), soit pour indiquer qu'une

  entrée périmée est en cours de mise à jour (pendant ce temps, c'est le contenu

  périmé qui sera renvoyé).

  </p>

  <section>

    <title>Mise en cache initiale d'une entrée</title>
@@ -239,12 +239,12 @@ LoadModule cache_module modules/mod_cache.so 
    verrou éventuel sera ignoré, la requête du client sera honorée

    immédiatement, et l'entrée du cache mise à jour.</p>



    <p>Comme mécanisme de sécurité supplémentaire, la durée de vie

    maximale des verrous est configurable. Lorsque cette limite est

    atteinte, le verrou est supprimé et une autre requête peut alors en

    créer un nouveau. Cette durée de vie peut être définie via la

    directive <directive>CacheLockMaxAge</directive>, et sa valeur par

    défaut est de 5 secondes.

    <p>Comme mécanisme de sécurité supplémentaire, la durée de vie maximale des

    verrous est configurable. Lorsque cette limite est atteinte, le verrou est

    supprimé et une autre requête peut alors en créer un nouveau. Cette durée de

    vie peut être définie via la directive <directive

    module="mod_cache">CacheMaxExpire</directive>, et sa valeur par défaut est

    de 5 secondes.

    </p>

  </section>

  <section>
@@ -400,14 +400,14 @@ en mandat direct dans les versions 2.2 et antérieures.</compatibility> 
    <p>La directive <directive>CacheEnable</directive> enjoint

    <module>mod_cache</module> de mettre en cache l'URL précisée par

    <var>chaîne URL</var>, ainsi que les URLs de niveaux inférieurs. Le

    gestionnaire de stockage du cache est spécifié à l'aide de

    l'argument <var>type de cache</var>. La directive

    <directive>CacheEnable</directive> peut être placée à l'intérieur d'une

    section <directive type="section">Location</directive> ou <directive

    type="section">LocationMatch</directive> pour indiquer que le

    contenu considéré peut être mis en cache. Si <var>type de cache</var>

    a pour valeur <code>disk</code>, <module>mod_cache</module>

    utilisera le gestionnaire de stockage sur disque implémenté par

    gestionnaire de stockage du cache est spécifié à l'aide de l'argument

    <var>type de cache</var>. La directive <directive>CacheEnable</directive>

    peut être placée à l'intérieur d'une section <directive type="section"

    module="core">Location</directive> ou <directive type="section"

    module="core">LocationMatch</directive> pour indiquer que le contenu

    considéré peut être mis en cache. Si <var>type de cache</var> a pour valeur

    <code>disk</code>, <module>mod_cache</module> utilisera le gestionnaire de

    stockage sur disque implémenté par

    <module>mod_cache_disk</module>. Pour que <module>mod_cache</module>

    utilise le gestionnaire de stockage basé sur le cache d'objets

    partagés implémenté par <module>mod_cache_socache</module>,
@@ -418,15 +418,14 @@ en mandat direct dans les versions 2.2 et antérieures.</compatibility> 
    ci-dessous), tous les gestionnaires de stockage possibles seront

    lancés, jusqu'au premier d'entre eux qui traitera effectivement la

    requête.

    L'ordre dans lequel les gestionnaires de stockage sont lancés est

    déterminé par l'ordre dans lequel apparaissent les directives

    <directive>CacheEnable</directive> dans le fichier de

    configuration. Les directives <directive>CacheEnable</directive>

    situées à l'intérieur de sections <directive

    type="section">Location</directive> ou <directive

    type="section">LocationMatch</directive> sont traitées avant les

    directives <directive>CacheEnable</directive> définies au niveau

    global.</p>

    L'ordre dans lequel les gestionnaires de stockage sont lancés est déterminé

    par l'ordre dans lequel apparaissent les directives

    <directive>CacheEnable</directive> dans le fichier de configuration. Les

    directives <directive>CacheEnable</directive> situées à l'intérieur de

    sections <directive type="section" module="core">Location</directive> ou

    <directive type="section" module="core">LocationMatch</directive> sont

    traitées avant les directives <directive>CacheEnable</directive> définies au

    niveau global.</p>



    <p>En fonctionnement du type serveur mandataire direct, <var>chaîne

    URL</var> doit au moins débuter par un protocole pour lequel la mise
@@ -500,10 +499,10 @@ spécifiées</description> 
    </example>



    <p>Si la directive se trouve à l'intérieur d'une section <directive

    type="section">Location</directive>, le chemin doit être spécifié en

    dessous de la Location, et si le mot "on" est utilisé, la mise en

    cache sera désactivée pour l'ensemble de l'arborescence concernée

    par la section Location.</p>

    type="section" module="core">Location</directive>, le chemin doit être

    spécifié en dessous de la Location, et si le mot "on" est utilisé, la mise

    en cache sera désactivée pour l'ensemble de l'arborescence concernée par la

    section Location.</p>



    <example><title>Exemple</title>

      <highlight language="config">
@@ -557,9 +556,9 @@ document</description> 
</contextlist>



<usage>

    <p>La directive <directive>CacheMaxExpire</directive> permet de

    spécifier le nombre maximum de secondes pendant lequel les documents

    HTTP suceptibles d'être mis en cache seront conservés sans vérifier

    <p>La directive <directive>CacheMinExpire</directive> permet de

    spécifier le nombre minimum de secondes pendant lequel les documents

    HTTP susceptibles d'être mis en cache seront conservés sans vérifier

    leur contenu sur le serveur d'origine. Elle n'est prise en compte

    que dans le cas où le document ne possède aucune date d'expiration

    valide.</p>
@@ -582,11 +581,11 @@ lorsqu'aucune date d'expiration n'a été spécifiée.</description> 


<usage>

    <p>La directive <directive>CacheDefaultExpire</directive> permet de

    spécifier un temps par défaut, en secondes, pendant lequel sera

    conservé dans le cache un document qui ne possède ni date

    d'expiration, ni date de dernière modification. La valeur de cette

    directive est écrasée par la valeur de la directive

    <directive>CacheMaxExpire</directive> si cette dernière est

    spécifier un temps par défaut, en secondes, pendant lequel sera conservé

    dans le cache un document qui ne possède ni date d'expiration, ni date de

    dernière modification. La valeur de cette directive n'est <em>pas</em>

    écrasée par la valeur de la directive <directive

    module="mod_cache">CacheMaxExpire</directive>, même si cette dernière est

    utilisée.</p>



    <highlight language="config">
@@ -612,11 +611,11 @@ Modified.</description> 
    cours des traitements liés à <module>mod_include</module> par

    exemple), ou n'existe tout simplement pas. La directive

    <directive>CacheIgnoreNoLastMod</directive> permet de spécifier si

    les documents ne possèdant pas de date de dernière modification

    doivent être mis en cache, même sans date de dernière modification.

    Si le document ne possède ni date d'expiration, ni date de dernière

    modification, la valeur spécifiée par la directive

    <directive>CacheDefaultExpire</directive> servira à générer une date

    les documents ne possèdant pas de date de dernière modification doivent être

    mis en cache, même sans date de dernière modification.  Si le document ne

    possède ni date d'expiration, ni date de dernière modification, la valeur

    spécifiée par la directive <directive

    module="mod_cache">CacheDefaultExpire</directive> servira à générer une date

    d'expiration.

    </p>
@@ -637,8 +636,8 @@ le contenu au client depuis le cache</description> 


<usage>

    <p>Normalement, les requêtes contenant des en-têtes tels que

    Cache-Control: no-cache ou Pragma: no-cache ne sont pas servies

    depuis le cache. La directive

    <code>Cache-Control: no-cache</code> ou Pragma: no-cache ne sont pas 

    servies depuis le cache. La directive

    <directive>CacheIgnoreCacheControl</directive> permet de modifier ce

    comportement. Avec <directive>CacheIgnoreCacheControl

    On</directive>, le serveur tentera de servir la ressource depuis le
@@ -717,8 +716,8 @@ fonction de la date de dernière modification.</description> 
    3:00pm, la date d'expiration calculée sera 3:00pm + 1 heure =

    4:00pm.



    Si le délai d'expiration est supérieur à celui spécifié par la

    directive <directive>CacheMaxExpire</directive>, c'est ce dernier

    Si le délai d'expiration est supérieur à celui spécifié par la directive

    <directive module="mod_cache">CacheMaxExpire</directive>, c'est ce dernier

    qui l'emporte.</p>



    <highlight language="config">
@@ -872,12 +871,11 @@ marquées comme privées</description> 
</contextlist>



<usage>

    <p>Normalement, les réponse comportant un en-tête Cache-Control:

    dont la valeur est private ne seront pas stockées dans le cache. La

    directive <directive>CacheStorePrivate</directive> permet de

    modifier ce comportement. Si

    <directive>CacheStorePrivate</directive> est définie à On, le

    serveur tentera de mettre la ressource en cache, même si elle

    <p>Normalement, les réponse comportant un en-tête <code>Cache-Control:

    private</code> ne seront pas stockées dans le cache. La directive

    <directive>CacheStorePrivate</directive> permet de modifier ce comportement.

    Si <directive>CacheStorePrivate</directive> est définie à On, le serveur

    tentera de mettre la ressource en cache, même si elle

    contient des en-têtes ayant pour valeur private. Les ressources

    nécessitant une autorisation ne sont <em>jamais</em> mises en

    cache.</p>
@@ -911,7 +909,7 @@ l'entête Cache-Control: a pour valeur no-store.</description> 


<usage>

    <p>Normalement, les requêtes ou réponses dont l'en-tête

    Cache-Control: a pour valeur no-store ne sont pas stockées dans le

    <code>Cache-Control: no-store</code> ne sont pas stockées dans le

    cache. La directive <directive>CacheStoreNoStore</directive> permet

    de modifier ce comportement. Si

    <directive>CacheStoreNoStore</directive> est définie à On, le
@@ -1015,8 +1013,7 @@ CacheLock on 
  Apache</compatibility>



  <usage>

    <p>La directive <directive

    module="mod_cache">CacheQuickHandler</directive> permet de contrôler

    <p>La directive <directive>CacheQuickHandler</directive> permet de contrôler

    la phase au cours de laquelle la mise en cache est effectuée.</p>



    <p>Avec la configuration par défaut, le cache agit au cours de la
@@ -1069,13 +1066,12 @@ AddOutputFilterByType CACHE;INCLUDES;DEFLATE text/html 
<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>



<usage>

  <p>Lorsque la directive <directive

  module="mod_cache">CacheHeader</directive> est définie à on, un

  <p>Lorsque la directive <directive>CacheHeader</directive> est définie à on, un

  en-tête <strong>X-Cache</strong> est ajouté à la réponse et contient

  l'état du cache pour cette dernière. Si le gestionnaire normal est

  utilisé, cette directive peut se situer dans une section

  <directive module="core" type="section">Directory</directive> ou

  <directive module="core" type="section">Location</directive>. Si c'est

  <directive type="section" module="core">Directory</directive> ou

  <directive type="section" module="core">Location</directive>. Si c'est

  le gestionnaire rapide qui est utilisé, elle doit se situer dans un

  contexte de serveur principal ou de serveur virtuel, sinon elle sera

  ignorée.</p>
@@ -1115,11 +1111,10 @@ CacheHeader on 
<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>



<usage>

  <p>Lorsque la directive <directive

  module="mod_cache">CacheDetailHeader</directive> est définie à on, un

  en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et

  contient les raisons précises d'une décision d'utilisation du cache

  vis à vis de cette dernière.</p>

  <p>Lorsque la directive <directive>CacheDetailHeader</directive> est définie à

  on, un en-tête <strong>X-Cache-Detail</strong> est ajouté à la réponse et

  contient les raisons précises d'une décision d'utilisation du cache vis à vis

  de cette dernière.</p>



  <p>Ceci peut s'avérer utile au cours du développement de services

  RESTful mis en cache pour obtenir des informations supplémentaires à
@@ -1128,11 +1123,10 @@ CacheHeader on 
  <code>Cache-Control</code> et d'autres en-têtes ont été correctement

  utilisés par le service et le client.</p>



  <p>Si le gestionnaire normal est utilisé, cette directive peut se

  situer dans une section <directive module="core"

  type="section">Directory</directive> ou <directive module="core"

  type="section">Location</directive>. Si c'est le gestionnaire

  rapide qui est utilisé, elle doit se situer dans un contexte de

  <p>Si le gestionnaire normal est utilisé, cette directive peut se situer dans

  une section <directive type="section" module="core">Directory</directive> ou

  <directive type="section" module="core">Location</directive>. Si c'est le

  gestionnaire rapide qui est utilisé, elle doit se situer dans un contexte de

  serveur principal ou de serveur virtuel, sinon elle sera ignorée.</p>



  <highlight language="config">
@@ -1152,21 +1146,19 @@ CacheDetailHeader on 
<description>Remplace l'URL de base des clés du cache mandaté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ée, l'URL

  spécifiée sera utilisée comme URL de base pour calculer l'URL des clés

  du cache dans la configuration du mandataire inverse. Par défaut,

  c'est le protocole/nom d'hôte/port du serveur virtuel courant qui sera

  utilisé pour construire la clé de cache. Dans le cas d'un cluster de

  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>

  <p>Lorsque la directive <directive>CacheKeyBaseURL</directive> est utilisée,

  l'URL spécifiée sera utilisée comme URL de base pour calculer l'URL des clés

  du cache dans la configuration du mandataire inverse. Par défaut, c'est le

  protocole/nom d'hôte/port du serveur virtuel courant qui sera utilisé pour

  construire la clé de cache. Dans le cas d'un cluster de 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>



  <highlight language="config">

# Remplace l'URL de base de la clé de cache.
@@ -1194,15 +1186,13 @@ CacheKeyBaseURL "http://www.example.com/" 
<compatibility>Disponible depuis la version 2.3.9 d'Apache</compatibility>



<usage>

  <p>Lorsque la directive <directive

  module="mod_cache">CacheStaleOnError</directive> est définie à on, et

  si des données non mises à jour sont disponibles dans le cache, ce

  <p>Lorsque la directive <directive>CacheStaleOnError</directive> est définie à

  on, et si des données non mises à jour sont disponibles dans le cache, ce

  dernier renverra ces données, plutôt qu'une éventuelle réponse 5xx en

  provenance du serveur d'arrière-plan. Alors que l'en-tête

  Cache-Control envoyé par les clients sera respecté, et que les clients

  recevront donc dans ce cas la réponse 5xx brute à leur requête, cette

  réponse 5xx renvoyée au client n'invalidera pas le contenu dans le

  cache.  </p>

  provenance du serveur d'arrière-plan. Alors que l'en-tête Cache-Control envoyé

  par les clients sera respecté, et que les clients recevront donc dans ce cas

  la réponse 5xx brute à leur requête, cette réponse 5xx renvoyée au client

  n'invalidera pas le contenu dans le cache.</p>



  <highlight language="config">

# Sert des données non mises à jour en cas d'erreur.

docs/manual/mod/mod_macro.xml.fr

+2 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

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

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

<!-- English Revision: 1737464 -->

<!-- English Revision: 1850541 -->

<!-- French translation: Fabien Coelho -->

<!-- Updated by Lucien Gentis -->
@@ -30,6 +30,7 @@ de configuration Apache.</description> 
<status>Base</status>

<sourcefile>mod_macro.c</sourcefile>

<identifier>macro_module</identifier>

<compatibility>Disponible à partir de la version 2.4.5 du serveur HTTP Apache</compatibility>



<summary>

docs/manual/mod/mod_proxy.xml.fr

+4 −3
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

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

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

<!-- English Revision: 1844558 -->

<!-- English Revision: 1851101 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -90,13 +90,14 @@ 
</summary>

<seealso><module>mod_cache</module></seealso>

<seealso><module>mod_proxy_ajp</module></seealso>

<seealso><module>mod_proxy_balancer</module></seealso>

<seealso><module>mod_proxy_connect</module></seealso>

<seealso><module>mod_proxy_fcgi</module></seealso>

<seealso><module>mod_proxy_ftp</module></seealso>

<seealso><module>mod_proxy_hcheck</module></seealso>

<seealso><module>mod_proxy_http</module></seealso>

<seealso><module>mod_proxy_scgi</module></seealso>

<seealso><module>mod_proxy_wstunnel</module></seealso>

<seealso><module>mod_proxy_balancer</module></seealso>

<seealso><module>mod_ssl</module></seealso>



    <section id="forwardreverse"><title>Mandataires directs et
@@ -1003,7 +1004,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache</compatibil 
    2.4.7 du serveur HTTP Apache ; pour utiliser cette fonctionnalité,

    il suffit d'utiliser une URL cible préfixée par

    <code>unix:/path/lis.sock|</code>. Par exemple, pour mandater HTTP

    et cibler l'UDS /home/www/socket, vous devez utiliser

    et cibler l'UDS /home/www.socket, vous devez utiliser

    <code>unix:/home/www.socket|http://localhost/whatever/</code>.</p>



    <note><strong>Note :</strong>Le chemin associé à l'URL

docs/manual/mod/mod_proxy_http2.xml.fr

+2 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8"?>

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

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

<!-- English Revision : 1798491 -->

<!-- English Revision : 1850547 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -29,6 +29,7 @@ 
<status>Extension</status>

<sourcefile>mod_proxy_http2.c</sourcefile>

<identifier>proxy_http2_module</identifier>

<compatibility>Disponible à partir de la version 2.4.19 du serveur HTTP Apache</compatibility>



<summary>

    <p><module>mod_proxy_http2</module> ne

docs/manual/mod/mod_proxy_scgi.xml.fr

+4 −4
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

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

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

<!-- English Revision: 1678234 -->

<!-- English Revision: 1850684 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -60,7 +60,7 @@ 


    <example><title>Passerelle simple</title>

    <highlight language="config">

      ProxyPass /scgi-bin/ scgi://localhost:4000/

ProxyPass "/scgi-bin/" "scgi://localhost:4000/"

      </highlight>

    </example>
@@ -99,9 +99,9 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/" 
	précise possible de <var>PATH_INFO</var>, définissez cette

	variable d'environnement. La variable doit être définie avant

	que la directive <directive

	module="env">SetEnv</directive> ne soit effective. Il est possible

	module="mod_env">SetEnv</directive> ne soit effective. Il est possible

	d'utiliser à la	place la directive <directive

	module="setenv">SetEnvIf</directive> : <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code>

	module="mod_setenvif">SetEnvIf</directive> : <code>SetEnvIf Request_URI . proxy-scgi-pathinfo</code>

	</dd>

    </dl>

</section>