<?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 : 1202456 -->
+<!-- English Revision: 1663259:1670320 (outdated) -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<seealso><directive module="core" type="section">If</directive></seealso>
<seealso><directive module="core" type="section">ElseIf</directive></seealso>
<seealso><directive module="core" type="section">Else</directive></seealso>
+<seealso><directive module="mod_alias">Alias</directive></seealso>
+<seealso><directive module="mod_alias">ScriptAlias</directive></seealso>
+<seealso><directive module="mod_alias">Redirect</directive></seealso>
+<seealso><directive module="mod_auth_basic">AuthBasicFake</directive></seealso>
+<seealso><directive module="mod_auth_form">AuthFormLoginRequiredLocation</directive></seealso>
+<seealso><directive module="mod_auth_form">AuthFormLoginSuccessLocation</directive></seealso>
+<seealso><directive module="mod_auth_form">AuthFormLogoutLocation</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><a href="mod/mod_authnz_ldap.html#requser">Require ldap-user</a></seealso>
+<seealso><a href="mod/mod_authnz_ldap.html#reqgroup">Require ldap-group</a></seealso>
+<seealso><a href="mod/mod_authnz_ldap.html#reqdn">Require ldap-dn</a></seealso>
+<seealso><a href="mod/mod_authnz_ldap.html#reqattribute">Require ldap-attribute</a></seealso>
+<seealso><a href="mod/mod_authnz_ldap.html#reqfilter">Require ldap-filter</a></seealso>
+<seealso><a href="mod/mod_authz_dbd.html#reqgroup">Require dbd-group</a></seealso>
+<seealso><a href="mod/mod_authz_dbm.html#reqgroup">Require dbm-group</a></seealso>
+<seealso><a href="mod/mod_authz_groupfile.html#reqgroup">Require group</a></seealso>
+<seealso><a href="mod/mod_authz_host.html#reqhost">Require host</a></seealso>
<seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
<seealso><directive module="mod_log_debug">LogMessage</directive></seealso>
<seealso><module>mod_include</module></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>
<tr><th>Nom</th></tr>
<tr><td><code>HTTP_ACCEPT</code></td></tr>
+ <tr><td><code>HTTP_COOKIE</code></td></tr>
<tr><td><code>HTTP_FORWARDED</code></td></tr>
<tr><td><code>HTTP_HOST</code></td></tr>
<tr><td><code>HTTP_PROXY_CONNECTION</code></td></tr>
<tr><td><code>REQUEST_URI</code></td>
<td>La partie chemin de l'URI de la requête</td></tr>
<tr><td><code>DOCUMENT_URI</code></td>
- <td>Idem REQUEST_URI</td></tr>
+ <td>Idem <code>REQUEST_URI</code></td></tr>
<tr><td><code>REQUEST_FILENAME</code></td>
<td>Le chemin complet dans le système de fichiers local du
fichier ou du script correspondant à la requête, si le serveur
<tr><td><code>REMOTE_HOST</code></td>
<td>Le nom d'hôte de l'hôte distant</td></tr>
<tr><td><code>REMOTE_USER</code></td>
- <td>Le nom de l'utilisateur authentifié (s'il existe)</td></tr>
+ <td>Le nom de l'utilisateur authentifié, s'il existe (non
+ disponible à l'intérieur d'un bloc <directive><If
+ ></directive>)</td></tr>
<tr><td><code>REMOTE_IDENT</code></td>
<td>Le nom de l'utilisateur défini par <module>mod_ident</module></td></tr>
<tr><td><code>SERVER_NAME</code></td>
module="mod_authn_core">AuthType</directive> (par exemple
"<code>basic</code>")</td></tr>
<tr><td><code>CONTENT_TYPE</code></td>
- <td>Le type de contenu de la réponse</td></tr>
+ <td>Le type de contenu de la réponse (non
+ disponible à l'intérieur d'un bloc <directive><If
+ ></directive>)</td></tr>
<tr><td><code>HANDLER</code></td>
<td>Le nom du <a href="handler.html">gestionnaire</a> qui a
généré la réponse</td></tr>
<td>"<code>on</code>" si la connexion utilise IPv6,
"<code>off</code>" dans le cas contraire</td></tr>
<tr><td><code>REQUEST_STATUS</code></td>
- <td>Le code d'erreur HTTP de la requête</td></tr>
+ <td>Le code d'erreur HTTP de la requête (non
+ disponible à l'intérieur d'un bloc <directive><If
+ ></directive>)</td></tr>
<tr><td><code>REQUEST_LOG_ID</code></td>
<td>L'identifiant du message d'erreur associé à la requête (voir
la directive <directive
<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>
+ <tr><td><code>CONTEXT_PREFIX</code></td>
+ <td></td></tr>
+ <tr><td><code>CONTEXT_DOCUMENT_ROOT</code></td>
+ <td></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 aucun nom d'en-tête n'est
+ ajouté à 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>
- <td>Recherche une variable d'environnement de requête</td><td></td></tr>
+ <td>Recherche une variable d'environnement de requête (on
+ peut aussi utiliser le raccourci <code>v</code>).</td><td></td></tr>
<tr><td><code>osenv</code></td>
<td>Recherche une variable d'environnement du système
d'exploitation</td><td></td></tr>
<td>"Déséchappe" les chaînes codées
en hexadécimal, en ne gardant encodés que les slashes; renvoie la chaîne vide
si la séquence %00 est rencontrée</td><td></td></tr>
+ <tr><td><code>base64</code></td>
+ <td>Encode la chaîne en base64</td><td></td></tr>
+ <tr><td><code>unbase64</code></td>
+ <td>Décode les chaînes codées en base64, renvoie une chaîne
+ tronquée si le caractère 0x00 est rencontré</td><td></td></tr>
+ <tr><td><code>md5</code></td>
+ <td>Génère un hash de la chaîne en utilisant MD5, puis code le
+ hash obtenu en hexadécimal</td><td></td></tr>
+ <tr><td><code>sha1</code></td>
+ <td>Génère un hash de la chaîne en utilisant SHA1, puis encode
+ le hash obtenu en hexadécimal</td><td></td></tr>
<tr><td><code>file</code></td>
- <td>Lit le contenu d'un fichier</td><td>oui</td></tr>
+ <td>Lit le contenu d'un fichier(fins de lignes incluses, si
+ elles existent)</td><td>oui</td></tr>
<tr><td><code>filesize</code></td>
<td>Renvoie la taille d'un fichier (ou 0 si le fichier n'existe
pas ou ne correspond pas à un fichier régulier)</td><td>oui</td></tr>
<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 l'ajout de noms
+ d'en-têtes à l'en-tête Vary.</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>
+
+# Vérifie si un en-tête HTTP correspond à une des valeurs d'une liste
+<If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }">
+ La définition de l'en-tête correspond à une des valeurs recherchées
+</If>
+
+# Recherche la valeur d'une expression rationnelle dans une variable
+# d'environnement, et renvoie la négation du résultat.
+<If "! reqenv('REDIRECT_FOO') =~ /bar/">
+ La condition est vérifiée
+</If>
+
+# Vérifie le résultat de la recherche d'une correspondance d'URI dans un
+# contexte de répertoire avec l'option -f
+<Directory /var/www>
+ AddEncoding x-gzip gz
+<If "-f '%{REQUEST_FILENAME}.unzipme' && ! %{HTTP:Accept-Encoding} =~ /gzip/">
+ SetOutputFilter INFLATE
+</If>
+</Directory>
+
+# Exemples de fonctions dans un contexte booléen
+<If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'">
+ Header set checksum-matched true
+</If>
+<If "md5('foo') == replace('md5:XXXd18db4cc2f85cedef654fccc4a4d8', 'md5:XXX', 'acb')>
+ Header set checksum-matched-2 true
+</If>
+
+# Function example in string context
+Header set foo-checksum "expr=%{md5:foo}"
+
+ </highlight>
+</section>
<section id="other">
<title>Autres</title>
<tr><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
<tr><td><code>-in</code></td>
<td><code>in</code></td>
- <td>chaîne contenue dans une liste de chaînes</td></tr>
+ <td>chaîne contenue dans une liste de mots</td></tr>
<tr><td><code>/regexp/</code></td>
<td><code>m#regexp#</code></td>
<td>Expression rationnelle (la seconde forme permet de spécifier
<directive module="mod_ssl">SSLRequire</directive>.</p>
</section>
+<section id="compatibility">
+ <title>Historique de version</title>
+ <p>La <a href="#functions">fonction</a> <code>req_novary</code> est
+ disponible à partir de la version 2.4.4 du serveur HTTP Apache.</p>
+</section>
+
</manualpage>