Commit 6ae9c635 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML updates. 


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

docs/manual/mod/core.xml.fr

+51 −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: 1827611:1828061 (outdated) -->

<!-- English Revision: 1828061 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -4217,6 +4217,56 @@ seulement depuis la version 2.3.3 sous Windows.</compatibility> 
    <seealso><directive module="core">Protocols</directive></seealso>

</directivesynopsis>



<directivesynopsis>

    <name>RegexDefaultOptions</name>

    <description>Configuration des options globales par défaut pour les

    expressions rationnelles</description>

    <syntax>RegexDefaultOptions [none] [+|-]<var>option</var> [[+|-]<var>option</var>] ...</syntax>

    <default>RegexDefaultOptions DOLLAR_ENDONLY</default>

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

    <compatibility>Disponible à partir de la version 2.4.30 du serveur HTTP

    Apache.</compatibility>

    

    <usage>

        <p>Cette directive permet d'ajouter certains comportements par défaut à

	TOUTES les expressions rationnelles utilisées ultérieurement.</p>



        <p>Toute option précédée d'un '+' est ajoutée aux options déjà définies.<br />

        Toute option précédée d'un '-' est enlevée des options déjà définies.<br />

	Toute option non suffixée par '+' ou '-' sera définie et remplacera

	l'option correspondante éventuellement déjà définie.<br />

        Le mot-clé <code>none</code> annule toutes les options déjà définies.</p>



        <p><var>option</var> peut être :</p>

        <dl>

            <dt><code>ICASE</code></dt>

            <dd>Utilise une recherche de correspondance insensible à la casse.</dd>



            <dt><code>DOTALL</code></dt>

            <dd>Le drapeau Perl /s.</dd>



            <dt><code>DOLLAR_ENDONLY</code></dt>

            <dd>'$' n'est actif qu'à la fin de la chaîne de référence.</dd>

            <dd>.</dd>

        </dl>

        <highlight language="config">

# 

RegexDefaultOptions +ICASE +DOLLAR_ENDONLY

...

# Supprime l'option ICASE, tout en conservant toutes les autres options

# préexistantes

RegexDefaultOptions -ICASE

...

# Définit l'option par défaut à DOTALL et annule toutes les autres options

RegexDefaultOptions DOTALL

...

# Annule toutes les options définies

RegexDefaultOptions none

...

        </highlight>

    </usage>

</directivesynopsis>



<directivesynopsis>

<name>RLimitCPU</name>

<description>Limite le temps CPU alloué aux processus initiés par les

docs/manual/mod/mod_include.xml.fr

+9 −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: 1747085:1827716 (outdated) -->

<!-- English Revision: 1827716 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -598,6 +598,11 @@ AddOutputFilter INCLUDES .shtml 
      <dd>Le nom de base du fichier demandé par l'utilisateur (sans son

      chemin).</dd>



      <dt><code>DOCUMENT_PATH_INFO</code></dt>

      <dd>La partie terminale du chemin du fichier. Voir la directive <directive

      module="core">AcceptPathInfo</directive> pour plus d'informations à

      propos de <code>PATH_INFO</code>.</dd>



      <dt><code>DOCUMENT_URI</code></dt>

      <dd>Le chemin URL (caractères % décodés) du document demandé par

      l'utilisateur. Notez que dans le cas d'inclusions de fichiers
@@ -621,6 +626,9 @@ AddOutputFilter INCLUDES .shtml 
      sont précédés d'anti-slashes). Cette variable n'est pas définie si aucune

      chaîne d'arguments n'est présente. Utilisez <code>DOCUMENT_ARGS</code> si

      l'échappement des caractères du shell n'est pas souhaité.</dd>



      <dt><code>USER_NAME</code></dt>

      <dd>Le nom d'utilisateur du propriétaire du fichier.</dd>

    </dl>

</section>

docs/manual/mod/mod_proxy.xml.fr

+33 −11
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: 1825765 -->

<!-- English Revision: 1828128 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -1032,7 +1032,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache</compatibil 
    </highlight>



    <p>va convertir en interne toute requête pour

    <code>http://example.com/miroir/foo/bar</code> en une requête

    <code>http://example.com/mirror/foo/bar</code> en une requête

    mandatée pour <code>http://backend.example.com/bar</code>.</p>



    <p>Si vous avez besoin d'un configuration de mandataire inverse plus
@@ -1047,7 +1047,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache</compatibil 
    href="mod_proxy_balancer.html#balancer_manager">Balancer Manager</a> :</p>



    <highlight language="config">

        ProxyPass "/miroir/foo/" "http://backend.example.com/"

        ProxyPass "/mirror/foo/" "http://backend.example.com/"

    </highlight>



    <note type="warning">
@@ -1076,9 +1076,25 @@ ProxyPass "/mirror/foo/i" "!" 
ProxyPass "/mirror/foo" "http://backend.example.com"

    </highlight>



    <p>va mandater toutes les requêtes pour <code>/miroir/foo</code>

    <p>va mandater toutes les requêtes pour <code>/mirror/foo</code>

    vers <code>backend.example.com</code>, <em>sauf</em> les requêtes

    pour <code>/miroir/foo/i</code>.</p>

    pour <code>/mirror/foo/i</code>.</p>



    <p>Mélanger plusieurs configurations ProxyPass dans différents contextes ne

    fonctionne pas :</p>

    <highlight language="config">

ProxyPass "/mirror/foo/i" "!"

&lt;Location "/mirror/foo/"&gt;

    ProxyPass "http://backend.example.com/"

&lt;/Location&gt;

    </highlight>

    <p>Dans ce cas, une requête pour <code>/mirror/foo/i</code> sera tout de

    même mandatée car c'est la directive <directive>ProxyPass</directive> de la

    section Location qui sera évaluée en premier. Le fait que la directive

    <directive>ProxyPass</directive> supporte les deux contextes serveur

    principal et répertoire ne signifie pas que sa portée et sa position dans le

    fichier de configuration va garantir une quelconque priorité et/ou

    chronologie de prise en compte.</p>



    <note type="warning"><title>Ordre de classement des directives ProxyPass</title>

      <p>Les directives <directive
@@ -1091,13 +1107,19 @@ ProxyPass "/mirror/foo" "http://backend.example.com" 
      l'URL la plus longue à la plus courte. Dans le cas contraire, les

      règles situées après une règle dont l'URL correspond au début de

      leur propre URL seront ignorées. Notez que tout ceci est en

      relation avec le partage de workers. Par contre, on ne peut placer

      relation avec le partage de workers.</p>

      

      </note>

    <note type="warning"><title>Chronologie de prise en compte des directives

    ProxyPass au sein des sections Locations</title>

      <p>On ne peut placer

      qu'une seule directive <directive

      module="mod_proxy">ProxyPass</directive> dans une section

      <directive module="core">Location</directive>, et c'est la section

      la plus spécifique qui l'emportera.</p>



    <p>Pour les mêmes raisons, les exclusions doivent se situer <em>avant</em>

     </note>

     <note type="warning"><title>Exclusions et variable d'environnement no-proxy</title>

      <p>Les exclusions doivent se situer <em>avant</em>

      les directives <directive>ProxyPass</directive> générales. A partir de la

      version 2.4.26 du serveur HTTP Apache, la variable

      d'environnement "no-proxy" est une alternative aux exclusions et constitue
@@ -1726,14 +1748,14 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/" 
    </highlight>



    <p>ne va pas seulement provoquer la conversion interne d'une requête

    locale pour <code>http://example.com/miroir/foo/bar</code> en une

    locale pour <code>http://example.com/mirror/foo/bar</code> en une

    requête mandatée pour <code>http://backend.example.com/bar</code>

    (la fonctionnalité fournie par <code>ProxyPass</code>). Il va

    aussi s'occuper des redirections que le serveur

    <code>backend.example.com</code> envoie lorsqu'il redirige

    <code>http://backend.example.com/bar</code> vers

    <code>http://backend.example.com/quux</code>. Apache

    httpd corrige ceci en <code>http://example.com/miroir/foo/quux</code>

    httpd corrige ceci en <code>http://example.com/mirror/foo/quux</code>

    avant de faire suivre la redirection HTTP au client. Notez que le

    nom d'hôte utilisé pour construire l'URL est choisi en respectant la

    définition de la directive <directive

docs/manual/mod/mod_reqtimeout.xml.fr

+64 −64
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<?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: 1334024:1827779 (outdated) -->

<!-- English Revision: 1827779 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -25,8 +25,8 @@ 
<modulesynopsis metafile="mod_reqtimeout.xml.meta">



<name>mod_reqtimeout</name>

<description>D&eacute;finit le d&eacute;lai maximum et le taux minimum de transfert des

donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes

<description>Définit le délai maximum et le taux minimum de transfert des

données pour la réception des requêtes

</description>

<status>Extension</status>

<sourcefile>mod_reqtimeout.c</sourcefile>
@@ -37,8 +37,8 @@ donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes 


    <ol>

      <li>

        Accorde 10 secondes pour la r&eacute;ception des en-t&ecirc;tes de la requ&ecirc;te

	et 30 secondes pour la r&eacute;ception du corps :

        Accorde 10 secondes pour la réception des en-têtes de la requête

	et 30 secondes pour la réception du corps :



        <highlight language="config">

          RequestReadTimeout headerinit=10 body=30
@@ -46,11 +46,11 @@ donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes 
      </li>



      <li>

        Accorde au moins 10 secondes pour la r&eacute;ception du corps de

	la requ&ecirc;te. Si le client envoie des donn&eacute;es, augmente ce d&eacute;lai

	d'une seconde pour chaque paquet de 1000 octets re&ccedil;us, sans

	limite sup&eacute;rieure (sauf si une limite a &eacute;t&eacute;

	sp&eacute;cifi&eacute;e via la directive <directive

        Accorde au moins 10 secondes pour la réception du corps de

	la requête. Si le client envoie des données, augmente ce délai

	d'une seconde pour chaque paquet de 1000 octets reçus, sans

	limite supérieure (sauf si une limite a été

	spécifiée via la directive <directive

	module="core">LimitRequestBody</directive>) :



        <highlight language="config">
@@ -59,10 +59,10 @@ donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes 
      </li>



      <li>

        Accorde au moins 10 secondes pour la r&eacute;ception de de la

	requ&ecirc;te, en-t&ecirc;tes inclus. Si le client envoie des donn&eacute;es, augmente ce d&eacute;lai

	d'une seconde pour chaque paquet de 500 octets re&ccedil;us, mais

	n'alloue que 30 secondes pour la requ&ecirc;te, en-t&ecirc;tes inclus :

        Accorde au moins 10 secondes pour la réception de de la

	requête, en-têtes inclus. Si le client envoie des données, augmente ce délai

	d'une seconde pour chaque paquet de 500 octets reçus, mais

	n'alloue que 30 secondes pour la requête, en-têtes inclus :



        <highlight language="config">

          RequestReadTimeout header=10-30,MinRate=500
@@ -70,10 +70,10 @@ donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes 
      </li>



      <li>

        En g&eacute;n&eacute;ral, un serveur doit avoir ses d&eacute;lais d'en-t&ecirc;te et de

	corps configur&eacute;s. Si les serveurs virtuels http et https

	utilisent une configuration commune, les d&eacute;lais ne doivent pas

	&ecirc;tre d&eacute;finis trop bas :

        En général, un serveur doit avoir ses délais d'en-tête et de

	corps configurés. Si les serveurs virtuels http et https

	utilisent une configuration commune, les délais ne doivent pas

	être définis trop bas :



        <highlight language="config">

          RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
@@ -85,86 +85,86 @@ donn&eacute;es pour la r&eacute;ception des requ&ecirc;tes 


<directivesynopsis>

<name>RequestReadTimeout</name>

<description>D&eacute;finit des d&eacute;lais maximums pour la r&eacute;ception des en-t&ecirc;tes

et corps des requ&ecirc;tes en provenance du client.

<description>Définit des délais maximums pour la réception des en-têtes

et corps des requêtes en provenance du client.

</description>

<syntax>RequestReadTimeout

[header=<var>d&eacute;lai</var>[-<var>d&eacute;lai-maxi</var>][,MinRate=<var>taux-mini</var>]

[body=<var>d&eacute;lai</var>[-<var>d&eacute;lai-maxi</var>][,MinRate=<var>taux-mini</var>]

[header=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]

[body=<var>délai</var>[-<var>délai-maxi</var>][,MinRate=<var>taux-mini</var>]

</syntax>

<default>header=20-40,MinRate=500 body=20,MinRate=500</default>

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

</contextlist>

<compatibility>Disponible depuis la version 2.2.15 du serveur HTTP

Apache ; d&eacute;sactiv&eacute;e par d&eacute;faut depuis la version 2.3.14.</compatibility>

Apache ; désactivée par défaut depuis la version 2.3.14.</compatibility>



<usage>

    <p>Cette directive permet de d&eacute;finir diff&eacute;rents d&eacute;lais pour la

    r&eacute;ception des en-t&ecirc;tes et corps des requ&ecirc;tes en provenance du

    client. Si le client ne parvient pas &agrave; respecter ces d&eacute;lais, un code

    d'erreur <code>408 REQUEST TIME OUT</code> est envoy&eacute;.</p>



    <p>Pour les serveurs virtuels SSL, le d&eacute;lai concernant les en-t&ecirc;tes

    inclut le temps n&eacute;cessaire &agrave; la n&eacute;gociation SSL initiale. Si le

    navigateur du client est configur&eacute; pour demander des listes de

    r&eacute;vocations de certificats, et si le serveur correspondant n'est pas

    disponible, le d&eacute;lai avant lequel le navigateur va abandonner son

    attente de CRL au cours de la n&eacute;gociation SSL initiale peut &ecirc;tre

    assez important. Par cons&eacute;quent, les valeurs de d&eacute;lais d'en-t&ecirc;tes ne

    doivent pas &ecirc;tre trop basses pour les serveurs virtuels SSL. Le d&eacute;lai

    concernant le corps inclut le temps n&eacute;cessaire &agrave; la ren&eacute;gociation

    SSL (si elle est n&eacute;cessaire).</p>

    <p>Cette directive permet de définir différents délais pour la

    réception des en-têtes et corps des requêtes en provenance du

    client. Si le client ne parvient pas à respecter ces délais, un code

    d'erreur <code>408 REQUEST TIME OUT</code> est envoyé.</p>



    <p>Pour les serveurs virtuels SSL, le délai concernant les en-têtes

    inclut le temps nécessaire à la négociation SSL initiale. Si le

    navigateur du client est configuré pour demander des listes de

    révocations de certificats, et si le serveur correspondant n'est pas

    disponible, le délai avant lequel le navigateur va abandonner son

    attente de CRL au cours de la négociation SSL initiale peut être

    assez important. Par conséquent, les valeurs de délais d'en-têtes ne

    doivent pas être trop basses pour les serveurs virtuels SSL. Le délai

    concernant le corps inclut le temps nécessaire à la renégociation

    SSL (si elle est nécessaire).</p>



    <p>Lorsqu'une directive <directive

    module="core">AcceptFilter</directive> est active (ce qui est en

    g&eacute;n&eacute;ral le cas sous Linux et FreeBSD), la socket n'est envoy&eacute;e au

    processus du serveur qu'apr&egrave;s la r&eacute;ception du premier octet (ou de

    l'ensemble de la requ&ecirc;te si <code>httpready</code> est d&eacute;fini). Le

    d&eacute;lai configur&eacute; pour les en-t&ecirc;tes via la directive

    <code>RequestReadTimeout</code> n'entre en ligne de compte qu'une fois

    la socket re&ccedil;ue par le processus du serveur.</p>



    <p>Il existe deux m&eacute;thodes pour sp&eacute;cifier le d&eacute;lai (pour l'en-t&ecirc;te

    général le cas sous Linux et FreeBSD), la socket n'est envoyée au

    processus du serveur qu'après la réception du premier octet (ou de

    l'ensemble de la requête si <code>httpready</code> est défini). Le

    délai configuré pour les en-têtes via la directive

    <directive>RequestReadTimeout</directive> n'entre en ligne de compte qu'une fois

    la socket reçue par le processus du serveur.</p>



    <p>Il existe deux méthodes pour spécifier le délai (pour l'en-tête

    ou le corps) :

    </p>



    <ul>



    <li><strong>Valeur de d&eacute;lai fixe</strong>:<br />

    <li><strong>Valeur de délai fixe</strong>:<br />



    <example><var>type</var>=<var>d&eacute;lai</var></example>

    <example><var>type</var>=<var>délai</var></example>



    <p>Le temps en secondes allou&eacute; pour la lecture des en-t&ecirc;tes ou du

    corps de la requ&ecirc;te. La valeur 0 signifie aucune limite.</p>

    <p>Le temps en secondes alloué pour la lecture des en-têtes ou du

    corps de la requête. La valeur 0 signifie aucune limite.</p>

    </li>



    <li><strong>D&eacute;sactivation du module pour un serveur virtuel :</strong>:<br />

    <li><strong>Désactivation du module pour un serveur virtuel</strong>:<br />



    <example>header=0 body=0</example>



    <p>Avec cet exemple, le module <module>mod_reqtimeout</module> est

    compl&egrave;tement d&eacute;sactiv&eacute;.</p>

    complètement désactivé.</p>

    </li>



    <li><strong>La valeur du d&eacute;lai qui est augment&eacute;e lorsque des donn&eacute;es

    sont re&ccedil;ues</strong> :<br />

    <li><strong>La valeur du délai qui est augmentée lorsque des données

    sont reçues</strong> :<br />

    <example>

    <var>type</var>=<var>d&eacute;lai</var>,MinRate=<var>taux-mini</var>

    <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</var>

    </example>



    <p>Identique &agrave; ce qui pr&eacute;c&egrave;de, mais chaque fois que des donn&eacute;es sont

    re&ccedil;ues, la valeur du d&eacute;lai est augment&eacute;e en fonction du taux-mini

    sp&eacute;cifi&eacute; (en octets par seconde).</p>

    <p>Identique à ce qui précède, mais chaque fois que des données sont

    reçues, la valeur du délai est augmentée en fonction du taux-mini

    spécifié (en octets par seconde).</p>

    </li>



    <li><strong>La valeur du d&eacute;lai augmente lorsque des donn&eacute;es sont

    re&ccedil;ues, jusqu'&agrave; une limite sup&eacute;rieure</strong>:<br />

    <li><strong>La valeur du délai augmente lorsque des données sont

    reçues, jusqu'à une limite supérieure</strong>:<br />

    <example>

    <var>type</var>=<var>d&eacute;lai</var>-<var>d&eacute;lai-maxi</var>,MinRate=<var>taux-mini</var>

    <var>type</var>=<var>délai</var>-<var>délai-maxi</var>,MinRate=<var>taux-mini</var>

    </example>



    <p>Identique &agrave; ce qui pr&eacute;c&egrave;de, mais le d&eacute;lai n'augmentera pas au

    del&agrave; de la borne sup&eacute;rieure du d&eacute;lai sp&eacute;cifi&eacute;e.</p>

    <p>Identique à ce qui précède, mais le délai n'augmentera pas au

    delà de la borne supérieure du délai spécifiée.</p>

    </li>



    </ul>

docs/manual/rewrite/rewritemap.xml.fr

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

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

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

<!-- English Revision: 1827600:1828122 (outdated) -->

<!-- English Revision: 1828122 -->

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

<!-- Reviewed by : VIncent Deffontaines -->

<!--
@@ -466,6 +466,11 @@ RewriteMap ma-requete "fastdbd:SELECT destination FROM rewrite WHERE source = %s 
    </highlight>

    </example>



    <note><title>Note</title>

    <p>Le nom de la requête est transmis au pilote de base de données en tant

    que label pour une requête SQL préparée, et doit donc respecter toutes les

    règles imposées par votre base de données (comme la sensibilité à la casse).</p></note>



  </section>

  <section id="summary">

    <title>Résumé</title>