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