granicus.if.org Git - apache/blob - docs/manual/rewrite/remapping.html.fr

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Redirection et remise en correspondance avec mod_rewrite - Serveur HTTP Apache Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  20 <p class="apache">Serveur HTTP Apache Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Redirection et remise en correspondance avec mod_rewrite</h1>
  25 <div class="toplang">
  26 <p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  27 <a href="../fr/rewrite/remapping.html" title="Français">&nbsp;fr&nbsp;</a></p>
  28 </div>
  29
  30
  31 <p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">Documentation de référence</a> de
  32 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il montre comment utiliser
  33 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour rediriger et remettre en
  34 correspondance une requête. Il contient de
  35 nombreux exemples d'utilisation courante de mod_rewrite avec une
  36 description détaillée de leur fonctionnement.</p>
  37
  38 <div class="warning">Vous devez vous attacher à comprendre le
  39 fonctionnement des exemples, car la plupart d'entre eux ne
  40 fonctionneront pas sur votre système si vous vous contentez de les
  41 copier/coller dans vos fichiers de configuration.</div>
  42
  43 </div>
  44 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#old-to-new">De l'ancienne à la nouvelle URL (en interne)</a></li>
  45 <li><img alt="" src="../images/down.gif" /> <a href="#old-to-new-extern">De l'ancien au nouveau (en externe)</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#movehomedirs">Ressource déplacée vers un autre serveur</a></li>
  47 <li><img alt="" src="../images/down.gif" /> <a href="#static-to-dynamic">De statique à dynamique</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
  49       d'extension de nom de fichier</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#canonicalhost">Noms d'hôtes canoniques</a></li>
  51 <li><img alt="" src="../images/down.gif" /> <a href="#multipledirs">Recherche de pages dans plus d'un répertoire</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a></li>
  53 <li><img alt="" src="../images/down.gif" /> <a href="#canonicalurl">URLs canoniques</a></li>
  54 <li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></li>
  55 <li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Ressource par défaut</a></li>
  56 <li><img alt="" src="../images/down.gif" /> <a href="#rewrite-query">Rewrite query string</a></li>
  57 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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><li><a href="#comments_section">Commentaires</a></li></ul></div>
  58 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  59 <div class="section">
  60 <h2><a name="old-to-new" id="old-to-new">De l'ancienne à la nouvelle URL (en interne)</a><a title="Lien permanent" href="#old-to-new" class="permalink">&para;</a></h2>
  61
  62
  63
  64       <dl>
  65         <dt>Description :</dt>
  66
  67         <dd>
  68           <p>Supposons que nous ayons récemment renommé la page
  69           <code>foo.html</code> en <code>bar.html</code>, et voulions
  70           maintenant que l'ancienne URL soit toujours valide à des fins
  71           de compatibilité ascendante. En fait, on voudrait que le
  72           changement de nom soit transparent aux utilisateurs de
  73           l'ancienne URL.</p>
  74         </dd>
  75
  76         <dt>Solution :</dt>
  77
  78         <dd>
  79           <p>On réécrit l'ancienne URL en interne vers la nouvelle via
  80           la règle suivante :</p>
  81
  82 <pre class="prettyprint lang-config">RewriteEngine  on
  83 RewriteRule    "^<strong>/foo</strong>\.html$" "<strong>/bar</strong>.html" [PT]</pre>
  84
  85     </dd>
  86   </dl>
  87
  88 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  89 <div class="section">
  90 <h2><a name="old-to-new-extern" id="old-to-new-extern">De l'ancien au nouveau (en externe)</a><a title="Lien permanent" href="#old-to-new-extern" class="permalink">&para;</a></h2>
  91
  92
  93
  94       <dl>
  95         <dt>Description :</dt>
  96
  97         <dd>
  98           <p>Supposons toujours que nous ayons récemment renommé la page
  99           <code>foo.html</code> en <code>bar.html</code>, et voulions
 100           maintenant que l'ancienne URL soit toujours valide à des fins
 101           de compatibilité ascendante. En revanche, nous voulons cette
 102           fois que la nouvelle URL soit suggérée aux utilisateurs de
 103           l'ancienne URL, c'est à dire que l'adresse vue depuis leur
 104           navigateur doit également être modifiée.</p>
 105         </dd>
 106
 107         <dt>Solution :</dt>
 108
 109         <dd>
 110           <p>On force une redirection HTTP vers la nouvelle URL, ce qui
 111           entraîne une modification de celle du navigateur et aussi de ce
 112           que voit l'utilisateur :</p>
 113
 114 <pre class="prettyprint lang-config">RewriteEngine  on
 115 RewriteRule    "^<strong>foo</strong>\.html$"  "<strong>bar</strong>.html"  [<strong>R</strong>]</pre>
 116
 117 </dd>
 118
 119 <dt>Discussion</dt>
 120
 121     <dd>
 122     <p>Dans l'exemple <a href="#old-to-new-intern">interne</a>, on a utilisé mod_rewrite afin
 123     de dissimuler la redirection au client. Dans cet exemple, en
 124     revanche, on aurait pu se contenter d'une directive Redirect :</p>
 125
 126     <pre class="prettyprint lang-config">Redirect "/foo.html" "/bar.html"</pre>
 127
 128
 129     </dd>
 130   </dl>
 131
 132 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 133 <div class="section">
 134 <h2><a name="movehomedirs" id="movehomedirs">Ressource déplacée vers un autre serveur</a><a title="Lien permanent" href="#movehomedirs" class="permalink">&para;</a></h2>
 135
 136
 137
 138   <dl>
 139     <dt>Description :</dt>
 140
 141     <dd>
 142       <p>Si une ressource a été déplacée vers un autre serveur, vous
 143       pouvez faire en sorte que les URLs de l'ancien serveur continuent
 144       de fonctionner pendant un certain temps, afin de laisser au
 145       utilisateurs le temps de modifier leurs favoris.</p>
 146     </dd>
 147
 148     <dt>Solution :</dt>
 149
 150     <dd>
 151       <p>Vous pouvez utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour
 152       rediriger ces URLs vers le nouveau serveur, mais vous pouvez aussi
 153       utiliser les directives Redirect ou RedirectMatch.</p>
 154
 155 <pre class="prettyprint lang-config">#Avec mod_rewrite
 156 RewriteEngine on
 157 RewriteRule   "^/docs/(.+)"  "http://nouveau.example.com/docs/$1"  [R,L]</pre>
 158
 159
 160 <pre class="prettyprint lang-config">#Avec RedirectMatch
 161 RedirectMatch "^/docs/(.*)" "http://nouveau.example.com/docs/$1"</pre>
 162
 163
 164 <pre class="prettyprint lang-config">#Avec Redirect
 165 Redirect "/docs/" "http://nouveau.example.com/docs/"</pre>
 166
 167     </dd>
 168   </dl>
 169
 170 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 171 <div class="section">
 172 <h2><a name="static-to-dynamic" id="static-to-dynamic">De statique à dynamique</a><a title="Lien permanent" href="#static-to-dynamic" class="permalink">&para;</a></h2>
 173
 174
 175
 176       <dl>
 177         <dt>Description :</dt>
 178
 179         <dd>
 180           <p>Comment transformer une page statique <code>foo.html</code>
 181           en sa variante dynamique <code>foo.cgi</code> de manière
 182           transparente, c'est à dire sans en avertir le
 183           navigateur/utilisateur.</p>
 184         </dd>
 185
 186         <dt>Solution :</dt>
 187
 188         <dd>
 189           <p>On réécrit simplement l'URL en script CGI et force le
 190           gestionnaire de contenu à <strong>cgi-script</strong> de façon
 191           à ce que le script s'exécute en tant que programme CGI.
 192           Ainsi, une requête vers <code>/~quux/foo.html</code> conduit
 193           en interne à l'invocation de
 194           <code>/~quux/foo.cgi</code>.</p>
 195
 196 <pre class="prettyprint lang-config">RewriteEngine  on
 197 RewriteBase    "/~quux/"
 198 RewriteRule    "^foo\.html$"  "foo.cgi"  [H=<strong>cgi-script</strong>]</pre>
 199
 200         </dd>
 201       </dl>
 202
 203     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 204 <div class="section">
 205 <h2><a name="backward-compatibility" id="backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
 206       d'extension de nom de fichier</a><a title="Lien permanent" href="#backward-compatibility" class="permalink">&para;</a></h2>
 207
 208
 209
 210       <dl>
 211         <dt>Description :</dt>
 212
 213         <dd>
 214           <p>Comment conférer une compatibilité ascendante aux URLs
 215           (existant encore virtuellement) après avoir migré
 216           <code>document.YYYY</code> vers <code>document.XXXX</code>,
 217           c'est à dire après avoir par exemple traduit un lot de
 218           fichiers <code>.html</code> en fichiers <code>.php</code>
 219           ?</p>
 220         </dd>
 221
 222         <dt>Solution :</dt>
 223
 224         <dd>
 225           <p>On réécrit simplement le nom du fichier en son nom
 226           de base et vérifie s'il existe aussi avec la nouvelle
 227           extension. Si c'est le cas, on utilise ce nom, sinon on
 228           réécrit l'URL sous sa forme originale.</p>
 229
 230
 231 <pre class="prettyprint lang-config">#   jeu de règles assurant une compatibilité ascendante en réécrivant<br />
 232 #   document.html en document.php si et seulement si document.php<br />
 233 #   existe
 234 &lt;Directory "/var/www/htdocs"&gt;
 235     RewriteEngine on
 236     RewriteBase "/var/www/htdocs"
 237
 238     RewriteCond "$1.php" -f
 239     RewriteCond "$1.html" !-f
 240     RewriteRule "^(.*).html$" "$1.php"
 241 &lt;/Directory&gt;</pre>
 242
 243     </dd>
 244
 245     <dt>Discussion</dt>
 246     <dd>
 247     <p>Cet exemple utilise une fonctionnalité souvent méconnue de
 248     mod_rewrite, en tirant avantage de l'ordre d'exécution du jeu de
 249     règles. En particulier, mod_rewrite évalue la partie gauche des
 250     règles de réécriture avant d'évaluer les directives RewriteCond. En
 251     conséquence, $1 est déjà défini au moment où les directives
 252     RewriteCond sont évaluées. Ceci nous permet de tester l'existence du
 253     fichier original (<code>document.html</code>) et du fichier cible
 254     (<code>document.php</code>) en utilisant le même nom de base.</p>
 255
 256     <p>Ce jeu de règles est conçu pour une utilisation dans un contexte
 257     de répertoire (au sein d'une section &lt;Directory&gt; ou d'un
 258     fichier .htaccess), de façon à ce que les vérifications
 259     <code>-f</code> effectuent leurs recherches dans le bon répertoire.
 260     Vous serez peut-être amené à définir une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> pour spécifier le
 261     répertoire de base à partir duquel vous travaillez.</p>
 262     </dd>
 263   </dl>
 264
 265 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 266 <div class="section">
 267 <h2><a name="canonicalhost" id="canonicalhost">Noms d'hôtes canoniques</a><a title="Lien permanent" href="#canonicalhost" class="permalink">&para;</a></h2>
 268
 269
 270
 271       <dl>
 272         <dt>Description :</dt>
 273
 274         <dd>Le but de cette règle est de préférer l'utilisation d'un nom
 275         d'hôte particulier à d'autres noms d'hôte utilisables
 276         pour atteindre le même site. Par exemple, si vous voulez
 277         utiliser <strong>www.example.com</strong> à la place de
 278         <strong>example.com</strong>, vous pouvez utiliser une solution
 279         du style :</dd>
 280
 281         <dt>Solution :</dt>
 282
 283         <dd>
 284
 285 <p>Pour y parvenir, il vaut mieux se passer de mod_rewrite, et utiliser
 286 plutôt la directive <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> dans
 287 une section de serveur virtuel pour le/les noms d'hôte non canoniques.</p>
 288
 289 <pre class="prettyprint lang-config">&lt;VirtualHost *:80&gt;
 290   ServerName undesired.example.com
 291   ServerAlias example.com notthis.example.com
 292
 293   Redirect "/" "http://www.example.com/"
 294 &lt;/VirtualHost&gt;
 295
 296 &lt;VirtualHost *:80&gt;
 297   ServerName www.example.com
 298 &lt;/VirtualHost&gt;</pre>
 299
 300
 301 <p>Vous pouvez aussi utiliser la directive <code class="directive"><a href="../mod/core.html#if">&lt;If&gt;</a></code> (versions 2.4 et ultérieures) :</p>
 302
 303 <pre class="prettyprint lang-config">&lt;If "%{HTTP_HOST} != 'www.example.com'"&gt;
 304         Redirect "/" "http://www.example.com/"
 305 &lt;/If&gt;</pre>
 306
 307
 308 <p>Ou, par exemple, pour rediriger une portion de votre site vers HTTPS
 309 :</p>
 310
 311 <pre class="prettyprint lang-config">&lt;If "%{SERVER_PROTOCOL} != 'HTTPS'"&gt;
 312         Redirect "/admin/" "https://www.example.com/admin/"
 313 &lt;/If&gt;</pre>
 314
 315
 316 <p>Si, pour une raison particulière, vous voulez tout de même utiliser
 317 <code>mod_rewrite</code> - dans le cas, par exemple, où vous avez besoin
 318 d'un jeu plus important de règles de réécritures - vous pouvez utiliser
 319 la recette suivante :</p>
 320
 321 <p>Pour les sites écoutant sur un port autre que 80:</p>
 322 <pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}"   "!^www\.example\.com" [NC]
 323 RewriteCond "%{HTTP_HOST}"   "!^$"
 324 RewriteCond "%{SERVER_PORT}" "!^80$"
 325 RewriteRule "^/?(.*)"         "http://www.example.com:%{SERVER_PORT}/$1" [L,R,NE]</pre>
 326
 327
 328 <p>Et pour un site écoutant sur le port 80</p>
 329 <pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}"   "!^www\.example\.com" [NC]
 330 RewriteCond "%{HTTP_HOST}"   "!^$"
 331 RewriteRule "^/?(.*)"         "http://www.example.com/$1" [L,R,NE]</pre>
 332
 333         <p>
 334         Si vous souhaitez que cette règle s'applique à tous les noms de
 335         domaine - en d'autres termes, si vous voulez rediriger
 336         <strong>example.com</strong> vers
 337         <strong>www.example.com</strong> pour toutes les valeurs
 338         possibles de <strong>example.com</strong>, vous pouvez utiliser
 339         le jeu de règles suivants :</p>
 340
 341 <pre class="prettyprint lang-config">RewriteCond "%{HTTP_HOST}" "!^www\." [NC]
 342 RewriteCond "%{HTTP_HOST}" "!^$"
 343 RewriteRule "^/?(.*)" "http://www.%{HTTP_HOST}/$1" [L,R,NE]</pre>
 344
 345         <p>
 346         Vous pouvez utiliser ce jeu de règles aussi bien dans le fichier
 347         de configuration de votre serveur principal que dans un fichier
 348         <code>.htaccess</code> placé dans le répertoire défini par la
 349         directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du serveur.</p>
 350         </dd>
 351       </dl>
 352
 353     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 354 <div class="section">
 355 <h2><a name="multipledirs" id="multipledirs">Recherche de pages dans plus d'un répertoire</a><a title="Lien permanent" href="#multipledirs" class="permalink">&para;</a></h2>
 356
 357
 358
 359   <dl>
 360     <dt>Description:</dt>
 361
 362     <dd>
 363       <p>Une ressource peut exister dans plusieurs répertoires, et nous
 364       voulons rechercher cette ressource dans ces répertoires
 365       lorsqu'elle fait l'objet d'une requête. Il est possible que nous
 366       ayons récemment réorganisé la structure de notre site en
 367       répartissant son contenu dans plusieurs répertoires.</p>
 368     </dd>
 369
 370     <dt>Solution :</dt>
 371
 372     <dd>
 373       <p>Le jeu de règles suivant recherche la ressource dans deux
 374       répertoires, et s'il ne la trouve dans aucun des deux, il tentera
 375       simplement de la servir à partir de l'adresse fournie dans la
 376       requête.</p>
 377
 378 <pre class="prettyprint lang-config">RewriteEngine on
 379
 380 #   on cherche tout d'abord dans dir1/...
 381 #   ... et si on trouve, on est content et on arrête :
 382 RewriteCond         "%{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI}"  -f
 383 RewriteRule  "^(.+)"  "%{DOCUMENT_ROOT}/<strong>dir1</strong>/$1"  [L]
 384
 385 #   on cherche ensuite dans dir2/...
 386 #   ... et si on trouve, on est content et on arrête :
 387 RewriteCond         "%{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI}"  -f
 388 RewriteRule  "^(.+)"  "%{DOCUMENT_ROOT}/<strong>dir2</strong>/$1"  [L]
 389
 390 #   sinon, on continue la recherche avec d'autres directives Alias
 391 #   ou ScriptAlias, etc...
 392 RewriteRule   "^"  "-"  [PT]</pre>
 393
 394         </dd>
 395       </dl>
 396
 397     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 398 <div class="section">
 399 <h2><a name="archive-access-multiplexer" id="archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a><a title="Lien permanent" href="#archive-access-multiplexer" class="permalink">&para;</a></h2>
 400
 401
 402
 403   <dl>
 404     <dt>Description :</dt>
 405
 406     <dd>
 407     <p>Notre site web possède de nombreux miroirs, et nous voulons
 408     rediriger les utilisateurs vers celui qui se situe dans le pays où
 409     ils se trouvent. </p>
 410     </dd>
 411
 412     <dt>Solution :</dt>
 413
 414     <dd>
 415     <p>En consultant le nom d'hôte du client demandeur, on détermine le
 416     pays dans lequel il se trouve. S'il est impossible d'effectuer une
 417     recherche sur leur adresse IP, on se rabat sur un serveur par
 418     défaut.</p>
 419     <p>Nous allons utiliser une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> afin de construire une
 420     liste des serveurs que nous voulons utiliser.</p>
 421
 422 <pre class="prettyprint lang-config">HostnameLookups on
 423 RewriteEngine on
 424 RewriteMap    multiplex         "txt:/path/to/map.mirrors"
 425 RewriteCond  "%{REMOTE_HOST}"     "([a-z]+)$ [NC]"
 426 RewriteRule   "^/(.*)$"  "${multiplex:<strong>%1</strong>|http://www.example.com/}$1"  [R,L]</pre>
 427
 428
 429 <div class="example"><p><code>
 430 ##  liste_miroirs -- Table de correspondance pays - serveurs<br />
 431 <br />
 432 de        http://www.exemple.de/<br />
 433 uk        http://www.exemple.uk/<br />
 434 com       http://www.example.com/<br />
 435 ##EOF##
 436 </code></p></div>
 437     </dd>
 438
 439     <dt>Discussion</dt>
 440     <dd>
 441     <div class="warning">Ce jeu de règles nécessite la définition à
 442     <code>on</code> de la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostNameLookups</a></code>, ce qui peut induire une
 443     baisse de performance significative.</div>
 444
 445     <p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> extrait la dernière
 446     partie du nom d'hôte du client demandeur - le code du pays - et la
 447     règle de réécriture qui suit utilise cette valeur pour rechercher le
 448     serveur miroir approprié dans le fichier de correspondances.</p>
 449     </dd>
 450   </dl>
 451
 452 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 453 <div class="section">
 454 <h2><a name="canonicalurl" id="canonicalurl">URLs canoniques</a><a title="Lien permanent" href="#canonicalurl" class="permalink">&para;</a></h2>
 455
 456
 457
 458 <dl>
 459  <dt>Description :</dt>
 460
 461    <dd>
 462      <p>Sur certains serveurs, une ressource peut posséder plusieurs
 463      URLs. Il y a en général les URLs canoniques (celles qui sont
 464      réellement distribuées et utilisées), et celles qui correspondent à
 465      des raccourcis, les URLs internes, etc... Quelle que soit l'adresse
 466      que l'utilisateur fournit dans la requête, il devrait finalement
 467      voir l'URL canonique dans la barre d'adresse de son navigateur.</p>
 468    </dd>
 469
 470    <dt>Solution :</dt>
 471
 472      <dd>
 473        <p>Nous effectuons une redirection HTTP externe pour toutes les
 474        URLs non canoniques afin de les corriger dans la barre d'adresse
 475        du navigateur, et ceci pour toutes les requêtes futures. Dans le
 476        jeu de règles suivant, nous remplaçons <code>/matous</code> et
 477        <code>/minettes</code> par le canonique <code>/chats</code>.</p>
 478
 479         <pre class="prettyprint lang-config">RewriteRule   "^/(matous|minettes)/(.*)"    "/chats/$2"  [R]</pre>
 480
 481         </dd>
 482
 483      <dt>Discussion :</dt>
 484      <dd>On serait mieux inspiré d'utiliser ici les directives Redirect ou
 485      RedirectMatch :
 486
 487      <pre class="prettyprint lang-config">RedirectMatch "^/(matous|minettes)/(.*)" "/chats/$2"</pre>
 488
 489      </dd>
 490       </dl>
 491
 492 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 493 <div class="section">
 494 <h2><a name="moveddocroot" id="moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a><a title="Lien permanent" href="#moveddocroot" class="permalink">&para;</a></h2>
 495
 496
 497
 498   <dl>
 499     <dt>Description :</dt>
 500
 501     <dd>
 502 <p>En général, le répertoire <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du serveur web correspond à l'URL
 503 "<code>/</code>". Ce répertoire ne contient cependant pas forcément des
 504 ressources de première importance pour l'utilisateur. Par exemple, vous
 505 préférerez peut-être que le répertoire d'accueil d'un visiteur accédant
 506 pour la première fois à votre site soit un répertoire particulier
 507 <code>/a-propos-de/</code>. Pour y parvenir, utilisez le jeu de règles
 508 suivant :</p>
 509 </dd>
 510
 511     <dt>Solution :</dt>
 512
 513     <dd>
 514       <p>On redirige l'URL <code>/</code> vers
 515       <code>/a-propos-de/</code> :
 516       </p>
 517
 518 <pre class="prettyprint lang-config">RewriteEngine on
 519 RewriteRule   "^/$"  "/a-propos-de/"  [<strong>R</strong>]</pre>
 520
 521
 522 <p>Notez que l'on peut aussi y parvenir en utilisant la directive
 523 <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> :</p>
 524
 525 <pre class="prettyprint lang-config">RedirectMatch "^/$" "http://example.com/a-propos-de/"</pre>
 526
 527
 528 <p>Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres
 529 termes, il réécrit une requête pour <code>http://example.com/</code>,
 530 mais pas pour une requête <code>http://example.com/page.html</code>. Si
 531 vous avez effectivement modifié la racine de vos documents - c'est à dire
 532 si <strong>tous</strong> vos contenus se trouvent dans un
 533 sous-répertoire, il est largement préférable de modifier simplement
 534 votre directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, ou de
 535 déplacer l'ensemble du contenu vers le répertoire supérieur, plutôt que
 536 de réécrire les URLs.</p>
 537 </dd>
 538 </dl>
 539
 540 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 541 <div class="section">
 542 <h2><a name="fallback-resource" id="fallback-resource">Ressource par défaut</a><a title="Lien permanent" href="#fallback-resource" class="permalink">&para;</a></h2>
 543
 544
 545 <dl>
 546 <dt>Description :</dt>
 547 <dd>Vous voulez qu'une seule ressource (disons un certain fichier tel
 548 que index.php) soit servie pour toutes les requêtes à destination d'un
 549 certain répertoire, sauf pour celles qui concernent une ressource
 550 existant effectivement comme une image, ou un fichier css.</dd>
 551
 552 <dt>Solution :</dt>
 553 <dd>
 554 <p>Depuis la version 2.2.16, vous pouvez y parvenir via la directive
 555 <code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code> :</p>
 556
 557 <pre class="prettyprint lang-config">&lt;Directory "/var/www/my_blog"&gt;
 558   FallbackResource index.php
 559 &lt;/Directory&gt;</pre>
 560
 561
 562 <p>Cependant, si vos besoins étaient plus complexes, vous pouviez, dans
 563 les versions plus anciennes d'Apache, utiliser un jeu de règles du style
 564 :</p>
 565
 566 <pre class="prettyprint lang-config">&lt;Directory "/var/www/my_blog"&gt;
 567   RewriteBase "/my_blog"
 568
 569   RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-f
 570   RewriteCond "/var/www/my_blog/%{REQUEST_FILENAME}" !-d
 571   RewriteRule "^" "index.php" [PT]
 572 &lt;/Directory&gt;</pre>
 573
 574
 575 <p>D'autre part, si vous voulez transmettre l'URI de la requête en tant
 576 que chaîne de paramètres à index.php, vous pouvez remplacer cette règle
 577 de réécriture par :</p>
 578
 579 <pre class="prettyprint lang-config">RewriteRule "(.*)" "index.php?$1" [PT,QSA]</pre>
 580
 581
 582 <p>Notez que l'on peut utiliser ces jeux de règles aussi bien dans un
 583 fichier <code>.htaccess</code> que dans une section
 584 &lt;Directory&gt;.</p>
 585
 586 </dd>
 587
 588 </dl>
 589
 590 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 591 <div class="section">
 592 <h2><a name="rewrite-query" id="rewrite-query">Rewrite query string</a><a title="Lien permanent" href="#rewrite-query" class="permalink">&para;</a></h2>
 593
 594
 595 <dl>
 596 <dt>Description :</dt>
 597 <dd>Vous voulez extraire une valeur particulière d'une chaîne de
 598 paramètres d'une URL, et soit la remplacer, soit l'incorporer dans un
 599 autre composant de l'URL.</dd>
 600
 601 <dt>Solutions :</dt>
 602 <dd>
 603 <p>Dans la plupart des solutions de cette section, on utilise la même
 604 condition qui stocke la valeur recherchée dans la référence arrière %2.
 605 %1 est le début de la requête, et %3 ce qui reste. Cette condition est
 606 un peu complexe car elle introduit de la flexibilité et évite les
 607 doubles perluettes '&amp;&amp;' dans les substitutions.</p>
 608 <ul>
 609   <li>Cette solution supprime le couple clé/valeur recherché :
 610
 611 <pre class="prettyprint lang-config"># Remove mykey=???
 612 RewriteCond "%{QUERY_STRING}" "(.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$"
 613 RewriteRule "(.*)" "$1?%1%3"</pre>
 614
 615   </li>
 616
 617   <li>Cette solution remplace la partie de l'URL qui suit la valeur
 618   recherchée par un '?' :
 619
 620 <pre class="prettyprint lang-config"># Copy from query string to PATH_INFO
 621 RewriteCond "%{QUERY_STRING}" "(.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$"
 622 RewriteRule "(.*)" "$1/products/%2/?" [PT]</pre>
 623
 624   </li>
 625
 626   <li>Cette solution utilise la valeur recherchée dans une deuxième
 627   condition ::
 628
 629 <pre class="prettyprint lang-config"># Capture the value of mykey in the query string
 630 RewriteCond "%{QUERY_STRING}" "(.*(?:^|&amp;))mykey=([^&amp;]*)&amp;?(.*)&amp;?$""
 631 RewriteCond "%2" !=not-so-secret-value
 632 RewriteRule "(.*)" - [F]</pre>
 633
 634   </li>
 635
 636   <li>Cette solution produit l'effet inverse des précédentes ; elle
 637   copie des composantes du chemin (peut-être PATH_INFO) depuis l'URL
 638   vers sa chaîne de paramètres :
 639 <pre class="prettyprint lang-config"># The desired URL might be /products/kitchen-sink, and the script expects
 640 # /path?products=kitchen-sink.
 641 RewriteRule "^/?path/([^/]+)/([^/]+)" "/path?$1=$2" [PT]</pre>
 642
 643   </li>
 644 </ul>
 645
 646 </dd>
 647
 648 </dl>
 649 </div></div>
 650 <div class="bottomlang">
 651 <p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 652 <a href="../fr/rewrite/remapping.html" title="Français">&nbsp;fr&nbsp;</a></p>
 653 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 654 <script type="text/javascript"><!--//--><![CDATA[//><!--
 655 var comments_shortname = 'httpd';
 656 var comments_identifier = 'http://httpd.apache.org/docs/trunk/rewrite/remapping.html';
 657 (function(w, d) {
 658     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 659         d.write('<div id="comments_thread"><\/div>');
 660         var s = d.createElement('script');
 661         s.type = 'text/javascript';
 662         s.async = true;
 663         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 664         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 665     }
 666     else {
 667         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 668     }
 669 })(window, document);
 670 //--><!]]></script></div><div id="footer">
 671 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 672 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 673 if (typeof(prettyPrint) !== 'undefined') {
 674     prettyPrint();
 675 }
 676 //--><!]]></script>
 677 </body></html>