You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2012/10/28 18:46:04 UTC
svn commit: r1403053 - in /httpd/httpd/branches/2.4.x/docs/manual/rewrite:
remapping.html remapping.html.fr remapping.xml.fr
Author: gryzor
Date: Sun Oct 28 17:46:03 2012
New Revision: 1403053
URL: http://svn.apache.org/viewvc?rev=1403053&view=rev
Log:
Adding .fr translation for rewrite's remapping doc
Added:
httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html.fr
httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.xml.fr
Modified:
httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html
Modified: httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html?rev=1403053&r1=1403052&r2=1403053&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html Sun Oct 28 17:46:03 2012
@@ -3,3 +3,7 @@
URI: remapping.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+
+URI: remapping.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
Added: httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html.fr?rev=1403053&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.html.fr Sun Oct 28 17:46:03 2012
@@ -0,0 +1,691 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Redirection et remise en correspondance avec mod_rewrite - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<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" />
+<script src="../style/scripts/prettify.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.4</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.4</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Redirection et remise en correspondance avec mod_rewrite</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/remapping.html" title="Français"> fr </a></p>
+</div>
+
+
+<p>Ce document est un complément à la <a href="../mod/mod_rewrite.html">Documentation de référence</a> de
+<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il montre comment utiliser
+<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour rediriger et remettre en
+correspondance une requête. Il contient de
+nombreux exemples d'utilisation courante de mod_rewrite avec une
+description détaillée de leur fonctionnement.</p>
+
+<div class="warning">Vous devez vous attacher à comprendre le
+fonctionnement des exemples, car la plupart d'entre eux ne
+fonctionneront pas sur votre système si vous vous contentez de les
+copier/coller dans vos fichiers de configuration.</div>
+
+</div>
+<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>
+<li><img alt="" src="../images/down.gif" /> <a href="#old-to-new-extern">De l'ancien au nouveau (en externe)</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#movehomedirs">Ressource déplacée vers un autre serveur</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#static-to-dynamic">De statique à dynamique</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
+ d'extension de nom de fichier</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#canonicalhost">Noms d'hôtes canoniques</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#multipledirs">Recherche de pages dans plus d'un répertoire</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#browser-dependent-content">Contenu dépendant du navigateur</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#canonicalurl">URLs canoniques</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Ressource par défaut</a></li>
+</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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="old-to-new" id="old-to-new">De l'ancienne à la nouvelle URL (en interne)</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons que nous ayons récemment renommé la page
+ <code>foo.html</code> en <code>bar.html</code>, et voulions
+ maintenant que l'ancienne URL soit toujours valide à des fins
+ de compatibilité ascendante. En fait, on voudrait que le
+ changement de nom soit transparent aux utilisateurs de
+ l'ancienne URL.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit l'ancienne URL en interne vers la nouvelle via
+ la règle suivante :</p>
+
+<pre class="prettyprint lang-config">
+RewriteEngine on
+RewriteRule ^<strong>/foo</strong>\.html$ <strong>/bar</strong>.html [PT]
+</pre>
+
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="old-to-new-extern" id="old-to-new-extern">De l'ancien au nouveau (en externe)</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons toujours que nous ayons récemment renommé la page
+ <code>foo.html</code> en <code>bar.html</code>, et voulions
+ maintenant que l'ancienne URL soit toujours valide à des fins
+ de compatibilité ascendante. En revanche, nous voulons cette
+ fois que la nouvelle URL soit suggérée aux utilisateurs de
+ l'ancienne URL, c'est à dire que l'adresse vue depuis leur
+ navigateur doit également être modifiée.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On force une redirection HTTP vers la nouvelle URL, ce qui
+ entraîne une modification de celle du navigateur et aussi de ce
+ que voit l'utilisateur :</p>
+
+<pre class="prettyprint lang-config">
+RewriteEngine on
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html [<strong>R</strong>]
+</pre>
+
+</dd>
+
+<dt>Discussion</dt>
+
+ <dd>
+ <p>Dans l'exemple <a href="#old-to-new-intern">interne</a>, on a utilisé mod_rewrite afin
+ de dissimuler la redirection au client. Dans cet exemple, en
+ revanche, on aurait pu se contenter d'une directive Redirect :</p>
+
+ <pre class="prettyprint lang-config">Redirect /foo.html /bar.html</pre>
+
+
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="movehomedirs" id="movehomedirs">Ressource déplacée vers un autre serveur</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Si une ressource a été déplacée vers un autre serveur, vous
+ pouvez faire en sorte que les URLs de l'ancien serveur continuent
+ de fonctionner pendant un certain temps, afin de laisser au
+ utilisateurs le temps de modifier leurs favoris.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Vous pouvez utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour
+ rediriger ces URLs vers le nouveau serveur, mais vous pouvez aussi
+ utiliser les directives Redirect ou RedirectMatch.</p>
+
+<pre class="prettyprint lang-config">#Avec mod_rewrite
+RewriteEngine on
+RewriteRule ^/docs/(.+) http://nouveau.example.com/docs/$1 [R,L]
+</pre>
+
+
+<pre class="prettyprint lang-config">#Avec RedirectMatch
+RedirectMatch ^/docs/(.*) http://nouveau.example.com/docs/$1
+</pre>
+
+
+<pre class="prettyprint lang-config">#Avec Redirect
+Redirect /docs/ http://nouveau.example.com/docs/
+</pre>
+
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="static-to-dynamic" id="static-to-dynamic">De statique à dynamique</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment transformer une page statique <code>foo.html</code>
+ en sa variante dynamique <code>foo.cgi</code> de manière
+ transparente, c'est à dire sans en avertir le
+ navigateur/utilisateur.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit simplement l'URL en script CGI et force le
+ gestionnaire de contenu à <strong>cgi-script</strong> de façon
+ à ce que le script s'exécute en tant que programme CGI.
+ Ainsi, une requête vers <code>/~quux/foo.html</code> conduit
+ en interne à l'invocation de
+ <code>/~quux/foo.cgi</code>.</p>
+
+<pre class="prettyprint lang-config">
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo\.html$ foo.cgi [H=<strong>cgi-script</strong>]
+</pre>
+
+ </dd>
+ </dl>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="backward-compatibility" id="backward-compatibility">Compatibilité ascendante dans le cadre d'une modification
+ d'extension de nom de fichier</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment conférer une compatibilité ascendante aux URLs
+ (existant encore virtuellement) après avoir migré
+ <code>document.YYYY</code> vers <code>document.XXXX</code>,
+ c'est à dire après avoir par exemple traduit un lot de
+ fichiers <code>.html</code> en fichiers <code>.php</code>
+ ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit simplement le nom du fichier en son nom
+ de base et vérifie s'il existe aussi avec la nouvelle
+ extension. Si c'est le cas, on utilise ce nom, sinon on
+ réécrit l'URL sous sa forme originale.</p>
+
+
+<pre class="prettyprint lang-config">
+# jeu de règles assurant une compatibilité ascendante en réécrivant<br />
+# document.html en document.php si et seulement si document.php<br />
+# existe
+<Directory /var/www/htdocs>
+ RewriteEngine on
+ RewriteBase /var/www/htdocs
+
+ RewriteCond $1.php -f
+ RewriteCond $1.html !-f
+ RewriteRule ^(.*).html$ $1.php
+</Directory>
+</pre>
+
+ </dd>
+
+ <dt>Discussion</dt>
+ <dd>
+ <p>Cet exemple utilise une fonctionnalité souvent méconnue de
+ mod_rewrite, en tirant avantage de l'ordre d'exécution du jeu de
+ règles. En particulier, mod_rewrite évalue la partie gauche des
+ règles de réécriture avant d'évaluer les directives RewriteCond. En
+ conséquence, $1 est déjà défini au moment où les directives
+ RewriteCond sont évaluées. Ceci nous permet de tester l'existence du
+ fichier original (<code>document.html</code>) et du fichier cible
+ (<code>document.php</code>) en utilisant le même nom de base.</p>
+
+ <p>Ce jeu de règles est conçu pour une utilisation dans un contexte
+ de répertoire (au sein d'une section <Directory> ou d'un
+ fichier .htaccess), de façon à ce que les vérifications
+ <code>-f</code> effectuent leurs recherches dans le bon répertoire.
+ 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
+ répertoire de base à partir duquel vous travaillez.</p>
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="canonicalhost" id="canonicalhost">Noms d'hôtes canoniques</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>Le but de cette règle est de préférer l'utilisation d'un nom
+ d'hôte particulier à d'autres noms d'hôte utilisables
+ pour atteindre le même site. Par exemple, si vous voulez
+ utiliser <strong>www.example.com</strong> à la place de
+ <strong>example.com</strong>, vous pouvez utiliser une solution
+ du style :</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+
+<p>Pour y parvenir, il vaut mieux se passer de mod_rewrite, et utiliser
+plutôt la directive <code class="directive"><a href="../mod/mod_alias.html#redirect">Redirect</a></code> dans
+une section de serveur virtuel pour le/les noms d'hôte non canoniques.</p>
+
+<pre class="prettyprint lang-config">
+<VirtualHost *:80>
+ ServerName undesired.example.com
+ ServerAlias example.com notthis.example.com
+
+ Redirect / http://www.example.com/
+</VirtualHost>
+
+<VirtualHost *:80>
+ ServerName www.example.com
+</VirtualHost>
+</pre>
+
+
+<p>Vous pouvez aussi utiliser la directive <code class="directive"><a href="../mod/core.html#if"><If></a></code> :</p>
+
+<pre class="prettyprint lang-config">
+<If "%{HTTP_HOST} != 'www.example.com'">
+ Redirect / http://www.example.com/
+</If>
+</pre>
+
+
+<p>Ou, par exemple, pour rediriger une portion de votre site vers HTTPS
+:</p>
+
+<pre class="prettyprint lang-config">
+<If "%{SERVER_PROTOCOL} != 'HTTPS'">
+ Redirect /admin/ https://www.example.com/admin/
+</If>
+</pre>
+
+
+<p>Si, pour une raison particulière, vous voulez tout de même utiliser
+<code>mod_rewrite</code> - dans le cas, par exemple, où vous avez besoin
+d'un jeu plus important de règles de réécritures - vous pouvez utiliser
+la recette suivante :</p>
+
+<p>Pour les sites écoutant sur un port autre que 80:</p>
+<pre class="prettyprint lang-config">
+RewriteCond %{HTTP_HOST} !^www\.example\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*) http://www.example.com:%{SERVER_PORT}/$1 [L,R,NE]
+</pre>
+
+
+<p>Et pour un site écoutant sur le port 80</p>
+<pre class="prettyprint lang-config">
+RewriteCond %{HTTP_HOST} !^www\.example\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.example.com/$1 [L,R,NE]
+</pre>
+
+ <p>
+ Si vous souhaitez que cette règle s'applique à tous les noms de
+ domaine - en d'autres termes, si vous voulez rediriger
+ <strong>example.com</strong> vers
+ <strong>www.example.com</strong> pour toutes les valeurs
+ possibles de <strong>example.com</strong>, vous pouvez utiliser
+ le jeu de règles suivants :</p>
+
+<pre class="prettyprint lang-config">
+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+</pre>
+
+ <p>
+ Vous pouvez utiliser ce jeu de règles aussi bien dans le fichier
+ de configuration de votre serveur principal que dans un fichier
+ <code>.htaccess</code> placé dans le répertoire défini par la
+ directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du serveur.</p>
+ </dd>
+ </dl>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="multipledirs" id="multipledirs">Recherche de pages dans plus d'un répertoire</a></h2>
+
+
+
+ <dl>
+ <dt>Description:</dt>
+
+ <dd>
+ <p>Une ressource peut exister dans plusieurs répertoires, et nous
+ voulons rechercher cette ressource dans ces répertoires
+ lorsqu'elle fait l'objet d'une requête. Il est possible que nous
+ ayons récemment réorganisé la structure de notre site en
+ répartissant son contenu dans plusieurs répertoires.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Le jeu de règles suivant recherche la ressource dans deux
+ répertoires, et s'il ne la trouve dans aucun des deux, il tentera
+ simplement de la servir à partir de l'adresse fournie dans la
+ requête.</p>
+
+<pre class="prettyprint lang-config">
+RewriteEngine on
+
+# on cherche tout d'abord dans dir1/...
+# ... et si on trouve, on est content et on arrête :
+RewriteCond %{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI} -f
+RewriteRule ^(.+) %{DOCUMENT_ROOT}/<strong>dir1</strong>/$1 [L]
+
+# on cherche ensuite dans dir2/...
+# ... et si on trouve, on est content et on arrête :
+RewriteCond %{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI} -f
+RewriteRule ^(.+) %{DOCUMENT_ROOT}/<strong>dir2</strong>/$1 [L]
+
+# sinon, on continue la recherche avec d'autres directives Alias
+# ou ScriptAlias, etc...
+RewriteRule ^ - [PT]
+</pre>
+
+ </dd>
+ </dl>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="archive-access-multiplexer" id="archive-access-multiplexer">Redirection vers des serveurs géographiquement distribués</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Notre site web possède de nombreux miroirs, et nous voulons
+ rediriger les utilisateurs vers celui qui se situe dans le pays où
+ ils se trouvent. </p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>En consultant le nom d'hôte du client demandeur, on détermine le
+ pays dans lequel il se trouve. S'il est impossible d'effectuer une
+ recherche sur leur adresse IP, on se rabat sur un serveur par
+ défaut.</p>
+ <p>Nous allons utiliser une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> afin de construire une
+ liste des serveurs que nous voulons utiliser.</p>
+
+<pre class="prettyprint lang-config">
+HostnameLookups on
+RewriteEngine on
+RewriteMap multiplex txt:/path/to/map.mirrors
+RewriteCond %{REMOTE_HOST} ([a-z]+)$ [NC]
+RewriteRule ^/(.*)$ ${multiplex:<strong>%1</strong>|http://www.example.com/}$1 [R,L]
+</pre>
+
+
+<div class="example"><p><code>
+## liste_miroirs -- Table de correspondance pays - serveurs<br />
+<br />
+de http://www.exemple.de/<br />
+uk http://www.exemple.uk/<br />
+com http://www.example.com/<br />
+##EOF##
+</code></p></div>
+ </dd>
+
+ <dt>Discussion</dt>
+ <dd>
+ <div class="warning">Ce jeu de règles nécessite la définition à
+ <code>on</code> de la directive <code class="directive"><a href="../mod/core.html#hostnamelookups">HostNameLookups</a></code>, ce qui peut induire une
+ baisse de performance significative.</div>
+
+ <p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> extrait la dernière
+ partie du nom d'hôte du client demandeur - le code du pays - et la
+ règle de réécriture qui suit utilise cette valeur pour rechercher le
+ serveur miroir approprié dans le fichier de correspondances.</p>
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="browser-dependent-content" id="browser-dependent-content">Contenu dépendant du navigateur</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Nous voulons fournir des contenus différents en fonction du
+ navigateur (user-agent) qui effectue la requête.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous devons déterminer quel contenu servir, en nous basant
+ sur l'en-tête HTTP "User-Agent". La
+ configuration suivante effectue ceci : si l'en-tête HTTP
+ "User-Agent" commence par "Mozilla/3", le nom de la page
+ <code>foo.html</code> est réécrit en <code>foo.NS.html</code>
+ et la réécriture s'arrête. Si le navigateur est "Lynx" ou
+ "Mozilla" version 1 ou 2, l'URL devient
+ <code>foo.20.html</code>. Tous les autres navigateurs
+ reçoivent la page <code>foo.32.html</code>. Tout ceci est
+ effectué par le jeu de règles suivant :</p>
+<pre class="prettyprint lang-config">
+RewriteCond %{HTTP_USER_AGENT} ^<strong>Mozilla/3</strong>.*
+RewriteRule ^foo\.html$ foo.<strong>NS</strong>.html [<strong>L</strong>]
+
+RewriteCond %{HTTP_USER_AGENT} ^Lynx/ [OR]
+RewriteCond %{HTTP_USER_AGENT} ^Mozilla/[12]
+RewriteRule ^foo\.html$ foo.<strong>20</strong>.html [<strong>L</strong>]
+
+RewriteRule ^foo\.html$ foo.<strong>32</strong>.html [<strong>L</strong>]
+</pre>
+
+ </dd>
+ </dl>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="canonicalurl" id="canonicalurl">URLs canoniques</a></h2>
+
+
+
+<dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Sur certains serveurs, une ressource peut posséder plusieurs
+ URLs. Il y a en général les URLs canoniques (celles qui sont
+ réellement distribuées et utilisées), et celles qui correspondent à
+ des raccourcis, les URLs internes, etc... Quelle que soit l'adresse
+ que l'utilisateur fournit dans la requête, il devrait finalement
+ voir l'URL canonique dans la barre d'adresse de son navigateur.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous effectuons une redirection HTTP externe pour toutes les
+ URLs non canoniques afin de les corriger dans la barre d'adresse
+ du navigateur, et ceci pour toutes les requêtes futures. Dans le
+ jeu de règles suivant, nous remplaçons <code>/matous</code> et
+ <code>/minettes</code> par le canonique <code>/chats</code>.</p>
+
+ <pre class="prettyprint lang-config">RewriteRule ^/(matous|minettes)/(.*) /chats/$2 [R]</pre>
+
+ </dd>
+
+ <dt>Discussion :</dt>
+ <dd>On serait mieux inspiré d'utiliser ici les directives Redirect ou
+ RedirectMatch :
+
+ <pre class="prettyprint lang-config"> RedirectMatch ^/(matous|minettes)/(.*) /chats/$2 </pre>
+
+ </dd>
+ </dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="moveddocroot" id="moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+<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
+"<code>/</code>". Ce répertoire ne contient cependant pas forcément des
+ressources de première importance pour l'utilisateur. Par exemple, vous
+préférerez peut-être que le répertoire d'accueil d'un visiteur accédant
+pour la première fois à votre site soit un répertoire particulier
+<code>/a-propos-de/</code>. Pour y parvenir, utilisez le jeu de règles
+suivant :</p>
+</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On redirige l'URL <code>/</code> vers
+ <code>/a-propos-de/</code> :
+ </p>
+
+<pre class="prettyprint lang-config">
+RewriteEngine on
+RewriteRule ^/$ /a-propos-de/ [<strong>R</strong>]
+</pre>
+
+
+<p>Notez que l'on peut aussi y parvenir en utilisant la directive
+<code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> :</p>
+
+<pre class="prettyprint lang-config">RedirectMatch ^/$
+http://example.com/a-propos-de/</pre>
+
+
+<p>Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres
+termes, il réécrit une requête pour <code>http://example.com/</code>,
+mais pas pour une requête <code>http://example.com/page.html</code>. Si
+vous avez effectivement modifié la racine de vos documents - c'est à dire
+si <strong>tous</strong> vos contenus se trouvent dans un
+sous-répertoire, il est largement préférable de modifier simplement
+votre directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, ou de
+déplacer l'ensemble du contenu vers le répertoire supérieur, plutôt que
+de réécrire les URLs.</p>
+</dd>
+</dl>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="fallback-resource" id="fallback-resource">Ressource par défaut</a></h2>
+
+
+<dl>
+<dt>Description :</dt>
+<dd>Vous voulez qu'une seule ressource (disons un certain fichier tel
+que index.php) soit servie pour toutes les requêtes à destination d'un
+certain répertoire, sauf pour celles qui concernent une ressource
+existant effectivement comme une image, ou un fichier css.</dd>
+
+<dt>Solution :</dt>
+<dd>
+<p>Depuis la version 2.2.16, vous pouvez y parvenir via la directive
+<code class="directive"><a href="../mod/mod_dir.html#fallbackresource">FallbackResource</a></code> :</p>
+
+<pre class="prettyprint lang-config">
+<Directory /var/www/my_blog>
+ FallbackResource index.php
+</Directory>
+</pre>
+
+
+<p>Cependant, si vos besoins étaient plus complexes, vous pouviez, dans
+les versions plus anciennes d'Apache, utiliser un jeu de règles du style
+:</p>
+
+<pre class="prettyprint lang-config">
+<Directory /var/www/my_blog>
+ RewriteBase /my_blog
+
+ RewriteCond /var/www/my_blog/%{REQUEST_FILENAME} !-f
+ RewriteCond /var/www/my_blog/%{REQUEST_FILENAME} !-d
+ RewriteRule ^ index.php [PT]
+</Directory>
+</pre>
+
+
+<p>D'autre part, si vous voulez transmettre l'URI de la requête en tant
+que chaîne de paramètres à index.php, vous pouvez remplacer cette règle
+de réécriture par :</p>
+
+<pre class="prettyprint lang-config">RewriteRule (.*) index.php?$1 [PT,QSA]</pre>
+
+
+<p>Notez que l'on peut utiliser ces jeux de règles aussi bien dans un
+fichier <code>.htaccess</code> que dans une section
+<Directory>.</p>
+
+</dd>
+
+</dl>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/remapping.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/remapping.html" title="Français"> fr </a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/rewrite/remapping.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.xml.fr?rev=1403053&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.xml.fr (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/rewrite/remapping.xml.fr Sun Oct 28 17:46:03 2012
@@ -0,0 +1,650 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 1363237 -->
+<!-- French translation : Lucien GENTIS -->
+<!-- Reviewed by : Vincent Deffontaines -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="remapping.xml.meta">
+ <parentdocument href="./">Rewrite</parentdocument>
+
+<title>Redirection et remise en correspondance avec mod_rewrite</title>
+
+<summary>
+
+<p>Ce document est un complément à la <a
+href="../mod/mod_rewrite.html">Documentation de référence</a> de
+<module>mod_rewrite</module>. Il montre comment utiliser
+<module>mod_rewrite</module> pour rediriger et remettre en
+correspondance une requête. Il contient de
+nombreux exemples d'utilisation courante de mod_rewrite avec une
+description détaillée de leur fonctionnement.</p>
+
+<note type="warning">Vous devez vous attacher à comprendre le
+fonctionnement des exemples, car la plupart d'entre eux ne
+fonctionneront pas sur votre système si vous vous contentez de les
+copier/coller dans vos fichiers de configuration.</note>
+
+</summary>
+<seealso><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></seealso>
+<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
+<!--<seealso><a href="remapping.html">Redirection et remise en
+correspondance</a></seealso>-->
+<seealso><a href="access.html">Contrôler l'accès</a></seealso>
+<seealso><a href="vhosts.html">Serveurs virtuels</a></seealso>
+<seealso><a href="proxy.html">Serveurs mandataires</a></seealso>
+<seealso><a href="rewritemap.html">Utilisation de RewriteMap</a></seealso>
+<seealso><a href="advanced.html">Techniques avancées</a></seealso>
+<seealso><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></seealso>
+
+<section id="old-to-new">
+
+ <title>De l'ancienne à la nouvelle URL (en interne)</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons que nous ayons récemment renommé la page
+ <code>foo.html</code> en <code>bar.html</code>, et voulions
+ maintenant que l'ancienne URL soit toujours valide à des fins
+ de compatibilité ascendante. En fait, on voudrait que le
+ changement de nom soit transparent aux utilisateurs de
+ l'ancienne URL.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit l'ancienne URL en interne vers la nouvelle via
+ la règle suivante :</p>
+
+<highlight language="config">
+RewriteEngine on
+RewriteRule ^<strong>/foo</strong>\.html$ <strong>/bar</strong>.html [PT]
+</highlight>
+ </dd>
+ </dl>
+
+</section>
+
+<section id="old-to-new-extern">
+
+ <title>De l'ancien au nouveau (en externe)</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons toujours que nous ayons récemment renommé la page
+ <code>foo.html</code> en <code>bar.html</code>, et voulions
+ maintenant que l'ancienne URL soit toujours valide à des fins
+ de compatibilité ascendante. En revanche, nous voulons cette
+ fois que la nouvelle URL soit suggérée aux utilisateurs de
+ l'ancienne URL, c'est à dire que l'adresse vue depuis leur
+ navigateur doit également être modifiée.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On force une redirection HTTP vers la nouvelle URL, ce qui
+ entraîne une modification de celle du navigateur et aussi de ce
+ que voit l'utilisateur :</p>
+
+<highlight language="config">
+RewriteEngine on
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html [<strong>R</strong>]
+</highlight>
+</dd>
+
+<dt>Discussion</dt>
+
+ <dd>
+ <p>Dans l'exemple <a
+ href="#old-to-new-intern">interne</a>, on a utilisé mod_rewrite afin
+ de dissimuler la redirection au client. Dans cet exemple, en
+ revanche, on aurait pu se contenter d'une directive Redirect :</p>
+
+ <highlight language="config">Redirect /foo.html /bar.html</highlight>
+
+ </dd>
+ </dl>
+
+</section>
+
+<section id="movehomedirs">
+
+ <title>Ressource déplacée vers un autre serveur</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Si une ressource a été déplacée vers un autre serveur, vous
+ pouvez faire en sorte que les URLs de l'ancien serveur continuent
+ de fonctionner pendant un certain temps, afin de laisser au
+ utilisateurs le temps de modifier leurs favoris.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Vous pouvez utiliser <module>mod_rewrite</module> pour
+ rediriger ces URLs vers le nouveau serveur, mais vous pouvez aussi
+ utiliser les directives Redirect ou RedirectMatch.</p>
+
+<highlight language="config">#Avec mod_rewrite
+RewriteEngine on
+RewriteRule ^/docs/(.+) http://nouveau.example.com/docs/$1 [R,L]
+</highlight>
+
+<highlight language="config">#Avec RedirectMatch
+RedirectMatch ^/docs/(.*) http://nouveau.example.com/docs/$1
+</highlight>
+
+<highlight language="config">#Avec Redirect
+Redirect /docs/ http://nouveau.example.com/docs/
+</highlight>
+ </dd>
+ </dl>
+
+</section>
+
+
+
+<section id="static-to-dynamic">
+
+ <title>De statique à dynamique</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment transformer une page statique <code>foo.html</code>
+ en sa variante dynamique <code>foo.cgi</code> de manière
+ transparente, c'est à dire sans en avertir le
+ navigateur/utilisateur.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit simplement l'URL en script CGI et force le
+ gestionnaire de contenu à <strong>cgi-script</strong> de façon
+ à ce que le script s'exécute en tant que programme CGI.
+ Ainsi, une requête vers <code>/~quux/foo.html</code> conduit
+ en interne à l'invocation de
+ <code>/~quux/foo.cgi</code>.</p>
+
+<highlight language="config">
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo\.html$ foo.cgi [H=<strong>cgi-script</strong>]
+</highlight>
+ </dd>
+ </dl>
+
+ </section>
+
+<section id="backward-compatibility">
+
+ <title>Compatibilité ascendante dans le cadre d'une modification
+ d'extension de nom de fichier</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment conférer une compatibilité ascendante aux URLs
+ (existant encore virtuellement) après avoir migré
+ <code>document.YYYY</code> vers <code>document.XXXX</code>,
+ c'est à dire après avoir par exemple traduit un lot de
+ fichiers <code>.html</code> en fichiers <code>.php</code>
+ ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On réécrit simplement le nom du fichier en son nom
+ de base et vérifie s'il existe aussi avec la nouvelle
+ extension. Si c'est le cas, on utilise ce nom, sinon on
+ réécrit l'URL sous sa forme originale.</p>
+
+
+<highlight language="config">
+# jeu de règles assurant une compatibilité ascendante en réécrivant<br />
+# document.html en document.php si et seulement si document.php<br />
+# existe
+<Directory /var/www/htdocs>
+ RewriteEngine on
+ RewriteBase /var/www/htdocs
+
+ RewriteCond $1.php -f
+ RewriteCond $1.html !-f
+ RewriteRule ^(.*).html$ $1.php
+</Directory>
+</highlight>
+ </dd>
+
+ <dt>Discussion</dt>
+ <dd>
+ <p>Cet exemple utilise une fonctionnalité souvent méconnue de
+ mod_rewrite, en tirant avantage de l'ordre d'exécution du jeu de
+ règles. En particulier, mod_rewrite évalue la partie gauche des
+ règles de réécriture avant d'évaluer les directives RewriteCond. En
+ conséquence, $1 est déjà défini au moment où les directives
+ RewriteCond sont évaluées. Ceci nous permet de tester l'existence du
+ fichier original (<code>document.html</code>) et du fichier cible
+ (<code>document.php</code>) en utilisant le même nom de base.</p>
+
+ <p>Ce jeu de règles est conçu pour une utilisation dans un contexte
+ de répertoire (au sein d'une section <Directory> ou d'un
+ fichier .htaccess), de façon à ce que les vérifications
+ <code>-f</code> effectuent leurs recherches dans le bon répertoire.
+ Vous serez peut-être amené à définir une directive <directive
+ module="mod_rewrite">RewriteBase</directive> pour spécifier le
+ répertoire de base à partir duquel vous travaillez.</p>
+ </dd>
+ </dl>
+
+</section>
+
+<section id="canonicalhost">
+
+<title>Noms d'hôtes canoniques</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>Le but de cette règle est de préférer l'utilisation d'un nom
+ d'hôte particulier à d'autres noms d'hôte utilisables
+ pour atteindre le même site. Par exemple, si vous voulez
+ utiliser <strong>www.example.com</strong> à la place de
+ <strong>example.com</strong>, vous pouvez utiliser une solution
+ du style :</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+
+<p>Pour y parvenir, il vaut mieux se passer de mod_rewrite, et utiliser
+plutôt la directive <directive module="mod_alias">Redirect</directive> dans
+une section de serveur virtuel pour le/les noms d'hôte non canoniques.</p>
+
+<highlight language="config">
+<VirtualHost *:80>
+ ServerName undesired.example.com
+ ServerAlias example.com notthis.example.com
+
+ Redirect / http://www.example.com/
+</VirtualHost>
+
+<VirtualHost *:80>
+ ServerName www.example.com
+</VirtualHost>
+</highlight>
+
+<p>Vous pouvez aussi utiliser la directive <directive module="core"
+type="section">If</directive> :</p>
+
+<highlight language="config">
+<If "%{HTTP_HOST} != 'www.example.com'">
+ Redirect / http://www.example.com/
+</If>
+</highlight>
+
+<p>Ou, par exemple, pour rediriger une portion de votre site vers HTTPS
+:</p>
+
+<highlight language="config">
+<If "%{SERVER_PROTOCOL} != 'HTTPS'">
+ Redirect /admin/ https://www.example.com/admin/
+</If>
+</highlight>
+
+<p>Si, pour une raison particulière, vous voulez tout de même utiliser
+<code>mod_rewrite</code> - dans le cas, par exemple, où vous avez besoin
+d'un jeu plus important de règles de réécritures - vous pouvez utiliser
+la recette suivante :</p>
+
+<p>Pour les sites écoutant sur un port autre que 80:</p>
+<highlight language="config">
+RewriteCond %{HTTP_HOST} !^www\.example\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*) http://www.example.com:%{SERVER_PORT}/$1 [L,R,NE]
+</highlight>
+
+<p>Et pour un site écoutant sur le port 80</p>
+<highlight language="config">
+RewriteCond %{HTTP_HOST} !^www\.example\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.example.com/$1 [L,R,NE]
+</highlight>
+ <p>
+ Si vous souhaitez que cette règle s'applique à tous les noms de
+ domaine - en d'autres termes, si vous voulez rediriger
+ <strong>example.com</strong> vers
+ <strong>www.example.com</strong> pour toutes les valeurs
+ possibles de <strong>example.com</strong>, vous pouvez utiliser
+ le jeu de règles suivants :</p>
+
+<highlight language="config">
+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+</highlight>
+ <p>
+ Vous pouvez utiliser ce jeu de règles aussi bien dans le fichier
+ de configuration de votre serveur principal que dans un fichier
+ <code>.htaccess</code> placé dans le répertoire défini par la
+ directive <directive
+ module="core">DocumentRoot</directive> du serveur.</p>
+ </dd>
+ </dl>
+
+ </section>
+
+<section id="multipledirs">
+
+ <title>Recherche de pages dans plus d'un répertoire</title>
+
+ <dl>
+ <dt>Description:</dt>
+
+ <dd>
+ <p>Une ressource peut exister dans plusieurs répertoires, et nous
+ voulons rechercher cette ressource dans ces répertoires
+ lorsqu'elle fait l'objet d'une requête. Il est possible que nous
+ ayons récemment réorganisé la structure de notre site en
+ répartissant son contenu dans plusieurs répertoires.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Le jeu de règles suivant recherche la ressource dans deux
+ répertoires, et s'il ne la trouve dans aucun des deux, il tentera
+ simplement de la servir à partir de l'adresse fournie dans la
+ requête.</p>
+
+<highlight language="config">
+RewriteEngine on
+
+# on cherche tout d'abord dans dir1/...
+# ... et si on trouve, on est content et on arrête :
+RewriteCond %{DOCUMENT_ROOT}/<strong>dir1</strong>/%{REQUEST_URI} -f
+RewriteRule ^(.+) %{DOCUMENT_ROOT}/<strong>dir1</strong>/$1 [L]
+
+# on cherche ensuite dans dir2/...
+# ... et si on trouve, on est content et on arrête :
+RewriteCond %{DOCUMENT_ROOT}/<strong>dir2</strong>/%{REQUEST_URI} -f
+RewriteRule ^(.+) %{DOCUMENT_ROOT}/<strong>dir2</strong>/$1 [L]
+
+# sinon, on continue la recherche avec d'autres directives Alias
+# ou ScriptAlias, etc...
+RewriteRule ^ - [PT]
+</highlight>
+ </dd>
+ </dl>
+
+ </section>
+
+<section id="archive-access-multiplexer">
+
+ <title>Redirection vers des serveurs géographiquement distribués</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Notre site web possède de nombreux miroirs, et nous voulons
+ rediriger les utilisateurs vers celui qui se situe dans le pays où
+ ils se trouvent. </p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>En consultant le nom d'hôte du client demandeur, on détermine le
+ pays dans lequel il se trouve. S'il est impossible d'effectuer une
+ recherche sur leur adresse IP, on se rabat sur un serveur par
+ défaut.</p>
+ <p>Nous allons utiliser une directive <directive
+ module="mod_rewrite">RewriteMap</directive> afin de construire une
+ liste des serveurs que nous voulons utiliser.</p>
+
+<highlight language="config">
+HostnameLookups on
+RewriteEngine on
+RewriteMap multiplex txt:/path/to/map.mirrors
+RewriteCond %{REMOTE_HOST} ([a-z]+)$ [NC]
+RewriteRule ^/(.*)$ ${multiplex:<strong>%1</strong>|http://www.example.com/}$1 [R,L]
+</highlight>
+
+<example>
+## liste_miroirs -- Table de correspondance pays - serveurs<br />
+<br />
+de http://www.exemple.de/<br />
+uk http://www.exemple.uk/<br />
+com http://www.example.com/<br />
+##EOF##
+</example>
+ </dd>
+
+ <dt>Discussion</dt>
+ <dd>
+ <note type="warning">Ce jeu de règles nécessite la définition à
+ <code>on</code> de la directive <directive
+ module="core">HostNameLookups</directive>, ce qui peut induire une
+ baisse de performance significative.</note>
+
+ <p>La directive <directive
+ module="mod_rewrite">RewriteCond</directive> extrait la dernière
+ partie du nom d'hôte du client demandeur - le code du pays - et la
+ règle de réécriture qui suit utilise cette valeur pour rechercher le
+ serveur miroir approprié dans le fichier de correspondances.</p>
+ </dd>
+ </dl>
+
+</section>
+
+<section id="browser-dependent-content">
+
+ <title>Contenu dépendant du navigateur</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Nous voulons fournir des contenus différents en fonction du
+ navigateur (user-agent) qui effectue la requête.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous devons déterminer quel contenu servir, en nous basant
+ sur l'en-tête HTTP "User-Agent". La
+ configuration suivante effectue ceci : si l'en-tête HTTP
+ "User-Agent" commence par "Mozilla/3", le nom de la page
+ <code>foo.html</code> est réécrit en <code>foo.NS.html</code>
+ et la réécriture s'arrête. Si le navigateur est "Lynx" ou
+ "Mozilla" version 1 ou 2, l'URL devient
+ <code>foo.20.html</code>. Tous les autres navigateurs
+ reçoivent la page <code>foo.32.html</code>. Tout ceci est
+ effectué par le jeu de règles suivant :</p>
+<highlight language="config">
+RewriteCond %{HTTP_USER_AGENT} ^<strong>Mozilla/3</strong>.*
+RewriteRule ^foo\.html$ foo.<strong>NS</strong>.html [<strong>L</strong>]
+
+RewriteCond %{HTTP_USER_AGENT} ^Lynx/ [OR]
+RewriteCond %{HTTP_USER_AGENT} ^Mozilla/[12]
+RewriteRule ^foo\.html$ foo.<strong>20</strong>.html [<strong>L</strong>]
+
+RewriteRule ^foo\.html$ foo.<strong>32</strong>.html [<strong>L</strong>]
+</highlight>
+ </dd>
+ </dl>
+
+ </section>
+
+<section id="canonicalurl">
+
+<title>URLs canoniques</title>
+
+<dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Sur certains serveurs, une ressource peut posséder plusieurs
+ URLs. Il y a en général les URLs canoniques (celles qui sont
+ réellement distribuées et utilisées), et celles qui correspondent à
+ des raccourcis, les URLs internes, etc... Quelle que soit l'adresse
+ que l'utilisateur fournit dans la requête, il devrait finalement
+ voir l'URL canonique dans la barre d'adresse de son navigateur.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous effectuons une redirection HTTP externe pour toutes les
+ URLs non canoniques afin de les corriger dans la barre d'adresse
+ du navigateur, et ceci pour toutes les requêtes futures. Dans le
+ jeu de règles suivant, nous remplaçons <code>/matous</code> et
+ <code>/minettes</code> par le canonique <code>/chats</code>.</p>
+
+ <highlight language="config">RewriteRule ^/(matous|minettes)/(.*) /chats/$2 [R]</highlight>
+ </dd>
+
+ <dt>Discussion :</dt>
+ <dd>On serait mieux inspiré d'utiliser ici les directives Redirect ou
+ RedirectMatch :
+
+ <highlight language="config"> RedirectMatch ^/(matous|minettes)/(.*) /chats/$2 </highlight>
+ </dd>
+ </dl>
+
+</section>
+
+<section id="moveddocroot">
+
+ <title>Déplacement du répertoire <code>DocumentRoot</code></title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+<p>En général, le répertoire <directive
+module="core">DocumentRoot</directive> du serveur web correspond à l'URL
+"<code>/</code>". Ce répertoire ne contient cependant pas forcément des
+ressources de première importance pour l'utilisateur. Par exemple, vous
+préférerez peut-être que le répertoire d'accueil d'un visiteur accédant
+pour la première fois à votre site soit un répertoire particulier
+<code>/a-propos-de/</code>. Pour y parvenir, utilisez le jeu de règles
+suivant :</p>
+</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On redirige l'URL <code>/</code> vers
+ <code>/a-propos-de/</code> :
+ </p>
+
+<highlight language="config">
+RewriteEngine on
+RewriteRule ^/$ /a-propos-de/ [<strong>R</strong>]
+</highlight>
+
+<p>Notez que l'on peut aussi y parvenir en utilisant la directive
+<directive module="mod_alias">RedirectMatch</directive> :</p>
+
+<highlight language="config">RedirectMatch ^/$
+http://example.com/a-propos-de/</highlight>
+
+<p>Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres
+termes, il réécrit une requête pour <code>http://example.com/</code>,
+mais pas pour une requête <code>http://example.com/page.html</code>. Si
+vous avez effectivement modifié la racine de vos documents - c'est à dire
+si <strong>tous</strong> vos contenus se trouvent dans un
+sous-répertoire, il est largement préférable de modifier simplement
+votre directive <directive module="core">DocumentRoot</directive>, ou de
+déplacer l'ensemble du contenu vers le répertoire supérieur, plutôt que
+de réécrire les URLs.</p>
+</dd>
+</dl>
+
+</section>
+
+<section id="fallback-resource">
+<title>Ressource par défaut</title>
+
+<dl>
+<dt>Description :</dt>
+<dd>Vous voulez qu'une seule ressource (disons un certain fichier tel
+que index.php) soit servie pour toutes les requêtes à destination d'un
+certain répertoire, sauf pour celles qui concernent une ressource
+existant effectivement comme une image, ou un fichier css.</dd>
+
+<dt>Solution :</dt>
+<dd>
+<p>Depuis la version 2.2.16, vous pouvez y parvenir via la directive
+<directive module="mod_dir">FallbackResource</directive> :</p>
+
+<highlight language="config">
+<Directory /var/www/my_blog>
+ FallbackResource index.php
+</Directory>
+</highlight>
+
+<p>Cependant, si vos besoins étaient plus complexes, vous pouviez, dans
+les versions plus anciennes d'Apache, utiliser un jeu de règles du style
+:</p>
+
+<highlight language="config">
+<Directory /var/www/my_blog>
+ RewriteBase /my_blog
+
+ RewriteCond /var/www/my_blog/%{REQUEST_FILENAME} !-f
+ RewriteCond /var/www/my_blog/%{REQUEST_FILENAME} !-d
+ RewriteRule ^ index.php [PT]
+</Directory>
+</highlight>
+
+<p>D'autre part, si vous voulez transmettre l'URI de la requête en tant
+que chaîne de paramètres à index.php, vous pouvez remplacer cette règle
+de réécriture par :</p>
+
+<highlight language="config">RewriteRule (.*) index.php?$1 [PT,QSA]</highlight>
+
+<p>Notez que l'on peut utiliser ces jeux de règles aussi bien dans un
+fichier <code>.htaccess</code> que dans une section
+<Directory>.</p>
+
+</dd>
+
+</dl>
+
+</section>
+
+</manualpage>