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