<?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 -->
<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
<?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 -->
</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
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">
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" "!"
+<Location "/mirror/foo/">
+ ProxyPass "http://backend.example.com/"
+</Location>
+ </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
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
module="core">Location</directive>. Cette variable doit être définie via
la directive <directive module="mod_setenvif">SetEnvIf</directive> car la
directive <directive module="mod_env">SetEnv</directive> n'est pas évaluée
- assez tôt.</p>
+ assez tôt.</p>
</note> <!-- /ordering_proxypass -->
</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
-<?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 -->
<modulesynopsis metafile="mod_reqtimeout.xml.meta">
<name>mod_reqtimeout</name>
-<description>Définit le délai maximum et le taux minimum de transfert des
-données pour la réception des requê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>
<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 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
</li>
<li>
- 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
+ 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">
</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
- 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 :
<highlight language="config">
RequestReadTimeout header=10-30,MinRate=500
</li>
<li>
- 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 :
<highlight language="config">
RequestReadTimeout header=20-40,MinRate=500 body=20,MinRate=500
<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 réception des en-têtes
+et 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>]
+[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é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.</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
- 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>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é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
- <code>RequestReadTimeout</code> 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
+ 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élai fixe</strong>:<br />
+ <li><strong>Valeur de délai fixe</strong>:<br />
- <example><var>type</var>=<var>délai</var></example>
+ <example><var>type</var>=<var>délai</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 la lecture des en-têtes ou du
+ corps de la requête. La valeur 0 signifie aucune limite.</p>
</li>
- <li><strong>Dé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ètement désactivé.</p>
+ complètement désactivé.</p>
</li>
- <li><strong>La valeur du délai qui est augmentée lorsque des données
- sont reç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élai</var>,MinRate=<var>taux-mini</var>
+ <var>type</var>=<var>délai</var>,MinRate=<var>taux-mini</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
- spécifié (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élai augmente lorsque des données sont
- reçues, jusqu'à une limite supé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élai</var>-<var>dé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 à 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 délai n'augmentera pas au
+ delà de la borne supérieure du délai spécifiée.</p>
</li>
</ul>
projects / apache / commitdiff