Commit 747956b4 authored by Lucien Gentis's avatar Lucien Gentis
Browse files

xml fr doc updates. 


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

docs/manual/mod/mod_http2.xml.fr

+58 −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 : 1798481 -->

<!-- English Revision : 1855431 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -291,6 +291,8 @@ Protocols h2 h2c http/1.1 
        <contextlist>

            <context>server config</context>

            <context>virtual host</context>

	    <context>directory</context>

            <context>.htaccess</context>

        </contextlist>

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

	Apache.</compatibility>
@@ -325,6 +327,7 @@ Protocols h2 h2c http/1.1 
            <p> 

                Les en-têtes link des réponses sont soit définis par

		l'application, soit configurés via

		<directive>H2PushResource</directive> ou

		<module>mod_headers</module> comme suit :

            </p>

            <example><title>Exemple de configuration d'en-tête link via mod_headers</title>
@@ -343,9 +346,13 @@ Protocols h2 h2c http/1.1 
		une ressource n'a pas déjà été "pushée" vers un client.

            </p>

            <p> 

                Les server pushes HTTP/2 sont activés par défaut. Cette

		directive permet de désactiver cette fonctionnalité pour

		le serveur virtuel ou non considéré.

                Les PUSH HTTP/2 sont activés par défaut. Vous pouvez

		activer/désactiver cette fonctionnalité pour toute connexion au

		serveur au niveau global ou serveur virtuel. Vous pouvez en

		outre désactiver PUSH pour un jeu de ressources dans une

		section Directory/Location. Notez que ceci permet de contrôler

		quelles ressources peuvent déclencher un PUSH, mais pas les

		ressources qui peuvent être envoyées via PUSH.

            </p>

            <example><title>Exemple</title>

                <highlight language="config">
@@ -560,6 +567,8 @@ H2PushPriority text/css interleaved # poids de 256 par défaut 
        <contextlist>

            <context>server config</context>

            <context>virtual host</context>

	    <context>directory</context>

            <context>.htaccess</context>

        </contextlist>

        

        <usage>
@@ -1186,4 +1195,49 @@ H2PushPriority text/css interleaved # poids de 256 par défaut 
        </usage>

    </directivesynopsis>



    <directivesynopsis>

        <name>H2Padding</name>

        <description>Spécifie un intervalle de nombres d'octets de bourrage à

	ajouter aux trames utiles</description>

        <syntax>H2Padding numbits</syntax>

        <default>H2Padding 0</default>

        <contextlist>

            <context>server config</context>

            <context>virtual host</context>

        </contextlist>

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

	Apache.</compatibility>

        

        <usage>

            <p>

                La valeur par défaut 0 indique qu'aucun octet de bourrage ne

		sera ajouté aux trames utiles comme HEADERS, DATA et

		PUSH_PROMISE. Ceci correspond au comportement des versions

		précédentes. Dans ce cas et sous certaines conditions, un

		observateur du trafic réseau pourra alors déterminer la longueur

		de ces trames dans le flux TLS.

            </p>

            <p>

                Si on attribue à numbits la valeur 1-8, un nombre aléatoire

		d'octets entre 0 et 2^numbits sont ajoutés à chaque trame. Une

		valeur aléatoire d'octets de bourrage est attribué

		indépendamment à chaque trame que le module renvoie au client.

            </p>

            <p>

                Pour améliorer la dissimulation de la longueur des trames, on

		peut augmenter le nombre moyen d'octets de bourrage, mais cela

		augmente d'autant le trafic réseau. Le nombre optimal d'octets

		de bourrage dépend donc du type de trafic web que le serveur

		engendre.

            </p>

            <p>

                La valeur par défaut de 0 (aucun octet de bourrage) a été

		choisie dans un but de compatibilité ascendante. Il peut en

		effet exister des installations où les octets de bourrage ne

		sont pas souhaités ou sont néfastes. La cause principale peut

		provenir d'un client dont l'implémentation comporte des erreurs.

            </p>

        </usage>

    </directivesynopsis>

    

</modulesynopsis>

docs/manual/mod/mod_reqtimeout.xml.fr

+56 −51
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: 1853625 -->

<!-- English Revision: 1855413 -->

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

<!-- Reviewed by : Vincent Deffontaines -->
@@ -53,11 +53,12 @@ données pour la réception des requêtes 


    <ol>

      <li>

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

	et 30 secondes pour la réception du corps :

	Accorde 5 secondes pour terminer la négociation TLS, 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

          RequestReadTimeout handshake=5 header=10 body=30

        </highlight>

      </li>
@@ -75,10 +76,10 @@ données pour la réception des requêtes 
      </li>



      <li>

        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

        Accorde au moins 10 secondes pour la réception des en-têtes de la

	requête. 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 :

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



        <highlight language="config">

          RequestReadTimeout header=10-30,MinRate=500
@@ -101,86 +102,90 @@ données pour la réception des requêtes 


<directivesynopsis>

<name>RequestReadTimeout</name>

<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>Définit des délais maximums pour la négociation TLS, la réception

des en-têtes et/ou corps des requêtes en provenance du client.

</description>

<syntax>RequestReadTimeout

[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>]

[handshake=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>rate</var>]

[header=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>MinRate</var>]

[body=<var>timeout</var>[-<var>maxtimeout</var>][,MinRate=<var>MinRate</var>]

</syntax>

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

<default>RequestReadTimeout handshake=0 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ésactivée par défaut depuis la version 2.3.14.</compatibility>

Apache ; désactivée par défaut depuis la version 2.3.14. La phase de

<code>négociation</code> est prise en compte à partir de la version 2.4.39.</compatibility>



<usage>

    <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

    <p>Cette directive permet de définir différents timeouts pour la négociation

    TLS, la réception des en-têtes et/ou corps des requêtes en provenance du

    client. Si le client ne parvient pas à respecter ces timeouts, 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é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>Pour les serveurs virtuels SSL, la valeur de timeout pour la

    <code>négociation</code> correspond au temps nécessaire pour 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 timeout 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 timeouts pour la

    <code>négociation</code> doivent prendre en compte un temps supplémentaire

    pour les serveurs virtuels SSL (si nécessaire). Le timeout 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é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). Les

    timeouts configurés pour la négociation et les en-têtes via la directive

    <directive>RequestReadTimeout</directive> n'entrent en ligne de compte

    qu'une fois le socket reçu par le processus du serveur.</p>



    <p>Il existe trois méthodes pour spécifier le timeout pour chacune des trois

    phases (négociation, en-tête ou corps) :

    </p>



    <ul>



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

    <li><strong>Valeur de timeout fixe</strong>:<br />



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

    <example><var>phase</var>=<var>timeout</var></example>



    <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>

    <p>Le temps en secondes alloué pour terminer l'ensemble de la phase

    (négociation, lecture de tous les en-têtes de la requête ou du corps de

    cette dernière). La valeur 0 signifie aucune limite.</p>

    </li>



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



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

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



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

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

    complètement désactivé (notez que <code>handshake=0</code> correspond à la

    valeur par défaut et peut donc être omis).</p>

    </li>



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

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

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

    <example>

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

    <var>phase</var>=<var>timeout</var>,MinRate=<var>débit</var>

    </example>



    <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

    reçues, la valeur du timeout est augmentée en fonction du MinRate

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

    </li>



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

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

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

    <example>

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

    <var>phase</var>=<var>timeout</var>-<var>maxtimeout</var>,MinRate=<var>débit</var>

    </example>



    <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>

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

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

    </li>



    </ul>

docs/manual/rewrite/rewritemap.xml.fr

+1 −2
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: 1828122 -->

<!-- English Revision: 1855357 -->

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

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

<!--
@@ -153,7 +153,6 @@ exemples pour chacun d'entre eux.</p> 


    <p> <strong>Redirige un URI vers son équivalent en minuscules</strong></p>

    <highlight language="config">



RewriteMap lc int:tolower

RewriteRule "(.*)" "${lc:$1}" [R]

    </highlight>