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