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

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
   4         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>Les expressions dans le serveur HTTP Apache - Serveur Apache HTTP</title>
   9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
  12 <script src="./style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
  16 <body id="manual-page"><div id="page-header">
  17 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
  18 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  19 <img alt="" src="./images/feather.gif" /></div>
  20 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  21 <div id="path">
  22 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Les expressions dans le serveur HTTP Apache</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="./en/expr.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="./fr/expr.html" title="Français">&nbsp;fr&nbsp;</a></p>
  26 </div>
  27 <div class="outofdate">Cette traduction peut être périmée. Vérifiez la version
  28             anglaise pour les changements récents.</div>
  29
  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 <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> peut être remplacée par la
  40     directive <a href="mod/mod_authz_core.html#reqexpr">Require
  41     expr</a>.
  42     </p>
  43   </div>
  44 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#grammar">Syntaxe en Forme de Backus-Naur</a></li>
  45 <li><img alt="" src="./images/down.gif" /> <a href="#vars">Variables</a></li>
  46 <li><img alt="" src="./images/down.gif" /> <a href="#binop">Opérateurs binaires</a></li>
  47 <li><img alt="" src="./images/down.gif" /> <a href="#unnop">Opérateurs unaires</a></li>
  48 <li><img alt="" src="./images/down.gif" /> <a href="#functions">Fonctions</a></li>
  49 <li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples d'expressions</a></li>
  50 <li><img alt="" src="./images/down.gif" /> <a href="#other">Autres</a></li>
  51 <li><img alt="" src="./images/down.gif" /> <a href="#sslrequire">Comparaison avec SSLRequire</a></li>
  52 </ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="directive"><a href="./mod/core.html#if">If</a></code></li><li><code class="directive"><a href="./mod/core.html#if">&lt;If&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#elseif">&lt;ElseIf&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#else">&lt;Else&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_rewrite.html#rewritecond">RewriteCond</a></code></li><li><code class="directive"><a href="./mod/mod_setenvif.html#setenvifexpr">SetEnvIfExpr</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code></li><li><code class="directive"><a href="./mod/mod_headers.html#requestheader">RequestHeader</a></code></li><li><code class="directive"><a href="./mod/mod_filter.html#filterprovider">FilterProvider</a></code></li><li><a href="mod/mod_authz_core.html#reqexpr">Require expr</a></li><li><code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code></li><li><code class="directive"><a href="./mod/mod_log_debug.html#logmessage">LogMessage</a></code></li><li><code class="module"><a href="./mod/mod_include.html">mod_include</a></code></li></ul></div>
  53 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
  54 <div class="section">
  55 <h2><a name="grammar" id="grammar">Syntaxe en Forme de Backus-Naur</a></h2>
  56
  57       <p>La <a href="http://fr.wikipedia.org/wiki/Forme_de_Backus-Naur">Forme de Backus-Naur</a>
  58       (souvent abrégée en BNF, de l'anglais Backus-Naur Form) est une notation permettant de décrire
  59       les règles syntaxiques des langages de programmation.
  60       </p>
  61 <blockquote>
  62 <pre>
  63 expr        ::= "<strong>true</strong>" | "<strong>false</strong>"
  64               | "<strong>!</strong>" expr
  65               | expr "<strong>&amp;&amp;</strong>" expr
  66               | expr "<strong>||</strong>" expr
  67               | "<strong>(</strong>" expr "<strong>)</strong>"
  68               | comp
  69
  70 comp        ::= stringcomp
  71               | integercomp
  72               | unaryop word
  73               | word binaryop word
  74               | word "<strong>in</strong>" "<strong>{</strong>" wordlist "<strong>}</strong>"
  75               | word "<strong>in</strong>" listfunction
  76               | word "<strong>=~</strong>" regex
  77               | word "<strong>!~</strong>" regex
  78
  79
  80 stringcomp  ::= word "<strong>==</strong>" word
  81               | word "<strong>!=</strong>" word
  82               | word "<strong>&lt;</strong>"  word
  83               | word "<strong>&lt;=</strong>" word
  84               | word "<strong>&gt;</strong>"  word
  85               | word "<strong>&gt;=</strong>" word
  86
  87 integercomp ::= word "<strong>-eq</strong>" word | word "<strong>eq</strong>" word
  88               | word "<strong>-ne</strong>" word | word "<strong>ne</strong>" word
  89               | word "<strong>-lt</strong>" word | word "<strong>lt</strong>" word
  90               | word "<strong>-le</strong>" word | word "<strong>le</strong>" word
  91               | word "<strong>-gt</strong>" word | word "<strong>gt</strong>" word
  92               | word "<strong>-ge</strong>" word | word "<strong>ge</strong>" word
  93
  94 wordlist    ::= word
  95               | wordlist "<strong>,</strong>" word
  96
  97 word        ::= word "<strong>.</strong>" word
  98               | digit
  99               | "<strong>'</strong>" string "<strong>'</strong>"
 100               | "<strong>"</strong>" string "<strong>"</strong>"
 101               | variable
 102               | rebackref
 103               | function
 104
 105 string      ::= stringpart
 106               | string stringpart
 107
 108 stringpart  ::= cstring
 109               | variable
 110               | rebackref
 111
 112 cstring     ::= ...
 113 digit       ::= [0-9]+
 114
 115 variable    ::= "<strong>%{</strong>" varname "<strong>}</strong>"
 116               | "<strong>%{</strong>" funcname "<strong>:</strong>" funcargs "<strong>}</strong>"
 117
 118 rebackref   ::= "<strong>$</strong>" [0-9]
 119
 120 function     ::= funcname "<strong>(</strong>" word "<strong>)</strong>"
 121
 122 listfunction ::= listfuncname "<strong>(</strong>" word "<strong>)</strong>"
 123 </pre>
 124 </blockquote>
 125
 126 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 127 <div class="section">
 128 <h2><a name="vars" id="vars">Variables</a></h2>
 129
 130
 131     <p>L'interpréteur d'expressions fournit plusieurs variables de la
 132     forme <code>%{HTTP_HOST}</code>. Notez que la valeur d'une variable
 133     peut dépendre de la phase du traitement de la requête au cours de
 134     laquelle elle est évaluée. Par exemple, une expression utilisée dans
 135     une directive <code class="directive">&lt;If &gt;</code> sera évaluée avant
 136     la phase d'authentification. Par conséquent, la variable
 137     <code>%{REMOTE_USER}</code> ne sera pas encore définie à ce stade.</p>
 138
 139     <p>Les variables suivantes contiennent la valeur de l'en-tête de
 140     requête HTTP correspondant. La <a href="#functions">fonction</a>
 141     <code>req</code> permet d'extraire les valeurs des autres en-têtes.</p>
 142
 143     <table class="bordered"><tr class="header"><th>Nom</th></tr>
 144 <tr><td><code>HTTP_ACCEPT</code></td></tr>
 145 <tr class="odd"><td><code>HTTP_FORWARDED</code></td></tr>
 146 <tr><td><code>HTTP_HOST</code></td></tr>
 147 <tr class="odd"><td><code>HTTP_PROXY_CONNECTION</code></td></tr>
 148 <tr><td><code>HTTP_REFERER</code></td></tr>
 149 <tr class="odd"><td><code>HTTP_USER_AGENT</code></td></tr>
 150 </table>
 151
 152     <p>Autres variables liées aux requêtes</p>
 153
 154     <table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
 155 <tr><td><code>REQUEST_METHOD</code></td>
 156         <td>La méthode HTTP de la requête entrante (par exemple
 157         <code>GET</code>)</td></tr>
 158 <tr class="odd"><td><code>REQUEST_SCHEME</code></td>
 159         <td>Le protocole associé à l'URI de la requête</td></tr>
 160 <tr><td><code>REQUEST_URI</code></td>
 161         <td>La partie chemin de l'URI de la requête</td></tr>
 162 <tr class="odd"><td><code>DOCUMENT_URI</code></td>
 163         <td>Idem REQUEST_URI</td></tr>
 164 <tr><td><code>REQUEST_FILENAME</code></td>
 165         <td>Le chemin complet dans le système de fichiers local du
 166         fichier ou du script correspondant à la requête, si le serveur
 167         l'a dèjà déterminé à l'instant où <code>REQUEST_FILENAME</code>
 168         est référencée. Dans le cas contraire, comme dans un
 169         contexte de serveur virtuel, même valeur que <code>REQUEST_URI</code> </td></tr>
 170 <tr class="odd"><td><code>SCRIPT_FILENAME</code></td>
 171         <td>Identique à <code>REQUEST_FILENAME</code></td></tr>
 172 <tr><td><code>LAST_MODIFIED</code></td>
 173         <td>La date et heure de dernière modification du fichier au
 174         format <code>20101231235959</code>, si elle est déjà connue du
 175         serveur au moment où <code>LAST_MODIFIED</code> est référencé.
 176         </td></tr>
 177 <tr class="odd"><td><code>SCRIPT_USER</code></td>
 178         <td>Le nom d'utilisateur du propriétaire du script.</td></tr>
 179 <tr><td><code>SCRIPT_GROUP</code></td>
 180         <td>Le nom du groupe auquel appartient le script.</td></tr>
 181 <tr class="odd"><td><code>PATH_INFO</code></td>
 182         <td>L'information relative au nom de chemin située en fin, voir
 183         la directive <code class="directive"><a href="./mod/core.html#acceptpathinfo">AcceptPathInfo</a></code></td></tr>
 184 <tr><td><code>QUERY_STRING</code></td>
 185         <td>La chaîne de paramètres de la requête courante</td></tr>
 186 <tr class="odd"><td><code>IS_SUBREQ</code></td>
 187         <td>"<code>true</code>" si la requête courante est une
 188         sous-requête, "<code>false</code>" dans le cas contraire</td></tr>
 189 <tr><td><code>THE_REQUEST</code></td>
 190         <td>La requête complète (par exemple "<code>GET /index.html
 191         HTTP/1.1</code>")</td></tr>
 192 <tr class="odd"><td><code>REMOTE_ADDR</code></td>
 193         <td>L'adresse IP de l'hôte distant</td></tr>
 194 <tr><td><code>REMOTE_HOST</code></td>
 195         <td>Le nom d'hôte de l'hôte distant</td></tr>
 196 <tr class="odd"><td><code>REMOTE_USER</code></td>
 197         <td>Le nom de l'utilisateur authentifié (s'il existe)</td></tr>
 198 <tr><td><code>REMOTE_IDENT</code></td>
 199         <td>Le nom de l'utilisateur défini par <code class="module"><a href="./mod/mod_ident.html">mod_ident</a></code></td></tr>
 200 <tr class="odd"><td><code>SERVER_NAME</code></td>
 201         <td>La valeur de la directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code> du serveur virtuel courant</td></tr>
 202 <tr><td><code>SERVER_PORT</code></td>
 203         <td>Le port associé au serveur virtuel courant ; voir la
 204         directive <code class="directive"><a href="./mod/core.html#servername">ServerName</a></code></td></tr>
 205 <tr class="odd"><td><code>SERVER_ADMIN</code></td>
 206         <td>La valeur de la directive <code class="directive"><a href="./mod/core.html#serveradmin">ServerAdmin</a></code> du serveur virtuel courant</td></tr>
 207 <tr><td><code>SERVER_PROTOCOL</code></td>
 208         <td>Le protocole utilisé par la requête</td></tr>
 209 <tr class="odd"><td><code>DOCUMENT_ROOT</code></td>
 210         <td>La valeur de la directive <code class="directive"><a href="./mod/core.html#documentroot">DocumentRoot</a></code> du serveur virtuel
 211         courant</td></tr>
 212 <tr><td><code>AUTH_TYPE</code></td>
 213         <td>La valeur de la directive <code class="directive"><a href="./mod/mod_authn_core.html#authtype">AuthType</a></code> (par exemple
 214         "<code>basic</code>")</td></tr>
 215 <tr class="odd"><td><code>CONTENT_TYPE</code></td>
 216         <td>Le type de contenu de la réponse</td></tr>
 217 <tr><td><code>HANDLER</code></td>
 218         <td>Le nom du <a href="handler.html">gestionnaire</a> qui a
 219         généré la réponse</td></tr>
 220 <tr class="odd"><td><code>HTTPS</code></td>
 221         <td>"<code>on</code>" si la requête utilise https,
 222         "<code>off</code>" dans le cas contraire</td></tr>
 223 <tr><td><code>IPV6</code></td>
 224         <td>"<code>on</code>" si la connexion utilise IPv6,
 225         "<code>off</code>" dans le cas contraire</td></tr>
 226 <tr class="odd"><td><code>REQUEST_STATUS</code></td>
 227         <td>Le code d'erreur HTTP de la requête</td></tr>
 228 <tr><td><code>REQUEST_LOG_ID</code></td>
 229         <td>L'identifiant du message d'erreur associé à la requête (voir
 230         la directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
 231 <tr class="odd"><td><code>CONN_LOG_ID</code></td>
 232         <td>L'identifiant du message d'erreur associé à la connexion
 233         (voir la directive <code class="directive"><a href="./mod/core.html#errorlogformat">ErrorLogFormat</a></code>)</td></tr>
 234 <tr><td><code>CONN_REMOTE_ADDR</code></td>
 235         <td>L'adresse IP du correspondant pour la connexion (voir le module
 236         <code class="module"><a href="./mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
 237 </table>
 238
 239     <p>Variables diverses</p>
 240
 241     <table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
 242 <tr><td><code>TIME_YEAR</code></td>
 243         <td>L'année courante (par exemple <code>2010</code>)</td></tr>
 244 <tr class="odd"><td><code>TIME_MON</code></td>
 245         <td>Le mois courant (<code>1</code>, ..., <code>12</code>)</td></tr>
 246 <tr><td><code>TIME_DAY</code></td>
 247         <td>Le jour courant dans le mois</td></tr>
 248 <tr class="odd"><td><code>TIME_HOUR</code></td>
 249         <td>Les heures de la date courante (<code>0</code>, ...,
 250         <code>23</code>)</td></tr>
 251 <tr><td><code>TIME_MIN</code></td>
 252         <td>Les minutes de la date courante</td></tr>
 253 <tr class="odd"><td><code>TIME_SEC</code></td>
 254         <td>Les secondes de la date courante</td></tr>
 255 <tr><td><code>TIME_WDAY</code></td>
 256         <td>Le jour de la semaine (à partir de <code>0</code> pour
 257         dimanche)</td></tr>
 258 <tr class="odd"><td><code>TIME</code></td>
 259         <td>La date et heure au format <code>20101231235959</code></td></tr>
 260 <tr><td><code>SERVER_SOFTWARE</code></td>
 261         <td>La chaîne contenant la version du serveur</td></tr>
 262 <tr class="odd"><td><code>API_VERSION</code></td>
 263         <td>La date de la version de l'API (module magic number)</td></tr>
 264 </table>
 265
 266     <p>Certains modules, comme <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code>, définissent des
 267     variables supplémentaires.</p>
 268
 269 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 270 <div class="section">
 271 <h2><a name="binop" id="binop">Opérateurs binaires</a></h2>
 272
 273
 274     <p>À l'exception de quelques opérateurs de comparaison internes, les
 275     opérateurs binaires sont de la forme
 276     "<code>-[a-zA-Z][a-zA-Z0-9_]+</code>", autrement dit un signe moins
 277     et au moins deux caractères. Le nom est insensible à la casse. Les
 278     modules peuvent fournir des opérateurs binaires supplémentaires.</p>
 279
 280     <h3><a name="comp" id="comp">Opérateurs de comparaison</a></h3>
 281
 282
 283     <table class="bordered"><tr class="header"><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
 284 <tr><td><code>==</code></td>
 285         <td><code>=</code></td>
 286         <td>Egalité de chaînes</td></tr>
 287 <tr class="odd"><td><code>!=</code></td>
 288         <td />
 289         <td>Inégalité de chaînes</td></tr>
 290 <tr><td><code>&lt;</code></td>
 291         <td />
 292         <td>Chaîne inférieure à</td></tr>
 293 <tr class="odd"><td><code>&lt;=</code></td>
 294         <td />
 295         <td>Chaîne inférieure ou égale à</td></tr>
 296 <tr><td><code>&gt;</code></td>
 297         <td />
 298         <td>Chaîne supérieure à</td></tr>
 299 <tr class="odd"><td><code>&gt;=</code></td>
 300         <td />
 301         <td>Chaîne supérieure ou égale à</td></tr>
 302 <tr><td><code>-eq</code></td>
 303         <td><code>eq</code></td>
 304         <td>Egalité d'entiers</td></tr>
 305 <tr class="odd"><td><code>-ne</code></td>
 306         <td><code>ne</code></td>
 307         <td>Inégalité d'entiers</td></tr>
 308 <tr><td><code>-lt</code></td>
 309         <td><code>lt</code></td>
 310         <td>Entier inférieur à</td></tr>
 311 <tr class="odd"><td><code>-le</code></td>
 312         <td><code>le</code></td>
 313         <td>Entier inférieur ou égal à</td></tr>
 314 <tr><td><code>-gt</code></td>
 315         <td><code>gt</code></td>
 316         <td>Entier supérieur à</td></tr>
 317 <tr class="odd"><td><code>-ge</code></td>
 318         <td><code>ge</code></td>
 319         <td>Entier supérieur ou égal à</td></tr>
 320 </table>
 321
 322
 323     <h3><a name="binaryother" id="binaryother">Autres opérateurs binaires</a></h3>
 324
 325
 326     <table class="bordered"><tr class="header"><th>Nom</th><th>Description</th></tr>
 327 <tr><td><code>-ipmatch</code></td>
 328         <td>L'adresse IP correspond à adresse/masque</td></tr>
 329 <tr class="odd"><td><code>-strmatch</code></td>
 330         <td>la chaîne de gauche correspond au modèle constitué par la
 331         chaîne de droite (contenant des caractères génériques *, ?, [])</td></tr>
 332 <tr><td><code>-strcmatch</code></td>
 333         <td>idem <code>-strmatch</code>, mais insensible à la casse</td></tr>
 334 <tr class="odd"><td><code>-fnmatch</code></td>
 335         <td>idem <code>-strmatch</code>, mais les slashes ne sont pas
 336         pris en compte par les caractères génériques</td></tr>
 337 </table>
 338
 339
 340 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 341 <div class="section">
 342 <h2><a name="unnop" id="unnop">Opérateurs unaires</a></h2>
 343
 344
 345     <p>Les opérateurs unaires acceptent un seul argument et sont
 346     de la forme "<code>-[a-zA-Z]</code>",
 347     autrement dit le signe moins et un caractère. Le nom <em>est</em>
 348     sensible à la casse. Les modules peuvent fournir des opérateurs
 349     unaires supplémentaires.</p>
 350
 351     <table class="bordered"><tr class="header"><th>Nom</th><th>Description</th><th>Restreint</th></tr>
 352 <tr><td><code>-d</code></td>
 353         <td>L'argument est traité comme un nom de fichier.
 354         Vrai si le fichier existe et correspond à un
 355         répertoire</td><td>oui</td></tr>
 356 <tr class="odd"><td><code>-e</code></td>
 357         <td>L'argument est traité comme un nom de fichier. Vrai si le
 358         fichier (ou dir ou special) existe</td><td>oui</td></tr>
 359 <tr><td><code>-f</code></td>
 360         <td>L'argument est traité comme un nom de fichier. Vrai si le
 361         fichier existe et correspond à un fichier
 362         régulier</td><td>oui</td></tr>
 363 <tr class="odd"><td><code>-s</code></td>
 364         <td>L'argument est traité comme un nom de fichier. Vrai si le
 365         fichier existe et n'est pas vide</td><td>oui</td></tr>
 366 <tr><td><code>-L</code></td>
 367         <td>L'argument est traité comme un nom de fichier. Vrai si le
 368         fichier existe et correspond à un lien
 369         symbolique</td><td>oui</td></tr>
 370 <tr class="odd"><td><code>-h</code></td>
 371         <td>L'argument est traité comme un nom de fichier. Vrai si le
 372         fichier existe et correspond à un lien symbolique
 373         (identique à <code>-L</code>)</td><td>oui</td></tr>
 374 <tr><td><code>-F</code></td>
 375         <td>Vrai si la chaîne correspond a un fichier valide, accessible
 376         avec tous les contrôles d'accès configurés pour ce chemin. A
 377         cette fin, une sous-requête effectue la vérification, et vous
 378         devez utiliser ce drapeau avec soin car il peut impacter les
 379         performances de votre serveur !</td><td /></tr>
 380 <tr class="odd"><td><code>-U</code></td>
 381         <td>Vrai si la chaîne correspond a une URL valide, accessible
 382         avec tous les contrôles d'accès configurés pour ce chemin. A
 383         cette fin, une sous-requête effectue la vérification, et vous
 384         devez utiliser ce drapeau avec soin car il peut impacter les
 385         performances de votre serveur !</td><td /></tr>
 386 <tr><td><code>-A</code></td>
 387         <td>Alias pour <code>-U</code></td><td /></tr>
 388 <tr class="odd"><td><code>-n</code></td>
 389         <td>Vrai si la chaîne n'est pas vide</td><td /></tr>
 390 <tr><td><code>-z</code></td>
 391         <td>Vrai si la chaîne est vide</td><td /></tr>
 392 <tr class="odd"><td><code>-T</code></td>
 393         <td>Faux si la chaîne est vide, "<code>0</code>",
 394         "<code>off</code>", "<code>false</code>", ou "<code>no</code>"
 395         (insensibilité à la casse). Vrai dans le cas contraire.</td><td /></tr>
 396 <tr><td><code>-R</code></td>
 397         <td>Idem "<code>%{REMOTE_ADDR} -ipmatch ...</code>", en plus
 398         efficace
 399         </td><td /></tr>
 400 </table>
 401
 402     <p>Les opérateurs marqués comme "restreints" ne sont pas disponibles
 403     avec certains modules comme <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
 404
 405 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 406 <div class="section">
 407 <h2><a name="functions" id="functions">Fonctions</a></h2>
 408
 409
 410     <p>Normalement, les fonctions dont la valeur est une chaîne acceptent une chaîne
 411     comme argument et renvoient une chaîne. Les noms de fonctions sont
 412     insensibles à la casse. Les modules peuvent fournir des fonctions
 413     supplémentaires.</p>
 414
 415     <table class="bordered"><tr class="header"><th>Nom</th><th>Description</th><th>Restreint</th></tr>
 416 <tr><td><code>req</code>, <code>http</code></td>
 417         <td>Lit l'en-tête de requête HTTP</td><td /></tr>
 418 <tr class="odd"><td><code>resp</code></td>
 419         <td>Lit l'en-tête de réponse HTTP</td><td /></tr>
 420 <tr><td><code>reqenv</code></td>
 421         <td>Recherche une variable d'environnement de requête</td><td /></tr>
 422 <tr class="odd"><td><code>osenv</code></td>
 423         <td>Recherche une variable d'environnement du système
 424         d'exploitation</td><td /></tr>
 425 <tr><td><code>note</code></td>
 426         <td>Recherche une note de requête</td><td /></tr>
 427 <tr class="odd"><td><code>env</code></td>
 428         <td>Renvoie le premier résultat positif de <code>note</code>,
 429         <code>reqenv</code>, <code>osenv</code></td><td /></tr>
 430 <tr><td><code>tolower</code></td>
 431         <td>Convertit une chaîne en minuscules</td><td /></tr>
 432 <tr class="odd"><td><code>toupper</code></td>
 433         <td>Convertit une chaîne en majuscules</td><td /></tr>
 434 <tr><td><code>escape</code></td>
 435         <td>Echappe les caractères spéciaux en codage hexadécimal</td><td /></tr>
 436 <tr class="odd"><td><code>unescape</code></td>
 437         <td>"Déséchappe" les chaînes codées
 438         en hexadécimal, en ne gardant encodés que les slashes; renvoie la chaîne vide
 439         si la séquence %00 est rencontrée</td><td /></tr>
 440 <tr><td><code>file</code></td>
 441         <td>Lit le contenu d'un fichier</td><td>oui</td></tr>
 442 <tr class="odd"><td><code>filesize</code></td>
 443         <td>Renvoie la taille d'un fichier (ou 0 si le fichier n'existe
 444         pas ou ne correspond pas à un fichier régulier)</td><td>oui</td></tr>
 445 </table>
 446
 447     <p>Les fonctions marquées comme "restreints" ne sont pas disponibles
 448     avec certains modules comme <code class="module"><a href="./mod/mod_include.html">mod_include</a></code>.</p>
 449
 450     <p>En plus des fonctions dont la valeur est une chaîne, il existe
 451     aussi des fonctions dont la valeur est une liste, qui acceptent une
 452     chaîne comme argument, et renvoient une liste de mots, autrement dit
 453     une liste de chaînes. La liste de mot peut être utilisée avec
 454     l'opérateur spécial <code>-in</code>. Les noms de fonctions sont
 455     insensibles à la casse. Les modules peuvent fournir des fonctions
 456     supplémentaires.</p>
 457
 458     <p>Il n'existe pas de fonctions internes dont la valeur est une
 459     liste. Le module <code class="module"><a href="./mod/mod_ssl.html">mod_ssl</a></code> fournit la fonction
 460     <code>PeerExtList</code>. Voir la description de la directive
 461     <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code> pour plus de
 462     détails (notez que la fonction <code>PeerExtList</code> peut aussi
 463     être utilisée en dehors de la directive <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>).</p>
 464
 465 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 466 <div class="section">
 467 <h2><a name="examples" id="examples">Exemples d'expressions</a></h2>
 468
 469
 470         <p>Les exemples suivants montent comment utiliser les
 471         expressions pour évaluer les requêtes :</p>
 472
 473         <div class="example"><p><code>
 474         # Comparer le nom d'hôte avec example.com et rediriger vers
 475         # www.example.com si le nom d'hôte correspond<br />
 476         &lt;If "%{HTTP_HOST} == 'example.com'"&gt;<br />
 477         <span class="indent">
 478                 Redirect permanent / http://www.example.com<br />
 479         </span>
 480         &lt;/If&gt;<br /><br />
 481         # Forcer le type text/plain si un fichier fait l'objet d'une
 482         # requête dont la chaîne de paramètres contient 'forcetext'<br />
 483         &lt;If "%{QUERY_STRING} =~ /forcetext/"&gt;<br />
 484         <span class="indent">
 485                 ForceType text/plain<br />
 486         </span>
 487         &lt;/If&gt;<br /><br />
 488         # N'autoriser l'accès à ce contenu que pendant les heures de
 489         # travail<br />
 490         &lt;Directory "/foo/bar/business"&gt;<br />
 491         <span class="indent">
 492                 Require expr %{TIME_HOUR} &gt;= 9 &amp;&amp; %{TIME_HOUR} &lt;= 17 <br />
 493         </span>
 494         &lt;/Directory&gt;
 495         </code></p></div>
 496 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 497 <div class="section">
 498 <h2><a name="other" id="other">Autres</a></h2>
 499
 500
 501     <table class="bordered"><tr class="header"><th>Nom</th><th>Alternative</th> <th>Description</th></tr>
 502 <tr><td><code>-in</code></td>
 503         <td><code>in</code></td>
 504         <td>chaîne contenue dans une liste de chaînes</td></tr>
 505 <tr class="odd"><td><code>/regexp/</code></td>
 506         <td><code>m#regexp#</code></td>
 507         <td>Expression rationnelle (la seconde forme permet de spécifier
 508         des délimiteurs autres que /)</td></tr>
 509 <tr><td><code>/regexp/i</code></td>
 510         <td><code>m#regexp#i</code></td>
 511         <td>Expression rationnelle insensible à la casse</td></tr>
 512 <tr class="odd"><td><code>$0 ... $9</code></td>
 513         <td />
 514         <td>Références arrières dans les expressions rationnelles</td></tr>
 515 </table>
 516
 517     <h3><a name="rebackref" id="rebackref">Références arrières dans les expressions rationnelles</a></h3>
 518
 519         <p>Les chaînes <code>$0</code> ... <code>$9</code> permettent de
 520         référencer les groupes de capture en provenance d'expressions
 521         rationnelles précédemment exécutées et mises en correspondance avec
 522         succès. Elles ne peuvent normalement être utilisées que dans la
 523         même expression que celle mise en correspondance, mais certains
 524         modules permettent de les utiliser de manière spéciale.</p>
 525
 526
 527 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 528 <div class="section">
 529 <h2><a name="sslrequire" id="sslrequire">Comparaison avec SSLRequire</a></h2>
 530
 531     <p>La syntaxe <em>ap_expr</em> consiste principalement en une
 532     surcouche de la syntaxe de la directive obsolète <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>. Vous pouvez consulter la
 533     liste de leur différences dans la documentation de la directive
 534     <code class="directive"><a href="./mod/mod_ssl.html#sslrequire">SSLRequire</a></code>.</p>
 535 </div></div>
 536 <div class="bottomlang">
 537 <p><span>Langues Disponibles: </span><a href="./en/expr.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 538 <a href="./fr/expr.html" title="Français">&nbsp;fr&nbsp;</a></p>
 539 </div><div id="footer">
 540 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 541 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript">
 542     if (typeof(prettyPrint) !== undefined) {
 543         prettyPrint();
 544     }
 545 </script>
 546 </body></html>