From 7b7252c995f189c33762b6d150be8df80cc7ab35 Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Sun, 8 Apr 2018 16:34:49 +0000 Subject: [PATCH] XML updates. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1828651 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/core.xml.fr | 52 ++++++++++- docs/manual/mod/mod_include.xml.fr | 10 +- docs/manual/mod/mod_proxy.xml.fr | 44 ++++++--- docs/manual/mod/mod_reqtimeout.xml.fr | 128 +++++++++++++------------- docs/manual/rewrite/rewritemap.xml.fr | 7 +- 5 files changed, 163 insertions(+), 78 deletions(-) diff --git a/docs/manual/mod/core.xml.fr b/docs/manual/mod/core.xml.fr index 215539acbc..bfc7945af0 100644 --- a/docs/manual/mod/core.xml.fr +++ b/docs/manual/mod/core.xml.fr @@ -1,7 +1,7 @@ - + @@ -4217,6 +4217,56 @@ seulement depuis la version 2.3.3 sous Windows. Protocols + + RegexDefaultOptions + Configuration des options globales par défaut pour les + expressions rationnelles + RegexDefaultOptions [none] [+|-]option [[+|-]option] ... + RegexDefaultOptions DOLLAR_ENDONLY + server config + Disponible à partir de la version 2.4.30 du serveur HTTP + Apache. + + +

Cette directive permet d'ajouter certains comportements par défaut à + TOUTES les expressions rationnelles utilisées ultérieurement.

+ +

Toute option précédée d'un '+' est ajoutée aux options déjà définies.
+ Toute option précédée d'un '-' est enlevée des options déjà définies.
+ Toute option non suffixée par '+' ou '-' sera définie et remplacera + l'option correspondante éventuellement déjà définie.
+ Le mot-clé none annule toutes les options déjà définies.

+ +

option peut être :

+
+
ICASE
+
Utilise une recherche de correspondance insensible à la casse.
+ +
DOTALL
+
Le drapeau Perl /s.
+ +
DOLLAR_ENDONLY
+
'$' n'est actif qu'à la fin de la chaîne de référence.
+
.
+
+ +# +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 +... + + + + RLimitCPU Limite le temps CPU alloué aux processus initiés par les diff --git a/docs/manual/mod/mod_include.xml.fr b/docs/manual/mod/mod_include.xml.fr index 43f0272a5e..58cb94ff5b 100644 --- a/docs/manual/mod/mod_include.xml.fr +++ b/docs/manual/mod/mod_include.xml.fr @@ -1,7 +1,7 @@ - + @@ -598,6 +598,11 @@ AddOutputFilter INCLUDES .shtml
Le nom de base du fichier demandé par l'utilisateur (sans son chemin).
+
DOCUMENT_PATH_INFO
+
La partie terminale du chemin du fichier. Voir la directive AcceptPathInfo pour plus d'informations à + propos de PATH_INFO.
+
DOCUMENT_URI
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 DOCUMENT_ARGS si l'échappement des caractères du shell n'est pas souhaité.
+ +
USER_NAME
+
Le nom d'utilisateur du propriétaire du fichier.
diff --git a/docs/manual/mod/mod_proxy.xml.fr b/docs/manual/mod/mod_proxy.xml.fr index 38b5eac75c..a243dbde26 100644 --- a/docs/manual/mod/mod_proxy.xml.fr +++ b/docs/manual/mod/mod_proxy.xml.fr @@ -1,7 +1,7 @@ - + @@ -1032,7 +1032,7 @@ sont supportés à partir de la version 2.4.7 du serveur HTTP Apache

va convertir en interne toute requête pour - http://example.com/miroir/foo/bar en une requête + http://example.com/mirror/foo/bar en une requête mandatée pour http://backend.example.com/bar.

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 ApacheBalancer Manager :

- ProxyPass "/miroir/foo/" "http://backend.example.com/" + ProxyPass "/mirror/foo/" "http://backend.example.com/" @@ -1076,9 +1076,25 @@ ProxyPass "/mirror/foo/i" "!" ProxyPass "/mirror/foo" "http://backend.example.com" -

va mandater toutes les requêtes pour /miroir/foo +

va mandater toutes les requêtes pour /mirror/foo vers backend.example.com, sauf les requêtes - pour /miroir/foo/i.

+ pour /mirror/foo/i.

+ +

Mélanger plusieurs configurations ProxyPass dans différents contextes ne + fonctionne pas :

+ +ProxyPass "/mirror/foo/i" "!" +<Location "/mirror/foo/"> + ProxyPass "http://backend.example.com/" +</Location> + +

Dans ce cas, une requête pour /mirror/foo/i sera tout de + même mandatée car c'est la directive ProxyPass de la + section Location qui sera évaluée en premier. Le fait que la directive + ProxyPass 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.

Ordre de classement des directives ProxyPass

Les directives + + + Chronologie de prise en compte des directives + ProxyPass au sein des sections Locations +

On ne peut placer qu'une seule directive ProxyPass dans une section Location, et c'est la section la plus spécifique qui l'emportera.

- -

Pour les mêmes raisons, les exclusions doivent se situer avant + + Exclusions et variable d'environnement no-proxy +

Les exclusions doivent se situer avant les directives ProxyPass 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 @@ -1106,7 +1128,7 @@ ProxyPass "/mirror/foo" "http://backend.example.com" module="core">Location. Cette variable doit être définie via la directive SetEnvIf car la directive SetEnv n'est pas évaluée - assez tôt.

+ assez tôt.

 @@ -1726,14 +1748,14 @@ ProxyPassReverseCookiePath "/" "/mirror/foo/"

ne va pas seulement provoquer la conversion interne d'une requête - locale pour http://example.com/miroir/foo/bar en une + locale pour http://example.com/mirror/foo/bar en une requête mandatée pour http://backend.example.com/bar (la fonctionnalité fournie par ProxyPass). Il va aussi s'occuper des redirections que le serveur backend.example.com envoie lorsqu'il redirige http://backend.example.com/bar vers http://backend.example.com/quux. Apache - httpd corrige ceci en http://example.com/miroir/foo/quux + httpd corrige ceci en http://example.com/mirror/foo/quux 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 + - + @@ -25,8 +25,8 @@ mod_reqtimeout -Définit le délai maximum et le taux minimum de transfert des -données pour la réception des requêtes +Définit le délai maximum et le taux minimum de transfert des +données pour la réception des requêtes Extension mod_reqtimeout.c @@ -37,8 +37,8 @@ données pour la réception des requêtes

  1. - 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 10 secondes pour la réception des en-têtes de la requête + et 30 secondes pour la réception du corps : RequestReadTimeout headerinit=10 body=30 @@ -46,11 +46,11 @@ données pour la réception des requêtes
  2. - 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 LimitRequestBody) : @@ -59,10 +59,10 @@ données pour la réception des requêtes
  3. - 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 : + 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 : RequestReadTimeout header=10-30,MinRate=500 @@ -70,10 +70,10 @@ données pour la réception des requêtes
  4. - 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 : + 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 : RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500 @@ -85,86 +85,86 @@ données pour la réception des requêtes RequestReadTimeout -Définit des délais maximums pour la réception des en-têtes -et corps des requêtes en provenance du client. +Définit des délais maximums pour la réception des en-têtes +et corps des requêtes en provenance du client. RequestReadTimeout -[header=délai[-délai-maxi][,MinRate=taux-mini] -[body=délai[-délai-maxi][,MinRate=taux-mini] +[header=délai[-délai-maxi][,MinRate=taux-mini] +[body=délai[-délai-maxi][,MinRate=taux-mini] header=20-40,MinRate=500 body=20,MinRate=500 server configvirtual host Disponible depuis la version 2.2.15 du serveur HTTP -Apache ; désactivée par défaut depuis la version 2.3.14. +Apache ; désactivée par défaut depuis la version 2.3.14. -

    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 408 REQUEST TIME OUT est envoyé.

    - -

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

    +

    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 408 REQUEST TIME OUT est envoyé.

    + +

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

    Lorsqu'une directive AcceptFilter 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 httpready est défini). Le - délai configuré pour les en-têtes via la directive - RequestReadTimeout n'entre en ligne de compte qu'une fois - la socket reçue par le processus du serveur.

    - -

    Il existe deux méthodes pour spécifier le délai (pour l'en-tê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 httpready est défini). Le + délai configuré pour les en-têtes via la directive + RequestReadTimeout n'entre en ligne de compte qu'une fois + la socket reçue par le processus du serveur.

    + +

    Il existe deux méthodes pour spécifier le délai (pour l'en-tête ou le corps) :

      -
    • Valeur de délai fixe:
      +
    • Valeur de délai fixe:
      - type=délai + type=délai -

      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.

      +

      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.

      • -
    • Désactivation du module pour un serveur virtuel ::
      +
    • Désactivation du module pour un serveur virtuel:
      header=0 body=0

      Avec cet exemple, le module mod_reqtimeout est - complètement désactivé.

      + complètement désactivé.

      • -
    • La valeur du délai qui est augmentée lorsque des données - sont reçues :
      +
    • La valeur du délai qui est augmentée lorsque des données + sont reçues :
      - type=délai,MinRate=taux-mini + type=délai,MinRate=taux-mini -

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

      +

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

      • -
    • La valeur du délai augmente lorsque des données sont - reçues, jusqu'à une limite supérieure:
      +
    • La valeur du délai augmente lorsque des données sont + reçues, jusqu'à une limite supérieure:
      - type=délai-délai-maxi,MinRate=taux-mini + type=délai-délai-maxi,MinRate=taux-mini -

      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.

      +

      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.

    diff --git a/docs/manual/rewrite/rewritemap.xml.fr b/docs/manual/rewrite/rewritemap.xml.fr index d850002d3f..cd964f82f7 100644 --- a/docs/manual/rewrite/rewritemap.xml.fr +++ b/docs/manual/rewrite/rewritemap.xml.fr @@ -1,7 +1,7 @@ - +