granicus.if.org Git - apache/blob - docs/manual/rewrite/flags.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 drapeaux de réécriture - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  12 <script src="../style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body id="manual-page"><div id="page-header">
  17 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  18 <p class="apache">Serveur Apache HTTP Version 2.4</p>
  19 <img alt="" src="../images/feather.gif" /></div>
  20 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  21 <div id="path">
  22 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Les drapeaux de réécriture</h1>
  23 <div class="toplang">
  24 <p><span>Langues Disponibles: </span><a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="../fr/rewrite/flags.html" title="Français">&nbsp;fr&nbsp;</a></p>
  26 </div>
  27
  28 <p>Ce document décrit les drapeaux disponibles dans la directive
  29 <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, en fournissant
  30 des explications détaillées et des exemples.</p>
  31 </div>
  32 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
  33 <li><img alt="" src="../images/down.gif" /> <a href="#flag_b">B (échappement dans les références arrières)</a></li>
  34 <li><img alt="" src="../images/down.gif" /> <a href="#flag_c">C|chain</a></li>
  35 <li><img alt="" src="../images/down.gif" /> <a href="#flag_co">CO|cookie</a></li>
  36 <li><img alt="" src="../images/down.gif" /> <a href="#flag_dpi">DPI|discardpath</a></li>
  37 <li><img alt="" src="../images/down.gif" /> <a href="#flag_e">E|env</a></li>
  38 <li><img alt="" src="../images/down.gif" /> <a href="#flag_end">END</a></li>
  39 <li><img alt="" src="../images/down.gif" /> <a href="#flag_f">F|forbidden</a></li>
  40 <li><img alt="" src="../images/down.gif" /> <a href="#flag_g">G|gone</a></li>
  41 <li><img alt="" src="../images/down.gif" /> <a href="#flag_h">H|handler</a></li>
  42 <li><img alt="" src="../images/down.gif" /> <a href="#flag_l">L|last</a></li>
  43 <li><img alt="" src="../images/down.gif" /> <a href="#flag_n">N|next</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#flag_nc">NC|nocase</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#flag_ne">NE|noescape</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#flag_ns">NS|nosubreq</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#flag_p">P|proxy</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#flag_pt">PT|passthrough</a></li>
  49 <li><img alt="" src="../images/down.gif" /> <a href="#flag_qsa">QSA|qsappend</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#flag_qsd">QSD|qsdiscard</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#flag_r">R|redirect</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#flag_s">S|skip</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#flag_t">T|type</a></li>
  54 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection and remise en
  55 correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</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="introduction" id="introduction">Introduction</a></h2>
  59 <p>Le comportement d'une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> peut être modifié par un ou
  60 plusieurs drapeaux. Les drapeaux sont situés en fin de règle, entourés
  61 de crochets, et séparés le cas échéant par des virgules.</p>
  62 <div class="example"><p><code>
  63 RewriteRule modèle cible [drapeau1,drapeau2,drapeau3]
  64 </code></p></div>
  65
  66 <p>Les drapeaux ont tous une forme courte, comme <code>CO</code>, ainsi
  67 qu'une forme longue, comme <code>cookie</code>. Certains drapeaux
  68 peuvent avoir un ou plusieurs arguments. Les drapeaux sont insensibles à
  69 la casse.</p>
  70
  71 <p>Chaque drapeau (à quelques exceptions près) possède une forme longue et une forme courte. Bien que
  72 la forme courte soit la plus couramment utilisée, nous vous recommandons
  73 de vous familiariser avec les drapeaux sous leur forme longue, afin de
  74 bien mémoriser ce que chaque drapeau est supposé faire.</p>
  75
  76 <p>Les drapeaux qui modifient les métadonnées associées à la requête
  77 (T=, H=, E=) n'ont aucun effet dans un contexte de répertoire ou de
  78 fichier htaccess, lorsqu'une substitution (autre que '-') est effectuée
  79 au cours de la même passe du processus de réécriture.
  80 </p>
  81
  82 <p>Chaque drapeau disponible est présenté ici, avec un exemple
  83 d'utilisation.</p>
  84 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  85 <div class="section">
  86 <h2><a name="flag_b" id="flag_b">B (échappement dans les références arrières)</a></h2>
  87 <p>Avec le drapeau [B], la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> échappe les caractères
  88 non-alphanumériques avant d'appliquer la transformation.</p>
  89
  90 <p><code>mod_rewrite</code> doit supprimer les séquences d'échappement
  91 des URLs avant leur
  92 mise en correspondance avec le système de fichiers ; les séquences
  93 d'échappement sont donc supprimées des références arrières au moment où
  94 ces dernières sont appliquées. Avec le drapeau B, les caractères
  95 non-alphanumériques des références arrières seront échappés. Considérons
  96 par exemple cette règle :</p>
  97
  98 <div class="example"><p><code>
  99 RewriteRule ^search/(.*)$ /search.php?term=$1
 100 </code></p></div>
 101
 102 <p>Soit le terme de recherche 'x &amp; y/z' ; un navigateur va le coder
 103 en 'x%20%26%20y%2Fz', transformant la requête en
 104 'search/x%20%26%20y%2Fz'. Sans le drapeau B, cette règle de réécriture
 105 va réécrire la requête en 'search.php?term=x &amp; y/z', ce qui ne
 106 correspond pas à une URL valide et cette dernière sera encodée en
 107 <code>search.php?term=x%20&amp;y%2Fz=</code>, ce qui ne correspond pas à
 108 ce que l'on souhaitait.</p>
 109
 110 <p>Avec le drapeau B, les paramètres sont réencodés avant d'être passés
 111 à l'URL résultante, ce qui fournit une réécriture correcte en
 112 <code>/search.php?term=x%20%26%20y%2Fz</code>.</p>
 113
 114 <p>Notez que vous devrez peut-être aussi définir la
 115 directive <code class="directive"><a href="../mod/core.html#allowencodedslashes">AllowEncodedSlashes</a></code>
 116 à <code>On</code> pour
 117 que cet exemple particulier fonctionne, car httpd ne permet pas les
 118 slashes encodés dans les URLs, et renvoie une erreur 404 s'il en
 119 rencontre un.</p>
 120
 121 <p>Ce processus d'échappement est en particulier nécessaire dans le
 122 contexte d'un mandataire, où l'accès au serveur d'arrière-plan échouera
 123 si on présente à ce dernier une URL non échappée.</p>
 124
 125 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 126 <div class="section">
 127 <h2><a name="flag_c" id="flag_c">C|chain</a></h2>
 128 <p>Le drapeau [C] ou [chain] indique que la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est chaînée avec la
 129 suivante. Autrement dit, si la règle s'applique, elle est traitée
 130 normalement et passe le contrôle à la règle suivante. Par contre, si
 131 elle ne s'applique pas, la règle suivante, ainsi que toutes les règles
 132 chaînées qui suivent, seront sautées.</p>
 133
 134 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 135 <div class="section">
 136 <h2><a name="flag_co" id="flag_co">CO|cookie</a></h2>
 137 <p>Le drapeau [CO], ou [cookie], vous permet de définir un cookie
 138 lorsqu'une règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
 139 s'applique. Il possède trois arguments obligatoires et
 140 quatre arguments optionnels.</p>
 141
 142 <p>La syntaxe complète de ce drapeau, avec tous ses attributs, est la
 143 suivante :</p>
 144
 145 <div class="example"><p><code>
 146 [CO=NAME:VALUE:DOMAIN:lifetime:path:secure:httponly]
 147 </code></p></div>
 148
 149 <p>Vous devez déclarer un nom, une valeur et un domaine pour que
 150 le cookie puisse être défini.</p>
 151
 152
 153 <dl>
 154 <dt>Domain</dt>
 155 <dd>Le domaine pour lequel vous souhaitez que le cookie soit valide. Ce
 156 peut être un nom de serveur, comme <code>www.example.com</code>, ou un
 157 domaine, comme <code>.example.com</code>. Il doit comporter au moins
 158 deux parties séparées par un point. C'est à dire que vous ne pouvez pas
 159 utiliser les valeurs <code>.com</code> ou <code>.net</code>. En effet,
 160 ce style de cookie est interdit par le modèle de sécurité des cookies.</dd>
 161 </dl>
 162
 163 <p>Vous pouvez aussi définir les valeurs suivantes :</p>
 164
 165 <dl>
 166 <dt>Lifetime</dt>
 167 <dd>La durée de vie du cookie, en minutes.</dd>
 168 <dd>Une valeur de 0 indique une durée de vie correspondant à la session
 169 courante du navigateur. Il s'agit de la valeur par défaut.</dd>
 170
 171 <dt>Path</dt>
 172 <dd>Le chemin, sur le site web concerné, pour lequel le cookie est
 173 valide, du style <code>/clients/</code> or
 174 <code>/fichiers/telechargement/</code>.</dd>
 175 <dd>La valeur par défaut est <code>/</code> - c'est à dire l'ensemble du
 176 site web.</dd>
 177
 178 <dt>Secure</dt>
 179 <dd>Si cet argument a pour valeur <code>secure</code>,
 180 <code>true</code>, ou <code>1</code>, le cookie ne pourra être transmis
 181 que dans le cadre d'une connexion sécurisée (https).</dd>
 182
 183 <dt>httponly</dt>
 184 <dd>Si cet argument a pour valeur <code>HttpOnly</code>,
 185 <code>true</code>, ou <code>1</code>, le cookie aura son drapeau
 186 <code>HttpOnly</code> activé, ce qui signifie qu'il sera inaccessible au
 187 code JavaScript pour les navigateurs qui supportent cette
 188 fonctionnalité.</dd>
 189 </dl>
 190
 191 <p>Voici un exemple :</p>
 192
 193 <div class="example"><p><code>
 194 RewriteEngine On<br />
 195 RewriteRule ^/index\.html - [CO=frontdoor:yes:.example.org:1440:/]
 196 </code></p></div>
 197
 198 <p>Dans l'exemple ci-dessus, la règle ne réécrit
 199 pas la requête. La cible de réécriture "-"
 200 indique à mod_rewrite de transmettre la requête sans
 201 modification. Par contre, il
 202 définit un cookie nommé 'frontdoor' avec une valeur 'yes'. Le cookie est
 203 valide pour tout hôte situé dans le domaine <code>.example.org</code>. Sa
 204 durée de vie est limitée à 1440 minutes (24 heures), et il sera renvoyé
 205 pour tous les URIs.</p>
 206
 207 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 208 <div class="section">
 209 <h2><a name="flag_dpi" id="flag_dpi">DPI|discardpath</a></h2>
 210 <p>Avec le drapeau DPI, la partie PATH_INFO de l'URI
 211 réécrit est supprimée.</p>
 212 <p>Ce drapeau est disponible dans les versions 2.2.12 et supérieures.</p>
 213 <p>Dans un contexte de répertoire, l'URI mis en comparaison par chaque
 214 règle <code class="directive">RewriteRule</code> est la concaténation des
 215 valeurs courantes de l'URI et de PATH_INFO.</p>
 216
 217 <p>L'URI courant peut être l'URI initial tel qu'il a été fourni par le
 218 client, le résultat d'une passe précédente du processus de réécriture,
 219 ou le résultat de la règle précédente dans le processus courant de
 220 réécriture.</p>
 221
 222 <p>Par contre, la partie PATH_INFO ajoutée à l'URI avant chaque règle ne
 223 reflète que la valeur de PATH_INFO avant la passe courante du processus
 224 de réécriture. En conséquence, si de larges portions de l'URI
 225 correspondent et sont traduites via plusieurs directives
 226 <code class="directive">RewriteRule</code>, sans prendre en compte
 227 quelles parties de l'URI provenaient du PATH_INFO courant, l'URI final
 228 pourra se voir ajouter plusieurs copies de PATH_INFO.</p>
 229
 230 <p>Utilisez ce drapeau pour toute substitution où la présence du PATH_INFO qui
 231 résultait de la mise en correspondance précédente de cette requête avec
 232 le système de fichier n'est pas nécessaire. Avec ce drapeau, le
 233 PATH_INFO établi avant que cette passe du processus de réécriture ne
 234 débute est oublié. PATH_INFO ne sera pas recalculé tant que la passe
 235 courante du processus de réécriture ne sera pas achevée. Les règles
 236 suivantes de cette passe ne verront que le résultat direct des
 237 substitutions, sans aucun PATH_INFO ajouté.</p>
 238 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 239 <div class="section">
 240 <h2><a name="flag_e" id="flag_e">E|env</a></h2>
 241 <p>Avec le drapeau [E], ou [env], vous pouvez définir la valeur d'une
 242 variable d'environnement. Notez que certaines variables d'environnement
 243 peuvent être définies après le traitement de la règle, annulant par
 244 la-même ce que vous avez défini. Voir le <a href="../env.html">document
 245 sur les variables d'environnement</a> pour plus de détails sur le
 246 fonctionnement des variables d'environnement.</p>
 247
 248 <p>La syntaxe complète pour ce drapeau est :</p>
 249
 250 <div class="example"><p><code>
 251 [E=!VAR]
 252 </code></p></div>
 253
 254 <p><code>VAL</code> peut comporter des références arrières
 255 (<code>$N</code> ou <code>%N</code>) qui seront développées.</p>
 256
 257 <p>En utilisant la version courte</p>
 258
 259 <div class="example"><p><code>
 260 [E=VAR]
 261 </code></p></div>
 262
 263 <p>vous pouvez définir la variable d'environnement nommée
 264 <code>VAR</code> avec une valeur vide.</p>
 265
 266 <p>La forme</p>
 267
 268 <div class="example"><p><code>
 269 [E=!VAR]
 270 </code></p></div>
 271
 272 <p>permet d'annuler la définition de la variable <code>VAR</code>.</p>
 273
 274 <p>Les variables d'environnement s'emploient dans différents contextes,
 275 comme les programmes CGI, d'autres directives RewriteRule, ou des
 276 directives CustomLog.</p>
 277
 278 <p>L'exemple suivant définit une variable d'environnement nommée 'image'
 279 avec une valeur de '1' si l'URI de la requête correspond à un fichier
 280 image. Cette variable d'environnement est ensuite utilisée pour exclure
 281 une telle requête du journal des accès.</p>
 282
 283 <div class="example"><p><code>
 284 RewriteRule \.(png|gif|jpg) - [E=image:1]<br />
 285 CustomLog logs/access_log combined env=!image
 286 </code></p></div>
 287
 288 <p>Notez que le même effet peut être obtenu à l'aide de la directive
 289 <code class="directive"><a href="../mod/mod_setenvif.html#setenvif">SetEnvIf</a></code>. Cette technique
 290 est présentée à titre d'exemple et non de recommandation.</p>
 291 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 292 <div class="section">
 293 <h2><a name="flag_end" id="flag_end">END</a></h2>
 294 <p>L'utilisation du drapeau [END] permet non seulement de terminer le
 295 processus de réécriture en cours (comme [L]), mais aussi d'empêcher tout
 296 processus de réécriture ultérieur dans un contexte de répertoire
 297 (htaccess).</p>
 298
 299 <p>Ceci ne s'applique pas aux nouvelles requêtes résultant d'une
 300 redirection externe.</p>
 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="flag_f" id="flag_f">F|forbidden</a></h2>
 304 <p>L'utilisation du drapeau [F] permet de faire envoyer par le serveur au
 305 client un code de statut "403 Forbidden". Le même effet peut être obtenu à
 306 l'aide de la directive <code class="directive"><a href="../mod/mod_access_compat.html#deny">Deny</a></code>,
 307 mais ce drapeau offre plus de souplesse dans l'attribution d'un statut
 308 Forbidden.</p>
 309
 310 <p>La règle suivante va interdire la téléchargement de fichiers
 311 <code>.exe</code> depuis votre serveur.</p>
 312
 313 <div class="example"><p><code>
 314 RewriteRule \.exe - [F]
 315 </code></p></div>
 316
 317 <p>Cet exemple utilise la syntaxe "-" pour la cible de réécriture, ce
 318 qui signifie que l'URI de la requête n'est pas modifié. Il n'y a aucune
 319 raison de réécrire un URI, si vous avez l'intention d'interdire la
 320 requête.</p>
 321
 322 <p>Lorsqu'on utilise [F], [L] est implicite - c'est à dire que la
 323 réponse est renvoyée immédiatement, et aucune autre règle n'est évaluée.</p>
 324
 325 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 326 <div class="section">
 327 <h2><a name="flag_g" id="flag_g">G|gone</a></h2>
 328 <p>Le drapeau [G] permet de faire envoyer par le serveur un code de statut
 329 "410 Gone" avec la réponse. Ce code indique qu'une ressource qui était
 330 disponible auparavant ne l'est plus actuellement.</p>
 331
 332 <p>Comme dans le cas du drapeau [F], on utilise en général la syntaxe
 333 "-" pour la cible de réécriture lorsqu'on utilise le drapeau [G] :</p>
 334
 335 <div class="example"><p><code>
 336 RewriteRule ancienne-ressource - [G,NC]
 337 </code></p></div>
 338
 339 <p>Lorsqu'on utilise [G], [L] est implicite - c'est à dire que la
 340 réponse est renvoyée immédiatement, et aucune autre règle n'est évaluée.</p>
 341
 342 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 343 <div class="section">
 344 <h2><a name="flag_h" id="flag_h">H|handler</a></h2>
 345 <p>Force le traitement de la requête résultante par le gestionnaire
 346 spécifié. Par exemple, on peut utiliser ce drapeau pour forcer
 347 l'interprétation de tous les fichiers sans extension par le gestionnaire
 348 php :</p>
 349
 350 <div class="example"><p><code>
 351 RewriteRule !\. - [H=application/x-httpd-php]
 352 </code></p></div>
 353
 354 <p>
 355 L'expression rationnelle ci-dessus - <code>!\.</code> - correspond à
 356 toute requête qui ne contient pas le caractère <code>.</code>.
 357 </p>
 358 <p>On peut aussi utiliser ce drapeau pour forcer l'utilisation d'un
 359 certain gestionnaire en fonction de certaines conditions. Par exemple,
 360 l'extrait suivant utilisé dans un contexte de niveau serveur permet de
 361 faire en sorte que les fichiers <code>.php</code> soient
 362 <em>affichés</em> par <code>mod_php</code> dans le cas où ils font
 363 l'objet d'une requête avec l'extension <code>.phps</code> :</p>
 364
 365 <div class="example"><p><code>
 366 RewriteRule ^(/source/.+\.php)s$ $1 [H=application/x-httpd-php-source]
 367 </code></p></div>
 368
 369
 370 <p>L'expression rationnelle ci-dessus -
 371 <code>^(/source/.+\.php)s$</code> - va correspondre à toute requête qui
 372 débutera par <code>/source/</code>, continuera par 1 ou n caractères
 373 puis par <code>.phps</code>. La référence arrière $1 fait référence à la
 374 correspondance capturée entre parenthèses de l'expression
 375 rationnelle.</p>
 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="flag_l" id="flag_l">L|last</a></h2>
 381 <p>Lorsque le drapeau [L] est présent, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
 382 arrête le traitement du jeu de règles. Cela signifie dans la plupart des
 383 situations que si la règle s'applique, aucune autre règle ne sera
 384 traitée. Ce drapeau correspond à la commande Perl <code>last</code>, ou
 385 à la commande <code>break</code> en C. Utilisez ce drapeau pour indiquer
 386 que la règle courante doit être appliquée immédiatement, sans tenir
 387 compte des règles ultérieures.</p>
 388
 389 <p>Si vous utilisez des règles <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dans des fichiers
 390 <code>.htaccess</code> ou des sections <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>, il est important d'avoir quelques
 391 notions sur la manière dont les règles sont traitées. Pour simplifier,
 392 une fois les règles traitées, la requête réécrite est passée à nouveau
 393 au moteur d'interprétation des URLs afin que ce dernier puisse la
 394 traiter. Il est possible qu'au cours du traitement de la requête
 395 réécrite, le fichier <code>.htaccess</code> ou la section <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> soient à nouveau
 396 rencontrés, entraînant un nouveau traitement du jeu de règles depuis le
 397 début. Cette situation se présente le plus souvent lorsqu'une des règles
 398 provoque une redirection - interne ou externe - ce qui réinitialise le
 399 traitement de la requête.</p>
 400
 401 <p>Si vous utilisez des directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> dans un de ces contextes,
 402 il importe par conséquent de prévoir explicitement des étapes permettant
 403 d'éviter un bouclage infini sur les règles,
 404 et de ne pas compter seulement sur
 405 le drapeau [L] pour terminer l'exécution d'une série de règles, comme
 406 décrit ci-dessous.</p>
 407
 408 <p>Un autre drapeau, [END], permet non seulement d'interrompre le cycle
 409 courant du processus de réécriture, mais aussi d'empêcher toute
 410 réécriture ultérieure dans le contexte de répertoire (htaccess). Ceci ne
 411 s'applique pas aux nouvelles requêtes résultant de redirections
 412 externes.</p>
 413
 414 <p>Dans l'exemple donné ici, toute requête est réécrite en
 415 <code>index.php</code>, la requête originale étant ajoutée comme chaîne
 416 de requête en argument à <code>index.php</code> ; cependant, la
 417 directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> permet de s'assurer que si
 418 la requête concerne déjà <code>index.php</code>, la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sera sautée.</p>
 419
 420 <div class="example"><p><code>
 421 RewriteBase /<br />
 422 RewriteCond %{REQUEST_URI} !=/index.php<br />
 423 RewriteRule ^(.*) /index.php?req=$1 [L,PT]
 424 </code></p></div>
 425 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 426 <div class="section">
 427 <h2><a name="flag_n" id="flag_n">N|next</a></h2>
 428 <p>Le drapeau [N] provoque un redémarrage du traitement des règles
 429 depuis le début, en utilisant le résultat du jeu de règles, sous
 430 réserve qu'il existe un point de démarrage ; à utiliser avec précautions
 431 car il peut provoquer un bouclage infini.
 432 </p>
 433 <p>
 434 Le drapeau [Next] peut servir, par exemple,
 435 à remplacer de manière répétitive
 436 une chaîne de caractère ou une lettre dans une requête. Dans l'exemple
 437 suivant, chaque occurence de A sera remplacée par B dans la requête, et
 438 ceci jusqu'il n'y ait plus de A à remplacer.
 439 </p>
 440
 441 <div class="example"><p><code>
 442 RewriteRule (.*)A(.*) $1B$2 [N]
 443 </code></p></div>
 444
 445 <p>Vous pouvez vous représenter ce traitement comme une boucle
 446 <code>while</code> : tant que le modèle de la règle correspond (c'est à
 447 dire, tant que l'URI contient un <code>A</code>),
 448 effectuer la substitution (c'est à dire, remplacer le <code>A</code> par
 449 un <code>B</code>).</p>
 450
 451 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 452 <div class="section">
 453 <h2><a name="flag_nc" id="flag_nc">NC|nocase</a></h2>
 454 <p>Avec le drapeau [NC], le modèle de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est comparé à la requête de
 455 manière insensible à la casse. C'est à dire que cette comparaison
 456 s'effectue sans tenir compte des majuscules/minuscules dans l'URI
 457 comparé.</p>
 458
 459 <p>Dans l'exemple suivant, toute requête pour un fichier image sera
 460 transmise par Apache à votre serveur d'images dédié. La correspondance est
 461 insensible à la casse, si bien que par exemple, <code>.jpg</code> aussi
 462 bien que <code>.JPG</code> seront acceptés.</p>
 463
 464 <div class="example"><p><code>
 465 RewriteRule (.*\.(jpg|gif|png))$ http://images.example.com$1 [P,NC]
 466 </code></p></div>
 467 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 468 <div class="section">
 469 <h2><a name="flag_ne" id="flag_ne">NE|noescape</a></h2>
 470 <p>Par défaut, les caractères spéciaux, comme <code>&amp;</code> et
 471 <code>?</code>, sont convertis en leur équivalent
 472 hexadécimal. Le drapeau [NE] permet d'éviter cette conversion.
 473 </p>
 474
 475 <div class="example"><p><code>
 476 RewriteRule ^/ancre/(.+) /grosse-page.html#$1 [NE,R]
 477 </code></p></div>
 478
 479 <p>
 480 Dans l'exemple ci-dessus, <code>/anchor/xyz</code> est réécrit en
 481 <code>/bigpage.html#xyz</code>. En l'absence du drapeau [NE], le #
 482 aurait été converti en son équivalent hexadécimal, <code>%23</code>, ce
 483 qui aurait provoqué un code d'erreur "404 Not Found".
 484 </p>
 485
 486 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 487 <div class="section">
 488 <h2><a name="flag_ns" id="flag_ns">NS|nosubreq</a></h2>
 489 <p>Le drapeau [NS] empêche la règle de s'appliquer aux sous-requêtes.
 490 Par exemple, une page incluse au moyen d'une SSI (Server
 491 Side Include) est une sous-requête, et vous ne voudrez probablement pas que
 492 la réécriture s'applique à ces sous-requêtes. Ainsi, lorsque
 493 <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> recherche des informations à propos des
 494 fichiers par défaut du répertoire (comme les fichiers
 495 <code>index.html</code>), il s'agit d'une sous-requête interne, et vous
 496 ne désirez en général pas que ces sous-requêtes soient réécrites. Cette
 497 réécriture
 498 n'est pas toujours utile pour les sous-requêtes, et peut même causer des
 499 erreurs si l'ensemble du jeu de règles est appliqué. L'utilisation de
 500 ce drapeau permet d'exclure les règles qui peuvent poser problème.</p>
 501
 502 <p>Comment déterminer si vous devez utiliser cette règle ou non : si
 503 vous préfixez les URLs avec des scripts CGI, afin de forcer leur
 504 traitement par le script CGI, vous vous exposez à des problèmes (ou du
 505 moins à une surcharge significative) avec les sous-requêtes. Dans ces
 506 cas, vous devez utiliser ce drapeau.</p>
 507
 508 <p>
 509 Les images, scripts java, ou fichiers css, chargés en tant que partie
 510 d'une page html, ne sont pas des sous-requêtes - le navigateur les
 511 appelle sous forme de requêtes HTTP à part entière.
 512 </p>
 513 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 514 <div class="section">
 515 <h2><a name="flag_p" id="flag_p">P|proxy</a></h2>
 516 <p>L'utilisation du drapeau [P] entraîne le traitement de la requête par
 517 le module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>, et ceci via une requête de
 518 mandataire. Par exemple, si vous voulez que toutes les requêtes d'images
 519 soient traitées par un serveur d'images annexe, vous pouvez utiliser
 520 une règle de ce style :</p>
 521
 522 <div class="example"><p><code>
 523 RewriteRule /(.*)\.(jpg|gif|png) http://images.example.com/$1.$2 [P]
 524 </code></p></div>
 525
 526 <p>L'utilisation du drapeau [P] provoque aussi l'effet du drapeau [L] -
 527 autrement dit, la requête est immédiatement envoyée au mandataire, et
 528 toute règle ultérieure sera ignorée.</p>
 529
 530 <p>
 531 Vous devez vous assurer que la chaîne de substitution soit un URI valide
 532 (commençant typiquement par <code>http://</code><em>nom-serveur</em>)
 533 qui puisse être traitée par le module <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Dans
 534 le cas contraire, le module mandataire vous renverra une erreur.
 535 L'utilisation de ce drapeau implémente de manière plus puissante la
 536 directive <code class="directive"><a href="../mod/mod_proxy.html#proxypass">ProxyPass</a></code>, pour
 537 faire correspondre le contenu distant à l'espace de nommage du serveur
 538 local.</p>
 539
 540 <div class="warning">
 541       <h3>Avertissement à propos de la sécurité</h3>
 542       <p>Lors de la construction de l'URL cible de la règle, il convient
 543       de prendre en compte l'impact en matière de sécurité qu'aura le
 544       fait de permettre au client d'influencer le jeu d'URLs pour
 545       lesquelles votre serveur agira en tant que mandataire.
 546       Assurez-vous que la partie protocole://nom-serveur de l'URL soit
 547       fixe, ou ne permette pas au client de l'influencer induement.</p>
 548 </div>
 549
 550 <p>Note: <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> doit être activé pour pouvoir
 551 utiliser ce drapeau.</p>
 552
 553 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 554 <div class="section">
 555 <h2><a name="flag_pt" id="flag_pt">PT|passthrough</a></h2>
 556
 557 <p>
 558 Par défaut, la cible (ou chaîne de substitution) d'une règle
 559 RewriteRule est sensée être un chemin de fichier. Avec le drapeau [PT],
 560 par contre, elle est traitée comme un URI. Autrement dit, avec le
 561 drapeau [PT], le résultat de la règle  <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est passé à nouveau au
 562 système de mise en correspondance des URLs avec le système de fichiers,
 563 de façon à ce que les systèmes de mise en correspondance basés sur les
 564 chemins de fichiers, comme la directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code>, ou <code class="directive"><a href="../mod/mod_alias.html#scriptalias">ScriptAlias</a></code>, par exemple, puissent avoir une
 565 chance d'accomplir leur tâche.
 566 </p>
 567
 568 <p>
 569 Si par exemple, vous avez un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> pour /icons, et une règle  <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> qui renvoie vers /icons,
 570 vous devez utiliser le drapeau [PT] pour être sûr que l'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> sera bien évalué.
 571 </p>
 572
 573 <div class="example"><p><code>
 574 Alias /icons /usr/local/apache/icons<br />
 575 RewriteRule /pics/(.+)\.jpg /icons/$1.gif [PT]
 576 </code></p></div>
 577
 578 <p>
 579 Dans l'exemple précédent, en l'absence du drapeau [PT], l'Alias aurait
 580 été ignoré, ce qui aurait provoqué une erreur 'File not found'.
 581 </p>
 582
 583 <p>Avec le drapeau <code>PT</code>, le drapeau <code>L</code> est
 584 implicite : la réécriture s'arrêtera afin de transmettre la requête à la
 585 phase suivante du traitement.</p>
 586
 587 <p>Notez que le drapeau <code>PT</code> est implicite dans des contextes
 588 de répertoire comme les sections <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> ou les fichiers
 589 <code>.htaccess</code>. Le seul moyen de contourner ceci consiste à
 590 réécrire vers <code>-</code>.</p>
 591
 592 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 593 <div class="section">
 594 <h2><a name="flag_qsa" id="flag_qsa">QSA|qsappend</a></h2>
 595 <p>
 596 Quand l'URI de remplacement contient une chaîne de requête, le
 597 comportement par défaut de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est de supprimer la <code>
 598 query string</code> (il s'agit des paramètres éventuellement passés dans l'URL après le
 599 caractère <code>?</code>, usuellement pour les formulaires traités par la
 600 méthode HTTP <code>GET</code>) existante, et de la remplacer par celle nouvellement créée.
 601 Avec le drapeau [QSA], les chaînes de requête peuvent être combinées.
 602 </p>
 603
 604 <p>Considérons la règle suivante :</p>
 605
 606 <div class="example"><p><code>
 607 RewriteRule /pages/(.+) /page.php?page=$1 [QSA]
 608 </code></p></div>
 609
 610 <p>Avec le drapeau [QSA], une requête pour
 611 <code>/pages/123?one=two</code> sera réécrite en
 612 <code>/page.php?page=123&amp;one=two</code>. Sans le drapeau [QSA], la
 613 même requête sera réécrite en <code>/page.php?page=123</code> -
 614 autrement dit, la chaîne de requête (<code>query string</code>) existante sera supprimée.
 615 </p>
 616 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 617 <div class="section">
 618 <h2><a name="flag_qsd" id="flag_qsd">QSD|qsdiscard</a></h2>
 619 <p>
 620 Lorsque l'URI de la requête contient une chaîne de paramètres, et si
 621 l'URI cible n'en contient pas, le comportement par défaut de la
 622 directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> consiste à copier cette
 623 chaîne de paramètres dans l'URI cible. Avec le drapeau [QSD], la chaîne
 624 de paramètres est supprimée.
 625 </p>
 626
 627 <p>Ce drapeau est disponible dans les versions 2.4.0 et supérieures.</p>
 628
 629 <p>
 630 Lorsque les drapeaux [QSD] et [QSA] sont utilisés ensemble, c'est le
 631 drapeau [QSD] qui l'emporte.
 632 </p>
 633
 634 <p>
 635 Si l'URI cible possède une chaîne de paramètres, le comportement par
 636 défaut sera respecté - c'est à dire que la chaîne de paramètres
 637 originale sera supprimée et remplacée par la chaîne de paramètres de
 638 l'URI cible.
 639 </p>
 640
 641 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 642 <div class="section">
 643 <h2><a name="flag_r" id="flag_r">R|redirect</a></h2>
 644 <p>
 645 L'utilisation du drapeau [R] provoque l'envoi d'une redirection au
 646 navigateur. Si une URL pleinement qualifiée (FQDN - fully qualified domain name)
 647  est spécifiée (c'est à dire incluant <code>http://nom-du-serveur/</code>),
 648  une redirection sera effectuée vers cette adresse. Dans le cas contraire,
 649  le protocole courant, le nom du serveur et le numéro de port seront
 650  utilisés pour générer l'URL envoyée avec la redirection.
 651 </p>
 652
 653 <p><em>Tout</em> code de statut de réponse HTTP valide peut être
 654 spécifié, en utilisant la syntaxe [R=305], le code de statut 302 étant
 655 utilisé par défaut si aucun code n'est spécifié. Le code de statut
 656 spécifié n'est pas nécessairement un code de statut de redirection (3xx).
 657 </p>
 658
 659 <p>Si le code de statut est en dehors de la plage des codes de
 660 redirection (300-399), la chaîne de substitution est entièrement
 661 supprimée, et la réécriture s'arrête comme si le drapeau <code>L</code>
 662 était utilisé.</p>
 663
 664 <p>En plus des codes de statut de réponse, vous pouvez spécifier les
 665 codes de redirection en utilisant leurs noms symboliques :
 666 <code>temp</code> (défaut), <code>permanent</code>, ou
 667 <code>seeother</code>.</p>
 668
 669 <p>
 670 Vous utiliserez presque toujours [R] en conjonction avec [L] (c'est à
 671 dire [R,L]), car employé seul, le drapeau [R] préfixe l'URI avec
 672 <code>http://cet-hôte[:ce-port]</code>, mais passe ensuite cette adresse
 673 à la règle suivante, ce qui provoquera le plus souvent des
 674 avertissements 'Invalid URI in request'.
 675 </p>
 676
 677 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 678 <div class="section">
 679 <h2><a name="flag_s" id="flag_s">S|skip</a></h2>
 680 <p>Le drapeau [S] sert à sauter des règles que vous ne voulez pas voir
 681 exécuter. La syntaxe du drapeau [S] est [S=<em>N</em>], où
 682 <em>N</em> correspond au nombre de règles à sauter.
 683 Ceci peut s'interpréter comme une instruction
 684 <code>goto</code>  dans votre jeu de règles de réécriture. Dans
 685 l'exemple suivant, nous ne voulons exécuter la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> que si l'URI demandé ne
 686 correspond pas à un fichier existant.</p>
 687
 688 <div class="example"><p><code>
 689 # La requête concerne-t-elle un fichier qui n'existe pas ?<br />
 690 RewriteCond %{REQUEST_FILENAME} !-f<br />
 691 RewriteCond %{REQUEST_FILENAME} !-d<br />
 692 # Si c'est la cas, on saute les deux règles de réécriture suivantes<br />
 693 RewriteRule .? - [S=2]<br />
 694 <br />
 695 RewriteRule (.*\.gif) images.php?$1<br />
 696 RewriteRule (.*\.html) docs.php?$1
 697 </code></p></div>
 698
 699 <p>Cette technique trouve son utilité dans le fait qu'une directive
 700 <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> ne s'applique
 701 qu'à la règle qui la suit immédiatement. Ainsi, si vous voulez
 702 qu'une directive <code>RewriteCond</code> s'applique à plusieurs règles
 703 <code>RewriteRule</code>, une technique possible consiste à inverser ces
 704 conditions et à ajouter une <code>RewriteRule</code> avec le drapeau [Skip]. Cette technique permet
 705 d'élaborer des pseudo-constructions if-then-else : la dernière règle du
 706 bloc then contiendra <code>skip=N</code>, où N est le nombre de règles
 707 contenues dans le bloc else :</p>
 708 <div class="example"><p><code>
 709 # Est-ce que le fichier existe ?<br />
 710 RewriteCond %{REQUEST_FILENAME} !-f<br />
 711 RewriteCond %{REQUEST_FILENAME} !-d<br />
 712
 713 # Create an if-then-else construct by skipping 3 lines if we meant to go to the "else" stanza.<br />
 714 RewriteRule .? - [S=3]<br />
 715 <br />
 716 # Si le fichier existe, alors :
 717 <span class="indent">
 718         RewriteRule (.*\.gif) images.php?$1<br />
 719         RewriteRule (.*\.html) docs.php?$1<br />
 720         # Skip past the "else" stanza.<br />
 721         RewriteRule .? - [S=1]<br />
 722 </span>
 723 # ELSE...
 724 <span class="indent">
 725         RewriteRule (.*) 404.php?file=$1<br />
 726 </span>
 727 # END
 728 </code></p></div>
 729
 730 <p>Il est probablement plus aisé de définir ce genre de configuration
 731 via les directives <code class="directive">&lt;If&gt;</code>, <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code>.</p>
 732
 733 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 734 <div class="section">
 735 <h2><a name="flag_t" id="flag_t">T|type</a></h2>
 736 <p>Définit le type MIME de la réponse résultante renvoyée. L'effet est
 737 identique à celui de la directive <code class="directive"><a href="../mod/mod_mime.html#addtype">AddType</a></code>.</p>
 738
 739 <p>Par exemple, vous pouvez utiliser la technique suivante pour servir
 740 du code source Perl en tant que plein texte, s'il est requis d'une
 741 certaine manière :</p>
 742
 743 <div class="example"><p><code>
 744 # Sert les fichier .pl en tant que plein texte<br />
 745 RewriteRule \.pl$ - [T=text/plain]
 746 </code></p></div>
 747
 748 <p>Ou encore, si vous possédez une caméra qui produit des fichiers
 749 images jpeg sans extension, vous pouvez forcer le renvoi de ces images
 750 avec le type MIME correct en se basant sur le nom du fichier :</p>
 751
 752 <div class="example"><p><code>
 753 # Les fichiers dont le nom contient 'IMG' sont des images jpg.<br />
 754 RewriteRule IMG - [T=image/jpg]
 755 </code></p></div>
 756
 757 <p>Notez cependant qu'il s'agit d'un exemple trivial, et que le problème
 758 aurait pu être résolu en utilisant à la place la directive <code class="directive"><a href="../mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>. Il faut toujours
 759 envisager la possibilité d'une solution alternative à un problème avant
 760 d'avoir recours à la réécriture, qui sera toujours moins efficace qu'une
 761 solution alternative.</p>
 762
 763 <p>
 764 Dans un contexte de niveau répertoire, n'utilisez que <code>-</code>
 765 (tiret) comme substitution, <em>dans toute la séquence de réécriture de
 766 mod_rewrite</em>, sinon le type MIME défini avec ce drapeau
 767 sera perdu suite à un retraitement interne (y compris les séquences de
 768 réécriture suivantes de mod_rewrite). Dans ce contexte, vous pouvez
 769 utiliser le drapeau <code>L</code> pour terminer la séquence
 770 <em>courante</em> de réécriture de mod_rewrite.</p>
 771
 772 </div></div>
 773 <div class="bottomlang">
 774 <p><span>Langues Disponibles: </span><a href="../en/rewrite/flags.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 775 <a href="../fr/rewrite/flags.html" title="Français">&nbsp;fr&nbsp;</a></p>
 776 </div><div id="footer">
 777 <p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 778 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 779 if (typeof(prettyPrint) !== undefined) {
 780     prettyPrint();
 781 }
 782 //--><!]]></script>
 783 </body></html>