<?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: 1825742 -->
+<!-- English Revision: 1827610 -->
<!-- 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
<description>Enregistrement de méthodes HTTP non standards</description>
<syntax>RegisterHttpMethod <var>method</var> [<var>method</var> [...]]</syntax>
<contextlist><context>server config</context></contextlist>
+<compatibility>Disponible à partir de la version 2.4.24 du serveur HTTP Apache</compatibility>
<usage>
<p>Cette directive permet d'enregistrer des méthodes HTTP supplémentaires. Ceci
<?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: 1798938 -->
+<!-- English Revision: 1827608 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<name>RewriteMap</name>
<description>Définit une fonction de mise en correspondance pour la
recherche de mots-clés</description>
-<syntax>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> <em>MapTypeOptions</em>
+<syntax>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> [<em>MapTypeOptions</em>]
</syntax>
<contextlist><context>server config</context><context>virtual host</context>
</contextlist>
+<compatibility>Le troisième paramètre, MapTypeOptions, est disponible à partir
+de la version 2.4.29 du serveur HTTP Apache</compatibility>
<usage>
<p>La directive <directive>RewriteMap</directive> définit une
</highlight>
<p>Vous pourrez ensuite utiliser cette table dans une
- directive <directive>RewriteRule</directive> comme suit :</p>
+ directive <directive module="mod_rewrite">RewriteRule</directive> comme suit :</p>
<highlight language="config">
RewriteRule "^/ex/(.*)" "${map-exemple:$1}"
module="core">UseCanonicalPhysicalPort</directive>.</p>
<p>Parmi les variables
- spécifiques à mod_rewrite, ou trouve les suivantes :</p>
+ spécifiques à <module>mod_rewrite</module>, ou trouve les suivantes :</p>
<dl>
<dt><code>API_VERSION</code></dt>
principal (fichier <code>httpd.conf</code>), vous devez utiliser
<code>%{LA-U:REMOTE_USER}</code> - cette variable est définie
par la phase d'autorisation qui intervient <em>après</em> la
- phase de traduction d'URL (pendant laquelle mod_rewrite opère).</p>
- <p>Par contre, comme mod_rewrite implémente son contexte de
+ phase de traduction d'URL (pendant laquelle <module>mod_rewrite</module>
+ opère).</p>
+ <p>Par contre, comme <module>mod_rewrite</module> implémente son contexte de
répertoire (fichier <code>.htaccess</code>) via la phase Fixup
de l'API, et comme la phase d'autorisation intervient
<em>avant</em> cette dernière, vous pouvez vous contenter
l'<em>expression_de_comparaison</em> en ajoutant ces
<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
comme troisième argument de la directive
- <code>RewriteCond</code>, où <em>drapeaux</em> est un
+ <directive>RewriteCond</directive>, où <em>drapeaux</em> est un
sous-ensemble séparé par des virgules des drapeaux suivants :</p>
<ul>
du système de fichiers "en dessous" de l'endroit où la règle est définie.</p>
<p>Le chemin correspondant actuel du système de fichiers est déterminé par
- des directives telles que <directive>DocumentRoot</directive> et
- <directive>Alias</directive>, ou même le résultat de substitutions dans
- des règles <directive>RewriteRule</directive> précédentes.
+ des directives telles que <directive module="core">DocumentRoot</directive> et
+ <directive module="mod_alias">Alias</directive>, ou même le résultat de
+ substitutions dans des règles <directive>RewriteRule</directive> précédentes.
</p>
</li>
href="../rewrite/intro.html#regex">Introduction à
mod_rewrite</a>.</p>
- <p>Dans mod_rewrite, on peut aussi utiliser le caractère NON
- ('<code>!</code>') comme préfixe de modèle. Ceci vous permet
+ <p>Dans <module>mod_rewrite</module>, on peut aussi utiliser le caractère
+ NOT ('<code>!</code>') comme préfixe de modèle. Ceci vous permet
d'inverser la signification d'un modèle, soit pour dire
``<em>si l'URL considérée ne correspond <strong>PAS</strong> à
ce modèle</em>''. Le caractère NON peut donc être utilisé à
<note><title>Développement du répertoire home</title>
<p> Quand la chaîne de substitution commence par quelque chose comme
-"/~user" (de manière explicite ou par références arrières), mod_rewrite
+"/~user" (de manière explicite ou par références arrières), <module>mod_rewrite</module>
développe le répertoire home sans tenir compte de la présence ou de la
configuration du module <module>mod_userdir</module>.</p>
<?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: 1826995 -->
+<!-- English Revision: 1827561 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
</usage>
</directivesynopsis>
-<directivesynopsis type="section" idtype="section">
-<name>SSLPolicyDefine</name>
-<description>Définit par un nom un jeu de configurations SSL</description>
-<syntax><SSLPolicyDefine <em>name</em>></syntax>
-<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 de définir un jeu de configurations SSL et de lui
-attribuer un nom. Ce nom peut alors être utilisé par les directives
-<directive>SSLPolicy</directive> et <directive>SSLProxyPolicy</directive> pour
-appliquer ce jeu de configurations au contexte courant.</p>
-
-<example><title>Définition et utilisation d'une configuration SSL</title>
-<highlight language="config">
-<SSLPolicyDefine safe-stapling>
- SSLUseStapling on
- SSLStaplingResponderTimeout 2
- SSLStaplingReturnResponderErrors off
- SSLStaplingFakeTryLater off
- SSLStaplingStandardCacheTimeout 86400
-</SSLPolicyDefine>
-
- ...
- <VirtualHost...>
- SSLPolicy safe-stapling
- ...
-</highlight>
-</example>
-
-<p>Cette directive permet d'une part de faciliter la <em>lecture</em> et la
-<em>maintenance</em> des configurations des serveurs. Elle a été conçue d'autre
-part pour faciliter et sécuriser l'<em>utilisation</em> de SSL. Sur ce dernier
-point, Apache httpd est fourni avec un jeu de configurations SSL prédéfinies qui
-respecte les bonnes pratiques du code open source. Par exemple, le jeu de
-configurations "modern" fait en sorte que votre serveur fonctionne de manière
-compatible et sécurisée avec les navigateurs courants.</p>
-
-<p>Vous pouvez obtenir la liste des politiques SSL prédéfinies de votre serveur
-Apache en lançant la commande suivante. Cette liste vous montre le détail du
-contenu de chaque politique SSL prédéfinie :</p>
-
-<example><title>Liste de toutes les politiques SSL prédéfinies</title>
-<highlight language="sh">
-httpd -t -D DUMP_SSL_POLICIES
-</highlight>
-</example>
-
-<p>Cette directive ne peut être utilisée qu'au niveau de la configuration
-globale du serveur. Elle peut gérer la plupart des directives SSL*, à l'exception de
-quelques unes qui ne peuvent être positionnées qu'une seule fois et ne sont pas
-autorisées dans les définitions de politiques. Il s'agit de <directive>SSLCryptoDevice</directive>,
-<directive>SSLRandomSeed</directive>,
-<directive>SSLSessionCache</directive> et
-<directive>SSLStaplingCache</directive>.</p>
-<p>Deux politiques ne peuvent pas partager le même nom. Pour autant, elles peuvent être
-redéfinies :</p>
-
-<example><title>Redéfinition d'une politique</title>
-<highlight language="config">
-<SSLPolicyDefine proxy-trust>
- SSLProxyVerify require
-</SSLPolicyDefine>
- ...
-<SSLPolicyDefine proxy-trust>
- SSLProxyVerify none
-</SSLPolicyDefine>
-</highlight>
-</example>
-
-<p>Les définitions des politiques SSL sont <em>ajoutées</em> selon l'ordre dans
-lequel elles apparaissent, mais sont appliquées lorsque l'ensemble du fichier de
-configuration a été lu. Cela implique que dans l'exemple précédent, toute
-utilisation de la politique 'proxy-trust' sera équivalente à la directive
-'SSLProxyVerify none' et que la première définition de cette politique sera
-ignorée. Il est ainsi possible de modifier des politiques préinstallées sans
-avoir à les désactiver.</p>
-
-<p>Il est aussi possible de ne modifier qu'un aspect de la polique SSL :</p>
-
-<example><title>Redéfinition d'un aspect d'une politique SSL</title>
-<highlight language="config">
-<SSLPolicyDefine proxy-trust>
- SSLProxyVerify require
-</SSLPolicyDefine>
- ...
-<SSLPolicyDefine proxy-trust>
- SSLPolicy proxy-trust
- SSLProxyVerifyDepth 10
-</SSLPolicyDefine>
-</highlight>
-</example>
-
-<p>Toutes les directives de la politique 'proxy-trust' sont alors réutilisées et
-la directive 'SSLProxyVerifyDepth 10' est ajoutée en tête de cette dernière. Cela
-s'avère particulièrement utile lorsque les politiques prédéfinies (par Apache ou
-une distribution) satisfont <em>presque</em> à vos besoins. Auparavant, ces
-politiques devaient être éditées et modifiées après copie éventuelle, ce qui
-compliquait les mises à jour. Elles peuvent maintenant être modifiées comme suit
-:</p>
-
-<example><title>Tweak a Pre-Defined Policy</title>
-<highlight language="config">
-Include ssl-policies.conf
-
-<SSLPolicyDefine modern>
- SSLPolicy modern
- SSLProxyVerify none
-</SSLPolicyDefine>
-</highlight>
-</example>
-
-</usage>
-</directivesynopsis>
-
<directivesynopsis>
<name>SSLPolicy</name>
<description>Applique une politique SSL en la référençant par son nom</description>
(ultime recours).</li>
</ul>
-<p>Vous poubez obtenir une description détaillée de toutes les politiques
+<p>La directive SSLPolicy s'applique à l'endroit où elle est définie, ce qui
+signifie que des valeurs définies évntuellement au préalable sont écrasées, et
+bien entendu que cette même directive peut être écrasée par d'éventuelles
+directives définies plus loin dans le fichier de configuration.</p>
+
+<p>Vous pouvez obtenir une description détaillée de toutes les politiques
prédéfinies via la commande :</p>
<example><title>Liste de toutes les politiques SSL prédéfinies</title>
<highlight language="sh">
</highlight>
</example>
-<p>Une politique SSL définit une base de départ pour le contexte dans lequel
-elle est définie. Autrement dit, toute directive SSL complémentaire l'emporte
-sur cette politique. A titre d'exemple, observez la valeur effective de
-<directive>SSLProtocol</directive> dans la configuration suivante :</p>
-
-<example><title>Politiques SSL et priorités</title>
-<highlight language="config">
-<VirtualHost...> # effective : 'all'
- SSLPolicy modern
- SSLProtocol all
-</VirtualHost>
-
-<VirtualHost...> # effective : 'all'
- SSLProtocol all
- SSLPolicy modern
-</VirtualHost>
-
-SSLPolicy modern
-<VirtualHost...> # effective : 'all'
- SSLProtocol all
-</VirtualHost>
-
-SSLProtocol all
-<VirtualHost...> # effective : '+TLSv1.2'
- SSLPolicy modern
-</VirtualHost>
-</highlight>
-</example>
-
-<p>Il est possible d'appliquer plusieurs politiques SSL au sein d'un même
-contexte. Les dernières auront alors priorité sur les précédentes :</p>
-
-<example><title>Ordonnancement des politiques SSL</title>
-<highlight language="config">
-<VirtualHost...> # protocole effectif : 'all -SSLv3'
- SSLPolicy modern
- SSLPolicy intermediate
-</VirtualHost>
-
-<VirtualHost...> # protocole effectif : '+TLSv1.2'
- SSLPolicy intermediate
- SSLPolicy modern
-</VirtualHost>
-</highlight>
-</example>
-
-</usage>
-</directivesynopsis>
-
-<directivesynopsis>
-<name>SSLProxyPolicy</name>
-<description>N'applique que les directives SSLProxy* d'une politique SSL</description>
-<syntax>SSLProxyPolicy <em>name</em></syntax>
-<contextlist><context>server config</context>
-<context>virtual host</context></contextlist>
-<compatibility>Disponible à partir de la version 2.4.30 du serveur HTTP Apache</compatibility>
-
-<usage>
-<p>Cette directive est similaire à la directive <directive>SSLPolicy</directive>
-mais elle n'applique que les directives SSLProxy* définies dans la politique SSL
-spécifiée. Ceci s'avère utile lorsque vous avez besoin de politiques SSL
-différentes pour les serveurs d'avant et d'arrière-plan :</p>
-
-<example><title>Autre politique SSL pour le mandataire seulement</title>
-<highlight language="config">
-SSLPolicy modern
-SSLProxyPolicy intermediate
-</highlight>
-</example>
-
-<p>Dans cet exemple, la politique 'modern' est tout d'abord appliquée pour
-l'avant et l'arrière-plan. La politique 'intermediate' est ensuite appliquée au
-mandataire en ne prenant en compte que les directives SSLProxy*.</p>
</usage>
</directivesynopsis>
projects / apache / commitdiff