intro.html.fr revision 70f5253b24dd333c67fb6502d557a8b48ad3ba87
<?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">
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" />
<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>
<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/intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
</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="#rewriterule">Les bases des r�gles de r��criture</a></li>
correspondance</a></li><li><a href="access.html">Contr�le d'acc�s</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avanc�es et conseils</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li></ul></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� le niveau de
journalisation de <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> � un des niveaux de trace
via la directive <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code>. Bien que
ceci risque de vous submerger sous une �norme quantit� d'informations,
le d�bogage des probl�mes avec la configuration de
<code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> est � ce prix car vous verrez alors
exactement comment chaque r�gle est trait�e.</p>
<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
<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 1
montre � quels endroits les r�f�rences arri�res sont suceptibles
d'�tre d�velopp�es, et illustre le flux des comparaisons
effectu�es par les r�gles RewriteRule et RewriteCond.</p>
<p class="figure">
<img src="/images/rewrite_rule_flow.png" alt="Flux des comparaisons effectu�es par les r�gles RewriteRule et RewriteCond" /><br />
<dfn>Figure 1 :</dfn> Le cheminement d'une r�f�rence arri�re �
travers une r�gle.
</p>
<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 class="figure">
<dfn>Figure 2 :</dfn> Syntaxe de la directive RewriteRule.
</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>
</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
</dd>
<dt>Une URL absolue</dt>
<dd>
<div class="example"><p><code>
</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>
</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
<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 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="flags.html">Drapeaux de
r��criture</a>.</p>
<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 class="figure">
<dfn>Figure 3 :</dfn> Syntaxe de la directive RewriteCond
</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.example.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>
<div class="section">
<h2><a name="rewritemap" id="rewritemap">Tables de r��criture</a></h2>
<p>La directive <code class="directive"><a href="/mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>
permet en quelque sorte de faire appel � une fonction externe pour
effectuer la r��criture � votre place. Tout ceci est d�crit plus en
d�tails dans la <a href="rewritemap.html">Documentation
suppl�mentaire sur RewriteMap</a>.</p>
<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/intro.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div><div id="footer">
<p class="apache">Copyright 2010 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>