<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
-<!-- English Revision : 1162192 -->
+<!-- English Revision: 1403492:1410756 (outdated) -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<seealso><directive module="core" type="section">Else</directive></seealso>
<seealso><directive module="mod_rewrite">RewriteCond</directive></seealso>
<seealso><directive module="mod_setenvif">SetEnvIfExpr</directive></seealso>
+<seealso><directive module="mod_headers">Header</directive></seealso>
+<seealso><directive module="mod_headers">RequestHeader</directive></seealso>
<seealso><directive module="mod_filter">FilterProvider</directive></seealso>
<seealso><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></seealso>
<seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
<title>Syntaxe en Forme de Backus-Naur</title>
<p>La <a href="http://fr.wikipedia.org/wiki/Forme_de_Backus-Naur">Forme de Backus-Naur</a>
(souvent abrégée en BNF, de l'anglais Backus-Naur Form) est une notation permettant de décrire
- les règles syntaxiques des langages de programmation.
+ les règles syntaxiques des langages de programmation. En
+ général, les expressions représentent des valeurs booléennes. Dans
+ ce cas, le point de départ de la BNF est <code>expr</code>.
+ Cependant, certaines directives comme <directive
+ module="mod_log_debug">LogMessage</directive> utilisent comme
+ paramètres des expressions qui représentent des chaînes de
+ caractères. Dans ce cas, le point de départ de la BNF est
+ <code>string</code>.
</p>
<blockquote>
<pre>
<p>Les variables suivantes contiennent la valeur de l'en-tête de
requête HTTP correspondant. La <a href="#functions">fonction</a>
- <code>req</code> permet d'extraire les valeurs des autres en-têtes.</p>
+ <code>req</code> permet d'extraire les valeurs des autres
+ en-têtes. L'utilisation de ces variables peut provoquer
+ l'ajout du nom d'en-tête correspondant à l'en-tête Vary de la
+ réponse HTTP, sauf spécification contraire pour la directive
+ qui accepte l'expression comme paramètre. La <a
+ href="#functions">function</a> <code>req_novary</code> permet de
+ modifier ce comportement.</p>
<table border="1" style="zebra">
<columnspec><column width="1"/></columnspec>
<td>L'identifiant du message d'erreur associé à la connexion
(voir la directive <directive
module="core">ErrorLogFormat</directive>)</td></tr>
+ <tr><td><code>CONN_REMOTE_ADDR</code></td>
+ <td>L'adresse IP du correspondant pour la connexion (voir le module
+ <module>mod_remoteip</module>)</td></tr>
</table>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et correspond à un fichier
régulier</td><td>oui</td></tr>
+ <tr><td><code>-s</code></td>
+ <td>L'argument est traité comme un nom de fichier. Vrai si le
+ fichier existe et n'est pas vide</td><td>oui</td></tr>
<tr><td><code>-L</code></td>
<td>L'argument est traité comme un nom de fichier. Vrai si le
fichier existe et correspond à un lien
<tr><th>Nom</th><th>Description</th><th>Restreint</th></tr>
<tr><td><code>req</code>, <code>http</code></td>
- <td>Lit l'en-tête de requête HTTP</td><td></td></tr>
+ <td>Lit l'en-tête de requête HTTP ; les noms
+ d'en-tête correspondants peuvent être ajoutés à l'en-tête Vary,
+ voir ci-dessous</td><td></td></tr>
+ <tr><td><code>req_novary</code></td>
+ <td>Identique à <code>req</code>, mais les noms
+ d'en-tête correspondants ne seront pas ajoutés à l'en-tête Vary</td><td></td></tr>
<tr><td><code>resp</code></td>
<td>Lit l'en-tête de réponse HTTP</td><td></td></tr>
<tr><td><code>reqenv</code></td>
<p>Les fonctions marquées comme "restreints" ne sont pas disponibles
avec certains modules comme <module>mod_include</module>.</p>
+ <p>Lorsque les fonctions <code>req</code> ou <code>http</code> sont
+ utilisées, le nom d'en-tête sera automatiquement ajouté à l'en-tête
+ Vary de la réponse HTTP, sauf spécification contraire pour la
+ directive qui accepte l'expression comme paramètre. La fonction
+ <code>req_novary</code> permet d'empêcher cet ajout.</p>
+
<p>En plus des fonctions dont la valeur est une chaîne, il existe
aussi des fonctions dont la valeur est une liste, qui acceptent une
chaîne comme argument, et renvoient une liste de mots, autrement dit
module="mod_ssl">SSLRequire</directive>).</p>
</section>
+<section id="examples">
+
+ <title>Exemples d'expressions</title>
+ <p>Les exemples suivants montent comment utiliser les
+ expressions pour évaluer les requêtes :</p>
+ <!-- This section should probably be extended with more, useful examples -->
+ <highlight language="config">
+# Comparer le nom d'hôte avec example.com et rediriger vers
+# www.example.com si le nom d'hôte correspond
+<If "%{HTTP_HOST} == 'example.com'">
+ Redirect permanent / http://www.example.com
+</If>
+
+# Forcer le type text/plain si un fichier fait l'objet d'une
+# requête dont la chaîne de paramètres contient 'forcetext'
+<If "%{QUERY_STRING} =~ /forcetext/">
+ ForceType text/plain
+</If>
+
+# N'autoriser l'accès à ce contenu que pendant les heures de
+# travail
+<Directory "/foo/bar/business">
+ Require expr %{TIME_HOUR} -gt 9 && %{TIME_HOUR} -lt 17
+</Directory>
+ </highlight>
+</section>
<section id="other">
<title>Autres</title>
</section>
+<section id="sslrequire">
+ <title>Comparaison avec SSLRequire</title>
+ <p>La syntaxe <em>ap_expr</em> consiste principalement en une
+ surcouche de la syntaxe de la directive obsolète <directive
+ module="mod_ssl">SSLRequire</directive>. Vous pouvez consulter la
+ liste de leur différences dans la documentation de la directive
+ <directive module="mod_ssl">SSLRequire</directive>.</p>
+</section>
+
</manualpage>