granicus.if.org Git - apache/blob - docs/manual/mod/mod_rewrite.xml.fr

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1760590:1776708 (outdated) -->
   5 <!-- French translation : Lucien GENTIS -->
   6 <!-- Reviewed by : Vincent Deffontaines -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <modulesynopsis metafile="mod_rewrite.xml.meta">
  26
  27 <name>mod_rewrite</name>
  28
  29 <description>Ce module fournit un moteur de réécriture à base de
  30 règles permettant de réécrire les URLs des requêtes
  31 à la volée</description>
  32
  33 <status>Extension</status>
  34 <sourcefile>mod_rewrite.c</sourcefile>
  35 <identifier>rewrite_module</identifier>
  36
  37 <summary>
  38       <p>Le module <module>mod_rewrite</module> utilise un moteur de
  39       réécriture à base de règles, basé sur un interpréteur
  40       d'expressions rationnelles PCRE, pour réécrire les URLs à la volée. Par
  41       défaut, <module>mod_rewrite</module> met en correspondance une URL
  42       avec le système de fichiers. Cependant, on peut aussi l'utiliser
  43       pour rediriger une URL vers une autre URL, ou pour invoquer une
  44       requête interne à destination du mandataire.</p>
  45       <p><module>mod_rewrite</module> fournit une méthode souple et
  46       puissante pour manipuler les URLs en utilisant un nombre illimité
  47       de règles. Chaque règle peut être associée à un nombre illimité de
  48       conditions, afin de vous permettre de réécrire les URLs en
  49       fonction de variables du serveur, de variables d'environnement,
  50       d'en-têtes HTTP, ou de repères temporels.</p>
  51       <p><module>mod_rewrite</module> agit sur la totalité de l'URL, y
  52       compris la partie chemin. Une règle de réécriture peut être
  53       invoquée dans <code>httpd.conf</code> ou dans un fichier
  54       <code>.htaccess</code>. Le chemin généré par une règle de
  55       réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
  56       vers un traitement secondaire interne, une redirection vers une
  57       requête externe ou vers le mandataire interne.</p>
  58
  59       <p>Vous trouverez d'avantage de détails, discussions et exemples
  60       dans la
  61       <a href="../rewrite/">documentation détaillée
  62       sur mod_rewrite</a>.</p>
  63 </summary>
  64
  65 <section id="logging"><title>Journalisation</title>
  66
  67     <p><module>mod_rewrite</module> offre une journalisation détaillée
  68     de ses actions aux niveaux de journalisation <code>trace1</code> à
  69     <code>trace8</code>. Le niveau de journalisation peut être défini de
  70     manière spécifique à <module>mod_rewrite</module> via la directive
  71     <directive module="core">LogLevel</directive> : jusqu'au niveau
  72     <code>debug</code> aucune action n'est journalisée, alors qu'elles
  73     le sont pratiquement toutes au niveau <code>trace8</code>.</p>
  74
  75     <note>
  76       L'utilisation d'un niveau de journalisation élevé pour
  77       <module>mod_rewrite</module> va ralentir votre serveur HTTP Apache
  78       de manière dramatique ! N'utilisez un niveau de journalisation
  79       supérieur à <code>trace2</code> qu'à des fins de débogage !
  80     </note>
  81
  82     <example><title>Exemple</title>
  83     <highlight language="config">
  84 LogLevel alert rewrite:trace3
  85     </highlight>
  86     </example>
  87
  88     <note><title>RewriteLog</title>
  89       <p>Ceux qui sont familiers avec les versions précédentes de
  90       <module>mod_rewrite</module> vont probablement rechercher en vain les
  91       directives <code>RewriteLog</code> et
  92       <code>RewriteLogLevel</code>. Elles ont été en effet remplacées
  93       par une configuration de la journalisation par module, comme
  94       mentionné plus haut.
  95       </p>
  96
  97       <p>Pour extraire les traces spécifiques à
  98       <module>mod_rewrite</module>, affichez le fichier journal en
  99       redirigeant la sortie vers grep :</p>
 100     <example>
 101     tail -f error_log|fgrep '[rewrite:'
 102     </example>
 103     </note>
 104
 105 </section>
 106
 107 <directivesynopsis>
 108 <name>RewriteEngine</name>
 109 <description>Active ou désactive l'exécution du
 110 moteur de réécriture</description>
 111 <syntax>RewriteEngine on|off</syntax>
 112 <default>RewriteEngine off</default>
 113 <contextlist><context>server config</context><context>virtual host</context>
 114 <context>directory</context><context>.htaccess</context></contextlist>
 115 <override>FileInfo</override>
 116
 117 <usage>
 118
 119       <p>La directive <directive>RewriteEngine</directive> active ou
 120       désactive l'exécution du moteur de réécriture. Si sa valeur est
 121       <code>off</code>, ce module n'exécutera aucun traitement et ne
 122       mettra pas à jour les variables d'environnement
 123       <code>SCRIPT_URx</code>.</p>
 124
 125       <p>Plutôt que de commenter toutes les directives <directive
 126       module="mod_rewrite">RewriteRule</directive>, il est préférable
 127       d'utiliser cette directive si l'on souhaite désactiver les
 128       règles de réécriture dans un contexte particulier.</p>
 129
 130       <p>Notez que les  hôtes virtuels n'héritent pas des
 131       configurations de réécriture. Ceci implique que vous devez
 132       insérer une directive <code>RewriteEngine on</code> dans chaque
 133       hôte virtuel pour lequel vous souhaitez utiliser des règles
 134       de réécriture.</p>
 135
 136       <p>Les directives <directive module="mod_rewrite">RewriteMap</directive> du type
 137       <code>prg</code> ne sont pas prises en compte au cours de
 138       l'initialisation du serveur si elle ont été définies dans un
 139       contexte où la directive <directive>RewriteEngine</directive> n'a
 140       pas été définie à <code>on</code>.</p>
 141
 142 </usage>
 143
 144 </directivesynopsis>
 145
 146 <directivesynopsis>
 147 <name>RewriteOptions</name>
 148 <description>Configure certaines options spéciales
 149 pour le moteur de réécriture</description>
 150 <syntax>RewriteOptions <var>Options</var></syntax>
 151 <contextlist><context>server config</context><context>virtual host</context>
 152 <context>directory</context><context>.htaccess</context></contextlist>
 153 <override>FileInfo</override>
 154 <usage>
 155
 156       <p>La directive <directive>RewriteOptions</directive> définit
 157       certaines options spéciales pour la configuration au niveau du
 158       serveur ou du répertoire. La chaîne de caractères <em>Option</em>
 159       ne peut actuellement prendre qu'une des valeurs suivantes :</p>
 160
 161       <dl>
 162       <dt><code>Inherit</code></dt>
 163       <dd>
 164
 165       <p>Ceci force la configuration locale à hériter de la
 166       configuration du niveau supérieur. Dans le contexte des hôtes
 167       virtuels, cela signifie que les correspondances, conditions et
 168       règles du serveur principal sont héritées. Dans le contexte des
 169       répertoires, cela signifie que les conditions et règles de la
 170       configuration <code>.htaccess</code> ou les sections <directive
 171       type="section" module="core">Directory</directive> du répertoire
 172       parent sont héritées. Les règles héritées sont virtuellement
 173       copiées dans la section où cette directive est utilisée. Si elles
 174       sont utilisées avec des règles locales, les règles héritées sont
 175       placées après ces dernières. La place de cette directive - avant
 176       ou après les règles locales - n'a aucune influence sur ce
 177       comportement. Si des règles locales ont forcé l'arrêt de la
 178       réécriture, les règles héritées ne seront pas traitées.</p>
 179
 180       <note type="warning">
 181       Les règles héritées du niveau parent sont appliquées
 182       <strong>after</strong> après les règles spécifiées dans le niveau
 183       enfant.
 184       </note>
 185       </dd>
 186
 187       <dt><code>InheritBefore</code></dt>
 188       <dd>
 189       <p>Même effet que l'option <code>Inherit</code> ci-dessus, mais
 190       les règles spécifiées dans le niveau parent s'appliquent
 191       <strong>avant</strong> les règles spécifiées dans le niveau
 192       enfant.<br />
 193       Disponible depuis la version 2.3.10 du serveur HTTP Apache.</p>
 194       </dd>
 195
 196       <dt><code>InheritDown</code></dt>
 197       <dd>
 198
 199       <p>Si cette option est activée, toutes les configurations enfants
 200       hériteront de la configuration courante. Il en est de même si l'on
 201       spécifie <code>RewriteOptions Inherit</code> dans toutes les
 202       configurations enfants. Voir l'option <code>Inherit</code> pour
 203       plus de détails à propos de la manière dont les relations
 204       parent-enfants sont traitées.<br />
 205       Cette option est disponible à partir
 206       de la version 2.4.8 du serveur HTTP Apache.</p>
 207       </dd>
 208
 209       <dt><code>InheritDownBefore</code></dt>
 210       <dd>
 211
 212       <p>L'effet de cette option est équivalent à celui de l'option
 213       <code>InheritDown</code> ci-dessus, mais les règles de la
 214       configuration parente s'appliquent <strong>avant</strong> toute
 215       règle de la configuration enfant.<br />
 216       Cette option est disponible à partir
 217       de la version 2.4.8 du serveur HTTP Apache.</p>
 218       </dd>
 219
 220       <dt><code>IgnoreInherit</code></dt>
 221       <dd>
 222
 223       <p>Si cette option est activée, les configurations courante et
 224       enfants ignoreront toute règle héritée d'une configuration parente
 225       via les options <code>InheritDown</code> ou
 226       <code>InheritDownBefore</code>.<br />
 227       Cette option est disponible à partir
 228       de la version 2.4.8 du serveur HTTP Apache.</p>
 229       </dd>
 230
 231       <dt><code>AllowNoSlash</code></dt>
 232       <dd>
 233       <p>Par défaut, <module>mod_rewrite</module> ignore les URLs qui
 234       correspondent à un répertoire sur disque, mais ne comportent pas
 235       de slash final, afin que le module <module>mod_dir</module>
 236       redirige le client vers l'URL canonique avec un slash final.</p>
 237
 238       <p>Lorsque la directive <directive
 239       module="mod_dir">DirectorySlash</directive> est définie à off, il
 240       est possible de spécifier l'option <code>AllowNoSlash</code> pour
 241       s'assurer que les règles de réécriture ne soient plus ignorées.
 242       Si on le souhaite, cette option permet de faire s'appliquer des
 243       règles de réécriture qui correspondent à un répertoire sans slash
 244       final au sein de fichiers .htaccess.<br />
 245       Elle est disponible à
 246       partir de la version 2.4.0 du serveur HTTP Apache.</p>
 247       </dd>
 248
 249       <dt><code>AllowAnyURI</code></dt>
 250       <dd>
 251
 252       <p>A partir de la version 2.2.22 de httpd, lorsqu'une directive <directive
 253       module="mod_rewrite">RewriteRule</directive> se situe dans un
 254       contexte de <code>serveur virtuel</code> ou de serveur principal,
 255       <module>mod_rewrite</module> ne traitera les règles de réécriture
 256       que si l'URI de la requête respecte la syntaxe d'un <a
 257       href="directive-dict.html#Syntax">chemin URL</a>. Ceci permet
 258       d'éviter certains problèmes de sécurité où des règles
 259       particulières pourraient permettre  des développements de modèles
 260       inattendus (voir <a
 261       href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-3368">CVE-2011-3368</a>
 262       et <a
 263       href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-4317">CVE-2011-4317</a>).
 264       Pour s'affranchir de la restriction relative à la syntaxe des chemins URL, on peut
 265       utiliser l'option <code>AllowAnyURI</code>, afin de permettre à
 266       <module>mod_rewrite</module> d'appliquer le jeu de règles à toute
 267       chaîne de requête URI, sans vérifier si cette dernière respecte la
 268       grammaire des chemins URL définie dans la spécification HTTP.<br />
 269       Disponible depuis la version 2.4.3 du serveur HTTP Apache.</p>
 270
 271       <note type="warning">
 272       <title>Avertissement à propos de la sécurité</title>
 273
 274       <p>L'utilisation de cette option rendra le serveur vulnérable à
 275       certains problèmes de sécurité si les règles de réécritures
 276       concernées n'ont pas été rédigées avec soin. Il est par conséquent
 277       <strong>fortement recommandé</strong> de ne pas utiliser cette
 278       option. En particulier, prêtez attention aux chaînes en entrée contenant le
 279       caractère '<code>@</code>', qui peuvent modifier l'interprétation
 280       de l'URI réécrite, comme indiqué dans les liens ci-dessus.</p>
 281       </note>
 282       </dd>
 283
 284       <dt><code>MergeBase</code></dt>
 285       <dd>
 286
 287       <p>Avec cette option, la valeur de la directive <directive
 288       module="mod_rewrite">RewriteBase</directive> est recopiée depuis
 289       une valeur explicitement définie dans tout sous-répertoire qui ne
 290       définit pas sa propre directive <directive
 291       module="mod_rewrite">RewriteBase</directive>. Il s'agissait du
 292       comportement par défaut avec les versions 2.4.0 à 2.4.3, et ce
 293       drapeau qui permet de retrouver ce comportement est disponible
 294       depuis la version 2.4.4 du serveur HTTP Apache.</p>
 295       </dd>
 296
 297       <dt><code>IgnoreContextInfo</code></dt>
 298       <dd>
 299
 300       <p>Lors d'une
 301       substitution relative dans un contexte de répertoire (htaccess),
 302       et si la directive <directive
 303       module="mod_rewrite">RewriteBase</directive> n'a pas été définie,
 304       ce module utilise des informations en provenance d'une extension
 305       d'URL et du contexte du système de fichiers pour transformer la
 306       sustitution relative en URL. Par exemple, les modules
 307       <module>mod_userdir</module> et <module>mod_alias</module>
 308       utilisent ces informations de contexte étendu. Disponible à partir de la
 309       version 2.4.16 du serveur HTTP Apache.</p>
 310       </dd>
 311
 312       </dl>
 313 </usage>
 314
 315 </directivesynopsis>
 316
 317 <directivesynopsis>
 318 <name>RewriteMap</name>
 319 <description>Définit une fonction de mise en correspondance pour la
 320 recherche de mots-clés</description>
 321 <syntax>RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> <em>MapTypeOptions</em>
 322 </syntax>
 323 <contextlist><context>server config</context><context>virtual host</context>
 324 </contextlist>
 325
 326 <usage>
 327       <p>La directive <directive>RewriteMap</directive> définit une
 328       <em>Table de correspondance pour la réécriture</em> que les
 329       fonctions de mise en correspondance
 330       peuvent utiliser dans les chaînes de substitution des règles
 331       pour insérer/substituer des champs en recherchant des mots-clés.
 332       La source utilisée pour cette recherche peut être de plusieurs
 333       types.</p>
 334
 335       <p><a id="mapfunc" name="mapfunc"><em>MapName</em></a> est le nom de la table de correspondance
 336       et servira à spécifier une fonction de mise en correspondance
 337       pour les chaînes de substitution d'une règle de réécriture selon
 338       une des constructions suivantes :</p>
 339
 340       <p class="indent">
 341         <strong><code>${</code> <em>MapName</em> <code>:</code>
 342         <em>mot-clé</em> <code>}</code><br />
 343          <code>${</code> <em>MapName</em> <code>:</code>
 344         <em>mot-clé</em> <code>|</code> <em>valeur par défaut</em>
 345         <code>}</code></strong>
 346       </p>
 347
 348       <p>Lorsqu'une telle construction est rencontrée, la table de
 349       correspondance <em>MapName</em> est consultée
 350       et la clé <em>mot-clé</em> recherchée. Si la clé est trouvée, la
 351       construction est remplacée par
 352       la <em>valeur de remplacement</em>. Si la clé n'est pas trouvée,
 353       elle est remplacée par la <em>valeur par défaut</em>, ou par une
 354       chaîne vide si aucune <em>valeur par défaut</em> n'est
 355       spécifiée. La valeur vide se comporte comme si la
 356       clé était absente ; il est donc impossible de distinguer une
 357       valeur vide d'une absence de clé.</p>
 358
 359       <p>Par exemple, vous pouvez définir une directive
 360       <directive>RewriteMap</directive> comme suit </p>
 361
 362       <highlight language="config">
 363       RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"
 364       </highlight>
 365
 366       <p>Vous pourrez ensuite utiliser cette table dans une
 367       directive <directive>RewriteRule</directive> comme suit :</p>
 368
 369       <highlight language="config">
 370       RewriteRule "^/ex/(.*)" "${map-exemple:$1}"
 371       </highlight>
 372
 373       <p>La signification de l'argument <em>MapTypeOptions</em> dépend du <em>MapType</em>
 374       spécifié. Veuillez vous référer au document <a
 375       href="../rewrite/rewritemap.html">Utiliser RewriteMap</a> pour
 376       plus de détails.</p>
 377
 378       <p>Les combinaisons suivantes pour <em>type de correspondance</em>
 379       et <em>MapSource</em>
 380       peuvent être utilisées :</p>
 381
 382 <dl>
 383     <dt>txt</dt>
 384         <dd>Un fichier texte contenant des paires clé-valeur séparées
 385         par des espaces, une paire par ligne (<a
 386         href="../rewrite/rewritemap.html#txt">Détails ...</a>).</dd>
 387
 388     <dt>rnd</dt>
 389         <dd>Sélection aléatoire d'une entrée depuis un fichier texte (<a
 390         href="../rewrite/rewritemap.html#rnd">Détails ...</a>).</dd>
 391
 392     <dt>dbm</dt>
 393         <dd>Recherche une entrée dans un fichier dbm contenant des
 394         paires nom-valeur. Le condensé hash est élaboré à partir d'un
 395         format de fichier texte via l'utilitaire <code><a
 396         href="../programs/httxt2dbm.html">httxt2dbm</a></code> (<a
 397         href="../rewrite/rewritemap.html#dbm">Détails ...</a>).</dd>
 398
 399     <dt>int</dt>
 400         <dd>Une des quatre fonctions internes disponibles que fournit
 401         <code>RewriteMap</code>: toupper, tolower, escape ou unescape
 402         (<a href="../rewrite/rewritemap.html#int">Détails ...</a>).</dd>
 403
 404     <dt>prg</dt>
 405         <dd>Appelle un programme externe ou un script pour effectuer la
 406         réécriture (<a href="../rewrite/rewritemap.html#prg">Détails
 407         ...</a>).</dd>
 408
 409     <dt>dbd or fastdbd</dt>
 410         <dd>Une commande SQL SELECT à exécuter pour rechercher la cible
 411         de réécriture (<a href="../rewrite/rewritemap.html#dbd">Détails
 412         ...</a>).</dd>
 413     </dl>
 414
 415 <p>Vous trouverez plus de détails et de nombreux exemples dans le <a
 416 href="../rewrite/rewritemap.html">RewriteMap HowTo</a>.</p>
 417
 418 </usage>
 419 </directivesynopsis>
 420
 421 <directivesynopsis>
 422 <name>RewriteBase</name>
 423 <description>Définit l'URL de base pour les réécritures au niveau
 424 répertoire</description>
 425 <syntax>RewriteBase <em>chemin_URL</em></syntax>
 426 <default>Pas de valeur par défaut</default>
 427 <contextlist><context>directory</context><context>.htaccess</context>
 428 </contextlist>
 429 <override>FileInfo</override>
 430
 431 <usage>
 432       <p>La directive <directive>RewriteBase</directive> permet de
 433       spécifier le préfixe d'URL à utiliser dans un contexte de
 434       répertoire (htaccess) pour les directives
 435       <directive module="mod_rewrite">RewriteRule</directive> qui réécrivent vers un chemin
 436       relatif.</p>
 437       <p>Cette directive est <em>obligatoire</em> si vous utilisez un
 438       chemin relatif dans une substitution, et dans un contexte de
 439       répertoire (htaccess), sauf si au moins une de ces conditions est
 440       vérifiée :</p>
 441       <ul>
 442           <li>La requête initiale, ainsi que la substitution, se
 443           situent par raport à la valeur de la directive
 444           <directive module="core">DocumentRoot</directive> (c'est à
 445           dire que pour y accéder, il n'est pas nécessaire d'utiliser
 446           une directive telle qu'<directive
 447           module="mod_alias">Alias</directive>).</li>
 448           <li>Le chemin du système de fichiers vers le répertoire
 449           contenant la <directive module="mod_rewrite">RewriteRule</directive>, suffixé par
 450           la substitution relative est aussi valide en tant qu'URL sur
 451           le serveur (ce qui est rare).</li>
 452           <li>A partir de la version 2.4.16 du serveur HTTP Apache,
 453           cette directive peut être omise lorsque la requête est mise en
 454           correspondance avec le système de fichiers via la directive
 455           <directive module="mod_alias">Alias</directive> ou le module
 456           <module>mod_userdir</module>.</li>
 457       </ul>
 458
 459 <p>Dans l'exemple ci-dessous, la directive
 460 <directive>RewriteBase</directive> est nécessaire afin d'éviter une
 461 réécriture en http://example.com/opt/myapp-1.2.3/welcome.html car la
 462 ressource n'était pas relative à la racine des documents. Cette erreur
 463 de configuration aurait conduit le serveur à rechercher un répertoire
 464 "opt" à la racine des documents.</p>
 465
 466 <highlight language="config">
 467 DocumentRoot "/var/www/example.com"
 468 AliasMatch "^/myapp" "/opt/myapp-1.2.3"
 469 &lt;Directory "/opt/myapp-1.2.3"&gt;
 470  RewriteEngine On
 471     RewriteBase "/myapp/"
 472     RewriteRule "^index\.html$"  "welcome.html"
 473 &lt;/Directory&gt;
 474 </highlight>
 475
 476 </usage>
 477
 478 </directivesynopsis>
 479
 480 <directivesynopsis>
 481 <name>RewriteCond</name>
 482 <description>Définit une condition qui devra être satisfaite pour que
 483 la réécriture soit effectuée
 484 </description>
 485 <syntax> RewriteCond
 486       <em>chaîne_de_test</em> <em>expression_de_comparaison</em> [<em>drapeaux</em>]</syntax>
 487 <contextlist><context>server config</context><context>virtual host</context>
 488 <context>directory</context><context>.htaccess</context></contextlist>
 489 <override>FileInfo</override>
 490
 491 <usage>
 492       <p>La directive <directive>RewriteCond</directive> permet de définir une
 493       condition d'exécution d'une règle. Une ou plusieurs conditions
 494       <directive>RewriteCond</directive> peuvent précéder une
 495       directive <directive module="mod_rewrite"
 496       >RewriteRule</directive>. La règle de réécriture correspondante n'est
 497       ainsi exécutée que si ces conditions sont satisfaites,
 498       <strong>et</strong> si l'URI correspond au modèle spécifié dans la
 499       règle.</p>
 500
 501       <p><em>TestString</em> est une chaîne qui peut contenir les
 502       extensions suivantes en plus du texte simple :</p>
 503
 504       <ul>
 505         <li>
 506           <strong>références arrières de règle de réécriture</strong> :
 507           ce sont des références arrières de la forme
 508           <strong><code>$N</code></strong> (0 &lt;= N &lt;= 9). $1 à $9
 509           permettent d'accéder aux parties regroupées (entre
 510           parenthèses) du modèle, issues de la <code>RewriteRule</code>
 511           concernée par le jeu de conditions <code>RewriteCond</code>
 512           courant. $0 donne accès à l'ensemble de la chaîne
 513           correspondant au modèle.</li>
 514         <li>
 515           <strong>Références arrières de condition de réécriture
 516           </strong> : ce sont des références arrières de la forme
 517           <strong><code>%N</code></strong> (0 &lt;= N &lt;= 9). %1 à %9
 518           permettent d'accéder aux parties regroupées (entre
 519           parenthèses) du modèle, issues de la dernière
 520           condition <code>RewriteCond</code> satisfaite du jeu de conditions <code>RewriteCond</code>
 521           courant. %0 donne accès à l'ensemble de la chaîne
 522           correspondant au modèle.</li>
 523         <li>
 524           <strong>extensions de table de réécriture</strong> :
 525           ce sont des extensions de la forme <strong><code
 526           >${nomTable:clé|défaut}</code></strong>. Voir la <a
 527           >href="#mapfunc">documentation sur RewriteMap</a>
 528            pour plus de détails.
 529         </li>
 530         <li>
 531           <strong>Variables du serveur</strong> :
 532           ce sont des variables de la forme
 533           <strong><code>%{</code> <em>NAME_OF_VARIABLE</em> <code>}</code></strong>,
 534             où <em>NOM_DE_VARIABLE</em> peut contenir une chaîne issue
 535             de la liste suivante :
 536
 537           <table>
 538           <columnspec><column width=".3"/><column width=".3"/>
 539            <column width=".3"/></columnspec>
 540             <tr>
 541               <th>En-têtes HTTP :</th> <th>connexion &amp; requête:</th> <th></th>
 542             </tr>
 543
 544             <tr>
 545               <td>
 546                  HTTP_ACCEPT<br />
 547                  HTTP_COOKIE<br />
 548                  HTTP_FORWARDED<br />
 549                  HTTP_HOST<br />
 550                  HTTP_PROXY_CONNECTION<br />
 551                  HTTP_REFERER<br />
 552                  HTTP_USER_AGENT<br />
 553               </td>
 554
 555               <td>
 556                  AUTH_TYPE<br />
 557                  CONN_REMOTE_ADDR<br />
 558                  CONTEXT_PREFIX<br />
 559                  CONTEXT_DOCUMENT_ROOT<br />
 560                  IPV6<br />
 561                  PATH_INFO<br />
 562                  QUERY_STRING<br />
 563                  REMOTE_ADDR<br />
 564                  REMOTE_HOST<br />
 565                  REMOTE_IDENT<br />
 566                  REMOTE_PORT<br />
 567                  REMOTE_USER<br />
 568                  REQUEST_METHOD<br />
 569                  SCRIPT_FILENAME<br />
 570               </td>
 571
 572               <td></td>
 573             </tr>
 574
 575             <tr>
 576               <th>variables internes au serveur :</th> <th>date et heure :</th> <th>spéciaux :</th>
 577             </tr>
 578
 579             <tr>
 580               <td>
 581                  DOCUMENT_ROOT<br />
 582                  SCRIPT_GROUP<br />
 583                  SCRIPT_USER<br />
 584                  SERVER_ADDR<br />
 585                  SERVER_ADMIN<br />
 586                  SERVER_NAME<br />
 587                  SERVER_PORT<br />
 588                  SERVER_PROTOCOL<br />
 589                  SERVER_SOFTWARE<br />
 590               </td>
 591
 592               <td>
 593                  TIME_YEAR<br />
 594                  TIME_MON<br />
 595                  TIME_DAY<br />
 596                  TIME_HOUR<br />
 597                  TIME_MIN<br />
 598                  TIME_SEC<br />
 599                  TIME_WDAY<br />
 600                  TIME<br />
 601               </td>
 602
 603               <td>
 604                  API_VERSION<br />
 605                  CONN_REMOTE_ADDR<br />
 606                  HTTPS<br />
 607                  IS_SUBREQ<br />
 608                  REMOTE_ADDR<br />
 609                  REQUEST_FILENAME<br />
 610                  REQUEST_SCHEME<br />
 611                  REQUEST_URI<br />
 612                  THE_REQUEST<br />
 613               </td>
 614             </tr>
 615           </table>
 616
 617                 <p>Ces variables correspondent toutes aux en-têtes MIME
 618                 HTTP de mêmes noms, au variables C du serveur HTTP Apache, ou
 619                 aux champs <code>struct tm</code> du système Unix. La
 620                 plupart d'entre elles sont documentées <a
 621                 href="../expr.html#vars">ici</a>, dans la
 622                 spécification CGI ou ailleurs dans le
 623                 manuel.</p>
 624
 625                 <p>SERVER_NAME et SERVER_PORT dépendent respectivement
 626                 des valeurs des directives <directive
 627                 module="core">UseCanonicalName</directive> et <directive
 628                 module="core">UseCanonicalPhysicalPort</directive>.</p>
 629
 630                 <p>Parmi les variables
 631                 spécifiques à mod_rewrite, ou trouve les suivantes :</p>
 632
 633                 <dl>
 634                   <dt><code>API_VERSION</code></dt>
 635
 636                   <dd>C'est la version de l'API des modules Apache httpd
 637                   (l'interface interne entre le serveur et les modules)
 638                   pour la construction courante de httpd, telle qu'elle
 639                   est définie dans include/ap_mmn.h. La version de l'API
 640                   des modules correspond à la version du serveur Apache
 641                   httpd
 642                   utilisé (par exemple, pour la version 1.3.14 d'Apache
 643                   httpd,
 644                   il s'agit de la version 19990320:10), mais intéresse
 645                   principalement les auteurs de modules.</dd>
 646
 647                   <dt><code>CONN_REMOTE_ADDR</code></dt>
 648
 649                   <dd>A partir de la version 2.4.8 : l'adresse IP distante de
 650                   la connexion (voir le module
 651                   <module>mod_remoteip</module>).</dd>
 652
 653                   <dt><code>HTTPS</code></dt>
 654
 655                   <dd>Contient le texte "on" si la connexion
 656                   utilise SSL/TLS, "off" dans le cas contraire
 657                   (Cette variable peut être utilisée sans problème, que
 658                   <module>mod_ssl</module> soit chargé ou non).</dd>
 659
 660                   <dt><code>IS_SUBREQ</code></dt>
 661
 662                   <dd>Contient le texte "true" si la requête en cours
 663                   de traitement est une sous-requête, "false" dans le
 664                   cas contraire. Une sous-requête est générée quand un
 665                   module a besoin de se référer à des fichiers ou URIs
 666                   addidionnels pour pouvoir mener à bien sa tâche.</dd>
 667
 668                   <dt><code>REMOTE_ADDR</code></dt>
 669                   <dd>L'adresse IP de l'hôte distant (se référer au
 670                   module <module>mod_remoteip</module>).</dd>
 671
 672                   <dt><code>REQUEST_FILENAME</code></dt>
 673
 674                   <dd>Le chemin complet local au système de fichiers
 675                   du fichier ou du script correspondant
 676                   à la requête, s'il a déjà été déterminé par le serveur
 677                   au moment où on y fait référence. Dans le cas
 678                   contraire, et en particulier dans le cas d'un serveur
 679                   virtuel, <code>REQUEST_FILENAME</code> contient la
 680                   valeur de <code>REQUEST_URI</code>. En fonction de la
 681                   valeur de la directive <directive
 682                   module="core">AcceptPathInfo</directive>, le serveur
 683                   peut n'utiliser que certains éléments de tête du
 684                   <code>REQUEST_URI</code> pour déterminer à quel
 685                   fichier correspond la requête.</dd>
 686
 687                   <dt><code>REQUEST_SCHEME</code></dt>
 688
 689                   <dd>Contient le protocole de la requête (en général
 690                   "http" ou "https"). La valeur peut être modifiée par
 691                   la directive <directive
 692                   module="core">ServerName</directive>.</dd>
 693
 694                   <dt><code>REQUEST_URI</code></dt>
 695
 696                   <dd>La partie chemin de l'URI de la requête, comme
 697                   "/index.html". Ceci exclut en particulier la chaîne de
 698                   paramètres de la requête qui est contenue dans la
 699                   variable <code>QUERY_STRING</code>.</dd>
 700
 701                   <dt><code>THE_REQUEST</code></dt>
 702
 703                   <dd>La ligne de requête HTTP complète envoyée par le
 704                   navigateur au serveur (par exemple, "<code>GET
 705                   /index.html HTTP/1.1</code>"), à l'exclusion de tout
 706                   en-tête ajouté par le navigateur. Cette
 707                   valeur n'a pas été déséchappée (décodée), à la
 708                   différence de la plupart des variables suivantes.</dd>
 709                 </dl>
 710
 711         </li>
 712       </ul>
 713
 714       <p>Si la <em>chaîne_de_test</em> contient la valeur spéciale
 715       <code>expr</code>, <em>expression_de_comparaison</em> sera traité
 716       en tant qu'expression rationnelle de type <a
 717       href="../expr.html">ap_expr</a>. Si des en-têtes HTTP sont
 718       référencés dans l'expression rationnelle, et si le drapeau
 719       <code>novary</code> n'est pas activé, ils seront ajoutés à
 720       l'en-tête Vary.</p>
 721
 722       <p>Autres points à connaître ::</p>
 723       <ol>
 724         <li>
 725         <p>Les variables <code>SCRIPT_FILENAME</code> et
 726         <code>REQUEST_FILENAME</code> contiennent toutes deux la valeur
 727         du champ <code>filename</code> de la
 728         structure interne <code>request_rec</code>du serveur HTTP Apache.
 729         Le premier nom correspond au nom de variable bien connu CGI,
 730         alors que le second est l'équivalent de REQUEST_URI (qui
 731         contient la valeur du champ <code>uri</code> de
 732         <code>request_rec</code>).</p>
 733         <p>Si une substitution intervient et si la réécriture se
 734         poursuit, la valeur des deux variables sera mise à jour en
 735         conséquence.</p>
 736         <p>Dans le contexte du serveur principal (c'est à dire avant que
 737         la requête ne soit mise en correspondance avec le système de
 738         fichiers), SCRIPT_FILENAME et REQUEST_FILENAME  ne peuvent pas
 739         contenir le chemin entier dans le système de fichiers local car
 740         ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
 741         les deux variables contiendront la valeur de REQUEST_URI. Pour
 742         obtenir le chemin complet de la requête dans le système de
 743         fichiers local dans le contexte du serveur principal, utilisez une
 744         référence avant à base d'URL
 745         <code>%{LA-U:REQUEST_FILENAME}</code> pour déterminer la valeur
 746         finale de REQUEST_FILENAME.</p></li>
 747
 748
 749         <li>
 750         <code>%{ENV:<em>variable</em>}</code>, où <em>variable</em> peut
 751         correspondre à une variable d'environnement quelconque.</li>
 752         <li>
 753         <code>%{ENV:variable}</code> est aussi disponible, où
 754         <em>variable</em> peut correspondre à toute variable
 755         d'environnement. Peut être consulté via des structures internes
 756         d'Apache httpd et (si on ne les trouve pas ici) via la fonction
 757         <code>getenv()</code> à partir du processus du serveur Apache
 758         httpd.</li>
 759
 760         <li>Que <module>mod_ssl</module> soit chargé ou non, on peut
 761         utiliser <code>%{SSL:variable}</code>, où <em>variable</em>
 762         peut être remplacé par le nom d'une
 763         <a href="mod_ssl.html#envvars">variable
 764         d'environnement SSL</a> . Si <module>mod_ssl</module> n'est pas
 765         chargé, cette variable contiendra toujours une chaîne vide.
 766         Exemple : <code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> pourra
 767         contenir la valeur <code>128</code>. Ces variables sont
 768         disponibles même si l'option <code>StdEnvVars</code> de la
 769         directive <directive module="mod_ssl">SSLOptions</directive> n'a
 770         pas été définie.</li>
 771
 772         <li>
 773         On peut utiliser <code>%{HTTP:en-tête}</code>, où
 774         <em>en-tête</em> peut correspondre à tout nom d'en-tête MIME
 775         HTTP, pour extraire la valeur d'un en-tête envoyé dans la
 776         requête HTTP. Par exemple, <code>%{HTTP:Proxy-Connection}</code>
 777         contiendra la valeur de l'en-tête HTTP
 778         "<code>Proxy-Connection:</code>".
 779         Si on utilise un en-tête HTTP
 780         dans une condition, et si cette condition est évaluée à
 781         <code>vrai</code> pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
 782         la réponse. Il ne le sera pas si la condition est évaluée à
 783         <code>faux</code>. L'ajout de l'en-tête HTTP à l'en-tête Vary
 784         est nécessaire à une mise en cache appropriée.
 785         <p>Il faut garder à l'esprit que les conditions suivent une
 786         logique de cout-circuit si le drapeau
 787         '<strong><code>ornext|OR</code></strong>' est utilisé, et que de
 788         ce fait, certaines d'entre elles ne seront pas évaluées.</p>
 789         </li>
 790
 791         <li>A des fins de référence avant, on peut utiliser,
 792         <a id="LA-U" name="LA-U"><code>%{LA-U:variable}</code></a>, qui
 793         permet d'effectuer une sous-requête interne à base d'URL, afin
 794         de déterminer la valeur finale de <em>variable</em>. Ceci permet
 795         d'accéder à la valeur d'une variable pour la réécriture inconnue
 796         à ce stade du traitement, mais qui sera définie au
 797         cours d'une phase ultérieure.
 798         <p>Par exemple, pour effectuer une réécriture dépendant de la
 799         variable <code>REMOTE_USER</code> dans le contexte du serveur
 800         principal (fichier <code>httpd.conf</code>), vous devez utiliser
 801         <code>%{LA-U:REMOTE_USER}</code> - cette variable est définie
 802         par la phase d'autorisation qui intervient <em>après</em> la
 803         phase de traduction d'URL (pendant laquelle mod_rewrite opère).</p>
 804         <p>Par contre, comme mod_rewrite implémente son contexte de
 805         répertoire (fichier <code>.htaccess</code>) via la phase Fixup
 806         de l'API, et comme la phase d'autorisation intervient
 807         <em>avant</em> cette dernière, vous pouvez vous contenter
 808         d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</p></li>
 809
 810         <li>
 811         <code>%{LA-F:variable}</code> peut être utilisée pour effectuer
 812         une sous-requête interne (basée sur le nom de fichier), afin de
 813         déterminer la valeur finale de <em>variable</em>. La plupart du
 814         temps, elle est identique à LA-U (voir ci-dessus).</li>
 815       </ol>
 816
 817
 818       <p><em>expression_de_comparaison</em> est une expression
 819       rationnelle qui est appliquée à l'instance actuelle de
 820       <em>chaîne_de_test</em>. <em>chaîne_de_test</em> est d'abord
 821       évaluée, puis comparée à
 822       l'<em>expression_de_comparaison</em>.</p>
 823
 824       <p><em>expression_de_comparaison</em> est en général une
 825       <em>expression rationnelle compatible perl</em>, mais vous
 826       disposez des syntaxes supplémentaires suivantes pour effectuer
 827       d'autres tests utiles sur <em>chaîne_de_test</em> :
 828       </p>
 829
 830       <ol>
 831         <li>Vous pouvez préfixer l'expression avec un caractère
 832         '<code>!</code>' (point d'exclamation) pour inverser le résultat
 833         de la condition, quelle que soit l'<em>expression de
 834         comparaison</em> utilisée.</li>
 835
 836         <li>Vous pouvez effectuer des comparaisons lexicographiques de
 837         chaînes        :
 838
 839          <dl>
 840             <dt><strong>&lt;expression</strong></dt>
 841             <dd>inférieur au sens lexicographique<br />
 842             Traite l'<em>expression</em> comme une chaîne de
 843             caractères et la compare lexicographiquement à
 844             <em>chaîne_de_test</em>. La condition est satisfaite si
 845             <em>chaîne_de_test</em> est inférieure au sens
 846             lexicographique à l'<em>expression</em>.</dd>
 847
 848             <dt><strong>&gt;expression</strong></dt>
 849             <dd>supérieur au sens lexicographique<br />
 850             Traite l'<em>expression</em> comme une chaîne de
 851             caractères et la compare lexicographiquement à
 852             <em>chaîne_de_test</em>. La condition est satisfaite si
 853             <em>chaîne_de_test</em> est supérieure au sens
 854             lexicographique à l'<em>expression</em>.</dd>
 855
 856             <dt><strong>=expression</strong></dt>
 857             <dd>égal au sens lexicographique<br />
 858             Traite l'<em>expression</em> comme une chaîne de
 859             caractères et la compare lexicographiquement à
 860             <em>chaîne_de_test</em>. La condition est satisfaite si
 861             <em>chaîne_de_test</em> est égale au sens
 862             lexicographique à l'<em>expression</em> (les deux chaînes
 863             sont exactement identiques, caractère pour caractère). Si
 864             <em>expression</em> est <code>""</code> (deux guillemets),
 865             <em>chaîne_de_test</em> est comparée à la
 866             chaîne vide.</dd>
 867
 868             <dt><strong>&lt;=expression de comparaison</strong></dt>
 869             <dd>inférieur ou égal à au sens lexicographique<br />
 870             Considère l'<em>expression_de_comparaison</em> comme une
 871             chaîne de caractères et la compare au sens lexicographique à
 872             la <em>chaîne_de_test</em>. Vrai si <em>chaîne_de_test</em>
 873             précède lexicographiquement <em>expression_de_comparaison</em>, ou est
 874             égale à <em>expression_de_comparaison</em> (les deux chaînes
 875             sont identiques, caractère pour caractère).</dd>
 876
 877             <dt><strong>&gt;=expression de comparaison</strong></dt>
 878             <dd>supérieur ou égal à au sens lexicographique<br />
 879             Considère l'<em>expression_de_comparaison</em> comme une
 880             chaîne de caractères et la compare au sens lexicographique à
 881             la <em>chaîne_de_test</em>. Vrai si <em>chaîne_de_test</em>
 882             suit lexicographiquement <em>expression_de_comparaison</em>, ou est
 883             égale à <em>expression_de_comparaison</em> (les deux chaînes
 884             sont identiques, caractère pour caractère).</dd>
 885         </dl>
 886         </li>
 887
 888         <li>
 889           Vous pouvez effectuer des comparaisons d'entiers :
 890           <dl>
 891
 892             <dt><strong>-eq</strong></dt>
 893             <dd>est numériquement égal à<br />
 894             La <em>chaîne_de_test</em> est considérée comme un entier,
 895             et est comparée numériquement à l'<em>expression de
 896             comparaison</em>. Vrai si les deux expressions sont
 897             numériquement égales.</dd>
 898
 899             <dt><strong>-ge</strong></dt>
 900             <dd>est numériquement supérieur ou égal à<br />
 901             La <em>chaîne_de_test</em> est considérée comme un entier,
 902             et est comparée numériquement à l'<em>expression de
 903             comparaison</em>. Vrai si <em>chaîne_de_test</em> est
 904             numériquement supérieure ou égale à
 905             <em>expression_de_comparaison</em>.</dd>
 906
 907              <dt><strong>-gt</strong></dt>
 908              <dd>est numériquement supérieur à<br />
 909             La <em>chaîne_de_test</em> est considérée comme un entier,
 910             et est comparée numériquement à l'<em>expression de
 911             comparaison</em>. Vrai si <em>chaîne_de_test</em> est
 912             numériquement
 913             supérieure à <em>expression_de_comparaison</em>.</dd>
 914
 915             <dt><strong>-le</strong></dt>
 916             <dd>est numériquement inférieur ou égal à<br />
 917             La <em>chaîne_de_test</em> est considérée comme un entier,
 918             et est comparée numériquement à l'<em>expression de
 919             comparaison</em>. Vrai si <em>chaîne_de_test</em> est
 920             numériquement
 921             inférieure ou égale à <em>expression_de_comparaison</em>.
 922             Attention à la confusion avec le drapeau <strong>-l</strong>
 923             en utilisant la variante the <strong>-L</strong> ou
 924             <strong>-h</strong>.</dd>
 925
 926              <dt><strong>-lt</strong></dt>
 927              <dd>est numériquement inférieur à<br />
 928             La <em>chaîne_de_test</em> est considérée comme un entier,
 929             et est comparée numériquement à l'<em>expression de
 930             comparaison</em>. Vrai si <em>chaîne_de_test</em> est
 931             numériquement
 932             inférieure à <em>expression_de_comparaison</em>.
 933             Attention à la confusion avec le drapeau <strong>-l</strong>
 934             en utilisant la variante the <strong>-L</strong> ou
 935             <strong>-h</strong>.</dd>
 936
 937             <dt><strong>-ne</strong></dt>
 938             <dd>Est numériquement <strong>n</strong>on <strong>é</strong>gal à<br />
 939              La <em>Chaîne de test</em> est considérée comme un entier et est
 940              numériquement comparée à l'<em>expression de comparaison</em>. Vrai
 941              si les deux éléments comparés sont numériquement différents.
 942              Equivalent à <code>!-eq</code>.</dd>
 943
 944            </dl>
 945         </li>
 946
 947         <li>Vous pouvez effectuer différents tests sur les attributs de
 948         fichier :
 949           <dl>
 950
 951             <dt><strong>-d</strong></dt>
 952             <dd>est un <strong>r</strong>épertoire<br />
 953             Traite <em>chaîne_de_test</em> comme un chemin et vérifie
 954             s'il existe ou pas, et s'il s'agit d'un répertoire.</dd>
 955
 956             <dt><strong>-f</strong></dt>
 957             <dd>est un <strong>f</strong>ichier régulier<br />
 958             Traite <em>chaîne_de_test</em> comme un chemin et vérifie
 959             s'il existe ou pas, et s'il s'agit d'un fichier régulier.</dd>
 960
 961             <dt><strong>-F</strong></dt>
 962             <dd>test de l'existence d'un fichier via une sous-requête<br />
 963             Vérifie si <em>chaîne_de_test</em> est un fichier valide,
 964             accessible à travers tous les contrôles d'accès du serveur
 965             actuellement configurés pour ce chemin. C'est une
 966             sous-requête interne qui effectue cette vérification - à
 967             utiliser avec précautions car les performances du serveur
 968             peuvent s'en trouver affectées !</dd>
 969
 970             <dt><strong>-h</strong></dt>
 971             <dd>est un lien symbolique, selon la convention bash<br />
 972             Voir <strong>-l</strong>.</dd>
 973
 974             <dt><strong>-l</strong></dt>
 975             <dd>est un <strong>l</strong>ien symbolique<br />
 976             Considère la <em>chaîne_de_test</em> comme un chemin et
 977             vérifie son existence et si elle est un lien symbolique. On
 978             peut aussi utiliser la convention bash <strong>-L</strong>
 979             ou <strong>-h</strong> lorsqu'il y a risque de confusion
 980             avec les tests <strong>-lt</strong> ou <strong>-le</strong>.</dd>
 981
 982             <dt><strong>-L</strong></dt>
 983             <dd>est un lien symbolique, selon la convention bash<br />
 984             Voir <strong>-l</strong>.</dd>
 985
 986             <dt><strong>-s</strong></dt>
 987             <dd>est un fichier régulier d'une certaine taille<br />
 988             Considère la <em>chaîne_de_test</em> comme un chemin et
 989             vérifie son existence et si elle est un fichier régulier
 990             d'une taille supérieure à zéro.</dd>
 991
 992             <dt><strong>-U</strong></dt>
 993             <dd><p>test de l'existence d'une
 994             URL via une sous-requête<br />
 995             Vérifie si <em>chaîne_de_test</em> est une URL valide,
 996             accessible à travers tous les contrôles d'accès du serveur
 997             actuellement configurés pour ce chemin. C'est une
 998             sous-requête interne qui effectue cette vérification - à
 999             utiliser avec précautions car les performances du serveur
1000             peuvent s'en trouver affectées !</p>
1001             <p>Ce drapeau ne renvoie <em>que</em> des informations
1002             concernant le contrôle d'accès, l'authentification et
1003             l'autorisation. Il ne renvoie <em>pas</em> d'informations
1004             concernant le code d'état que le gestionnaire configuré
1005             (static file, CGI, proxy, etc...) aurait, quant à lui,
1006             retourné.</p></dd>
1007
1008           <dt><strong>-x</strong></dt>
1009           <dd>a l'attribut d'exécution positionné<br />
1010             Considère la <em>chaîne_de_test</em> comme un chemin et
1011             vérifie son existence et si elle a son attribut d'exécution
1012             positionné. Ce positionnement est déterminé en fonction de
1013             l'OS sous-jacent.</dd>
1014
1015             </dl>
1016
1017             Par exemple:
1018
1019         <highlight language="config">
1020 RewriteCond /var/www/%{REQUEST_URI} !-f
1021 RewriteRule ^(.+) /other/archive/$1 [R]
1022         </highlight>
1023
1024         </li>
1025
1026         <li>
1027            <p>Si la <em>chaîne_de_test</em> contient la valeur spéciale
1028            <code>expr</code>, la <em>chaîne de comparaison</em> sera
1029            traitée en tant qu'expression rationnelle de type <a
1030            href="../expr.html">ap_expr</a>.</p>
1031
1032            <p>
1033             Dans l'exemple ci-dessous, on utilise <code>-strmatch</code>
1034             pour comparer le <code>REFERER</code> avec le nom d'hôte du
1035             site afin de bloquer le hotlinking (référencement direct)
1036             non désiré.
1037            </p>
1038
1039            <highlight language="config">
1040            RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
1041            RewriteRule "^/images" "-" [F]
1042            </highlight>
1043         </li>
1044     </ol>
1045
1046         <p>Vous pouvez aussi définir certains drapeaux pour
1047         l'<em>expression_de_comparaison</em> en ajoutant ces
1048         <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
1049         comme troisième argument de la directive
1050         <code>RewriteCond</code>, où <em>drapeaux</em> est un
1051         sous-ensemble séparé par des virgules des drapeaux suivants :</p>
1052
1053       <ul>
1054         <li>'<strong><code>nocase|NC</code></strong>'
1055         (<strong>n</strong>o <strong>c</strong>ase)<br />
1056         Rend le test insensible à la casse - il n'est pas fait de
1057         distinction entre majuscules et minuscules, à la fois dans le
1058         développement de <em>chaîne_de_test</em> et dans
1059         <em>expression_de_comparaison</em>. Ce drapeau n'est pris en
1060         compte que lors d'une comparaison entre <em>chaîne_de_test</em>
1061         et <em>expression_de_comparaison</em>. Il ne l'est pas pour les
1062         vérification par sous-requêtes ou sur le système de
1063         fichiers.</li>
1064
1065         <li>
1066           '<strong><code>ornext|OR</code></strong>'
1067           (<strong>ou</strong> condition suivante)<br />
1068           Permet de chaîner les conditions de règles avec un OU au
1069           lieu du AND implicite. Exemple typique :
1070
1071 <highlight language="config">
1072 RewriteCond "%{REMOTE_HOST}"  "^host1"  [OR]
1073 RewriteCond "%{REMOTE_HOST}"  "^host2"  [OR]
1074 RewriteCond "%{REMOTE_HOST}"  "^host3"
1075 RewriteRule ...règles concernant tous ces hôtes...
1076 </highlight>
1077
1078           Sans ce drapeau, les paires
1079           condition/règle devraient être écrites trois fois.
1080         </li>
1081
1082         <li>'<strong><code>novary|NV</code></strong>'
1083         (<strong>n</strong>o <strong>v</strong>ary)<br />
1084         Si la condition contient un en-tête HTTP, ce drapeau empêche
1085         ce dernier d'être ajouté à l'en-tête Vary de la réponse. <br />
1086         L'utilisation de ce drapeau peut provoquer une mise en cache
1087         incorrecte de la réponse, si la représentation de cette réponse
1088         varie avec la valeur de l'en-tête considéré. Ce drapeau ne
1089         devrait donc être utilisé que si l'on maîtrise parfaitement le
1090         fonctionnement de l'en-tête Vary.
1091         </li>
1092       </ul>
1093
1094
1095       <p><strong>Exemple :</strong></p>
1096
1097        <p>Pour réécrire la page d'accueil d'un site en fonction de
1098        l'en-tête ``<code>User-Agent:</code>'' de la requête, vous
1099        pouvez utiliser ce qui suit : </p>
1100
1101 <highlight language="config">
1102 RewriteCond  "%{HTTP_USER_AGENT}"  "(iPhone|Blackberry|Android)"
1103 RewriteRule  "^/$"               "/homepage.mobile.html"  [L]
1104
1105 RewriteRule  "^/$"                 "/homepage.std.html"  [L]
1106 </highlight>
1107
1108         <p>Explications : si vous utilisez un navigateur
1109         qui s'identifie comme un
1110         navigateur de plateforme mobile (notez que l'exemple est
1111         incomplet car il existe de nombreuses autres plateformes
1112         mobiles), c'est la version pour mobile de la page d'accueil qui
1113         sera renvoyée. Dans le cas contraire, ce sera la page d'accueil
1114         standard.</p>
1115
1116 </usage>
1117
1118 </directivesynopsis>
1119
1120 <directivesynopsis>
1121 <name>RewriteRule</name>
1122 <description>Définit les règles pour le moteur de réécriture</description>
1123 <syntax>RewriteRule
1124       <em>Modèle</em> <em>Substitution</em> [<em>drapeaux</em>]</syntax>
1125 <contextlist><context>server config</context><context>virtual host</context>
1126 <context>directory</context><context>.htaccess</context></contextlist>
1127 <override>FileInfo</override>
1128
1129 <usage>
1130       <p>La directive <directive>RewriteRule</directive> est le
1131       véritable cheval de trait de la réécriture. La directive peut
1132       apparaître plusieurs fois, chaque instance définissant une
1133       règle de réécriture particulière. L'ordre dans lequel ces règles
1134       sont définies est important - il s'agit de l'ordre dans lequel
1135       les règles seront appliquées au cours du processus de
1136       réécriture.</p>
1137
1138       <p><a id="patterns" name="patterns"><em>Modèle</em></a> est une
1139       <a id="regexp" name="regexp">expression rationnelle</a>
1140       compatible perl. Ce avec quoi ce modèle est comparé dépend de l'endroit où
1141       la directive <directive>RewriteRule</directive> est définie.</p>
1142
1143 <note><title><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est comparé ?</a></title>
1144
1145 <ul>
1146       <li><p>Dans un contexte de serveur virtuel <directive
1147       module="core">VirtualHost</directive>, le <em>modèle</em> est tout
1148       d'abord comparé à la portion de l'URL située entre le nom d'hôte
1149       éventuellement accompagné du port, et la chaîne de paramètres (par
1150       exemple "/app1/index.html"). Il s'agit du <a
1151       href="directive-dict.html#Syntax">URL-path</a> décodé de sa valeur "%xx".</p></li>
1152
1153       <li><p>Dans un contexte de répertoire (sections <directive
1154       module="core">Directory</directive> et fichiers .htaccess), le
1155       <em>Modèle</em> est comparé avec une partie de chemin ; par exemple une
1156       requête pour "/app1/index.html" entraînera une comparaison avec
1157       "app1/index.html" ou "index.html" selon l'endroit où la directive
1158       <directive>RewriteRule</directive> est définie.</p>
1159
1160       <p>Le chemin où la règle est défini est supprimé du chemin correspondant
1161       du système de fichiers avant comparaison (jusqu'au slash final compris).
1162       En conséquence de cette suppression, les règles définies dans
1163       ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
1164       du système de fichiers "en dessous" de l'endroit où la règle est définie.</p>
1165
1166       <p>Le chemin correspondant actuel du système de fichiers est déterminé par
1167       des directives telles que <directive>DocumentRoot</directive> et
1168       <directive>Alias</directive>, ou même le résultat de substitutions dans
1169       des règles <directive>RewriteRule</directive> précédentes.
1170       </p>
1171       </li>
1172
1173       <li><p>Si vous souhaitez faire une comparaison sur le nom
1174       d'hôte, le port, ou la chaîne de requête, utilisez une
1175       directive <directive module="mod_rewrite">RewriteCond</directive>
1176       comportant respectivement les variables
1177       <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
1178       <code>%{QUERY_STRING}</code>.</p></li>
1179 </ul>
1180
1181 </note>
1182
1183 <note><title>Réécritures dans un contexte de répertoire</title>
1184 <ul>
1185 <li>L'utilisation du moteur de réécriture dans les
1186 fichiers <a href="../howto/htaccess.html">.htaccess</a> et les sections
1187 <directive
1188 type="section" module="core">Directory</directive> est un peu plus
1189 complexe.</li>
1190
1191 <li>Pour activer le moteur de réécriture dans ces contextes, vous devez
1192 définir "<code>RewriteEngine On</code>" <strong>et</strong>
1193 "<code>Options FollowSymLinks</code>". Si l'administrateur a désactivé
1194 la possibilité de modifier l'option <code>FollowSymLinks</code> au
1195 niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
1196 moteur de réécriture. Cette restriction a été instaurée à des fins de
1197 sécurité.</li>
1198
1199 <li>Voir la directive
1200 <directive module="mod_rewrite">RewriteBase</directive> pour plus de détails à
1201 propos de l'ajout du préfixe après les substitutions relatives.</li>
1202
1203 <li>Si vous souhaitez effectuer une comparaison en prenant en compte
1204 l'intégralité du
1205 chemin de l'URL dans un contexte de répertoire (htaccess), vous devez
1206 utiliser la variable <code>%{REQUEST_URI}</code> dans la directive
1207 <directive module="mod_rewrite">RewriteCond</directive>.</li>
1208
1209 <li>Le prefixe supprimé se termine toujours par un slash, ce qui
1210 signifie que la comparaison s'effectue avec une chaîne qui ne comporte
1211 <em>jamais</em> de slash de début. Ainsi, un <em>modèle</em> contenant
1212 <code>^/</code> ne correspondra jamais dans un contexte de répertoire.</li>
1213
1214 <li>Bien que les règles de réécriture soient permises du point de vue de
1215 la syntaxe dans les sections <directive type="section"
1216 module="core">Location</directive> et <directive type="section"
1217 module="core">Files</directive> (y compris leurs versions sous forme
1218 d'expression rationnelle), elles n'y sont pas prises en compte, et
1219 n'y sont à priori d'aucune utilité. Les substitutions
1220 relatives sont une fonctionnalité qui n'est, elle non-plus pas supportée
1221 dans ce genre de contexte.</li>
1222 </ul>
1223 </note>
1224
1225         <p>Pour quelques conseils à propos des <glossary
1226         ref="regex">expressions rationnelles</glossary>, voir le
1227         document <a
1228         href="../rewrite/intro.html#regex">Introduction à
1229         mod_rewrite</a>.</p>
1230
1231       <p>Dans mod_rewrite, on peut aussi utiliser le caractère NON
1232       ('<code>!</code>') comme préfixe de modèle. Ceci vous permet
1233       d'inverser la signification d'un modèle, soit pour dire
1234       ``<em>si l'URL considérée ne correspond <strong>PAS</strong> à
1235       ce modèle</em>''. Le caractère NON peut donc être utilisé à
1236       titre exceptionnel, lorsqu'il est plus simple d'effectuer une
1237       comparaison avec le modèle inversé, ou dans la dernière règle
1238       par défaut.</p>
1239
1240 <note><title>Note</title>
1241 Si vous utilisez le caractère NON pour inverser la signification d'un
1242 modèle, vous ne pouvez pas inclure de parties génériques groupées dans
1243 le modèle. Ceci est dû au fait que, lorsque le modèle ne correspond
1244 pas (autrement dit, sa négation correspond), les groupes sont vides.
1245 Ainsi, si vous utilisez des modèles inversés, vous ne pouvez
1246 pas vous référer aux groupes par <code>$N</code> dans la chaîne de
1247 substitution !
1248 </note>
1249
1250       <p>Dans une règle de réécriture,
1251       <a id="rhs" name="rhs"><em>Substitution</em></a> est la chaîne
1252       de caractères qui remplace le chemin de l'URL original qui
1253       correspondait au <em>Modèle</em>. <em>Substitution</em> peut
1254       être :</p>
1255
1256       <dl>
1257
1258         <dt>un chemin du système de fichiers</dt>
1259
1260         <dd>Il indique alors la localisation dans le système de
1261         fichiers de la ressource qui doit être envoyée au
1262         client. Les substitutions ne sont traitées en tant que chemins du
1263         système de fichiers que si la règle est configurée dans un
1264         contexte de serveur (serveur virtuel), et si le premier
1265         composant du chemin dans la substitution existe dans le système
1266         de fichiers.</dd>
1267
1268         <dt>chemin d'URL</dt>
1269
1270         <dd>Un chemin relatif à la valeur de <directive
1271         module="core">DocumentRoot</directive> vers la ressource qui
1272         doit être servie. Notez que <module>mod_rewrite</module>
1273         essaie de deviner si vous avez spécifié un chemin du système
1274         de fichiers ou un chemin d'URL en vérifiant si la première
1275         partie du chemin existe à la racine du système de fichiers.
1276         Par exemple, si vous avez spécifié comme chaîne de
1277         <em>Substitution</em> <code>/www/file.html</code>, cette
1278         dernière sera traitée comme un chemin d'URL <em>à moins</em>
1279         qu'un répertoire nommé <code>www</code> n'existe à la racine
1280         de votre système de fichiers (ou dans le cas d'une
1281         réécriture au sein d'un fichier <code>.htaccess</code>,
1282         relativement à la racine des documents), auquel cas la chaîne de
1283         substitution sera traitée comme un chemin du système de
1284         fichiers. Si vous désirez que d'autres directives de
1285         correspondance d'URL (comme la directive <directive
1286         module="mod_alias">Alias</directive>) soient appliquées au
1287         chemin d'URL résultant, utilisez le drapeau <code>[PT]</code>
1288         comme décrit ci-dessous.</dd>
1289
1290         <dt>URL absolue</dt>
1291
1292         <dd>Si une URL absolue est spécifiée,
1293         <module>mod_rewrite</module> vérifie si le nom d'hôte
1294         correspond à celui de l'hôte local. Si c'est le cas, le
1295         protocole et le nom d'hôte sont supprimés, et ce qui reste est
1296         traité comme un chemin d'URL. Dans le cas contraire, une
1297         redirection externe vers l'URL indiquée est effectuée. Pour
1298         forcer une redirection externe vers l'hôte local, voir le
1299         drapeau <code>[R]</code> ci-dessous.</dd>
1300
1301         <dt><code>-</code> (tiret)</dt>
1302
1303         <dd>Un tiret indique qu'aucune substitution ne doit être
1304         effectuée (le chemin considéré est transmis sans changement).
1305         Ceci est utile quand un drapeau doit être appliqué sans
1306         modifier le chemin (voir ci-dessous).</dd>
1307
1308       </dl>
1309
1310       <p>En plus du texte, la chaîne <em>Substitution</em> peut
1311       comporter :</p>
1312
1313       <ol>
1314         <li>des références arrières (<code>$N</code>) vers le modèle
1315         d'une directive RewriteRule</li>
1316
1317         <li>des références arrières (<code>%N</code>) vers le dernier
1318         modèle d'une directive RewriteCond qui correspondait</li>
1319
1320         <li>des variables du serveur comme dans les chaînes de test de
1321         condition d'une règle (<code>%{VARNAME}</code>)</li>
1322
1323         <li>des appels de
1324         <a href="#mapfunc">fonctions de comparaison</a>
1325         (<code>${nom correspondance:clé|défaut}</code>)</li>
1326       </ol>
1327
1328       <p>Les références arrières sont des identificateurs de la forme
1329       <code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
1330       seront remplacés par le contenu du <strong>N</strong>ème groupe
1331       du <em>Modèle</em> qui correspondait. Les variables du serveur
1332       sont les mêmes que dans la <em>Chaîne_de_test</em> d'une
1333       directive <directive module="mod_rewrite">RewriteCond</directive>. Les
1334       fonctions de comparaison sont issues de la directive <directive
1335       module="mod_rewrite">RewriteMap</directive> dans la
1336       section de laquelle elles sont décrites. Ces trois types de
1337       variables sont évaluées dans l'ordre ci-dessus.</p>
1338
1339        <p>Chaque règle de réécriture s'applique au résultat de la règle
1340        précédente, selon l'ordre dans lequel elles ont été définies dans
1341        le fichier de configuration. Le chemin de l'URL ou du système de fichier (voir
1342        ci-dessus <a href="#what_is_matched">Qu'est-ce qui est
1343        comparé ?</a>) est <strong>intégralement
1344       remplacée</strong> par la chaîne de <em>Substitution</em> et le
1345       processus de réécriture se poursuit jusqu'à ce que toutes les
1346       règles aient été appliquées, ou qu'il soit explicitement stoppé
1347       par un drapeau <a
1348       href="../rewrite/flags.html#flag_l"><code><strong>L</strong></code></a>,
1349       ou par un autre drapeau qui implique un arrêt immédiat, comme
1350       <code><strong>END</strong></code> ou
1351       <code><strong>F</strong></code>.</p>
1352
1353      <note><title>Modifier la chaîne de requête</title>
1354       <p>Par défaut, la chaîne de requête est transmise sans
1355       modification. Vous pouvez cependant créer dans la chaîne de
1356       substitution des URLs dont une partie constitue une chaîne de
1357       requête. Pour cela, ajoutez simplement un point d'interrogation
1358       dans la chaîne de substitution pour indiquer que le texte qui
1359       suit doit être réinjecté dans la chaîne de requête. Pour
1360       supprimer une chaîne de requête, terminez simplement la chaîne de
1361       substitution par un point d'interrogation. Pour combiner les
1362       nouvelles chaînes de requête avec les anciennes, utilisez le
1363       drapeau <code>[QSA]</code>.</p>
1364      </note>
1365
1366
1367       <p>En outre, vous pouvez spécifier des <a name="rewriteflags"
1368       id="rewriteflags">actions</a> spéciales à effectuer en ajoutant
1369       des
1370       <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
1371       comme troisième argument de la directive
1372       <directive>RewriteRule</directive>. Séparés par des virgules au sein d'une
1373       liste encadrée par des crochets, les <em>drapeaux</em> peuvent
1374       être choisis dans la table suivante. Vous trouverez plus de
1375       détails, et des exemples pour chaque drapeau dans le <a
1376       href="../rewrite/flags.html">document à propos des drapeaux de
1377       réécriture.</a></p>
1378
1379       <table border="1" style="zebra">
1380     <tr><th>Drapeaux et syntaxe</th>
1381         <th>Fonction</th>
1382     </tr>
1383     <tr>
1384         <td>B</td>
1385         <td>Echappe les caractères non-alphanumériques
1386         dans les références arrières <em>avant</em>
1387         d'appliquer la transformation. <em><a
1388         href="../rewrite/flags.html#flag_b">détails ...</a></em></td>
1389     </tr>
1390     <tr>
1391         <td>backrefnoplus|BNP</td>
1392         <td>Avec ce drapeau, si les références arrières sont échappées,
1393         les espaces seront échappés en %20 au lieu de +. Ceci s'avère
1394         utile lorsqu'une référence arrière est utilisée dans la partie
1395         chemin, et non dans la chaîne de paramètres de la requête ;
1396         pour plus de détails, voir <em><a
1397         href="../rewrite/flags.html#flag_bnp">ici.</a></em></td>
1398     </tr>
1399
1400     <tr>
1401         <td>chain|C</td>
1402         <td>La règle est chaînée avec la règle suivante. Si la règle
1403         échoue, la ou les règles avec lesquelles elle est est chaînée
1404         seront sautées. <em><a
1405         href="../rewrite/flags.html#flag_c">détails ...</a></em></td>
1406     </tr>
1407     <tr>
1408         <td>cookie|CO=<em>NAME</em>:<em>VAL</em></td>
1409         <td>Définit un cookie au niveau du navigateur client. La syntaxe
1410         complète est :
1411         CO=<em>NAME</em>:<em>VAL</em>:<em>domain</em>[:<em>lifetime</em>[:<em>path</em>[:<em>secure</em>[:<em>httponly</em>]]]] <em><a href="../rewrite/flags.html#flag_co">details ...</a></em>
1412         <em><a href="../rewrite/flags.html#flag_co">détails ...</a></em>
1413         </td>
1414     </tr>
1415     <tr>
1416         <td>discardpath|DPI</td>
1417         <td>Supprime la partie PATH_INFO de l'URI réécrit. <em><a
1418         href="../rewrite/flags.html#flag_dpi">détails
1419         ...</a></em></td>
1420     </tr>
1421     <tr>
1422         <td>END</td>
1423         <td>Stoppe le processus de réécriture immédiatement et
1424         n'applique plus aucune règle. Empêche aussi l'application
1425         ultérieure de règles de réécriture dans les contextes de
1426         répertoire et de fichier .htaccess (disponible à partir de la
1427         version 2.3.9 du serveur HTTP Apache). <em><a
1428         href="../rewrite/flags.html#flag_end">détails ...</a></em></td>
1429     </tr>
1430     <tr>
1431         <td>env|E=[!]<em>VAR</em>[:<em>VAL</em>]</td>
1432         <td>Définit la variable d'environnement <em>VAR</em> (à la valeur
1433         <em>VAL</em> si elle est fournie). La variante !<em>VAR</em>
1434         annule la définition de la variable <em>VAR</em>.<em><a
1435         href="../rewrite/flags.html#flag_e">détails ...</a></em></td>
1436     </tr>
1437     <tr>
1438         <td>forbidden|F</td>
1439         <td>Renvoie une réponse 403 FORBIDDEN au navigateur client.
1440         <em><a href="../rewrite/flags.html#flag_f">détails ...</a></em></td>
1441     </tr>
1442     <tr>
1443         <td>gone|G</td>
1444         <td>Renvoie un message d'erreur 410 GONE au navigateur client. <em><a
1445         href="../rewrite/flags.html#flag_g">détails ...</a></em></td>
1446     </tr>
1447     <tr>
1448         <td>Handler|H=<em>Gestionnaire de contenu</em></td>
1449         <td>L'URI résultant est envoyé au <em>Gestionnaire de
1450         contenu</em> pour traitement. <em><a
1451         href="../rewrite/flags.html#flag_h">détails ...</a></em></td>
1452     </tr>
1453     <tr>
1454         <td>last|L</td>
1455         <td>Arrête le processus de réécriture immédiatement et n'applique
1456         plus aucune règle. Prêtez une attention particulière aux mises
1457         en garde concernant les contextes de niveau répertoire et
1458         .htaccess (voir aussi le drapeau END). <em><a
1459         href="../rewrite/flags.html#flag_l">détails ...</a></em></td>
1460     </tr>
1461     <tr>
1462         <td>next|N</td>
1463         <td>Réexécute le processus de réécriture à partir de la première
1464         règle, en utilisant le résultat du jeu de règles, sous réserve
1465         qu'il y ait un point de départ. <em><a
1466         href="../rewrite/flags.html#flag_n">détails
1467         ...</a></em></td>
1468     </tr>
1469     <tr>
1470         <td>nocase|NC</td>
1471         <td>Rend la comparaison entre modèles insensible à la casse.
1472         <em><a href="../rewrite/flags.html#flag_nc">détails ...</a></em></td>
1473     </tr>
1474     <tr>
1475         <td>noescape|NE</td>
1476         <td>Empêche mod_rewrite d'effectuer un échappement hexadécimal
1477         des caractères spéciaux dans le résultat de la réécriture. <em><a
1478         href="../rewrite/flags.html#flag_ne">détails ...</a></em></td>
1479     </tr>
1480     <tr>
1481         <td>nosubreq|NS</td>
1482         <td>La règle est sautée si la requête courante est une
1483         sous-requête interne. <em><a
1484         href="../rewrite/flags.html#flag_ns">détails ...</a></em></td>
1485     </tr>
1486     <tr>
1487         <td>proxy|P</td>
1488         <td>Force l'envoi en interne de l'URL de substitution en tant
1489         que requête mandataire. <em><a
1490         href="../rewrite/flags.html#flag_p">détails
1491         ...</a></em></td>
1492     </tr>
1493     <tr>
1494         <td>passthrough|PT</td>
1495         <td>L'URI résultant est repassé au moteur de mise en
1496         correspondance des URLs pour y être traité par d'autres
1497         traducteurs URI-vers-nom de fichier, comme <code>Alias</code> ou
1498         <code>Redirect</code>. <em><a
1499         href="../rewrite/flags.html#flag_pt">détails ...</a></em></td>
1500     </tr>
1501     <tr>
1502         <td>qsappend|QSA</td>
1503         <td>Ajoute toute chaîne de paramètres présente dans l'URL de la
1504         requête originale à toute chaîne de paramètres créée dans la
1505         cible de réécriture. <em><a
1506         href="../rewrite/flags.html#flag_qsa">détails ...</a></em></td>
1507     </tr>
1508     <tr>
1509         <td>qsdiscard|QSD</td>
1510         <td>Supprime toute chaîne de paramètres de l'URI entrant. <em><a
1511         href="../rewrite/flags.html#flag_qsd">détails
1512         ...</a></em></td>
1513     </tr>
1514     <tr>
1515         <td>qslast|QSL</td>
1516         <td>Interprète le dernier (le plus à droite) point d'interrogation comme
1517         le délimiteur de la chaîne de paramètres de la requête, au lieu du
1518         premier (le plus à gauche) comme c'est le cas habituellement. Disponble
1519         à partir de la version 2.4.19 du serveur HTTP Apache. <em><a
1520         href="../rewrite/flags.html#flag_qsl">détails ...</a></em></td>
1521     </tr>
1522
1523     <tr>
1524         <td>redirect|R[=<em>code</em>]</td>
1525         <td>Force une redirection externe, avec un code de statut HTTP
1526         optionnel. <em><a
1527         href="../rewrite/flags.html#flag_r">détails ...</a></em>
1528         </td>
1529     </tr>
1530     <tr>
1531         <td>skip|S=<em>nombre</em></td>
1532         <td>Si la règle courante s'applique, le moteur de réécriture
1533         doit sauter les <em>nombre</em> règles suivantes. <em><a
1534         href="../rewrite/flags.html#flag_s">détails ...</a></em></td>
1535     </tr>
1536     <tr>
1537         <td>type|T=<em>MIME-type</em></td>
1538         <td>Force l'attribution du <glossary>Type-MIME</glossary>
1539         spécifié au fichier cible. <em><a
1540         href="../rewrite/flags.html#flag_t">détails ...</a></em></td>
1541     </tr>
1542     </table>
1543
1544 <note><title>Développement du répertoire home</title>
1545 <p> Quand la chaîne de substitution commence par quelque chose comme
1546 "/~user" (de manière explicite ou par références arrières), mod_rewrite
1547 développe le répertoire home sans tenir compte de la présence ou de la
1548 configuration du module <module>mod_userdir</module>.</p>
1549
1550 <p> Ce développement n'est pas effectué si le drapeau <em>PT</em> est
1551 utilisé dans la directive <directive module="mod_rewrite">RewriteRule</directive></p>
1552 </note>
1553
1554      <p>Voici toutes les combinaisons de substitution et leurs
1555      significations :</p>
1556
1557       <p><strong>Dans la configuration au niveau du serveur principal
1558       (<code>httpd.conf</code>)<br />
1559        pour la requête ``<code>GET
1560       /chemin/infochemin</code>'':</strong><br />
1561       </p>
1562
1563 <table border="1" style="zebra">
1564 <tr>
1565 <th>Règle</th>
1566 <th>Résultat de la substitution</th>
1567 </tr>
1568
1569 <tr>
1570 <td>^/un_chemin(.*) autre_chemin$1</td>
1571 <td>invalide, non supporté</td>
1572 </tr>
1573
1574 <tr>
1575 <td>^/un_chemin(.*) autre_chemin$1  [R]</td>
1576 <td>invalide, non supporté</td>
1577 </tr>
1578
1579 <tr>
1580 <td>^/un_chemin(.*) autre_chemin$1  [P]</td>
1581 <td>invalide, non supporté</td>
1582 </tr>
1583
1584 <tr>
1585 <td>^/un_chemin(.*) /autre_chemin$1</td>
1586 <td>/autre_chemin/info_chemin</td>
1587 </tr>
1588
1589 <tr>
1590 <td>^/un_chemin(.*) /autre_chemin$1 [R]</td>
1591 <td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
1592 </tr>
1593
1594 <tr>
1595 <td>^/un_chemin(.*) /autre_chemin$1 [P]</td>
1596 <td>sans objet, non supporté</td>
1597 </tr>
1598
1599 <tr>
1600 <td>^/un_chemin(.*) http://cet_hote/autre_chemin$1</td>
1601 <td>/autre_chemin/info_chemin</td>
1602 </tr>
1603
1604 <tr>
1605 <td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [R]</td>
1606 <td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
1607 </tr>
1608
1609 <tr>
1610 <td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P]</td>
1611 <td>sans objet, non supporté</td>
1612 </tr>
1613
1614 <tr>
1615 <td>^/un_chemin(.*) http://autre_hote/autre_chemin$1</td>
1616 <td>http://autre_hote/autre_chemin/info_chemin via une redirection externe</td>
1617 </tr>
1618
1619 <tr>
1620 <td>^/un_chemin(.*) http://autre_hote/autre_chemin$1 [R]</td>
1621 <td>http://autre_hote/autre_chemin/info_chemin (le drapeau [R] est
1622 redondant)</td>
1623 </tr>
1624
1625 <tr>
1626 <td>^/somepath(.*) http://otherhost/otherpath$1 [P]</td>
1627 <td>http://otherhost/otherpath/pathinfo via internal proxy</td>
1628 </tr>
1629 </table>
1630
1631       <p><strong>Dans une configuration de niveau répertoire pour
1632       <code>/chemin</code><br />
1633        (<code>/chemin/physique/vers/chemin/.htacccess</code>, avec
1634       <code>RewriteBase "/chemin"</code>)<br />
1635        pour la requête ``<code>GET
1636       /chemin/chemin-local/infochemin</code>'':</strong><br />
1637      </p>
1638
1639 <table border="1" style="zebra">
1640
1641 <tr>
1642 <th>Règle</th>
1643 <th>Résultat de la substitution</th>
1644 </tr>
1645
1646 <tr>
1647 <td>^chemin-local(.*) autre-chemin$1</td>
1648 <td>/chemin/autre-chemin/infochemin</td>
1649 </tr>
1650
1651 <tr>
1652 <td>^chemin-local(.*) autre-chemin$1  [R]</td>
1653 <td>http://cet-hôte/chemin/autre-chemin/infochemin via redirection
1654 externe</td>
1655 </tr>
1656
1657 <tr>
1658 <td>^chemin-local(.*) autre-chemin$1  [P]</td>
1659 <td>n'a pas lieu d'être, non supporté</td>
1660 </tr>
1661
1662 <tr>
1663 <td>^chemin-local(.*) /autre-chemin$1</td>
1664 <td>/autre-chemin/infochemin</td>
1665 </tr>
1666
1667 <tr>
1668 <td>^chemin-local(.*) /autre-chemin$1 [R]</td>
1669 <td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td>
1670 </tr>
1671
1672 <tr>
1673 <td>^chemin-local(.*) /autre-chemin$1 [P]</td>
1674 <td>n'a pas lieu d'être, non supporté</td>
1675 </tr>
1676
1677 <tr>
1678 <td>^chemin-local(.*) http://cet-hôte/autre-chemin$1</td>
1679 <td>/autre-chemin/infochemin</td>
1680 </tr>
1681
1682 <tr>
1683 <td>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [R]</td>
1684 <td>http://cet-hôte/autre-chemin/infochemin via redirection externe</td>
1685 </tr>
1686
1687 <tr>
1688 <td>^chemin-local(.*) http://cet-hôte/autre-chemin$1 [P]</td>
1689 <td>n'a pas lieu d'être, non supporté</td>
1690 </tr>
1691
1692 <tr>
1693 <td>^chemin-local(.*) http://autre hôte/autre-chemin$1</td>
1694 <td>http://autre hôte/autre-chemin/infochemin via redirection externe</td>
1695 </tr>
1696
1697 <tr>
1698 <td>^chemin-local(.*) http://autre hôte/autre-chemin$1 [R]</td>
1699 <td>http://autre hôte/autre-chemin/infochemin via redirection externe
1700 (le drapeau [R] est redondant)</td>
1701 </tr>
1702
1703 <tr>
1704 <td>^chemin-local(.*) http://autre hôte/autre-chemin$1 [P]</td>
1705 <td>http://autre hôte/autre-chemin/infochemin via un mandataire interne</td>
1706 </tr>
1707
1708 </table>
1709
1710   </usage>
1711  </directivesynopsis>
1712 </modulesynopsis>