granicus.if.org Git - apache/blob - docs/manual/expr.xml.fr

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
   4 <!-- English Revision: 1776459:1780210 (outdated) -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <manualpage metafile="expr.xml.meta">
  26
  27   <title>Les expressions dans le serveur HTTP Apache</title>
  28
  29   <summary>
  30     <p>Historiquement, il existe de nombreuses variantes dans la syntaxe
  31     des expressions permettant d'exprimer une condition dans les
  32     différents modules du serveur HTTP Apache. À ce titre, des travaux sont
  33     en cours pour n'utiliser qu'une seule variante nommée
  34     <em>ap_expr</em>, pour toutes les directives de configuration. Ce
  35     document décrit l'interpréteur d'expressions <em>ap_expr</em>.
  36     </p>
  37     <p>Le type d'expression <em>ap_expr</em> est appelé à remplacer la
  38     plupart des autres types d'expressions dans HTTPD. Par exemple, la
  39     directive obsolète <directive
  40     module="mod_ssl">SSLRequire</directive> peut être remplacée par la
  41     directive <a href="mod/mod_authz_core.html#reqexpr">Require
  42     expr</a>.
  43     </p>
  44   </summary>
  45
  46 <seealso><directive module="core">If</directive></seealso>
  47 <seealso><directive module="core" type="section">If</directive></seealso>
  48 <seealso><directive module="core" type="section">ElseIf</directive></seealso>
  49 <seealso><directive module="core" type="section">Else</directive></seealso>
  50 <seealso><directive module="core">ErrorDocument</directive></seealso>
  51 <seealso><directive module="mod_alias">Alias</directive></seealso>
  52 <seealso><directive module="mod_alias">ScriptAlias</directive></seealso>
  53 <seealso><directive module="mod_alias">Redirect</directive></seealso>
  54 <seealso><directive module="mod_auth_basic">AuthBasicFake</directive></seealso>
  55 <seealso><directive module="mod_auth_form">AuthFormLoginRequiredLocation</directive></seealso>
  56 <seealso><directive module="mod_auth_form">AuthFormLoginSuccessLocation</directive></seealso>
  57 <seealso><directive module="mod_auth_form">AuthFormLogoutLocation</directive></seealso>
  58 <seealso><directive module="mod_authn_core">AuthName</directive></seealso>
  59 <seealso><directive module="mod_authn_core">AuthType</directive></seealso>
  60 <seealso><directive module="mod_rewrite">RewriteCond</directive></seealso>
  61 <seealso><directive module="mod_setenvif">SetEnvIfExpr</directive></seealso>
  62 <seealso><directive module="mod_headers">Header</directive></seealso>
  63 <seealso><directive module="mod_headers">RequestHeader</directive></seealso>
  64 <seealso><directive module="mod_filter">FilterProvider</directive></seealso>
  65 <seealso><directive module="mod_crypto">CryptoKey</directive></seealso>
  66 <seealso><directive module="mod_crypto">CryptoIV</directive></seealso>
  67 <seealso><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></seealso>
  68 <seealso><a href="mod/mod_authnz_ldap.html#requser">Require ldap-user</a></seealso>
  69 <seealso><a href="mod/mod_authnz_ldap.html#reqgroup">Require ldap-group</a></seealso>
  70 <seealso><a href="mod/mod_authnz_ldap.html#reqdn">Require ldap-dn</a></seealso>
  71 <seealso><a href="mod/mod_authnz_ldap.html#reqattribute">Require ldap-attribute</a></seealso>
  72 <seealso><a href="mod/mod_authnz_ldap.html#reqfilter">Require ldap-filter</a></seealso>
  73 <seealso><a href="mod/mod_authnz_ldap.html#reqsearch">Require ldap-search</a></seealso>
  74 <seealso><a href="mod/mod_authz_dbd.html#reqgroup">Require dbd-group</a></seealso>
  75 <seealso><a href="mod/mod_authz_dbm.html#reqgroup">Require dbm-group</a></seealso>
  76 <seealso><a href="mod/mod_authz_groupfile.html#reqgroup">Require group</a></seealso>
  77 <seealso><a href="mod/mod_authz_host.html#reqhost">Require host</a></seealso>
  78 <seealso><directive module="mod_ssl">SSLRequire</directive></seealso>
  79 <seealso><directive module="mod_log_debug">LogMessage</directive></seealso>
  80 <seealso><module>mod_include</module></seealso>
  81
  82   <section id="grammar">
  83     <title>Syntaxe en Forme de Backus-Naur</title>
  84       <p>La <a href="http://fr.wikipedia.org/wiki/Forme_de_Backus-Naur">Forme de Backus-Naur</a>
  85       (souvent abrégée en BNF, de l'anglais Backus-Naur Form) est une notation permettant de décrire
  86       les règles syntaxiques des langages de programmation. En
  87       général, les expressions représentent des valeurs booléennes. Dans
  88       ce cas, le point de départ de la BNF est <code>expr</code>.
  89       Cependant, certaines directives comme <directive
  90       module="mod_log_debug">LogMessage</directive> utilisent comme
  91       paramètres des expressions qui représentent des chaînes de
  92       caractères. Dans ce cas, le point de départ de la BNF est
  93       <code>string</code>.
  94       </p>
  95 <blockquote>
  96 <pre>
  97 expr        ::= "<strong>true</strong>" | "<strong>false</strong>"
  98               | "<strong>!</strong>" expr
  99               | expr "<strong>&amp;&amp;</strong>" expr
 100               | expr "<strong>||</strong>" expr
 101               | "<strong>(</strong>" expr "<strong>)</strong>"
 102               | comp
 103
 104 comp        ::= stringcomp
 105               | integercomp
 106               | unaryop word
 107               | word binaryop word
 108               | word "<strong>in</strong>" "<strong>{</strong>" wordlist "<strong>}</strong>"
 109               | word "<strong>in</strong>" listfunction
 110               | word "<strong>=~</strong>" regex
 111               | word "<strong>!~</strong>" regex
 112
 113
 114 stringcomp  ::= word "<strong>==</strong>" word
 115               | word "<strong>!=</strong>" word
 116               | word "<strong>&lt;</strong>"  word
 117               | word "<strong>&lt;=</strong>" word
 118               | word "<strong>&gt;</strong>"  word
 119               | word "<strong>&gt;=</strong>" word
 120
 121 integercomp ::= word "<strong>-eq</strong>" word | word "<strong>eq</strong>" word
 122               | word "<strong>-ne</strong>" word | word "<strong>ne</strong>" word
 123               | word "<strong>-lt</strong>" word | word "<strong>lt</strong>" word
 124               | word "<strong>-le</strong>" word | word "<strong>le</strong>" word
 125               | word "<strong>-gt</strong>" word | word "<strong>gt</strong>" word
 126               | word "<strong>-ge</strong>" word | word "<strong>ge</strong>" word
 127
 128 wordlist    ::= word
 129               | wordlist "<strong>,</strong>" word
 130
 131 word        ::= word "<strong>.</strong>" word
 132               | digit
 133               | "<strong>'</strong>" string "<strong>'</strong>"
 134               | "<strong>"</strong>" string "<strong>"</strong>"
 135               | variable
 136               | rebackref
 137               | function
 138
 139 string      ::= stringpart
 140               | string stringpart
 141
 142 stringpart  ::= cstring
 143               | variable
 144               | rebackref
 145
 146 cstring     ::= ...
 147 digit       ::= [0-9]+
 148
 149 variable    ::= "<strong>%{</strong>" varname "<strong>}</strong>"
 150               | "<strong>%{</strong>" funcname "<strong>:</strong>" funcargs "<strong>}</strong>"
 151
 152 rebackref   ::= "<strong>$</strong>" [0-9]
 153
 154 function     ::= funcname "<strong>(</strong>" wordlist "<strong>)</strong>"
 155
 156 listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 157 </pre>
 158 </blockquote>
 159 </section>
 160
 161 <section id="vars">
 162     <title>Variables</title>
 163
 164     <p>L'interpréteur d'expressions fournit plusieurs variables de la
 165     forme <code>%{HTTP_HOST}</code>. Notez que la valeur d'une variable
 166     peut dépendre de la phase du traitement de la requête au cours de
 167     laquelle elle est évaluée. Par exemple, une expression utilisée dans
 168     une directive <directive>&lt;If &gt;</directive> sera évaluée avant
 169     la phase d'authentification. Par conséquent, la variable
 170     <code>%{REMOTE_USER}</code> ne sera pas encore définie à ce stade.</p>
 171
 172     <p>Les variables suivantes contiennent la valeur de l'en-tête de
 173     requête HTTP correspondant. La <a href="#functions">fonction</a>
 174     <code>req</code> permet d'extraire les valeurs des autres
 175     en-têtes. L'utilisation de ces variables peut provoquer
 176     l'ajout du nom d'en-tête correspondant à l'en-tête Vary de la
 177     réponse HTTP, sauf spécification contraire pour la directive
 178     qui accepte l'expression comme paramètre. La <a
 179     href="#functions">function</a> <code>req_novary</code> permet de
 180     modifier ce comportement.</p>
 181
 182     <table border="1" style="zebra">
 183     <columnspec><column width="1"/></columnspec>
 184
 185     <tr><th>Nom</th></tr>
 186     <tr><td><code>HTTP_ACCEPT</code></td></tr>
 187     <tr><td><code>HTTP_COOKIE</code></td></tr>
 188     <tr><td><code>HTTP_FORWARDED</code></td></tr>
 189     <tr><td><code>HTTP_HOST</code></td></tr>
 190     <tr><td><code>HTTP_PROXY_CONNECTION</code></td></tr>
 191     <tr><td><code>HTTP_REFERER</code></td></tr>
 192     <tr><td><code>HTTP_USER_AGENT</code></td></tr>
 193
 194     </table>
 195
 196     <p>Autres variables liées aux requêtes</p>
 197
 198     <table border="1" style="zebra">
 199     <columnspec><column width=".4"/><column width=".6"/></columnspec>
 200
 201     <tr><th>Nom</th><th>Description</th></tr>
 202     <tr><td><code>REQUEST_METHOD</code></td>
 203         <td>La méthode HTTP de la requête entrante (par exemple
 204         <code>GET</code>)</td></tr>
 205     <tr><td><code>REQUEST_SCHEME</code></td>
 206         <td>Le protocole associé à l'URI de la requête</td></tr>
 207     <tr><td><code>REQUEST_URI</code></td>
 208         <td>La partie chemin de l'URI de la requête</td></tr>
 209     <tr><td><code>DOCUMENT_URI</code></td>
 210         <td>Idem <code>REQUEST_URI</code></td></tr>
 211     <tr><td><code>REQUEST_FILENAME</code></td>
 212         <td>Le chemin complet dans le système de fichiers local du
 213         fichier ou du script correspondant à la requête, si le serveur
 214         l'a dèjà déterminé à l'instant où <code>REQUEST_FILENAME</code>
 215         est référencée. Dans le cas contraire, comme dans un
 216         contexte de serveur virtuel, même valeur que <code>REQUEST_URI</code> </td></tr>
 217     <tr><td><code>SCRIPT_FILENAME</code></td>
 218         <td>Identique à <code>REQUEST_FILENAME</code></td></tr>
 219     <tr><td><code>LAST_MODIFIED</code></td>
 220         <td>La date et heure de dernière modification du fichier au
 221         format <code>20101231235959</code>, si elle est déjà connue du
 222         serveur au moment où <code>LAST_MODIFIED</code> est référencé.
 223         </td></tr>
 224     <tr><td><code>SCRIPT_USER</code></td>
 225         <td>Le nom d'utilisateur du propriétaire du script.</td></tr>
 226     <tr><td><code>SCRIPT_GROUP</code></td>
 227         <td>Le nom du groupe auquel appartient le script.</td></tr>
 228     <tr><td><code>PATH_INFO</code></td>
 229         <td>L'information relative au nom de chemin située en fin, voir
 230         la directive <directive module="core">AcceptPathInfo</directive></td></tr>
 231     <tr><td><code>QUERY_STRING</code></td>
 232         <td>La chaîne de paramètres de la requête courante</td></tr>
 233     <tr><td><code>IS_SUBREQ</code></td>
 234         <td>"<code>true</code>" si la requête courante est une
 235         sous-requête, "<code>false</code>" dans le cas contraire</td></tr>
 236     <tr><td><code>THE_REQUEST</code></td>
 237         <td>La requête complète (par exemple "<code>GET /index.html
 238         HTTP/1.1</code>")</td></tr>
 239     <tr><td><code>REMOTE_ADDR</code></td>
 240         <td>L'adresse IP de l'hôte distant</td></tr>
 241     <tr><td><code>REMOTE_PORT</code></td>
 242         <td>Le port de l'hôte distant</td></tr>
 243     <tr><td><code>REMOTE_HOST</code></td>
 244         <td>Le nom d'hôte de l'hôte distant</td></tr>
 245     <tr><td><code>REMOTE_USER</code></td>
 246         <td>Le nom de l'utilisateur authentifié, s'il existe (non
 247         disponible à l'intérieur d'un bloc <directive>&lt;If&gt;</directive>)</td></tr>
 248     <tr><td><code>REMOTE_IDENT</code></td>
 249         <td>Le nom de l'utilisateur défini par <module>mod_ident</module></td></tr>
 250     <tr><td><code>SERVER_NAME</code></td>
 251         <td>La valeur de la directive <directive
 252         module="core">ServerName</directive> du serveur virtuel courant</td></tr>
 253     <tr><td><code>SERVER_PORT</code></td>
 254         <td>Le port associé au serveur virtuel courant ; voir la
 255         directive <directive module="core">ServerName</directive></td></tr>
 256     <tr><td><code>SERVER_ADMIN</code></td>
 257         <td>La valeur de la directive <directive
 258         module="core">ServerAdmin</directive> du serveur virtuel courant</td></tr>
 259     <tr><td><code>SERVER_PROTOCOL</code></td>
 260         <td>Le protocole utilisé par la requête (par
 261         exemple HTTP/1.1). Avec certains types de sous-requêtes
 262         internes, cette variable prend la valeur <code>INCLUDED</code>.</td></tr>
 263     <tr><td><code>SERVER_PROTOCOL_VERSION</code></td>
 264         <td>Un nombre qui représente la version HTTP de la requête :
 265         <code>1000 * major + minor</code>. Par exemple,
 266         <code>1001</code> correspond à HTTP/1.1 et <code>9</code> à
 267         HTTP/0.9.</td></tr>
 268     <tr><td><code>SERVER_PROTOCOL_VERSION_MAJOR</code></td>
 269         <td>La partie majeure de la version HTTP de la requête, par
 270         exemple <code>1</code> pour HTTP/1.0.</td></tr>
 271     <tr><td><code>SERVER_PROTOCOL_VERSION_MINOR</code></td>
 272         <td>La partie mineure de la version HTTP de la requête, par
 273         exemple <code>0</code> pour HTTP/1.0.</td></tr>
 274     <tr><td><code>DOCUMENT_ROOT</code></td>
 275         <td>La valeur de la directive <directive
 276         module="core">DocumentRoot</directive> du serveur virtuel
 277         courant</td></tr>
 278     <tr><td><code>AUTH_TYPE</code></td>
 279         <td>La valeur de la directive <directive
 280         module="mod_authn_core">AuthType</directive> (par exemple
 281         "<code>basic</code>")</td></tr>
 282     <tr><td><code>CONTENT_TYPE</code></td>
 283         <td>Le type de contenu de la réponse (non
 284         disponible à l'intérieur d'un bloc <directive>&lt;If&gt;</directive>)</td></tr>
 285     <tr><td><code>HANDLER</code></td>
 286         <td>Le nom du <a href="handler.html">gestionnaire</a> qui a
 287         généré la réponse</td></tr>
 288     <tr><td><code>HTTP2</code></td>
 289         <td>"<code>on</code>" si la requête utilise http/2,
 290             "<code>off</code>" dans le cas contraire</td></tr>
 291     <tr><td><code>HTTPS</code></td>
 292         <td>"<code>on</code>" si la requête utilise https,
 293         "<code>off</code>" dans le cas contraire</td></tr>
 294     <tr><td><code>IPV6</code></td>
 295         <td>"<code>on</code>" si la connexion utilise IPv6,
 296         "<code>off</code>" dans le cas contraire</td></tr>
 297     <tr><td><code>REQUEST_STATUS</code></td>
 298         <td>Le code d'erreur HTTP de la requête (non
 299         disponible à l'intérieur d'un bloc <directive>&lt;If&gt;</directive>)</td></tr>
 300     <tr><td><code>REQUEST_LOG_ID</code></td>
 301         <td>L'identifiant du message d'erreur associé à la requête (voir
 302         la directive <directive
 303         module="core">ErrorLogFormat</directive>)</td></tr>
 304     <tr><td><code>CONN_LOG_ID</code></td>
 305         <td>L'identifiant du message d'erreur associé à la connexion
 306         (voir la directive <directive
 307         module="core">ErrorLogFormat</directive>)</td></tr>
 308     <tr><td><code>CONN_REMOTE_ADDR</code></td>
 309         <td>L'adresse IP du correspondant pour la connexion (voir le module
 310         <module>mod_remoteip</module>)</td></tr>
 311     <tr><td><code>CONTEXT_PREFIX</code></td>
 312         <td></td></tr>
 313     <tr><td><code>CONTEXT_DOCUMENT_ROOT</code></td>
 314         <td></td></tr>
 315
 316     </table>
 317
 318     <p>Variables diverses</p>
 319
 320     <table border="1" style="zebra">
 321     <columnspec><column width=".4"/><column width=".6"/></columnspec>
 322
 323     <tr><th>Nom</th><th>Description</th></tr>
 324     <tr><td><code>TIME_YEAR</code></td>
 325         <td>L'année courante (par exemple <code>2010</code>)</td></tr>
 326     <tr><td><code>TIME_MON</code></td>
 327         <td>Le mois courant (<code>01</code>, ..., <code>12</code>)</td></tr>
 328     <tr><td><code>TIME_DAY</code></td>
 329         <td>Le jour courant dans le mois (<code>01</code>, ...)</td></tr>
 330     <tr><td><code>TIME_HOUR</code></td>
 331         <td>Les heures de la date courante (<code>00</code>, ...,
 332         <code>23</code>)</td></tr>
 333     <tr><td><code>TIME_MIN</code></td>
 334         <td>Les minutes de la date courante</td></tr>
 335     <tr><td><code>TIME_SEC</code></td>
 336         <td>Les secondes de la date courante</td></tr>
 337     <tr><td><code>TIME_WDAY</code></td>
 338         <td>Le jour de la semaine (à partir de <code>0</code> pour
 339         dimanche)</td></tr>
 340     <tr><td><code>TIME</code></td>
 341         <td>La date et heure au format <code>20101231235959</code></td></tr>
 342     <tr><td><code>SERVER_SOFTWARE</code></td>
 343         <td>La chaîne contenant la version du serveur</td></tr>
 344     <tr><td><code>API_VERSION</code></td>
 345         <td>La date de la version de l'API (module magic number)</td></tr>
 346     </table>
 347
 348     <p>Certains modules, comme <module>mod_ssl</module>, définissent des
 349     variables supplémentaires.</p>
 350
 351 </section>
 352
 353 <section id="binop">
 354     <title>Opérateurs binaires</title>
 355
 356     <p>À l'exception de quelques opérateurs de comparaison internes, les
 357     opérateurs binaires sont de la forme
 358     "<code>-[a-zA-Z][a-zA-Z0-9_]+</code>", autrement dit un signe moins
 359     et au moins deux caractères. Le nom est insensible à la casse. Les
 360     modules peuvent fournir des opérateurs binaires supplémentaires.</p>
 361
 362     <section id="comp">
 363     <title>Opérateurs de comparaison</title>
 364
 365     <table border="1" style="zebra">
 366     <columnspec><column width=".2"/><column width=".2"/><column width=".6"/></columnspec>
 367
 368     <tr><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
 369     <tr><td><code>==</code></td>
 370         <td><code>=</code></td>
 371         <td>Egalité de chaînes</td></tr>
 372     <tr><td><code>!=</code></td>
 373         <td></td>
 374         <td>Inégalité de chaînes</td></tr>
 375     <tr><td><code>&lt;</code></td>
 376         <td></td>
 377         <td>Chaîne inférieure à</td></tr>
 378     <tr><td><code>&lt;=</code></td>
 379         <td></td>
 380         <td>Chaîne inférieure ou égale à</td></tr>
 381     <tr><td><code>&gt;</code></td>
 382         <td></td>
 383         <td>Chaîne supérieure à</td></tr>
 384     <tr><td><code>&gt;=</code></td>
 385         <td></td>
 386         <td>Chaîne supérieure ou égale à</td></tr>
 387     <tr><td><code>=~</code></td>
 388         <td></td>
 389         <td>La chaîne correspond à l'expression rationnelle</td></tr>
 390     <tr><td><code>!~</code></td>
 391         <td></td>
 392         <td>La chaîne ne correspond pas à l'expression rationnelle</td></tr>
 393     <tr><td><code>-eq</code></td>
 394         <td><code>eq</code></td>
 395         <td>Egalité d'entiers</td></tr>
 396     <tr><td><code>-ne</code></td>
 397         <td><code>ne</code></td>
 398         <td>Inégalité d'entiers</td></tr>
 399     <tr><td><code>-lt</code></td>
 400         <td><code>lt</code></td>
 401         <td>Entier inférieur à</td></tr>
 402     <tr><td><code>-le</code></td>
 403         <td><code>le</code></td>
 404         <td>Entier inférieur ou égal à</td></tr>
 405     <tr><td><code>-gt</code></td>
 406         <td><code>gt</code></td>
 407         <td>Entier supérieur à</td></tr>
 408     <tr><td><code>-ge</code></td>
 409         <td><code>ge</code></td>
 410         <td>Entier supérieur ou égal à</td></tr>
 411     </table>
 412     </section>
 413
 414     <section id="binaryother">
 415     <title>Autres opérateurs binaires</title>
 416
 417     <table border="1" style="zebra">
 418     <columnspec><column width=".2"/><column width=".8"/></columnspec>
 419
 420     <tr><th>Nom</th><th>Description</th></tr>
 421     <tr><td><code>-ipmatch</code></td>
 422         <td>L'adresse IP correspond à adresse/masque</td></tr>
 423     <tr><td><code>-strmatch</code></td>
 424         <td>la chaîne de gauche correspond au modèle constitué par la
 425         chaîne de droite (contenant des caractères génériques *, ?, [])</td></tr>
 426     <tr><td><code>-strcmatch</code></td>
 427         <td>idem <code>-strmatch</code>, mais insensible à la casse</td></tr>
 428     <tr><td><code>-fnmatch</code></td>
 429         <td>idem <code>-strmatch</code>, mais les slashes ne sont pas
 430         pris en compte par les caractères génériques</td></tr>
 431     </table>
 432     </section>
 433
 434 </section>
 435
 436 <section id="unnop">
 437     <title>Opérateurs unaires</title>
 438
 439     <p>Les opérateurs unaires acceptent un seul argument et sont
 440     de la forme "<code>-[a-zA-Z]</code>",
 441     autrement dit le signe moins et un caractère. Le nom <em>est</em>
 442     sensible à la casse. Les modules peuvent fournir des opérateurs
 443     unaires supplémentaires.</p>
 444
 445     <table border="1" style="zebra">
 446     <columnspec><column width=".2"/><column width=".2"/><column width=".6"/></columnspec>
 447
 448     <tr><th>Nom</th><th>Description</th><th>Restreint</th></tr>
 449     <tr><td><code>-d</code></td>
 450         <td>L'argument est traité comme un nom de fichier.
 451         Vrai si le fichier existe et correspond à un
 452         répertoire</td><td>oui</td></tr>
 453     <tr><td><code>-e</code></td>
 454         <td>L'argument est traité comme un nom de fichier. Vrai si le
 455         fichier (ou dir ou special) existe</td><td>oui</td></tr>
 456     <tr><td><code>-f</code></td>
 457         <td>L'argument est traité comme un nom de fichier. Vrai si le
 458         fichier existe et correspond à un fichier
 459         régulier</td><td>oui</td></tr>
 460     <tr><td><code>-s</code></td>
 461         <td>L'argument est traité comme un nom de fichier. Vrai si le
 462         fichier existe et n'est pas vide</td><td>oui</td></tr>
 463     <tr><td><code>-L</code></td>
 464         <td>L'argument est traité comme un nom de fichier. Vrai si le
 465         fichier existe et correspond à un lien
 466         symbolique</td><td>oui</td></tr>
 467     <tr><td><code>-h</code></td>
 468         <td>L'argument est traité comme un nom de fichier. Vrai si le
 469         fichier existe et correspond à un lien symbolique
 470         (identique à <code>-L</code>)</td><td>oui</td></tr>
 471     <tr><td><code>-F</code></td>
 472         <td>Vrai si la chaîne correspond a un fichier valide, accessible
 473         avec tous les contrôles d'accès configurés pour ce chemin. A
 474         cette fin, une sous-requête effectue la vérification, et vous
 475         devez utiliser ce drapeau avec soin car il peut impacter les
 476         performances de votre serveur !</td><td></td></tr>
 477     <tr><td><code>-U</code></td>
 478         <td>Vrai si la chaîne correspond a une URL valide, accessible
 479         avec tous les contrôles d'accès configurés pour ce chemin. A
 480         cette fin, une sous-requête effectue la vérification, et vous
 481         devez utiliser ce drapeau avec soin car il peut impacter les
 482         performances de votre serveur !</td><td></td></tr>
 483     <tr><td><code>-A</code></td>
 484         <td>Alias pour <code>-U</code></td><td></td></tr>
 485     <tr><td><code>-n</code></td>
 486         <td>Vrai si la chaîne n'est pas vide</td><td></td></tr>
 487     <tr><td><code>-z</code></td>
 488         <td>Vrai si la chaîne est vide</td><td></td></tr>
 489     <tr><td><code>-T</code></td>
 490         <td>Faux si la chaîne est vide, "<code>0</code>",
 491         "<code>off</code>", "<code>false</code>", ou "<code>no</code>"
 492         (insensibilité à la casse). Vrai dans le cas contraire.</td><td></td></tr>
 493     <tr><td><code>-R</code></td>
 494         <td>Idem "<code>%{REMOTE_ADDR} -ipmatch ...</code>", en plus
 495         efficace
 496         </td><td></td></tr>
 497     </table>
 498
 499     <p>Les opérateurs marqués comme "restreints" ne sont pas disponibles
 500     avec certains modules comme <module>mod_include</module>.</p>
 501
 502 </section>
 503
 504 <section id="functions">
 505     <title>Fonctions</title>
 506
 507     <p>Normalement, les fonctions dont la valeur est une chaîne acceptent une chaîne
 508     comme argument et renvoient une chaîne. Les noms de fonctions sont
 509     insensibles à la casse. Les modules peuvent fournir des fonctions
 510     supplémentaires.</p>
 511
 512     <table border="1" style="zebra">
 513     <columnspec><column width=".2"/><column width=".4"/><column width=".4"/></columnspec>
 514
 515     <tr><th>Nom</th><th>Description</th><th>Remarques particulières</th></tr>
 516     <tr><td><code>req</code>, <code>http</code></td>
 517         <td>Lit l'en-tête de requête HTTP ; les noms
 518         d'en-tête correspondants peuvent être ajoutés à l'en-tête Vary,
 519         voir ci-dessous</td><td></td></tr>
 520     <tr><td><code>req_novary</code></td>
 521         <td>Identique à <code>req</code>, mais les noms
 522         d'en-tête correspondants ne seront pas ajoutés à l'en-tête Vary</td><td></td></tr>
 523     <tr><td><code>resp</code></td>
 524         <td>Lit l'en-tête de réponse HTTP (la plupart des
 525         en-tête de la réponse ne sont pas encore définis pendant
 526         l'exécution de la directive <directive>&lt;If&gt;</directive>)</td><td></td></tr>
 527     <tr><td><code>reqenv</code></td>
 528         <td>Recherche une variable d'environnement de requête (on
 529         peut aussi utiliser le raccourci <code>v</code>).
 530         </td>
 531         <td>ordonnancement</td></tr>
 532     <tr><td><code>osenv</code></td>
 533         <td>Recherche une variable d'environnement du système
 534         d'exploitation</td><td></td></tr>
 535     <tr><td><code>note</code></td>
 536         <td>Recherche une note de requête</td><td>ordonnancement</td></tr>
 537     <tr><td><code>env</code></td>
 538         <td>Renvoie le premier résultat positif de <code>note</code>,
 539         <code>reqenv</code>, <code>osenv</code></td><td>ordonnancement</td></tr>
 540     <tr><td><code>tolower</code></td>
 541         <td>Convertit une chaîne en minuscules</td><td></td></tr>
 542     <tr><td><code>toupper</code></td>
 543         <td>Convertit une chaîne en majuscules</td><td></td></tr>
 544     <tr><td><code>escape</code></td>
 545         <td>Echappe les caractères spéciaux en codage hexadécimal</td><td></td></tr>
 546     <tr><td><code>unescape</code></td>
 547         <td>"Déséchappe" les chaînes codées
 548         en hexadécimal, en ne gardant encodés que les slashes; renvoie la chaîne vide
 549         si la séquence %00 est rencontrée</td><td></td></tr>
 550     <tr><td><code>base64</code></td>
 551         <td>Encode la chaîne en utilisant le codage base64</td><td></td></tr>
 552     <tr><td><code>unbase64</code></td>
 553         <td>Décode une chaîne codée en base64, renvoie une chaîne
 554         tronquée si le caractère 0x00 est rencontré</td><td></td></tr>
 555     <tr><td><code>md5</code></td>
 556         <td>Effectue un hashage MD5 de la chaîne, puis encode le hash
 557         avec un codage hexadécimal</td><td></td></tr>
 558     <tr><td><code>sha1</code></td>
 559         <td>Effectue un hashage SHA1 de la chaîne, puis encode le hash
 560         avec un codage hexadécimal</td><td></td></tr>
 561     <tr><td><code>file</code></td>
 562         <td>Lit le contenu d'un fichier (fins de lignes incluses, si
 563         elles existent)</td><td>limité</td></tr>
 564     <tr><td><code>filemod</code></td>
 565         <td>Renvoie la date de dernière modification d'un fichier (ou 0
 566         si le fichier n'existe pas ou n'est pas un fichier
 567         régulier)</td><td>limité</td></tr>
 568     <tr><td><code>filesize</code></td>
 569         <td>Renvoie la taille d'un fichier (ou 0 si le fichier n'existe
 570         pas ou ne correspond pas à un fichier
 571         régulier)</td><td>limité</td></tr>
 572     <tr><td><code>ldap</code></td>
 573         <td>Echappe les caractères selon la RFC4514 (Echappement des
 574         noms distinctifs LDAP - DN) et la RFC4515 (Echappement des
 575         filtres LDAP).</td><td></td></tr>
 576     <tr><td><code>replace</code></td>
 577         <td>replace(chaîne, "de", "vers") remplace dans la chaîne
 578         spécifiée toutes les occurrences de "de" par "vers".</td><td></td></tr>
 579
 580     </table>
 581
 582     <p>Les fonctions marquées comme "limité" dans la dernière colonne ne sont
 583     pas disponibles avec certains modules comme
 584     <module>mod_include</module>.</p>
 585
 586     <p>Les fonctions marquées comme "ordonnancement" dans la dernière colonne
 587     nécessitent une attention particulière pour l'ordonnancement des différents
 588     composants du serveur, spécialement lorsque la fonction est utilisée au sein
 589     d'une directive &lt;<directive module="core">If</directive>&gt; qui est
 590     évaluée relativement tôt.</p>
 591     <note>
 592     <title>Ordonnancement des variables d'environnement</title>
 593     Lorsque des variables d'environnement sont évaluées au sein d'une directive
 594     &lt;<directive module="core">If</directive>&gt;, il est important de tenir
 595     compte du moment où cette évaluation intervient dans le traitement de la
 596     requête. Par exemple, toute directive définie en dehors d'un contexte de
 597     serveur virtuel (directory, location, htaccess) aura peu de chance d'être
 598     déjà exécutée. Ainsi la directive <directive
 599     module="mod_setenvif">SetEnvIf</directive> est une directive qui s'exécute
 600     avant cette évaluation.
 601     <br/>
 602     <br/>
 603     Lorsque <code>reqenv</code> est utilisé en dehors de la directive
 604     &lt;<directive module="core">If</directive>&gt;, l'évaluation survient en
 605     général plus tard, mais le moment exact dépend de la directive dans laquelle
 606     l'expression a été utilisée.
 607     </note>
 608
 609     <p>Lorsque les fonctions <code>req</code> ou <code>http</code> sont
 610     utilisées, le nom d'en-tête sera automatiquement ajouté à l'en-tête
 611     Vary de la réponse HTTP, sauf spécification contraire pour la
 612     directive qui accepte l'expression comme paramètre. La fonction
 613     <code>req_novary</code> permet d'empêcher cet ajout.</p>
 614
 615     <p>En plus des fonctions dont la valeur est une chaîne, il existe
 616     aussi des fonctions dont la valeur est une liste, qui acceptent une
 617     chaîne comme argument, et renvoient une liste de mots, autrement dit
 618     une liste de chaînes. La liste de mot peut être utilisée avec
 619     l'opérateur spécial <code>-in</code>. Les noms de fonctions sont
 620     insensibles à la casse. Les modules peuvent fournir des fonctions
 621     supplémentaires.</p>
 622
 623     <p>Il n'existe pas de fonctions internes dont la valeur est une
 624     liste. Le module <module>mod_ssl</module> fournit la fonction
 625     <code>PeerExtList</code>. Voir la description de la directive
 626     <directive module="mod_ssl">SSLRequire</directive> pour plus de
 627     détails (notez que la fonction <code>PeerExtList</code> peut aussi
 628     être utilisée en dehors de la directive <directive
 629     module="mod_ssl">SSLRequire</directive>).</p>
 630
 631 </section>
 632 <section id="examples">
 633
 634         <title>Exemples d'expressions</title>
 635         <p>Les exemples suivants montent comment utiliser les
 636         expressions pour évaluer les requêtes :</p>
 637         <!-- This section should probably be extended with more, useful examples -->
 638         <highlight language="config">
 639 # Comparer le nom d'hôte avec example.com et rediriger vers
 640 # www.example.com si le nom d'hôte correspond
 641 &lt;If "%{HTTP_HOST} == 'example.com'"&gt;
 642     Redirect permanent "/" "http://www.example.com/"
 643 &lt;/If&gt;
 644
 645 # Forcer le type text/plain si un fichier fait l'objet d'une
 646 # requête dont la chaîne de paramètres contient 'forcetext'
 647 &lt;If "%{QUERY_STRING} =~ /forcetext/"&gt;
 648     ForceType text/plain
 649 &lt;/If&gt;
 650
 651 # N'autoriser l'accès à ce contenu que pendant les heures de
 652 # travail
 653 &lt;Directory "/foo/bar/business"&gt;
 654      Require expr %{TIME_HOUR} -gt 9 &amp;&amp; %{TIME_HOUR} -lt 17
 655 &lt;/Directory&gt;
 656
 657 # Vérifie si un en-tête HTTP correspond à une des valeurs d'une liste
 658 &lt;If "%{HTTP:X-example-header} in { 'foo', 'bar', 'baz' }"&gt;
 659     La définition de l'en-tête correspond à une des valeurs recherchées
 660 &lt;/If&gt;
 661 # Recherche la valeur d'une expression rationnelle dans une variable
 662 # d'environnement, et renvoie la négation du résultat.
 663 &lt;If "! reqenv('REDIRECT_FOO') =~ /bar/"&gt;
 664     La condition est vérifiée
 665 &lt;/If&gt;
 666
 667 # Vérifie le résultat de la recherche d'une correspondance d'URI dans un
 668 # contexte de répertoire avec l'option -f
 669 &lt;Directory "/var/www"&gt;
 670     AddEncoding x-gzip gz
 671 &lt;If "-f '%{REQUEST_FILENAME}.unzipme' &amp;&amp; ! %{HTTP:Accept-Encoding} =~ /gzip/"&gt;
 672       SetOutputFilter INFLATE
 673 &lt;/If&gt;
 674 &lt;/Directory&gt;
 675
 676 # Vérifie l'adresse IP du client
 677 &lt;If "-R '192.168.1.0/24'"&gt;
 678     Header set matched true
 679 &lt;/If&gt;
 680
 681 # Exemples de fonctions dans un contexte booléen
 682 &lt;If "md5('foo') == 'acbd18db4cc2f85cedef654fccc4a4d8'"&gt;
 683   Header set checksum-matched true
 684 &lt;/If&gt;
 685 &lt;If "md5('foo') == replace('md5:XXXd18db4cc2f85cedef654fccc4a4d8', 'md5:XXX', 'acb')&gt;
 686   Header set checksum-matched-2 true
 687 &lt;/If&gt;
 688
 689
 690 # Function example in string context
 691 Header set foo-checksum "expr=%{md5:foo}"
 692
 693 # L'exemple suivant retarde l'évaluation de la clause de condition par rapport à
 694 # &lt;If&gt;
 695 Header always set CustomHeader my-value "expr=%{REQUEST_URI} =~
 696 m#^/special_path\.php$#"
 697
 698         </highlight>
 699 </section>
 700
 701 <section id="other">
 702     <title>Autres</title>
 703
 704     <table border="1" style="zebra">
 705     <columnspec><column width=".2"/><column width=".2"/><column width=".6"/></columnspec>
 706
 707     <tr><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
 708     <tr><td><code>-in</code></td>
 709         <td><code>in</code></td>
 710         <td>chaîne contenue dans une liste de mots</td></tr>
 711     <tr><td><code>/regexp/</code></td>
 712         <td><code>m#regexp#</code></td>
 713         <td>Expression rationnelle (la seconde forme permet de spécifier
 714         des délimiteurs autres que /)</td></tr>
 715     <tr><td><code>/regexp/i</code></td>
 716         <td><code>m#regexp#i</code></td>
 717         <td>Expression rationnelle insensible à la casse</td></tr>
 718     <tr><td><code>$0 ... $9</code></td>
 719         <td></td>
 720         <td>Références arrières dans les expressions rationnelles</td></tr>
 721     </table>
 722
 723     <section id="rebackref">
 724         <title>Références arrières dans les expressions rationnelles</title>
 725         <p>Les chaînes <code>$0</code> ... <code>$9</code> permettent de
 726         référencer les groupes de capture en provenance d'expressions
 727         rationnelles précédemment exécutées et mises en correspondance avec
 728         succès. Elles ne peuvent normalement être utilisées que dans la
 729         même expression que celle mise en correspondance, mais certains
 730         modules permettent de les utiliser de manière spéciale.</p>
 731     </section>
 732
 733 </section>
 734
 735 <section id="sslrequire">
 736     <title>Comparaison avec SSLRequire</title>
 737     <p>La syntaxe <em>ap_expr</em> consiste principalement en une
 738     surcouche de la syntaxe de la directive obsolète <directive
 739     module="mod_ssl">SSLRequire</directive>. Vous pouvez consulter la
 740     liste de leur différences dans la documentation de la directive
 741     <directive module="mod_ssl">SSLRequire</directive>.</p>
 742 </section>
 743
 744 <section id="compatibility">
 745     <title>Historique de version</title>
 746     <p>La <a href="#functions">fonction</a> <code>req_novary</code> est
 747     disponible à partir de la version 2.4.4 du serveur HTTP Apache.</p>
 748     <p>Les <a href="#vars">variables</a>
 749     <code>SERVER_PROTOCOL_VERSION</code>,
 750     <code>SERVER_PROTOCOL_VERSION_MAJOR</code> et
 751     <code>SERVER_PROTOCOL_VERSION_MINOR</code> sont disponibles à partir
 752     de la version 2.5.0 du serveur HTTP Apache.</p>
 753 </section>
 754
 755 </manualpage>