Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: index.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
+
URI: index.html.tr.utf8
Content-Language: tr
Content-type: text/html; charset=UTF-8
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Available Languages: </span><a href="../en/rewrite/" title="English"> en </a> |
+<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div>
</div></div>
<div class="bottomlang">
<p><span>Available Languages: </span><a href="../en/rewrite/" title="English"> en </a> |
+<a href="../fr/rewrite/" hreflang="fr" rel="alternate" title="Français"> fr </a> |
<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
--- /dev/null
+<?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>Le module Apache 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 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="../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.3</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.3</a></div><div id="page-content"><div id="preamble"><h1>Le module Apache mod_rewrite</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/" title="Français"> fr </a> |
+<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div>
+
+ <blockquote>
+ <p>``Ce qui est super avec mod_rewrite, c'est qui permet
+ autant de configuration et de flexibilité que Sendmail.
+ L'inconvénient de mod_rewrite, c'est qu'il permet autant de
+ configuration et de flexibilité que Sendmail.''</p>
+
+ <p class="cite">-- <cite>Brian Behlendorf</cite><br />
+ Groupe Apache</p>
+
+ </blockquote>
+
+ <blockquote>
+ <p>``Malgré les tonnes d'exemples et de documentations,
+ mod_rewrite relève de la magie vaudoue. De la magie vaudoue super
+ géniale, mais de la magie vaudoue.''</p>
+
+ <p class="cite">-- <cite>Brian Moore</cite><br />
+ bem@news.cmc.net</p>
+
+ </blockquote>
+
+ <p>Bienvenue dans mod_rewrite, le couteau suisse de la
+ manipulation d'URL !</p>
+
+ <p>Ce module met en oeuvre un moteur de réécriture à base de
+ règles (basé sur un interpréteur d'expressions rationnelles) pour
+ réécrire les URLs issues des requêtes à la volée. Il fournit un
+ mécanisme de manipulation d'URL particulièrement souple et
+ puissant en supportant un nombre illimité de règles et de
+ conditions attachées à chaque règle. Les manipulations d'URLs
+ peuvent dépendre de tests variés : par exemple, les URLs peuvent
+ être finement caractérisées en fonction de variables du serveur,
+ de variables d'environnement, d'en-têtes HTTP, de repères
+ temporels, ou même de requêtes vers des bases de données externes
+ sous différents formats.</p>
+
+ <p>Ce module agit sur l'ensemble des URLs (la partie chemin
+ incluse) non seulement dans le contexte du serveur principal
+ (<code>httpd.conf</code>), mais aussi dans le contexte des
+ répertoires (fichiers <code>.htaccess</code> et blocs
+ <code><Directory></code>), et peut même générer des chaînes
+ de requête comme résultat. Le résultat réécrit peut conduire à un
+ traitement secondaire interne, une redirection vers une requête
+ externe ou même l'envoi vers un serveur mandataire.</p>
+
+ <p>Mais toutes ces fonctionnalités et cette souplesse ont un
+ inconvénient : la complexité. N'espérez donc pas comprendre ce
+ module dans les détails en un seul jour.</p>
+
+</div>
+<div id="quickview"><h3>Voir aussi</h3><ul class="seealso"><li><a href="../urlmapping.html">Mise en correspondance des URLs
+avec le système de fichiers</a></li><li><a href="http://wiki.apache.org/httpd/Rewrite">wiki mod_rewrite
+</a></li><li><a href="../glossary.html">Glossaire</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="documentation" id="documentation">Documentation</a></h2>
+<ul>
+<li><a href="../mod/mod_rewrite.html">Documentation de référence de
+mod_rewrite</a></li>
+<li><a href="rewrite_intro.html">Introduction</a></li>
+<li><a href="rewrite_flags.html">Drapeaux</a></li>
+<li><a href="rewrite_tech.html">Détails techniques</a></li>
+<li><a href="rewrite_guide.html">Guide de réécriture - exemples utiles</a></li>
+<li><a href="rewrite_guide_advanced.html">Guide de réécriture avancé -
+encore plus d'exemples utiles</a></li>
+</ul>
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/" title="Français"> fr </a> |
+<a href="../tr/rewrite/" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
--- /dev/null
+<?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 : 636374 $ -->
+<!-- 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="index.xml.meta">
+<parentdocument href="../"/>
+
+ <title>Le module Apache mod_rewrite</title>
+
+<summary>
+ <blockquote>
+ <p>``Ce qui est super avec mod_rewrite, c'est qui permet
+ autant de configuration et de flexibilité que Sendmail.
+ L'inconvénient de mod_rewrite, c'est qu'il permet autant de
+ configuration et de flexibilité que Sendmail.''</p>
+
+ <p class="cite">-- <cite>Brian Behlendorf</cite><br />
+ Groupe Apache</p>
+
+ </blockquote>
+
+ <blockquote>
+ <p>``Malgré les tonnes d'exemples et de documentations,
+ mod_rewrite relève de la magie vaudoue. De la magie vaudoue super
+ géniale, mais de la magie vaudoue.''</p>
+
+ <p class="cite">-- <cite>Brian Moore</cite><br />
+ bem@news.cmc.net</p>
+
+ </blockquote>
+
+ <p>Bienvenue dans mod_rewrite, le couteau suisse de la
+ manipulation d'URL !</p>
+
+ <p>Ce module met en oeuvre un moteur de réécriture à base de
+ règles (basé sur un interpréteur d'expressions rationnelles) pour
+ réécrire les URLs issues des requêtes à la volée. Il fournit un
+ mécanisme de manipulation d'URL particulièrement souple et
+ puissant en supportant un nombre illimité de règles et de
+ conditions attachées à chaque règle. Les manipulations d'URLs
+ peuvent dépendre de tests variés : par exemple, les URLs peuvent
+ être finement caractérisées en fonction de variables du serveur,
+ de variables d'environnement, d'en-têtes HTTP, de repères
+ temporels, ou même de requêtes vers des bases de données externes
+ sous différents formats.</p>
+
+ <p>Ce module agit sur l'ensemble des URLs (la partie chemin
+ incluse) non seulement dans le contexte du serveur principal
+ (<code>httpd.conf</code>), mais aussi dans le contexte des
+ répertoires (fichiers <code>.htaccess</code> et blocs
+ <code><Directory></code>), et peut même générer des chaînes
+ de requête comme résultat. Le résultat réécrit peut conduire à un
+ traitement secondaire interne, une redirection vers une requête
+ externe ou même l'envoi vers un serveur mandataire.</p>
+
+ <p>Mais toutes ces fonctionnalités et cette souplesse ont un
+ inconvénient : la complexité. N'espérez donc pas comprendre ce
+ module dans les détails en un seul jour.</p>
+
+</summary>
+
+<seealso><a href="../urlmapping.html">Mise en correspondance des URLs
+avec le système de fichiers</a></seealso>
+<seealso><a href="http://wiki.apache.org/httpd/Rewrite">wiki mod_rewrite
+</a></seealso>
+<seealso><a href="../glossary.html">Glossaire</a></seealso>
+
+<section id="documentation"><title>Documentation</title>
+<ul>
+<li><a href="../mod/mod_rewrite.html">Documentation de référence de
+mod_rewrite</a></li>
+<li><a href="rewrite_intro.html">Introduction</a></li>
+<li><a href="rewrite_flags.html">Drapeaux</a></li>
+<li><a href="rewrite_tech.html">Détails techniques</a></li>
+<li><a href="rewrite_guide.html">Guide de réécriture - exemples utiles</a></li>
+<li><a href="rewrite_guide_advanced.html">Guide de réécriture avancé -
+encore plus d'exemples utiles</a></li>
+</ul>
+</section>
+
+</manualpage>
+
+
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant>tr</variant>
</variants>
</metafile>
URI: rewrite_guide.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+
+URI: rewrite_guide.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>URL Rewriting Guide</h1>
<div class="toplang">
-<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_guide.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_guide.html" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_guide.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
</div></div>
<div class="bottomlang">
-<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_guide.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_guide.html" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_guide.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
--- /dev/null
+<?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>Guide de réécriture des URLs - 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 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="../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.3</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.3</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Guide de réécriture des URLs</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewrite_guide.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_guide.html" title="Français"> fr </a></p>
+</div>
+
+
+ <p>Ce document complète la <a href="../mod/mod_rewrite.html">documentation de référence</a> du
+ module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit de quelle manière on
+ peut utiliser le module Apache <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour
+ résoudre les problèmes typiques relatifs aux URLs auxquels les
+ webmasters sont souvent confrontés. La résolution de chaque problème
+ par la configuration des jeux de règles de réécriture d'URLs fait
+ l'objet d'une description détaillée.</p>
+
+ <div class="warning">ATTENTION : l'adaptation des exemples à votre
+ situation en fonction de la configuration de votre serveur pourra
+ s'avérer nécessaire, par exemple l'ajout du drapeau
+ <code>[PT]</code> si vous utilisez les modules
+ <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>, <code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>, etc... Un
+ jeu de règles défini dans le contexte du serveur devra aussi être
+ adapté pour être utilisé dans un contexte <code>.htaccess</code>.
+ Efforcez-vous toujours de bien comprendre l'effet produit par un jeu
+ de règles avant de l'utiliser, ce qui pourra vous éviter bien des
+ problèmes.</div>
+
+ </div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#canonicalurl">URLs canoniques</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="#moveddocroot"><code>DocumentRoot</code>déplacé</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#trailingslash">Problème du slash de fin</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#movehomedirs">Déplacement des répertoires home vers un autre serveur</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="#setenvvars">Définir des variables d'environnement en fonction de
+ certaines parties de l'URL</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#uservhosts">Hôtes virtuels basés sur l'utilisateur</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#redirecthome">Redirection des répertoires d'accueil pour les étrangers</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#redirectanchors">Redirection des ancrages</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#time-dependent">Réécriture dépendant de l'heure</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#backward-compatibility">Compatibilité ascendante pour une migration de YYYY vers
+ XXXX</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#old-to-new">De l'ancien au nouveau (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="#static-to-dynamic">De statique à dynamique</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#blocking-of-robots">Blocage des robots</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#blocked-inline-images">Blocage du référencement à chaud (Hotlinking) d'images</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#proxy-deny">Interdiction du mandataire</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#external-rewriting">Moteur de réécriture externe</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="rewrite_intro.html">Introduction à mod_rewrite</a></li><li><a href="rewrite_guide_advanced.html">Guide de réécriture
+avancé - exemples utiles avancés</a></li><li><a href="rewrite_tech.html">Détails techniques</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="canonicalurl" id="canonicalurl">URLs canoniques</a></h2>
+
+
+
+<dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Sur certains serveurs web, une ressource peut être accessible
+ depuis plusieurs URLs. On trouve en général des URLs canoniques
+ (qui sont réellement utilisables et distribuables), mais aussi des
+ URLs à usage interne, ou celles qui ne sont que des raccourcis,
+ etc... On souhaite que, quelle que soit l'URL que l'utilisateur
+ a fournie avec sa requête, il ne doit en voir en fin de compte
+ que la forme canonique.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On effectue une redirection HTTP externe pour toutes les URLs
+ non canoniques afin de les rendre compréhensibles au navigateur
+ et ceci pour toutes les requêtes sous-jacentes. Dans l'exemple de
+ jeux de règles ci-dessous, <code>/~user</code> est remplacé par
+ l'expression canonique <code>/u/user</code>, et une éventuelle
+ absence du slash à la fin de <code>/u/user</code> est corrigée.</p>
+
+<div class="example"><pre>
+RewriteRule ^/<strong>~</strong>([^/]+)/?(.*) /<strong>u</strong>/$1/$2 [<strong>R</strong>]
+RewriteRule ^/u/(<strong>[^/]+</strong>)$ /$1/$2<strong>/</strong> [<strong>R</strong>]
+</pre></div>
+ </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 par rapport à 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 devez utiliser une solution
+ de ce style.</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+<p>Pour les sites écoutant sur un port autre que 80:</p>
+<div class="example"><pre>
+RewriteCond %{HTTP_HOST} !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*) http://www.exemple.com:%{SERVER_PORT}/$1
+[L,R,NE]
+</pre></div>
+
+<p>Et pour un site écoutant sur le port 80</p>
+<div class="example"><pre>
+RewriteCond %{HTTP_HOST} !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.exemple.com/$1 [L,R,NE]
+</pre></div>
+ <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>
+
+<div class="example"><pre>
+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+</pre></div>
+ <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="moveddocroot" id="moveddocroot"><code>DocumentRoot</code>déplacé</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+<p>En général, la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> correspond directement à l'URL
+"<code>/</code>" du serveur web. Mais souvent, les données qui s'y
+trouvent ne sont pas de la première priorité. Par exemple, il peut être
+intéressant, pour les visiteurs qui entrent sur le site pour la première
+fois, d'être redirigés vers un sous-répertoire particulier
+<code>/a-propos-de/</code>. Pour ce faire, on peut utiliser 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>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteRule <strong>^/$</strong> /a-propos-de/ [<strong>R</strong>]
+</pre></div>
+
+ <p>Notez que le même effet peut être obtenu à l'aide de la directive
+ <code class="directive"><a href="../mod/mod_alias.html#redirectmatch">RedirectMatch</a></code> :</p>
+
+<div class="example"><p><code>
+RedirectMatch ^/$ http://exemple.com/apropos/
+</code></p></div>
+<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 ne réécrira pas une requête pour
+<code>http://example.com/page.html</code>. En fait, si vous avez modifié
+la racine de vos documents - c'est à dire si tous vos contenus se
+trouvent dans ce sous-répertoire, il vaut mieux simplement modifier
+votre directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> que de
+procéder à une réécriture d'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="trailingslash" id="trailingslash">Problème du slash de fin</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd><p>La plupart des problèmes de "slash de fin" peuvent être
+ résolus grâce aux techniques décrites dans ce <a href="http://httpd.apache.org/docs/misc/FAQ-E.html#set-servername">sujet
+ de la FAQ</a>. Cependant, dans certaines situations où l'absence de slash de fin
+ peut rendre une URL inopérante, l'utilisation de
+ mod_rewrite s'avère nécessaire. Le cas peut se présenter, par exemple,
+ après une série complexe de règles de réécriture.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>La solution à ce problème subtil consiste à laisser le
+ serveur ajouter le slash de fin automatiquement. Pour y
+ parvenir, il faut utiliser une redirection externe, afin que
+ le navigateur demande correctement les images sous-jacentes,
+ etc... Une réécriture en interne ne fonctionnerait que pour la
+ page du répertoire, mais échouerait pour toute image incluse
+ dans cette page via des liens relatifs, car le navigateur
+ demanderait un objet inséré. Par exemple, une requête pour
+ <code>image.gif</code> dans <code>/~quux/foo/index.html</code>
+ deviendrait <code>/~quux/image.gif</code> sans la redirection
+ externe !</p>
+
+ <p>Pour y parvenir, on peut utiliser des règles de ce style :</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo<strong>$</strong> foo<strong>/</strong> [<strong>R</strong>]
+</pre></div>
+
+ <p>Vous pouvez aussi ajouter ce qui suit dans un fichier
+ <code>.htaccess</code> situé dans le répertoire contenant la
+ ressource. Notez cependant que cela augmente la charge du processeur.</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteCond %{REQUEST_FILENAME} <strong>-d</strong>
+RewriteRule ^(.+<strong>[^/]</strong>)$ $1<strong>/</strong> [R]
+</pre></div>
+ </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">Déplacement des répertoires home vers un autre serveur</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>De nombreux webmasters ont demandé comment résoudre le
+ problème suivant : ils voudraient tout simplement rediriger
+ les répertoires home d'un serveur web vers un autre serveur
+ web. Cette situation se présente en général lorsqu'on installe
+ un nouveau serveur web destiné à terme à en remplacer un autre
+ plus ancien.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Avec <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, la solution est
+ évidente. Sur l'ancien serveur web, on redirige simplement
+ toutes les URLs du style <code>/~user/chemin</code> vers
+ <code>http://nouveau-serveur/~user/chemin</code>.</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteRule ^/~(.+) http://<strong>nouveau-serveur</strong>/~$1 [R,L]
+</pre></div>
+ </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>Le serveur web doit parfois rechercher des pages dans plus
+ d'un répertoire. Dans ce cas, les vues multiples ou autres
+ techniques similaires ne sont d'aucun secours.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On définit explicitement un jeu de règles qui recherche les
+ fichiers dans les répertoires.</p>
+
+<div class="example"><pre>
+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></div>
+ </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="setenvvars" id="setenvvars">Définir des variables d'environnement en fonction de
+ certaines parties de l'URL</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment conserver des informations
+ d'état d'une requête à l'autre et utiliser l'URL pour les
+ encoder, sans utiliser d'encapsulateur CGI
+ pour toutes les pages pour seulement supprimer ces
+ informations.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise une règle de réécriture pour supprimer
+ l'information d'état et l'enregistrer dans une variable
+ d'environnement dont on pourra plus tard extraire la valeur
+ dans XSSI ou CGI. De cette façon, une URL telle que
+ <code>/foo/S=java/bar/</code> sera traduite en
+ <code>/foo/bar/</code> et la variable d'environnement
+ <code>STATUS</code> aura pour valeur "java".</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteRule ^(.*)/<strong>S=([^/]+)</strong>/(.*) $1/$3 [E=<strong>STATUS:$2</strong>]
+</pre></div>
+ </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="uservhosts" id="uservhosts">Hôtes virtuels basés sur l'utilisateur</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons que vous vouliez atteindre la page d'accueil des
+ utilisateurs sur une même machine au moyen de l'URL
+ <code>www.<strong>nom-utilisateur</strong>.hôte.domaine.com</code>,
+ en vous basant
+ seulement sur les enregistrements DNS de type A, et ceci sans qu'aucun
+ hôte virtuel ne soit installé sur cette machine.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Dans le cas des requêtes HTTP/1.0, il n'y a pas de solution
+ ; par contre, avec une requête HTTP/1.1 qui contient un
+ en-tête HTTP Host:, on peut utiliser le jeu de règles suivant
+ pour réécrire en interne
+ <code>http://www.nom-utilisateur.hôte.com/chemin</code> vers
+ <code>/home/nom-utilisateur/chemin</code> :</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteCond %{<strong>HTTP_HOST</strong>} ^www\.<strong>([^.]+)</strong>\.host\.com$
+RewriteRule ^(.*) /home/<strong>%1</strong>$1
+</pre></div>
+<p>Les parenthèses utilisées dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> sont capturées dans les
+références arrières <code>%1</code>, <code>%2</code>, etc..., alors que
+les parenthèses utilisées dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> sont capturées dans les
+références arrières <code>$1</code>, <code>$2</code>, etc...</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="redirecthome" id="redirecthome">Redirection des répertoires d'accueil pour les étrangers</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>On veut rediriger les URLs des répertoires d'accueil vers
+ un autre serveur <code>www.quelque-part.com</code> lorsque
+ l'utilisateur demandeur n'appartient pas au domaine local
+ <code>notre-domaine.com</code>. On rencontre parfois cette
+ situation dans un contexte d'hôtes virtuels.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Juste une condition de réécriture :</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteCond %{REMOTE_HOST} <strong>!^.+\.notre-domaine\.com$</strong>
+RewriteRule ^(/~.+) http://www.quelque-part.com/$1 [R,L]
+</pre></div>
+ </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="redirectanchors" id="redirectanchors">Redirection des ancrages</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Par défaut, la redirection vers un ancrage HTML ne fonctionne
+ pas, car mod_rewrite échappe le caractère <code>#</code> en le
+ transformant en <code>%23</code>, ce qui rend la redirection
+ inopérante.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise le drapeau <code>[NE]</code> dans la règle
+ <code>RewriteRule</code>. NE signifie "No Escape".
+ </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="time-dependent" id="time-dependent">Réécriture dépendant de l'heure</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Lorsqu'il s'agit de distribuer des contenus dont la nature
+ dépend de l'heure, de nombreux webmasters utilisent encore des
+ scripts CGI qui redirigent par exemple vers des pages
+ spécifiques. Comment peut-on y parvenir à tenir compte de
+ l'heure à l'aide de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Il existe de nombreuses variables nommées
+ <code>TIME_xxx</code> utilisables dans les conditions de
+ réécriture. Utilisées en conjonction avec les modèles de
+ comparaison lexicographique spéciaux <code><STRING</code>,
+ <code>>STRING</code> et <code>=STRING</code>, elles
+ permettent d'effectuer des redirections dépendant de
+ l'heure :</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteCond %{TIME_HOUR}%{TIME_MIN} >0700
+RewriteCond %{TIME_HOUR}%{TIME_MIN} <1900
+RewriteRule ^foo\.html$ foo.jour.html
+RewriteRule ^foo\.html$ foo.nuit.html
+</pre></div>
+
+ <p>Avec cet exemple, l'URL <code>foo.html</code> renvoie
+ le contenu de <code>foo.jour.html</code> durant le
+ créneau horaire <code>07:00-19:00</code>, et le contenu de
+ <code>foo.nuit.html</code> le reste du temps. Agréable
+ fonctionnalité pour une page d'accueil...</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="backward-compatibility" id="backward-compatibility">Compatibilité ascendante pour une migration de YYYY vers
+ XXXX</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>.phtml</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>
+
+
+<div class="example"><pre>
+# jeu de règles assurant une compatibilité ascendante en réécrivant
+# document.html en document.phtml si et seulement si document.phtml
+# existe et document.html n'existe plus
+RewriteEngine on
+RewriteBase /~quux/
+# réécriture du fichier en son nom de base,
+# mais garde en mémoire le fait qu'il s'agit
+# d'un fichier html
+RewriteRule ^(.*)\.html$ $1 [C,E=WasHTML:yes]
+# réécrit vers document.phtml s'il existe
+# Note : il s'agit d'un exemple de niveau répertoire, si bien que
+# %{REQUEST_FILENAME} contient le chemin complet du système de fichier
+# tel qu'il a été construit par le serveur.
+RewriteCond %{REQUEST_FILENAME}.phtml -f
+RewriteRule ^(.*)$ $1.phtml [S=1]
+# sinon, restauration du nom de fichier complet original
+RewriteCond %{ENV:WasHTML} ^yes$
+RewriteRule ^(.*)$ $1.html
+</pre></div>
+ </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" id="old-to-new">De l'ancien au nouveau (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>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html
+</pre></div>
+ </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. Par contre, nous voulons cette
+ fois que les utilisateurs de l'ancienne URL soient redirigés
+ vers la nouvelle, c'est à dire que l'adresse tapée
+ dans leur navigateur doit aussi ê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>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html [<strong>R</strong>]
+</pre></div>
+ </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>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo\.<strong>html</strong>$ foo.<strong>cgi</strong> [H=<strong>cgi-script</strong>]
+</pre></div>
+ </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="blocking-of-robots" id="blocking-of-robots">Blocage des robots</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment empêcher un robot vraiment gênant de collecter les
+ pages d'une partie spécifique du site web ? Un fichier
+ <code>/robots.txt</code> comportant les entrées du "Protocole
+ d'Exclusion des Robots" ne suffit généralement pas à en venir
+ à bout.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise un jeu de règles qui interdit les URLs de la
+ partie du site web concernée <code>/~quux/foo/arc/</code>
+ (peut-être une partie du serveur avec une arborescence très
+ développée à travers laquelle le parcours du
+ robot induirait une charge importante pour le serveur). Nous
+ devons nous assurer de n'interdire l'accès qu'à ce robot
+ particulier, c'est à dire qu'il ne suffit pas d'interdire
+ l'accès à l'hôte sur lequel le robot fonctionne, ce qui
+ bloquerait aussi les utilisateurs de cet hôte. Pour y
+ parvenir, on tient aussi compte des informations contenues
+ dans l'en-tête HTTP User-Agent.</p>
+
+<div class="example"><pre>
+RewriteCond %{HTTP_USER_AGENT} ^<strong>NameOfBadRobot</strong>.*
+RewriteCond %{REMOTE_ADDR} ^<strong>123\.45\.67\.[8-9]</strong>$
+RewriteRule ^<strong>/~quux/foo/arc/</strong>.+ - [<strong>F</strong>]
+</pre></div>
+ </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="blocked-inline-images" id="blocked-inline-images">Blocage du référencement à chaud (Hotlinking) d'images</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Cette technique vous permet d'interdire à d'autres sites
+ d'inclure directement vos images dans leurs pages. On fait
+ souvent référence à cette pratique sous le nom de
+ référencement à chaud (Hotlinking) qui entraîne l'utilisation
+ de votre bande passante pour servir des contenus faisant
+ partie du site de quelqu'un d'autre.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Cette technique repose sur la valeur de la variable
+ optionnelle <code>HTTP_REFERER</code>. Certaines personnes
+ pourront donc contourner cette limitation. Pour la plupart des
+ utilisateurs cependant, la requête échouera, en ce sens que
+ l'image ne sera pas affichée depuis le site tiers.</p>
+ <p>Il y a plusieurs manières de gérer cette situation.</p>
+
+ <p>Dans le premier exemple, nous rejetons tout simplement la
+ requête si elle ne provenait pas d'une page appartenant à notre
+ site. Pour les besoins de cet exemple, nous supposons que le nom
+ de votre site est <code>www.example.com</code>.</p>
+
+<div class="example"><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> - [F,NC]
+</pre></div>
+
+ <p>Dans le second exemple, plutôt que de rejeter la requête,
+ nous affichons une autre image à la place.</p>
+
+<div class="example"><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> /images/go-away.png [R,NC]
+</pre></div>
+
+ <p>Dans le troisième exemple, nous redirigeons la requête vers
+ une image appartenant à un site tiers.</p>
+
+
+<div class="example"><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> http://other.site.com/image.gif [R,NC]
+</pre></div>
+ <p>De tous ces exemples, les deux derniers semblent les plus
+ efficaces pour faire en sorte que les gens arrêtent de
+ référencer vos images à chaud, car il ne verront pas les images
+ qu'ils s'attendent à voir.</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="proxy-deny" id="proxy-deny">Interdiction du mandataire</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment interdire l'utilisation du mandataire d'Apache à un
+ certain hôte, ou même à un utilisateur d'un certain hôte ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous devons tout d'abord nous assurer que
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> se situe en dessous (!) de
+ <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> dans le fichier de configuration
+ lors de la compilation du serveur web Apache. De cette façon,
+ il est appelé <em>avant</em> <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code>. Nous
+ pouvons alors utiliser la règle suivante pour une interdiction
+ concernant un hôte...</p>
+
+<div class="example"><pre>
+RewriteCond %{REMOTE_HOST} <strong>^mauvais-hôte\.mon-domaine\.com$</strong>
+RewriteRule !^http://[^/.]\.mon-domaine.com.* - [F]
+</pre></div>
+
+ <p>...et celle-ci pour une interdiction concernant un
+ utilisateur d'un certain hôte :</p>
+
+<div class="example"><pre>
+RewriteCond %{REMOTE_IDENT}@%{REMOTE_HOST}
+<strong>^mauvais-sujet@mauvais-hôte\.mon-domaine\.com$</strong>
+RewriteRule !^http://[^/.]\.mon-domaine.com.* - [F]
+</pre></div>
+ </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="external-rewriting" id="external-rewriting">Moteur de réécriture externe</a></h2>
+
+
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Une question de la Faq : comment résoudre le problème
+ FOO/BAR/QUUX/etc. ? <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ne semble pas
+ devoir y apporter de solution...</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Utiliser une <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ou table de réécriture externe, c'est
+ à dire un programme qui agit de la même façon qu'une
+ <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. Il
+ doit être lancé une fois au démarrage d'Apache, recevoir les
+ URLs des requêtes sur <code>STDIN</code>, et restituer l'URL
+ résultante (en général réécrite) sur <code>STDOUT</code> (dans
+ cet ordre !).</p>
+
+<div class="example"><pre>
+RewriteEngine on
+RewriteMap quux-table <strong>prg:</strong>/chemin/vers/table.quux.pl
+RewriteRule ^/~quux/(.*)$ /~quux/<strong>${quux-table:$1}</strong>
+</pre></div>
+
+<div class="example"><pre>
+#!/chemin/vers/perl
+
+# désactive la mise en tampon des entrées/sorties, qui risque
+# de provoquer des bouclages infinis pour le serveur Apache
+$| = 1;
+
+# lit les URLs (une par ligne) depuis stdin et
+# génère l'URL transformée sur stdout
+
+# read URLs one per line from stdin and
+# generate substitution URL on stdout
+while (<>) {
+ s|^foo/|bar/|;
+ print $_;
+}
+</pre></div>
+
+ <p>Ceci n'est qu'un exemple de démonstration qui ne fait que
+ réécrire les URLs du style <code>/~quux/foo/...</code> vers
+ <code>/~quux/bar/...</code>. En fait, vous pouvez programmer
+ la substitution que vous voulez. Notez cependant que si de
+ tels programmes peuvent aussi être <strong>utilisés</strong>
+ par un utilisateur standard, seul l'administrateur du système
+ peut les <strong>écrire</strong>.</p>
+ </dd>
+ </dl>
+
+ </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewrite_guide.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_guide.html" title="Français"> fr </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
--- /dev/null
+<?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 : 774161 -->
+<!-- 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="rewrite_guide.xml.meta">
+ <parentdocument href="./">Rewrite</parentdocument>
+
+ <title>Guide de réécriture des URLs</title>
+
+ <summary>
+
+ <p>Ce document complète la <a
+ href="../mod/mod_rewrite.html">documentation de référence</a> du
+ module <module>mod_rewrite</module>. Il décrit de quelle manière on
+ peut utiliser le module Apache <module>mod_rewrite</module> pour
+ résoudre les problèmes typiques relatifs aux URLs auxquels les
+ webmasters sont souvent confrontés. La résolution de chaque problème
+ par la configuration des jeux de règles de réécriture d'URLs fait
+ l'objet d'une description détaillée.</p>
+
+ <note type="warning">ATTENTION : l'adaptation des exemples à votre
+ situation en fonction de la configuration de votre serveur pourra
+ s'avérer nécessaire, par exemple l'ajout du drapeau
+ <code>[PT]</code> si vous utilisez les modules
+ <module>mod_alias</module>, <module>mod_userdir</module>, etc... Un
+ jeu de règles défini dans le contexte du serveur devra aussi être
+ adapté pour être utilisé dans un contexte <code>.htaccess</code>.
+ Efforcez-vous toujours de bien comprendre l'effet produit par un jeu
+ de règles avant de l'utiliser, ce qui pourra vous éviter bien des
+ problèmes.</note>
+
+ </summary>
+<seealso><a href="../mod/mod_rewrite.html">Documentation du module</a></seealso>
+<seealso><a href="rewrite_intro.html">Introduction à mod_rewrite</a></seealso>
+<seealso><a href="rewrite_guide_advanced.html">Guide de réécriture
+avancé - exemples utiles avancés</a></seealso>
+<seealso><a href="rewrite_tech.html">Détails techniques</a></seealso>
+
+
+<section id="canonicalurl">
+
+<title>URLs canoniques</title>
+
+<dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Sur certains serveurs web, une ressource peut être accessible
+ depuis plusieurs URLs. On trouve en général des URLs canoniques
+ (qui sont réellement utilisables et distribuables), mais aussi des
+ URLs à usage interne, ou celles qui ne sont que des raccourcis,
+ etc... On souhaite que, quelle que soit l'URL que l'utilisateur
+ a fournie avec sa requête, il ne doit en voir en fin de compte
+ que la forme canonique.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On effectue une redirection HTTP externe pour toutes les URLs
+ non canoniques afin de les rendre compréhensibles au navigateur
+ et ceci pour toutes les requêtes sous-jacentes. Dans l'exemple de
+ jeux de règles ci-dessous, <code>/~user</code> est remplacé par
+ l'expression canonique <code>/u/user</code>, et une éventuelle
+ absence du slash à la fin de <code>/u/user</code> est corrigée.</p>
+
+<example><pre>
+RewriteRule ^/<strong>~</strong>([^/]+)/?(.*) /<strong>u</strong>/$1/$2 [<strong>R</strong>]
+RewriteRule ^/u/(<strong>[^/]+</strong>)$ /$1/$2<strong>/</strong> [<strong>R</strong>]
+</pre></example>
+ </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 par rapport à 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 devez utiliser une solution
+ de ce style.</dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+<p>Pour les sites écoutant sur un port autre que 80:</p>
+<example><pre>
+RewriteCond %{HTTP_HOST} !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*) http://www.exemple.com:%{SERVER_PORT}/$1
+[L,R,NE]
+</pre></example>
+
+<p>Et pour un site écoutant sur le port 80</p>
+<example><pre>
+RewriteCond %{HTTP_HOST} !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.exemple.com/$1 [L,R,NE]
+</pre></example>
+ <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>
+
+<example><pre>
+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+</pre></example>
+ <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="moveddocroot">
+
+ <title><code>DocumentRoot</code>déplacé</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+<p>En général, la directive <directive
+module="core">DocumentRoot</directive> correspond directement à l'URL
+"<code>/</code>" du serveur web. Mais souvent, les données qui s'y
+trouvent ne sont pas de la première priorité. Par exemple, il peut être
+intéressant, pour les visiteurs qui entrent sur le site pour la première
+fois, d'être redirigés vers un sous-répertoire particulier
+<code>/a-propos-de/</code>. Pour ce faire, on peut utiliser 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>
+
+<example><pre>
+RewriteEngine on
+RewriteRule <strong>^/$</strong> /a-propos-de/ [<strong>R</strong>]
+</pre></example>
+
+ <p>Notez que le même effet peut être obtenu à l'aide de la directive
+ <directive module="mod_alias">RedirectMatch</directive> :</p>
+
+<example>
+RedirectMatch ^/$ http://exemple.com/apropos/
+</example>
+<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 ne réécrira pas une requête pour
+<code>http://example.com/page.html</code>. En fait, si vous avez modifié
+la racine de vos documents - c'est à dire si tous vos contenus se
+trouvent dans ce sous-répertoire, il vaut mieux simplement modifier
+votre directive <directive module="core">DocumentRoot</directive> que de
+procéder à une réécriture d'URLs.</p>
+</dd>
+</dl>
+
+ </section>
+
+ <section id="trailingslash">
+
+ <title>Problème du slash de fin</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd><p>La plupart des problèmes de "slash de fin" peuvent être
+ résolus grâce aux techniques décrites dans ce <a
+ href="http://httpd.apache.org/docs/misc/FAQ-E.html#set-servername">sujet
+ de la FAQ</a>. Cependant, dans certaines situations où l'absence de slash de fin
+ peut rendre une URL inopérante, l'utilisation de
+ mod_rewrite s'avère nécessaire. Le cas peut se présenter, par exemple,
+ après une série complexe de règles de réécriture.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>La solution à ce problème subtil consiste à laisser le
+ serveur ajouter le slash de fin automatiquement. Pour y
+ parvenir, il faut utiliser une redirection externe, afin que
+ le navigateur demande correctement les images sous-jacentes,
+ etc... Une réécriture en interne ne fonctionnerait que pour la
+ page du répertoire, mais échouerait pour toute image incluse
+ dans cette page via des liens relatifs, car le navigateur
+ demanderait un objet inséré. Par exemple, une requête pour
+ <code>image.gif</code> dans <code>/~quux/foo/index.html</code>
+ deviendrait <code>/~quux/image.gif</code> sans la redirection
+ externe !</p>
+
+ <p>Pour y parvenir, on peut utiliser des règles de ce style :</p>
+
+<example><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo<strong>$</strong> foo<strong>/</strong> [<strong>R</strong>]
+</pre></example>
+
+ <p>Vous pouvez aussi ajouter ce qui suit dans un fichier
+ <code>.htaccess</code> situé dans le répertoire contenant la
+ ressource. Notez cependant que cela augmente la charge du processeur.</p>
+
+<example><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteCond %{REQUEST_FILENAME} <strong>-d</strong>
+RewriteRule ^(.+<strong>[^/]</strong>)$ $1<strong>/</strong> [R]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="movehomedirs">
+
+ <title>Déplacement des répertoires home vers un autre serveur</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>De nombreux webmasters ont demandé comment résoudre le
+ problème suivant : ils voudraient tout simplement rediriger
+ les répertoires home d'un serveur web vers un autre serveur
+ web. Cette situation se présente en général lorsqu'on installe
+ un nouveau serveur web destiné à terme à en remplacer un autre
+ plus ancien.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Avec <module>mod_rewrite</module>, la solution est
+ évidente. Sur l'ancien serveur web, on redirige simplement
+ toutes les URLs du style <code>/~user/chemin</code> vers
+ <code>http://nouveau-serveur/~user/chemin</code>.</p>
+
+<example><pre>
+RewriteEngine on
+RewriteRule ^/~(.+) http://<strong>nouveau-serveur</strong>/~$1 [R,L]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="multipledirs">
+
+ <title>Recherche de pages dans plus d'un répertoire</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Le serveur web doit parfois rechercher des pages dans plus
+ d'un répertoire. Dans ce cas, les vues multiples ou autres
+ techniques similaires ne sont d'aucun secours.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On définit explicitement un jeu de règles qui recherche les
+ fichiers dans les répertoires.</p>
+
+<example><pre>
+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></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="setenvvars">
+
+ <title>Définir des variables d'environnement en fonction de
+ certaines parties de l'URL</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment conserver des informations
+ d'état d'une requête à l'autre et utiliser l'URL pour les
+ encoder, sans utiliser d'encapsulateur CGI
+ pour toutes les pages pour seulement supprimer ces
+ informations.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise une règle de réécriture pour supprimer
+ l'information d'état et l'enregistrer dans une variable
+ d'environnement dont on pourra plus tard extraire la valeur
+ dans XSSI ou CGI. De cette façon, une URL telle que
+ <code>/foo/S=java/bar/</code> sera traduite en
+ <code>/foo/bar/</code> et la variable d'environnement
+ <code>STATUS</code> aura pour valeur "java".</p>
+
+<example><pre>
+RewriteEngine on
+RewriteRule ^(.*)/<strong>S=([^/]+)</strong>/(.*) $1/$3 [E=<strong>STATUS:$2</strong>]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="uservhosts">
+
+ <title>Hôtes virtuels basés sur l'utilisateur</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Supposons que vous vouliez atteindre la page d'accueil des
+ utilisateurs sur une même machine au moyen de l'URL
+ <code>www.<strong>nom-utilisateur</strong>.hôte.domaine.com</code>,
+ en vous basant
+ seulement sur les enregistrements DNS de type A, et ceci sans qu'aucun
+ hôte virtuel ne soit installé sur cette machine.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Dans le cas des requêtes HTTP/1.0, il n'y a pas de solution
+ ; par contre, avec une requête HTTP/1.1 qui contient un
+ en-tête HTTP Host:, on peut utiliser le jeu de règles suivant
+ pour réécrire en interne
+ <code>http://www.nom-utilisateur.hôte.com/chemin</code> vers
+ <code>/home/nom-utilisateur/chemin</code> :</p>
+
+<example><pre>
+RewriteEngine on
+RewriteCond %{<strong>HTTP_HOST</strong>} ^www\.<strong>([^.]+)</strong>\.host\.com$
+RewriteRule ^(.*) /home/<strong>%1</strong>$1
+</pre></example>
+<p>Les parenthèses utilisées dans une directive <directive
+module="mod_rewrite">RewriteCond</directive> sont capturées dans les
+références arrières <code>%1</code>, <code>%2</code>, etc..., alors que
+les parenthèses utilisées dans une directive <directive
+module="mod_rewrite">RewriteRule</directive> sont capturées dans les
+références arrières <code>$1</code>, <code>$2</code>, etc...</p>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="redirecthome">
+
+ <title>Redirection des répertoires d'accueil pour les étrangers</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>On veut rediriger les URLs des répertoires d'accueil vers
+ un autre serveur <code>www.quelque-part.com</code> lorsque
+ l'utilisateur demandeur n'appartient pas au domaine local
+ <code>notre-domaine.com</code>. On rencontre parfois cette
+ situation dans un contexte d'hôtes virtuels.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Juste une condition de réécriture :</p>
+
+<example><pre>
+RewriteEngine on
+RewriteCond %{REMOTE_HOST} <strong>!^.+\.notre-domaine\.com$</strong>
+RewriteRule ^(/~.+) http://www.quelque-part.com/$1 [R,L]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="redirectanchors">
+
+ <title>Redirection des ancrages</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Par défaut, la redirection vers un ancrage HTML ne fonctionne
+ pas, car mod_rewrite échappe le caractère <code>#</code> en le
+ transformant en <code>%23</code>, ce qui rend la redirection
+ inopérante.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise le drapeau <code>[NE]</code> dans la règle
+ <code>RewriteRule</code>. NE signifie "No Escape".
+ </p>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="time-dependent">
+
+ <title>Réécriture dépendant de l'heure</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Lorsqu'il s'agit de distribuer des contenus dont la nature
+ dépend de l'heure, de nombreux webmasters utilisent encore des
+ scripts CGI qui redirigent par exemple vers des pages
+ spécifiques. Comment peut-on y parvenir à tenir compte de
+ l'heure à l'aide de <module>mod_rewrite</module> ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Il existe de nombreuses variables nommées
+ <code>TIME_xxx</code> utilisables dans les conditions de
+ réécriture. Utilisées en conjonction avec les modèles de
+ comparaison lexicographique spéciaux <code><STRING</code>,
+ <code>>STRING</code> et <code>=STRING</code>, elles
+ permettent d'effectuer des redirections dépendant de
+ l'heure :</p>
+
+<example><pre>
+RewriteEngine on
+RewriteCond %{TIME_HOUR}%{TIME_MIN} >0700
+RewriteCond %{TIME_HOUR}%{TIME_MIN} <1900
+RewriteRule ^foo\.html$ foo.jour.html
+RewriteRule ^foo\.html$ foo.nuit.html
+</pre></example>
+
+ <p>Avec cet exemple, l'URL <code>foo.html</code> renvoie
+ le contenu de <code>foo.jour.html</code> durant le
+ créneau horaire <code>07:00-19:00</code>, et le contenu de
+ <code>foo.nuit.html</code> le reste du temps. Agréable
+ fonctionnalité pour une page d'accueil...</p>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="backward-compatibility">
+
+ <title>Compatibilité ascendante pour une migration de YYYY vers
+ XXXX</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>.phtml</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>
+
+
+<example><pre>
+# jeu de règles assurant une compatibilité ascendante en réécrivant
+# document.html en document.phtml si et seulement si document.phtml
+# existe et document.html n'existe plus
+RewriteEngine on
+RewriteBase /~quux/
+# réécriture du fichier en son nom de base,
+# mais garde en mémoire le fait qu'il s'agit
+# d'un fichier html
+RewriteRule ^(.*)\.html$ $1 [C,E=WasHTML:yes]
+# réécrit vers document.phtml s'il existe
+# Note : il s'agit d'un exemple de niveau répertoire, si bien que
+# %{REQUEST_FILENAME} contient le chemin complet du système de fichier
+# tel qu'il a été construit par le serveur.
+RewriteCond %{REQUEST_FILENAME}.phtml -f
+RewriteRule ^(.*)$ $1.phtml [S=1]
+# sinon, restauration du nom de fichier complet original
+RewriteCond %{ENV:WasHTML} ^yes$
+RewriteRule ^(.*)$ $1.html
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="old-to-new">
+
+ <title>De l'ancien au nouveau (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>
+
+<example><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html
+</pre></example>
+ </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. Par contre, nous voulons cette
+ fois que les utilisateurs de l'ancienne URL soient redirigés
+ vers la nouvelle, c'est à dire que l'adresse tapée
+ dans leur navigateur doit aussi ê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>
+
+<example><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^<strong>foo</strong>\.html$ <strong>bar</strong>.html [<strong>R</strong>]
+</pre></example>
+ </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>
+
+<example><pre>
+RewriteEngine on
+RewriteBase /~quux/
+RewriteRule ^foo\.<strong>html</strong>$ foo.<strong>cgi</strong> [H=<strong>cgi-script</strong>]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="blocking-of-robots">
+
+ <title>Blocage des robots</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment empêcher un robot vraiment gênant de collecter les
+ pages d'une partie spécifique du site web ? Un fichier
+ <code>/robots.txt</code> comportant les entrées du "Protocole
+ d'Exclusion des Robots" ne suffit généralement pas à en venir
+ à bout.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>On utilise un jeu de règles qui interdit les URLs de la
+ partie du site web concernée <code>/~quux/foo/arc/</code>
+ (peut-être une partie du serveur avec une arborescence très
+ développée à travers laquelle le parcours du
+ robot induirait une charge importante pour le serveur). Nous
+ devons nous assurer de n'interdire l'accès qu'à ce robot
+ particulier, c'est à dire qu'il ne suffit pas d'interdire
+ l'accès à l'hôte sur lequel le robot fonctionne, ce qui
+ bloquerait aussi les utilisateurs de cet hôte. Pour y
+ parvenir, on tient aussi compte des informations contenues
+ dans l'en-tête HTTP User-Agent.</p>
+
+<example><pre>
+RewriteCond %{HTTP_USER_AGENT} ^<strong>NameOfBadRobot</strong>.*
+RewriteCond %{REMOTE_ADDR} ^<strong>123\.45\.67\.[8-9]</strong>$
+RewriteRule ^<strong>/~quux/foo/arc/</strong>.+ - [<strong>F</strong>]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="blocked-inline-images">
+
+ <title>Blocage du référencement à chaud (Hotlinking) d'images</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Cette technique vous permet d'interdire à d'autres sites
+ d'inclure directement vos images dans leurs pages. On fait
+ souvent référence à cette pratique sous le nom de
+ référencement à chaud (Hotlinking) qui entraîne l'utilisation
+ de votre bande passante pour servir des contenus faisant
+ partie du site de quelqu'un d'autre.</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Cette technique repose sur la valeur de la variable
+ optionnelle <code>HTTP_REFERER</code>. Certaines personnes
+ pourront donc contourner cette limitation. Pour la plupart des
+ utilisateurs cependant, la requête échouera, en ce sens que
+ l'image ne sera pas affichée depuis le site tiers.</p>
+ <p>Il y a plusieurs manières de gérer cette situation.</p>
+
+ <p>Dans le premier exemple, nous rejetons tout simplement la
+ requête si elle ne provenait pas d'une page appartenant à notre
+ site. Pour les besoins de cet exemple, nous supposons que le nom
+ de votre site est <code>www.example.com</code>.</p>
+
+<example><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> - [F,NC]
+</pre></example>
+
+ <p>Dans le second exemple, plutôt que de rejeter la requête,
+ nous affichons une autre image à la place.</p>
+
+<example><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> /images/go-away.png [R,NC]
+</pre></example>
+
+ <p>Dans le troisième exemple, nous redirigeons la requête vers
+ une image appartenant à un site tiers.</p>
+
+
+<example><pre>
+RewriteCond %{HTTP_REFERER} <strong>!^$</strong>
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule <strong>\.(gif|jpg|png)$</strong> http://other.site.com/image.gif [R,NC]
+</pre></example>
+ <p>De tous ces exemples, les deux derniers semblent les plus
+ efficaces pour faire en sorte que les gens arrêtent de
+ référencer vos images à chaud, car il ne verront pas les images
+ qu'ils s'attendent à voir.</p>
+
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="proxy-deny">
+
+ <title>Interdiction du mandataire</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Comment interdire l'utilisation du mandataire d'Apache à un
+ certain hôte, ou même à un utilisateur d'un certain hôte ?</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Nous devons tout d'abord nous assurer que
+ <module>mod_rewrite</module> se situe en dessous (!) de
+ <module>mod_proxy</module> dans le fichier de configuration
+ lors de la compilation du serveur web Apache. De cette façon,
+ il est appelé <em>avant</em> <module>mod_proxy</module>. Nous
+ pouvons alors utiliser la règle suivante pour une interdiction
+ concernant un hôte...</p>
+
+<example><pre>
+RewriteCond %{REMOTE_HOST} <strong>^mauvais-hôte\.mon-domaine\.com$</strong>
+RewriteRule !^http://[^/.]\.mon-domaine.com.* - [F]
+</pre></example>
+
+ <p>...et celle-ci pour une interdiction concernant un
+ utilisateur d'un certain hôte :</p>
+
+<example><pre>
+RewriteCond %{REMOTE_IDENT}@%{REMOTE_HOST}
+<strong>^mauvais-sujet@mauvais-hôte\.mon-domaine\.com$</strong>
+RewriteRule !^http://[^/.]\.mon-domaine.com.* - [F]
+</pre></example>
+ </dd>
+ </dl>
+
+ </section>
+
+ <section id="external-rewriting">
+
+ <title>Moteur de réécriture externe</title>
+
+ <dl>
+ <dt>Description :</dt>
+
+ <dd>
+ <p>Une question de la Faq : comment résoudre le problème
+ FOO/BAR/QUUX/etc. ? <module>mod_rewrite</module> ne semble pas
+ devoir y apporter de solution...</p>
+ </dd>
+
+ <dt>Solution :</dt>
+
+ <dd>
+ <p>Utiliser une <directive module="mod_rewrite"
+ >RewriteMap</directive> ou table de réécriture externe, c'est
+ à dire un programme qui agit de la même façon qu'une
+ <directive module="mod_rewrite">RewriteMap</directive>. Il
+ doit être lancé une fois au démarrage d'Apache, recevoir les
+ URLs des requêtes sur <code>STDIN</code>, et restituer l'URL
+ résultante (en général réécrite) sur <code>STDOUT</code> (dans
+ cet ordre !).</p>
+
+<example><pre>
+RewriteEngine on
+RewriteMap quux-table <strong>prg:</strong>/chemin/vers/table.quux.pl
+RewriteRule ^/~quux/(.*)$ /~quux/<strong>${quux-table:$1}</strong>
+</pre></example>
+
+<example><pre>
+#!/chemin/vers/perl
+
+# désactive la mise en tampon des entrées/sorties, qui risque
+# de provoquer des bouclages infinis pour le serveur Apache
+$| = 1;
+
+# lit les URLs (une par ligne) depuis stdin et
+# génère l'URL transformée sur stdout
+
+# read URLs one per line from stdin and
+# generate substitution URL on stdout
+while (<>) {
+ s|^foo/|bar/|;
+ print $_;
+}
+</pre></example>
+
+ <p>Ceci n'est qu'un exemple de démonstration qui ne fait que
+ réécrire les URLs du style <code>/~quux/foo/...</code> vers
+ <code>/~quux/bar/...</code>. En fait, vous pouvez programmer
+ la substitution que vous voulez. Notez cependant que si de
+ tels programmes peuvent aussi être <strong>utilisés</strong>
+ par un utilisateur standard, seul l'administrateur du système
+ peut les <strong>écrire</strong>.</p>
+ </dd>
+ </dl>
+
+ </section>
+
+</manualpage>
+
<variants>
<variant>en</variant>
+ <variant>fr</variant>
</variants>
</metafile>
URI: rewrite_intro.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+
+URI: rewrite_intro.html.fr
+Content-Language: fr
+Content-type: text/html; charset=ISO-8859-1
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP Server</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Apache mod_rewrite Introduction</h1>
<div class="toplang">
-<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_intro.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_intro.html" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div>
<p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
</div></div>
<div class="bottomlang">
-<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_intro.html" title="English"> en </a></p>
+<p><span>Available Languages: </span><a href="../en/rewrite/rewrite_intro.html" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_intro.html" hreflang="fr" rel="alternate" title="Français"> fr </a></p>
</div><div id="footer">
<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Licensed under the <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="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
--- /dev/null
+<?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>Introduction au module Apache 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 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="../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.3</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.3</a> > <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Introduction au module Apache mod_rewrite</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewrite_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_intro.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> du module
+<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit les concepts de base dont la
+connaissance est nécessaire pour l'utilisation de
+<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. D'autres documents entrent d'avantage dans
+les détails, mais celui-ci devrait aider le débutant à se mouiller les
+pieds.
+</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#regex">Expressions rationnelles</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#rewriterule">Les bases des règles de réécriture</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#flags">Drapeaux de réécriture</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#rewritecond">Conditions de réécriture</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#rewritemap">Tables de réécriture</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du
+module</a></li><li><a href="rewrite_tech.html">Détails techniques</a></li><li><a href="rewrite_guide.html">Solutions pratiques aux problèmes
+courants</a></li><li><a href="rewrite_guide_advanced.html">Solutions pratiques aux
+problèmes plus complexes</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="introduction" id="introduction">Introduction</a></h2>
+<p>Le module Apache <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> est un module puissant
+et sophistiqué qui permet la réécriture des URLs. Grâce à lui, vous
+pouvez effectuer quasiment tous les types de réécriture d'URLs dont vous
+avez besoin. Il est cependant assez complexe, et peut paraître
+intimidant au débutant. Certains ont aussi tendance à traiter les
+règles de réécriture comme des incantations magiques, et à les utiliser
+sans vraiment comprendre leur manière d'agir.</p>
+
+<p>Ce document a pour ambition d'être suffisamment explicite pour
+permettre la compréhension, et non la copie en aveugle, de ce qui suit.
+</p>
+
+<p>Gardez à l'esprit que de nombreuses tâches de manipulation d'URLs
+courantes n'ont pas besoin de la puissance et de la complexité de
+<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour les tâches simples, voir
+<code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code> et la documentation sur la <a href="../urlmapping.html">Mise en correspondance des URLs avec le
+système de fichiers</a>.</p>
+
+<p>Enfin, avant de procéder, assurez-vous d'avoir configuré la directive
+<code class="directive"><a href="../mod/mod_rewrite.html#rewritelog">RewriteLog</a></code>. Bien que ce
+fichier journal puisse contenir une quantité impressionnante d'informations,
+il s'avère indispensable pour le débogage des problèmes avec la
+configuration de <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, car il vous indiquera
+exactement la manière dont chaque règle est traitée.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="regex" id="regex">Expressions rationnelles</a></h2>
+
+<p>mod_rewrite utilise le vocabulaire des <a href="http://pcre.org/">Expressions rationnelles compatibles Perl</a>.
+Ce document n'a pas pour prétention d'être une référence détaillée des
+expressions rationnelles. A cet effet, nous recommandons les <a href="http://pcre.org/pcre.txt">pages de manuel de PCRE</a>, la <a href="http://perldoc.perl.org/perlre.html">page de manuel des
+expressions rationnelles Perl</a>, et l'ouvrage <a href="http://www.oreilly.com/catalog/regex2/index.html">Mastering
+Regular Expressions, by Jeffrey Friedl</a>.</p>
+
+<p>Dans ce document, nous avons pour but de vous fournir suffisamment de
+vocabulaire des expressions rationnelles pour vous mettre le pied à
+l'étrier, sans être dépassé, en espérant que les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> vous apparaîtront comme des
+formules scientifiques, plutôt que comme des incantations magiques.</p>
+
+<h3><a name="regexvocab" id="regexvocab">Vocabulaire des expressions rationnelles</a></h3>
+
+<p>Vous trouverez dans ce qui suit le minimum à connaître pour être en
+mesure d'écrire des expressions rationnelles et des règles <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. Ceci ne représente
+certainement pas un vocabulaire des expressions rationnelles complet,
+mais constitue un bon point de départ, et devrait vous aider à
+déchiffrer les expressions rationnelles simples, et à écrire vos propres
+expressions.</p>
+
+<table>
+<tr>
+<th>Motif</th>
+<th>Signification</th>
+<th>Exemple</th>
+</tr>
+
+<tr><td><code>.</code></td><td>Correspond à tout caractère unique
+</td><td><code>c.t</code> correspondra à <code>cat</code>,
+<code>cot</code>, <code>cut</code>, etc.</td></tr>
+<tr><td><code>+</code></td><td>Répète le caractère de correspondance
+précédent une ou plusieurs fois</td>
+<td><code>a+</code> correspond à <code>a</code>, <code>aa</code>,
+<code>aaa</code>, etc.</td></tr>
+<tr><td><code>*</code></td><td>Répète le caractère de correspondance
+précédent zéro ou plusieurs fois</td>
+<td><code>a*</code> correspond à tout ce à quoi correspond
+<code>a+</code>, mais correspond aussi à la chaîne vide.</td></tr>
+<tr><td><code>?</code></td><td>Rend la correspondance optionnelle.</td><td>
+<code>colou?r</code> correspondra à <code>color</code> et <code>colour</code>.</td>
+</tr>
+<tr><td><code>^</code></td><td>Appelé ancrage, correspond au début de la
+chaîne</td>
+<td><code>^a</code> correspond à une chaîne qui commence par
+<code>a</code></td></tr>
+<tr><td><code>$</code></td><td>L'autre ancrage, correspond à la fin de
+la chaîne.</td>
+<td><code>a$</code> correspond à une chaîne qui se termine par
+<code>a</code>.</td></tr>
+<tr><td><code>( )</code></td><td>Regroupe plusieurs caractères en une
+seule entité, et conserve une correspondance à des fins d'utilisation
+dans une référence arrière.</td>
+<td><code>(ab)+</code>
+correspond à <code>ababab</code> - à savoir, le <code>+</code>
+s'applique au groupe.
+Pour plus de détails sur les références arrières, voir <a href="#InternalBackRefs">ci-dessous</a>.</td></tr>
+<tr><td><code>[ ]</code></td><td>Une classe de caractères - correspond à
+un des caractères de la classe</td>
+<td><code>c[uoa]t</code> correspond à <code>cut</code>,
+<code>cot</code> ou <code>cat</code>.</td></tr>
+<tr><td><code>[^ ]</code></td><td>Négation de la classe de caractères -
+correspond à tout caractère ne faisant pas partie de la classe</td>
+<td><code>c[^/]t</code> correspond à <code>cat</code> ou
+<code>c=t</code> mais pas à <code>c/t</code></td></tr>
+</table>
+
+<p>Avec <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, le caractère <code>!</code> peut
+préfixer une expression rationnelle afin d'en exprimer la négation.
+Autrement dit, une chaîne ne correspondra que si elle ne correspond pas
+à l'expression située après le <code>!</code>.</p>
+
+
+
+<h3><a name="InternalBackRefs" id="InternalBackRefs">Disponibilité des références
+arrières dans les expressions rationnelles</a></h3>
+
+ <p>Vous devez vous souvenir d'une chose importante : chaque fois
+ que vous utilisez des parenthèses dans un <em>Modèle</em> ou dans
+ un des <em>modèles de conditions</em>, des références arrières
+ sont créées en interne et peuvent être rappelées via les chaînes
+ <code>$N</code> et <code>%N</code> (voir ci-dessous). Ces
+ références sont disponibles lors de la création des chaînes de
+ <em>Substitution</em> et des <em>Chaînes de test</em>. La figure 2
+ montre à quels endroits les références arrières sont suceptibles
+ d'être développées.</p>
+
+<p class="figure">
+ <img src="../images/mod_rewrite_fig2.gif" width="381" height="179" alt="[Pas affichable sans support des images]" /><br />
+ <dfn>Figure 2:</dfn> Le cheminement d'une référence arrière à
+ travers une règle.
+</p>
+
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="rewriterule" id="rewriterule">Les bases des règles de réécriture</a></h2>
+<p>Une règle de réécriture <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est constituée de trois
+arguments séparés par des espaces. Les arguments sont :</p>
+<ol>
+<li><var>Modèle</var>: le modèle des URLs auxquelles la règle doit
+s'appliquer;</li>
+<li><var>Substitution</var>: vers quoi la requête correspondante doit être
+transformée;</li>
+<li><var>[drapeaux]</var>: options affectant la requête réécrite.</li>
+</ol>
+
+<p>Le <var>Modèle</var> est toujours une <a href="#regex">expression
+rationnelle</a> comparée au chemin de l'URL de la requête entrante (la
+partie située après le nom d'hôte mais avant tout point d'interrogation
+qui indique le début d'une chaîne de requête).</p>
+
+<p>La chaîne de <var>Substitution</var> peut, quant à elle, être de
+trois types :</p>
+
+<dl>
+<dt>Un chemin complet du système de fichiers vers une ressource</dt>
+<dd>
+<div class="example"><p><code>
+RewriteRule ^/jeux.* /usr/local/jeux/web
+</code></p></div>
+<p>Ceci peut faire correspondre une requête à toute localisation voulue de
+votre système de fichiers, un peu comme la directive <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>.</p>
+</dd>
+
+<dt>Un chemin web vers une ressource</dt>
+<dd>
+<div class="example"><p><code>
+RewriteRule ^/foo$ /bar
+</code></p></div>
+<p>Si la directive <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> a
+pour valeur <code>/usr/local/apache2/htdocs</code>, cette règle va faire
+correspondre les requêtes pour <code>http://example.com/foo</code> au
+chemin <code>/usr/local/apache2/htdocs/bar</code>.</p>
+</dd>
+
+<dt>Une URL absolue</dt>
+<dd>
+<div class="example"><p><code>
+RewriteRule ^/produits/vues$ http://site2.exemple.com/voirproduits.html [R]
+</code></p></div>
+<p>Ceci informe le client qu'il doit effectuer une nouvelle requête vers
+l'URL spécifiée.</p>
+</dd>
+</dl>
+
+<p>La chaîne de <var>Substitution</var> peut aussi contenir des
+<em>références arrières</em> vers des parties du chemin d'URL entrant
+correspondant au <var>Modèle</var>. Considérons ce qui suit :</p>
+<div class="example"><p><code>
+RewriteRule ^/produits/(.*)/view$ /var/web/produitsdb/$1
+</code></p></div>
+<p>La variable <code>$1</code> sera remplacée par tout texte
+correspondant à l'expression située entre les parenthèses dans le
+<var>Modèle</var>. Par exemple, une requête pour
+<code>http://example.com/produits/r14df/vue</code> correspondra au
+chemin <code>/var/web/produitsdb/r14df</code>.</p>
+
+<p>S'il y a plus d'une expression entre parenthèses, elle seront
+accessibles selon leur ordre d'apparition via les variables
+<code>$1</code>, <code>$2</code>, <code>$3</code>, etc...</p>
+
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="flags" id="flags">Drapeaux de réécriture</a></h2>
+<p>Le comportement d'une règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> peut être modifié par la
+présence d'un ou plusieurs drapeaux en fin de règle. Par exemple, les
+conditions de correspondance d'une règle peuvent être rendues
+insensibles à la casse par la présence du drapeau <code>[NC]</code> :
+</p>
+<div class="example"><p><code>
+RewriteRule ^puppy.html petitchien.html [NC]
+</code></p></div>
+
+<p>Pour une liste des drapeaux disponibles, leurs significations, et des
+exemples, voir le document <a href="rewrite_flags.html">Drapeaux de
+réécriture</a>.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="rewritecond" id="rewritecond">Conditions de réécriture</a></h2>
+<p>Il est possible d'utiliser une ou plusieurs directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> pour restreindre les types
+de requêtes auxquelles devra s'appliquer la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> suivante. Le premier
+argument est une variable décrivant une caractéristique de la requête,
+le second argument est une <a href="#regex">expression rationnelle</a>
+qui doit correspondre à la variable, et un troisième argument optionnel
+est une liste de drapeaux qui modifient la manière dont la
+correspondance est évaluée.</p>
+
+<p>Par exemple, pour renvoyer toutes les requêtes en provenance d'une
+certaine tranche d'adresses IP vers un autre serveur, vous pouvez
+utiliser :</p>
+<div class="example"><p><code>
+RewriteCond %{REMOTE_ADDR} ^10\.2\.<br />
+RewriteRule (.*) http://intranet.exemple.com$1
+</code></p></div>
+
+<p>Si vous spécifiez plus d'une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>, ces directives
+doivent toutes être satisfaites pour que la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> suivante s'applique. Par exemple,
+pour interdire les requêtes qui contiennent le mot "hack" dans la chaîne
+de requête, sauf si elles contiennent aussi un cookie contenant le mot
+"go", vous pouvez utiliser :</p>
+<div class="example"><p><code>
+RewriteCond %{QUERY_STRING} hack<br />
+RewriteCond %{HTTP_COOKIE} !go<br />
+RewriteRule .* - [F]
+</code></p></div>
+<p>Notez que le point d'exclamation indique une correspondance négative
+; ainsi, la règle n'est appliquée que si le cookie ne contient pas "go"</p>
+
+<p>Les correspondances dans les expressions rationnelles contenues dans
+les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code>
+peuvent constituer des parties de la chaîne de <var>Substitution</var>
+de la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> via
+les variables <code>%1</code>, <code>%2</code>, etc... Par
+exemple, ce qui suit va diriger la requête vers un répertoire différent
+en fonction du nom d'hôte utilisé pour accéder au site :</p>
+<div class="example"><p><code>
+RewriteCond %{HTTP_HOST} (.*)<br />
+RewriteRule ^/(.*) /sites/%1/$1
+</code></p></div>
+<p>Si la requête concernait <code>http://example.com/foo/bar</code>,
+alors <code>%1</code> contiendrait <code>example.com</code> et
+<code>$1</code> contiendrait <code>foo/bar</code>.</p>
+
+
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="rewritemap" id="rewritemap">Tables de réécriture</a></h2>
+<p>Voir la directive
+<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="htaccess" id="htaccess">Fichiers .htaccess</a></h2>
+
+<p>La réécriture est en général définie au niveau de la configuration du
+serveur principal (en dehors de toute section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>) ou dans une section <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>. Il s'agit là de la
+manière la plus simple de mettre en oeuvre la réécriture et nous la
+recommandons. Il est possible, cependant, de mettre en oeuvre la
+réécriture au sein d'une section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> ou d'un fichier <a href="../howto/htaccess.html"><code>.htaccess</code></a> ; ce type de
+configuration est cependant plus complexe. Cette technique est appelée
+réécriture par répertoire.</p>
+
+<p>La principale différence avec les réécritures au niveau du serveur réside
+dans le fait que le préfixe du chemin du répertoire contenant le fichier
+<code>.htaccess</code> est supprimé avant la mise en correspondance dans
+la règle <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>. De
+plus, on doit utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> pour s'assurer que la
+requête est correctement mise en correspondance.</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/rewrite/rewrite_intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/rewrite/rewrite_intro.html" title="Français"> fr </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 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="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
--- /dev/null
+<?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 : 653690 -->
+<!-- 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="rewrite_intro.xml.meta">
+<parentdocument href="./">Rewrite</parentdocument>
+
+ <title>Introduction au module Apache mod_rewrite</title>
+
+<summary>
+<p>Ce document est un complément à la <a
+href="../mod/mod_rewrite.html">documentation de référence</a> du module
+<module>mod_rewrite</module>. Il décrit les concepts de base dont la
+connaissance est nécessaire pour l'utilisation de
+<module>mod_rewrite</module>. D'autres documents entrent d'avantage dans
+les détails, mais celui-ci devrait aider le débutant à se mouiller les
+pieds.
+</p>
+</summary>
+
+<seealso><a href="../mod/mod_rewrite.html">Documentation du
+module</a></seealso>
+<seealso><a href="rewrite_tech.html">Détails techniques</a></seealso>
+<seealso><a href="rewrite_guide.html">Solutions pratiques aux problèmes
+courants</a></seealso>
+<seealso><a href="rewrite_guide_advanced.html">Solutions pratiques aux
+problèmes plus complexes</a></seealso>
+
+<section id="introduction"><title>Introduction</title>
+<p>Le module Apache <module>mod_rewrite</module> est un module puissant
+et sophistiqué qui permet la réécriture des URLs. Grâce à lui, vous
+pouvez effectuer quasiment tous les types de réécriture d'URLs dont vous
+avez besoin. Il est cependant assez complexe, et peut paraître
+intimidant au débutant. Certains ont aussi tendance à traiter les
+règles de réécriture comme des incantations magiques, et à les utiliser
+sans vraiment comprendre leur manière d'agir.</p>
+
+<p>Ce document a pour ambition d'être suffisamment explicite pour
+permettre la compréhension, et non la copie en aveugle, de ce qui suit.
+</p>
+
+<p>Gardez à l'esprit que de nombreuses tâches de manipulation d'URLs
+courantes n'ont pas besoin de la puissance et de la complexité de
+<module>mod_rewrite</module>. Pour les tâches simples, voir
+<module>mod_alias</module> et la documentation sur la <a
+href="../urlmapping.html">Mise en correspondance des URLs avec le
+système de fichiers</a>.</p>
+
+<p>Enfin, avant de procéder, assurez-vous d'avoir configuré la directive
+<directive module="mod_rewrite">RewriteLog</directive>. Bien que ce
+fichier journal puisse contenir une quantité impressionnante d'informations,
+il s'avère indispensable pour le débogage des problèmes avec la
+configuration de <module>mod_rewrite</module>, car il vous indiquera
+exactement la manière dont chaque règle est traitée.</p>
+</section>
+
+<section id="regex"><title>Expressions rationnelles</title>
+
+<p>mod_rewrite utilise le vocabulaire des <a
+href="http://pcre.org/">Expressions rationnelles compatibles Perl</a>.
+Ce document n'a pas pour prétention d'être une référence détaillée des
+expressions rationnelles. A cet effet, nous recommandons les <a
+href="http://pcre.org/pcre.txt">pages de manuel de PCRE</a>, la <a
+href="http://perldoc.perl.org/perlre.html">page de manuel des
+expressions rationnelles Perl</a>, et l'ouvrage <a
+href="http://www.oreilly.com/catalog/regex2/index.html">Mastering
+Regular Expressions, by Jeffrey Friedl</a>.</p>
+
+<p>Dans ce document, nous avons pour but de vous fournir suffisamment de
+vocabulaire des expressions rationnelles pour vous mettre le pied à
+l'étrier, sans être dépassé, en espérant que les directives <directive
+module="mod_rewrite">RewriteRule</directive> vous apparaîtront comme des
+formules scientifiques, plutôt que comme des incantations magiques.</p>
+
+<section id="regexvocab"><title>Vocabulaire des expressions rationnelles</title>
+
+<p>Vous trouverez dans ce qui suit le minimum à connaître pour être en
+mesure d'écrire des expressions rationnelles et des règles <directive
+module="mod_rewrite">RewriteRule</directive>. Ceci ne représente
+certainement pas un vocabulaire des expressions rationnelles complet,
+mais constitue un bon point de départ, et devrait vous aider à
+déchiffrer les expressions rationnelles simples, et à écrire vos propres
+expressions.</p>
+
+<table>
+<tr>
+<th>Motif</th>
+<th>Signification</th>
+<th>Exemple</th>
+</tr>
+
+<tr><td><code>.</code></td><td>Correspond à tout caractère unique
+</td><td><code>c.t</code> correspondra à <code>cat</code>,
+<code>cot</code>, <code>cut</code>, etc.</td></tr>
+<tr><td><code>+</code></td><td>Répète le caractère de correspondance
+précédent une ou plusieurs fois</td>
+<td><code>a+</code> correspond à <code>a</code>, <code>aa</code>,
+<code>aaa</code>, etc.</td></tr>
+<tr><td><code>*</code></td><td>Répète le caractère de correspondance
+précédent zéro ou plusieurs fois</td>
+<td><code>a*</code> correspond à tout ce à quoi correspond
+<code>a+</code>, mais correspond aussi à la chaîne vide.</td></tr>
+<tr><td><code>?</code></td><td>Rend la correspondance optionnelle.</td><td>
+<code>colou?r</code> correspondra à <code>color</code> et <code>colour</code>.</td>
+</tr>
+<tr><td><code>^</code></td><td>Appelé ancrage, correspond au début de la
+chaîne</td>
+<td><code>^a</code> correspond à une chaîne qui commence par
+<code>a</code></td></tr>
+<tr><td><code>$</code></td><td>L'autre ancrage, correspond à la fin de
+la chaîne.</td>
+<td><code>a$</code> correspond à une chaîne qui se termine par
+<code>a</code>.</td></tr>
+<tr><td><code>( )</code></td><td>Regroupe plusieurs caractères en une
+seule entité, et conserve une correspondance à des fins d'utilisation
+dans une référence arrière.</td>
+<td><code>(ab)+</code>
+correspond à <code>ababab</code> - à savoir, le <code>+</code>
+s'applique au groupe.
+Pour plus de détails sur les références arrières, voir <a
+href="#InternalBackRefs">ci-dessous</a>.</td></tr>
+<tr><td><code>[ ]</code></td><td>Une classe de caractères - correspond à
+un des caractères de la classe</td>
+<td><code>c[uoa]t</code> correspond à <code>cut</code>,
+<code>cot</code> ou <code>cat</code>.</td></tr>
+<tr><td><code>[^ ]</code></td><td>Négation de la classe de caractères -
+correspond à tout caractère ne faisant pas partie de la classe</td>
+<td><code>c[^/]t</code> correspond à <code>cat</code> ou
+<code>c=t</code> mais pas à <code>c/t</code></td></tr>
+</table>
+
+<p>Avec <module>mod_rewrite</module>, le caractère <code>!</code> peut
+préfixer une expression rationnelle afin d'en exprimer la négation.
+Autrement dit, une chaîne ne correspondra que si elle ne correspond pas
+à l'expression située après le <code>!</code>.</p>
+
+</section>
+
+<section id="InternalBackRefs"><title>Disponibilité des références
+arrières dans les expressions rationnelles</title>
+
+ <p>Vous devez vous souvenir d'une chose importante : chaque fois
+ que vous utilisez des parenthèses dans un <em>Modèle</em> ou dans
+ un des <em>modèles de conditions</em>, des références arrières
+ sont créées en interne et peuvent être rappelées via les chaînes
+ <code>$N</code> et <code>%N</code> (voir ci-dessous). Ces
+ références sont disponibles lors de la création des chaînes de
+ <em>Substitution</em> et des <em>Chaînes de test</em>. La figure 2
+ montre à quels endroits les références arrières sont suceptibles
+ d'être développées.</p>
+
+<p class="figure">
+ <img src="../images/mod_rewrite_fig2.gif" width="381"
+ height="179" alt="[Pas affichable sans support des images]" /><br />
+ <dfn>Figure 2:</dfn> Le cheminement d'une référence arrière à
+ travers une règle.
+</p>
+
+</section>
+</section>
+
+<section id="rewriterule"><title>Les bases des règles de réécriture</title>
+<p>Une règle de réécriture <directive
+module="mod_rewrite">RewriteRule</directive> est constituée de trois
+arguments séparés par des espaces. Les arguments sont :</p>
+<ol>
+<li><var>Modèle</var>: le modèle des URLs auxquelles la règle doit
+s'appliquer;</li>
+<li><var>Substitution</var>: vers quoi la requête correspondante doit être
+transformée;</li>
+<li><var>[drapeaux]</var>: options affectant la requête réécrite.</li>
+</ol>
+
+<p>Le <var>Modèle</var> est toujours une <a href="#regex">expression
+rationnelle</a> comparée au chemin de l'URL de la requête entrante (la
+partie située après le nom d'hôte mais avant tout point d'interrogation
+qui indique le début d'une chaîne de requête).</p>
+
+<p>La chaîne de <var>Substitution</var> peut, quant à elle, être de
+trois types :</p>
+
+<dl>
+<dt>Un chemin complet du système de fichiers vers une ressource</dt>
+<dd>
+<example>
+RewriteRule ^/jeux.* /usr/local/jeux/web
+</example>
+<p>Ceci peut faire correspondre une requête à toute localisation voulue de
+votre système de fichiers, un peu comme la directive <directive
+module="mod_alias">Alias</directive>.</p>
+</dd>
+
+<dt>Un chemin web vers une ressource</dt>
+<dd>
+<example>
+RewriteRule ^/foo$ /bar
+</example>
+<p>Si la directive <directive module="core">DocumentRoot</directive> a
+pour valeur <code>/usr/local/apache2/htdocs</code>, cette règle va faire
+correspondre les requêtes pour <code>http://example.com/foo</code> au
+chemin <code>/usr/local/apache2/htdocs/bar</code>.</p>
+</dd>
+
+<dt>Une URL absolue</dt>
+<dd>
+<example>
+RewriteRule ^/produits/vues$ http://site2.exemple.com/voirproduits.html [R]
+</example>
+<p>Ceci informe le client qu'il doit effectuer une nouvelle requête vers
+l'URL spécifiée.</p>
+</dd>
+</dl>
+
+<p>La chaîne de <var>Substitution</var> peut aussi contenir des
+<em>références arrières</em> vers des parties du chemin d'URL entrant
+correspondant au <var>Modèle</var>. Considérons ce qui suit :</p>
+<example>
+RewriteRule ^/produits/(.*)/view$ /var/web/produitsdb/$1
+</example>
+<p>La variable <code>$1</code> sera remplacée par tout texte
+correspondant à l'expression située entre les parenthèses dans le
+<var>Modèle</var>. Par exemple, une requête pour
+<code>http://example.com/produits/r14df/vue</code> correspondra au
+chemin <code>/var/web/produitsdb/r14df</code>.</p>
+
+<p>S'il y a plus d'une expression entre parenthèses, elle seront
+accessibles selon leur ordre d'apparition via les variables
+<code>$1</code>, <code>$2</code>, <code>$3</code>, etc...</p>
+
+
+</section>
+
+<section id="flags"><title>Drapeaux de réécriture</title>
+<p>Le comportement d'une règle <directive
+module="mod_rewrite">RewriteRule</directive> peut être modifié par la
+présence d'un ou plusieurs drapeaux en fin de règle. Par exemple, les
+conditions de correspondance d'une règle peuvent être rendues
+insensibles à la casse par la présence du drapeau <code>[NC]</code> :
+</p>
+<example>
+RewriteRule ^puppy.html petitchien.html [NC]
+</example>
+
+<p>Pour une liste des drapeaux disponibles, leurs significations, et des
+exemples, voir le document <a href="rewrite_flags.html">Drapeaux de
+réécriture</a>.</p>
+
+</section>
+
+
+<section id="rewritecond"><title>Conditions de réécriture</title>
+<p>Il est possible d'utiliser une ou plusieurs directives <directive
+module="mod_rewrite">RewriteCond</directive> pour restreindre les types
+de requêtes auxquelles devra s'appliquer la règle <directive
+module="mod_rewrite">RewriteRule</directive> suivante. Le premier
+argument est une variable décrivant une caractéristique de la requête,
+le second argument est une <a href="#regex">expression rationnelle</a>
+qui doit correspondre à la variable, et un troisième argument optionnel
+est une liste de drapeaux qui modifient la manière dont la
+correspondance est évaluée.</p>
+
+<p>Par exemple, pour renvoyer toutes les requêtes en provenance d'une
+certaine tranche d'adresses IP vers un autre serveur, vous pouvez
+utiliser :</p>
+<example>
+RewriteCond %{REMOTE_ADDR} ^10\.2\.<br />
+RewriteRule (.*) http://intranet.exemple.com$1
+</example>
+
+<p>Si vous spécifiez plus d'une directive <directive
+module="mod_rewrite">RewriteCond</directive>, ces directives
+doivent toutes être satisfaites pour que la règle <directive
+module="mod_rewrite">RewriteRule</directive> suivante s'applique. Par exemple,
+pour interdire les requêtes qui contiennent le mot "hack" dans la chaîne
+de requête, sauf si elles contiennent aussi un cookie contenant le mot
+"go", vous pouvez utiliser :</p>
+<example>
+RewriteCond %{QUERY_STRING} hack<br />
+RewriteCond %{HTTP_COOKIE} !go<br />
+RewriteRule .* - [F]
+</example>
+<p>Notez que le point d'exclamation indique une correspondance négative
+; ainsi, la règle n'est appliquée que si le cookie ne contient pas "go"</p>
+
+<p>Les correspondances dans les expressions rationnelles contenues dans
+les directives <directive module="mod_rewrite">RewriteCond</directive>
+peuvent constituer des parties de la chaîne de <var>Substitution</var>
+de la règle <directive module="mod_rewrite">RewriteRule</directive> via
+les variables <code>%1</code>, <code>%2</code>, etc... Par
+exemple, ce qui suit va diriger la requête vers un répertoire différent
+en fonction du nom d'hôte utilisé pour accéder au site :</p>
+<example>
+RewriteCond %{HTTP_HOST} (.*)<br />
+RewriteRule ^/(.*) /sites/%1/$1
+</example>
+<p>Si la requête concernait <code>http://example.com/foo/bar</code>,
+alors <code>%1</code> contiendrait <code>example.com</code> et
+<code>$1</code> contiendrait <code>foo/bar</code>.</p>
+
+
+
+</section>
+
+<section id="rewritemap"><title>Tables de réécriture</title>
+<p>Voir la directive
+<directive module="mod_rewrite">RewriteMap</directive>.</p>
+</section>
+
+<section id="htaccess"><title>Fichiers .htaccess</title>
+
+<p>La réécriture est en général définie au niveau de la configuration du
+serveur principal (en dehors de toute section <directive type="section"
+module="core">Directory</directive>) ou dans une section <directive
+type="section" module="core">VirtualHost</directive>. Il s'agit là de la
+manière la plus simple de mettre en oeuvre la réécriture et nous la
+recommandons. Il est possible, cependant, de mettre en oeuvre la
+réécriture au sein d'une section <directive type="section"
+module="core">Directory</directive> ou d'un fichier <a
+href="../howto/htaccess.html"><code>.htaccess</code></a> ; ce type de
+configuration est cependant plus complexe. Cette technique est appelée
+réécriture par répertoire.</p>
+
+<p>La principale différence avec les réécritures au niveau du serveur réside
+dans le fait que le préfixe du chemin du répertoire contenant le fichier
+<code>.htaccess</code> est supprimé avant la mise en correspondance dans
+la règle <directive module="mod_rewrite">RewriteRule</directive>. De
+plus, on doit utiliser la directive <directive
+module="mod_rewrite">RewriteBase</directive> pour s'assurer que la
+requête est correctement mise en correspondance.</p>
+
+</section>
+
+</manualpage>
+
<variants>
<variant>en</variant>
+ <variant>fr</variant>
</variants>
</metafile>
projects / apache / commitdiff