<?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 : 1212883 -->
+<!-- English Revision: 1403492:1410756 (outdated) -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<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>
<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>