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