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