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