mod_rewrite.html.fr revision bc9d4698fce0238d2f6f2682e99423ebb1149976
<?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>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>
<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="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_rewrite</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de r��criture � base de
r�gles permettant de r��crire les URLs des requ�tes
� la vol�e</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>rewrite_module</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible � partir de la version 1.3
d'Apache</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module utilise un moteur de r��criture � base de r�gles
(bas� sur un interpr�teur d'expressions rationnelles) pour
r��crire les URLs des requ�tes � la vol�e. Il accepte un nombre
illimit� de r�gles, ainsi q'un nombre illimit� de conditions
attach�es � chaque r�gle, fournissant ainsi un m�canisme de
manipulation d'URL vraiment souple et puissant. Les manipulations
d'URL peuvent d�pendre de nombreux tests, des variables du
serveur, des variables d'environnement, des en-t�tes HTTP ou de
l'horodatage. On peut m�me lancer des requ�tes vers une base de
donn�es externe sous divers formats, afin d'obtenir une
s�lection d'URL tr�s fine.</p>
<p>Ce module agit sur l'ensemble de l'URL (la partie concernant
le chemin incluse) au niveau du serveur
(<code>.htaccess</code>), et peut inclure des arguments de cha�ne
de requ�te (query string) comme r�sultat. Le r�sultat de la r��criture peut
renvoyer vers un sous-traitement interne, une redirection vers
une requ�te externe, ou m�me vers le flux d'un proxy interne.</p>
<p>Vous trouverez d'avantage de d�tails, discussions et exemples
dans la
<a href="/rewrite/">documentation d�taill�e
sur mod_rewrite</a>.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="/images/down.gif" /> <a href="#quoting">Marquage des caract�res sp�ciaux</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><a href="#rewriteflags">Drapeaux des r�gles de r��criture</a></li>
</ul></div>
<div class="section">
<h2><a name="quoting" id="quoting">Marquage des caract�res sp�ciaux</a></h2>
<p>Depuis Apache 1.3.20, les caract�res sp�ciaux dans les
<em>cha�nes de test</em> et les cha�nes de <em>Substitution</em>
peuvent �tre �chapp�s (c'est � dire trait�s comme des caract�res
normaux sans tenir compte de leur signification en tant que
caract�re sp�cial), en les faisant pr�c�der d'un caract�re
anti-slash ('\'). En d'autres termes, vous pouvez inclure un
v�ritable signe "dollar" dans une cha�ne de <em>Substitution</em>
en utilisant '<code>\$</code>' ; ceci emp�che mod_rewrite de le
traiter comme une r�f�rence arri�re.</p>
<div class="section">
<h2><a name="EnvVar" id="EnvVar">Variables d'environnement</a></h2>
<p>Ce module conserve le contenu de deux variables d'environnement
<code>SCRIPT_URL</code> et <code>SCRIPT_URI</code>. Celles-ci
contiennent l'adresse <em>logique</em> vue du Web
standards <code>SCRIPT_NAME</code> et
<code>SCRIPT_FILENAME</code> contiennent l'adresse
<em>physique</em> de la ressource vue du syst�me. </p>
�tait � l'arriv�e de la requ�te</em>, c'est � dire
<em>avant</em> tout processus de r��criture. Il est important de
le savoir car le processus de r��criture est principalement
utilis� pour r��crire des URLs logiques en chemins physiques.
<br />
Ces variables sont d�finies dans un contexte du niveau serveur, ce
qui signifie qu'elles ne sont disponibles que dans un contexte de
r�pertoire, si <code class="directive">RewriteEngine</code> est positionn� �
<code>on</code> dans un contexte de niveau serveur.</p>
<div class="example"><h3>Exemple</h3><pre>
SCRIPT_URI=http://en1.engelschall.com/u/rse/
</pre></div>
<div class="section">
<h2><a name="vhosts" id="vhosts">R��criture et h�tes virtuels</a></h2>
<p>Par d�faut, les h�tes virtuels n'h�ritent pas de la
configuration de <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> telle qu'elle est
d�finie dans le contexte du serveur principal. Pour que la
configuration du serveur principal s'applique aux h�tes virtuels,
vous devez ins�rez les directives suivantes dans chaque section
<div class="example"><p><code>
RewriteEngine On<br />
RewriteOptions Inherit
</code></p></div>
<div class="section">
<h2><a name="Solutions" id="Solutions">Solutions pratiques</a></h2>
<p>Vous trouverez de nombreux exemples d'utilisation courante (et
moins courante) de mod_rewrite dans le
et dans le
</div>
<div class="directive-section"><h2><a name="RewriteBase" id="RewriteBase">RewriteBase</a> <a name="rewritebase" id="rewritebase">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit l'URL de base pour les r��critures au niveau
r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteBase <em>chemin URL</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Voir utilisation pour plus d'informations.</code></td></tr>
</table>
<p>La directive <code class="directive">RewriteBase</code> d�finit
explicitement l'URL de base pour les r��critures au niveau du
r�pertoire. Comme vous le verrez plus loin, la directive
<code class="directive"><a href="#rewriterule">RewriteRule</a></code> peut
�tre utilis�e dans les fichiers de configuration au niveau du
r�pertoire (<code>.htaccess</code>). Elle agit alors localement,
en amputant le r�pertoire local de son pr�fixe avant traitement,
et en n'appliquant les r�gles de r��criture que sur ce qui reste
de l'URL. Lorsque le traitement est termin�, le pr�fixe est
automatiquement rajout� � l'URL. La valeur par d�faut est
<code class="directive">RewriteBase</code>
<em>chemin r�pertoire physique</em></p>
<p>Lorsqu'une substitution intervient pour une nouvelle URL, ce
module doit r�injecter l'URL dans le traitement du serveur. Pour
y parvenir, il doit conna�tre le pr�fixe de l'URL ou l'URL de
base correspondants. Par d�faut, le pr�fixe est le chemin du
fichier correspondant lui-m�me. <strong>Cependant, pour la
plupart des sites web, les URLs ne correspondent PAS directement
aux chemins des fichiers physiques, cette assertion s'av�re
ainsi souvent fausse !</strong>. C'est pourquoi vous pouvez
utiliser la directive <code>RewriteBase</code> pour sp�cifier
le pr�fixe correct.</p>
<div class="note"> Si les URLs de votre serveur web ne correspondent
<strong>pas</strong> directement aux chemins physiques des fichiers,
vous devrez utiliser <code class="directive">RewriteBase</code> dans chaque
fichier <code>.htaccess</code> o� vous voudrez utiliser des
directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code>.
</div>
<p> Par exemple, consid�rons le fichier de configuration de
r�pertoire suivant :</p>
<div class="example"><pre>
#
# <em>ce qui veut dire</em> que la configuration du serveur comporte
#
RewriteEngine On
# faisons savoir au serveur qu'on nous a atteint via /xyz et non par
RewriteBase /xyz
# maintenant les r�gles de r��criture
RewriteRule ^avant\.html$ apr�s.html
</pre></div>
<p>Dans l'exemple pr�c�dent, une requ�te pour
sous sa forme chemin physique
<div class="note"><h3>Pour les hackers d'Apache</h3>
<p>La liste suivante fournit des informations d�taill�es � propos des
�tapes du traitement interne :</p>
<pre>
Requ�te :
Traitement interne :
R�sultat :
</pre>
<p>Tout ceci para�t tr�s compliqu�, mais correspond
r�ellement au traitement interne d'Apache. Comme la
r��criture au niveau du r�pertoire intervient plus tard
au cours du traitement, la requ�te de r��criture doit �tre
r�inject�e dans le noyau d'Apache, comme s'il s'agissait
propos de mod_rewrite</a>). La surcharge
correspondante n'est pas aussi importante qu'il n'y
para�t, car la r�injection est enti�rement prise en charge
en interne par Apache (comme c'est d'ailleurs le cas pour
de nombreuses autres op�rations effectu�es � l'int�rieur
d'Apache).</p>
</div>
</div>
<div class="directive-section"><h2><a name="RewriteCond" id="RewriteCond">RewriteCond</a> <a name="rewritecond" id="rewritecond">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit une condition qui devra �tre satisfaite pour que
la r��criture soit effectu�e
</td></tr>
<em>cha�ne de test</em> <em>expression de comparaison</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">RewriteCond</code> d�finit une
condition d'application d'une certaine r�gle. Une ou plusieurs
directives <code class="directive">RewriteCond</code> peuvent pr�c�der
une directive
<code class="directive"><a href="#rewriterule">RewriteRule</a></code>. La r�gle
qui suit n'est appliqu�e que si l'�tat actuel de l'URI
correspond � son mod�le, <strong>et</strong> si les conditions sont satisfaites.</p>
<p><em>cha�ne de test</em> est une cha�ne de caract�res qui peut
contenir, en plus du texte plat, les constructions �tendues
suivantes :</p>
<ul>
<li>
<strong>r�f�rences arri�res de r�gle de r��criture</strong> :
ce sont des r�f�rences arri�res de la forme
<strong><code>$N</code></strong> (0 <= N <= 9), qui
donnent acc�s aux parties group�es (entre parenth�ses) du
mod�le tir� de la <code>RewriteRule</code> assujettie au
jeu de conditions concern�.
</li>
<li>
<strong>R�f�rences arri�res de condition de r��criture
</strong> : ce sont des r�f�rences arri�res de la forme
<strong><code>%N</code></strong> (1 <= N <= 9), qui
donnent acc�s aux parties group�es (l� aussi entre
parenth�ses) du mod�le de la derni�re condition satisfaite
du jeu de conditions concern�.
</li>
<li>
<strong>extensions de table de r��criture</strong> :
ce sont des extensions de la forme <strong><code>${nomTable:cl�|d�faut}</code></strong>. Voir
<a href="#mapfunc">la documentation de
RewriteMap</a> pour plus de d�tails.
</li>
<li>
<strong>Variables du serveur</strong> :
ce sont des variables de la forme
<strong><code>%{</code> <em>NOM_DE_VARIABLE</em>
<code>}</code></strong>
<strong><code>%{</code> <em>NOM_DE_VARIABLE</em>
<code>}</code></strong> o� <em>NOM_DE_VARIABLE</em>
peut �tre une cha�ne de caract�res faisant partie de la
liste suivante :
<table>
<tr>
<th>En-t�tes HTTP :</th> <th>connexion & requ�te:</th> <th />
</tr>
<tr>
<td>
HTTP_USER_AGENT<br />
HTTP_REFERER<br />
HTTP_COOKIE<br />
HTTP_FORWARDED<br />
HTTP_HOST<br />
HTTP_PROXY_CONNECTION<br />
HTTP_ACCEPT<br />
</td>
<td>
REMOTE_ADDR<br />
REMOTE_HOST<br />
REMOTE_PORT<br />
REMOTE_USER<br />
REMOTE_IDENT<br />
REQUEST_METHOD<br />
SCRIPT_FILENAME<br />
PATH_INFO<br />
QUERY_STRING<br />
AUTH_TYPE<br />
</td>
<td />
</tr>
<tr>
<th>variables internes au serveur :</th> <th>date et heure :</th> <th>sp�ciaux :</th>
</tr>
<tr>
<td>
DOCUMENT_ROOT<br />
SERVER_ADMIN<br />
SERVER_NAME<br />
SERVER_ADDR<br />
SERVER_PORT<br />
SERVER_PROTOCOL<br />
SERVER_SOFTWARE<br />
</td>
<td>
TIME_YEAR<br />
TIME_MON<br />
TIME_DAY<br />
TIME_HOUR<br />
TIME_MIN<br />
TIME_SEC<br />
TIME_WDAY<br />
TIME<br />
</td>
<td>
API_VERSION<br />
THE_REQUEST<br />
REQUEST_URI<br />
REQUEST_FILENAME<br />
IS_SUBREQ<br />
HTTPS<br />
</td>
</tr>
</table>
<p>Toutes ces variables correspondent nom pour nom aux
en-t�tes MIME HTTP, aux variables C du serveur Apache
ou aux champs <code>struct tm</code> du syst�me Unix.
La plupart sont document�es dans une autre partie du
manuel ou dans la sp�cification CGI. Vous trouverez
dans ce qui suit quelques variables sp�cifiques
� mod_rewrite.</p>
<div class="note">
<dl>
<dt><code>IS_SUBREQ</code></dt>
<dd>Contiendra le texte "true" si la requ�te en cours
de traitement est une sous-requ�te, "false" dans le
cas contraire. Une sous-requ�te est g�n�r�e quand un
module a besoin de se r�f�rer � des fichiers ou URIs
addidionnels pour pouvoir mener � bien sa t�che.</dd>
<dt><code>API_VERSION</code></dt>
<dd>Il s'agit de la version de l'API des modules
Apache (l'interface interne entre le serveur et les
modules) dans la construction actuelle de httpd,
version de l'API des modules correspond � la version
d'Apache utilis�e (pour Apache 1.3.14, par exemple,
la version de l'API sera 19990320:10), mais cette
information int�resse principalement les
d�veloppeurs de modules.</dd>
<dt><code>THE_REQUEST</code></dt>
<dd>La ligne de requ�te HTTP compl�te envoy�e par le
navigateur au serveur (par exemple, "<code>GET
en-t�te ajout� par le navigateur.</dd>
<dt><code>REQUEST_URI</code></dt>
<dd>La ressource demand�e dans la ligne de requ�te
HTTP (correspondrait, dans l'exemple pr�c�dent, �
"/index.html").</dd>
<dt><code>REQUEST_FILENAME</code></dt>
<dd>Le chemin complet local au syst�me de fichiers
du fichier ou du script correspondant
� la requ�te.</dd>
<dt><code>HTTPS</code></dt>
<dd>Contiendra le texte "on" si la connexion
(L'utilisation de cette variable est pertinente,
soit charg� ou non).</dd>
</dl>
</div>
</li>
</ul>
<p>Autres points � conna�tre :</p>
<ol>
<li>
<p>Les variables SCRIPT_FILENAME et REQUEST_FILENAME ont la
m�me valeur - celle du champ <code>filename</code> de la
structure interne du serveur Apache <code>request_rec</code>.
Le premier nom est bien connu en tant que variable CGI,
alors que le second est �quivalent � REQUEST_URI (qui contient
la valeur du champ <code>uri</code> de la structure
<code>request_rec</code>).</p>
<p>Si une substitution intervient et si la r��criture continue,
les valeurs des deux variables seront mises � jour en
cons�quence.</p>
<p>Dans un contexte de niveau serveur (<em>c'est � dire</em>
avant que la requ�te soit mise en correspondance avec le syst�me
de fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
contenir le chemin complet dans le syst�me de fichier local car
ce dernier n'est pas encore connu � ce niveau du traitement.
Dans ce cas, les deux variables contiendront initialement la
valeur de REQUEST_URI. Pour avoir acc�s au chemin complet de la
requ�te dans le syst�me de fichiers local dans un contexte de
niveau serveur, utilisez une r�f�rence avant � base d'URL
<code>%{LA-U:REQUEST_FILENAME}</code> pour d�terminer la valeur
finale de REQUEST_FILENAME.</p></li>
<li>On peut �galement utiliser <code>%{ENV:variable}</code>, o�
<em>variable</em> peut �tre remplac� par toute variable
d'environnement. Ces variables sont recherch�es dans les
structures internes d'Apache, et (si elles n'y figurent pas)
via <code>getenv()</code> depuis le processus du serveur
Apache.</li>
<li>Que <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> soit charg� ou non, on peut
utiliser <code>%{SSL:variable}</code>, o� <em>variable</em>
peut �tre remplac� par le nom d'une
<a href="mod_ssl.html#envvars">variable
d'environnement SSL</a>, mais la valeur produite sera toujours
une cha�ne de caract�res vide si <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> n'est
pas charg�. Exemple :
<code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> peut correspondre
� <code>128</code>.</li>
<li>Pour obtenir la valeur d'un en-t�te contenu dans une requ�te
HTTP, on peut toujours utiliser <code>%{HTTP:header}</code>,
o� <em>header</em> peut �tre remplac� par tout nom d'en-t�te
MIME HTTP. Exemple : <code>%{HTTP:Proxy-Connection}</code> est
la valeur de l'en-t�te HTTP ``<code>Proxy-Connection:</code>''.
<p>Si une condition contient un en-t�te HTTP, il est ajout� �
l'en-t�te Vary de la r�ponse dans le cas o� la condition est
�valu�e � true pour la requ�te. Dans le cas contraire, il n'est
<strong>pas</strong> ajout�. L'ajout de l'en-t�te HTTP �
l'en-t�te Vary de la r�ponse s'av�re n�cessaire pour une mise
en cache correcte.</p>
<p>Il faut garder � l'esprit que les conditions suivent une
logique de court-circuit en cas de pr�sence du drapeau
'<strong><code>ornext|OR</code></strong>', si bien que
certaines d'entre elles sont susceptibles de ne pas �tre
�valu�es du tout.</p></li>
<li>On peut utiliser <code>%{LA-U:variable}</code> pour les
recherches en avant qui effectuent une sous-requ�te interne
(bas�e sur l'URL), pour d�terminer la valeur finale de
<em>variable</em>. Cela peut servir � acc�der � une variable
(n�cessaire pour une r��criture) qui n'est pas disponible dans
la situation pr�sente, mais le sera dans une phase ult�rieure.
<p>Par exemple, pour effectuer une r��criture qui tient compte
de la variable <code>REMOTE_USER</code> dans un contexte
utiliser <code>%{LA-U:REMOTE_USER}</code> ; cette variable est
d�finie au cours des phases d'autorisation, qui interviennent
<em>apr�s</em> la phase de traduction de l'URL (pendant
laquelle agit mod_rewrite).</p>
<p>Par contre, comme mod_rewrite impl�mente son contexte
niveau r�pertoire (fichier <code>.htaccess</code>) via la
phase Fixup de l'API, et comme les phases d'autorisation
interviennent <em>avant</em> cette phase, vous pouvez vous contenter
d'utiliser <code>%{REMOTE_USER}</code>
dans le contexte niveau serveur.</p></li>
<li>On peut utiliser <code>%{LA-F:variable}</code> pour
effectuer une sous-requ�te interne (bas�e sur un nom de
fichier), pour d�terminer la valeur finale de
<em>variable</em>. La plupart du temps, elle est identique �
LA-U vue pr�c�demment.</li>
</ol>
<p><em>expression de comparaison</em> est une expression
rationnelle qui est appliqu�e � l'instance actuelle de
<em>cha�ne de test</em>. <em>cha�ne de test</em> est d'abord
�valu�e, puis compar�e �
l'<em>expression de comparaison</em>.</p>
<p><strong>A savoir :</strong>
<em>expression de comparaison</em> est une
<em>expression rationnelle compatible perl</em> avec
quelques extensions :</p>
<ol>
<li>Vous pouvez pr�fixer l'expression avec un caract�re
'<code>!</code>' (point d'exclamation) pour indiquer une
expression de <strong>non</strong>-correspondance.</li>
<li>Il existe certaines variantes sp�ciales
d'<em>expressions de comparaison</em>. A la place d'une
expression rationnelle, vous pouvez utiliser :
<ul>
<li>'<strong><expression</strong>' (inf�rieur au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha�ne de
caract�res et la compare lexicographiquement �
<em>cha�ne de test</em>. La condition est satisfaite si
<em>cha�ne de test</em> est inf�rieure au sens
lexicographique � l'<em>expression</em>.</li>
<li>'<strong>>expression</strong>' (sup�rieur au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha�ne de
caract�res et la compare lexicographiquement �
<em>cha�ne de test</em>. La condition est satisfaite si
<em>cha�ne de test</em> est sup�rieure au sens
lexicographique � l'<em>expression</em>.</li>
<li>'<strong>=expression</strong>' (�gal au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha�ne de
caract�res et la compare lexicographiquement �
<em>cha�ne de test</em>. La condition est satisfaite si
<em>cha�ne de test</em> est �gale au sens
lexicographique � l'<em>expression</em> (les deux cha�nes
sont exactement identiques, caract�re pour caract�re). Si
<em>expression</em> est <code>""</code> (deux guillemets),
<em>cha�ne de test</em> est compar�e � la cha�ne vide.</li>
<li>'<strong>-d</strong>' (est un r�pertoire -
<strong>d</strong>irectory)<br />
Traite <em>cha�ne de test</em> comme un chemin et v�rifie
s'il existe ou pas, et s'il s'agit d'un r�pertoire.</li>
<li>'<strong>-f</strong>' (est un
<strong>f</strong>ichier r�gulier)<br />
Traite <em>cha�ne de test</em> comme un chemin et v�rifie
s'il existe ou pas, et s'il s'agit d'un fichier r�gulier.</li>
<li>'<strong>-s</strong>' (est un fichier r�gulier d'une
certaine taille - <strong>s</strong>ize)<br />
Traite <em>cha�ne de test</em> comme un chemin et v�rifie
s'il existe ou pas, et s'il s'agit d'un fichier r�gulier
dont la taille est sup�rieure � z�ro.</li>
<li>'<strong>-l</strong>' (est un
<strong>l</strong>ien symbolique)<br />
Traite <em>cha�ne de test</em> comme un chemin et v�rifie
s'il existe ou pas, et s'il s'agit d'un lien
symbolique.</li>
<li>'<strong>-x</strong>' (a le droit
d'e<strong>x</strong>�cution)<br />
Traite <em>cha�ne de test</em> comme un chemin et v�rifie
s'il existe ou pas, et a le droit d'ex�cution. Ce droit est
d�termin� en accord avec le syst�me d'exploitation
sous-jacent.</li>
<li>'<strong>-F</strong>' (test de l'existence d'un fichier
via une sous-requ�te)<br />
V�rifie si <em>cha�ne de test</em> est un fichier valide,
accessible � travers tous les contr�les d'acc�s du serveur
actuellement configur�s pour ce chemin. C'est une
sous-requ�te interne qui effectue cette v�rification - �
utiliser avec pr�cautions car les performances du serveur
peuvent s'en trouver affect�es !</li>
<li>'<strong>-U</strong>' (test de l'existence d'une
<strong>U</strong>RL via une sous-requ�te)<br />
V�rifie si <em>cha�ne de test</em> est une URL valide,
accessible � travers tous les contr�les d'acc�s du serveur
actuellement configur�s pour ce chemin. C'est une
sous-requ�te interne qui effectue cette v�rification - �
utiliser avec pr�cautions car les performances du serveur
peuvent s'en trouver affect�es !</li>
</ul>
<div class="note"><h3>Note :</h3>
Tous ces tests peuvent aussi �tre pr�fix�s par un point
d'exclamation ('!') pour inverser leur signification.
</div>
</li>
<li>Vous pouvez aussi d�finir certains drapeaux pour
l'<em>expression de comparaison</em> en ajoutant ces
<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
comme troisi�me argument de la directive
<code>RewriteCond</code>, o� <em>drapeaux</em> est un
sous-ensemble s�par� par des virgules des drapeaux suivants :
<ul>
<li>'<strong><code>nocase|NC</code></strong>'
(<strong>n</strong>o <strong>c</strong>ase)<br />
Rend le test insensible � la casse - il n'est pas fait de
distinction entre majuscules et minuscules, � la fois dans le
d�veloppement de <em>cha�ne de test</em> et dans
<em>expression de comparaison</em>. Ce drapeau n'est pris en
compte que lors d'une comparaison entre <em>cha�ne de test</em>
et <em>expression de comparaison</em>. Il ne l'est pas pour les
v�rification par sous-requ�tes ou sur le syst�me de
fichiers.</li>
<li>
'<strong><code>ornext|OR</code></strong>'
(<strong>ou</strong> condition suivante)<br />
Permet de cha�ner les conditions de r�gles avec un OU au
lieu du AND implicite. Exemple typique :
<div class="example"><pre>
RewriteCond %{REMOTE_HOST} ^hote1.* [OR]
RewriteCond %{REMOTE_HOST} ^hote2.* [OR]
RewriteCond %{REMOTE_HOST} ^hote3.*
RewriteRule ...r�gles concernant tous ces h�tes...
</pre></div>
Sans ce drapeau, les paires
condition/r�gle devraient �tre �crites trois fois.
</li>
<li>'<strong><code>novary|NV</code></strong>'
(<strong>n</strong>o <strong>v</strong>ary)<br />
Si la condition contient un en-t�te HTTP, ce drapeau emp�che
ce dernier d'�tre ajout� � l'en-t�te Vary de la r�ponse. <br />
L'utilisation de ce drapeau peut provoquer une mise en cache
incorrecte de la r�ponse, si la repr�sentation de cette r�ponse
varie avec la valeur de l'en-t�te consid�r�. Ce drapeau ne
devrait donc �tre utilis� que si l'on ma�trise parfaitement le
fonctionnement de l'en-t�te Vary.
</li>
</ul>
</li>
</ol>
<p><strong>Exemple :</strong></p>
<p>Pour r��crire la page d'accueil d'un site en fonction de
l'en-t�te ``<code>User-Agent:</code>'' de la requ�te, vous
pouvez utiliser ce qui suit : </p>
<div class="example"><pre>
RewriteCond %{HTTP_USER_AGENT} ^Mozilla.*
RewriteRule ^/$ /homepage.max.html [L]
RewriteCond %{HTTP_USER_AGENT} ^Lynx.*
RewriteRule ^/$ /homepage.min.html [L]
RewriteRule ^/$ /homepage.std.html [L]
</pre></div>
<p>Explications : si vous utilisez un navigateur
(Netscape Navigator, Mozilla etc) qui s'identifie comme
'Mozilla', vous acc�derez � la page d'accueil max (qui
peut contenir des frames, ou d'autres ressources
particuli�res).
Si vous utilisez le navigateur Lynx (qui est un navigateur
en mode texte), vous acc�derez � une page d'accueil min
(qui peut �tre une version con�ue pour une navigation simple
bas�e sur le texte).
Si aucune de ces conditions n'est satisfaite (vous utilisez tout
autre navigateur, ou votre navigateur s'identifie de mani�re non
standard), vous acc�derez � la page d'accueil std
(standard).</p>
</div>
<div class="directive-section"><h2><a name="RewriteEngine" id="RewriteEngine">RewriteEngine</a> <a name="rewriteengine" id="rewriteengine">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou d�sactive l'ex�cution du
moteur de r��criture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteEngine on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>RewriteEngine off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">RewriteEngine</code> active ou
d�sactive l'ex�cution du moteur de r��criture. Si sa valeur est
<code>off</code>, ce module n'ex�cutera aucun traitement et ne
mettra pas � jour les variables d'environnement
<code>SCRIPT_URx</code>.</p>
<p>Pour d�sactiver le module, il vaut mieux utiliser cette
directive que commenter toutes les directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code> !</p>
<p>Notez que les h�tes virtuels n'h�ritent pas des
configurations de r��criture. Ceci implique que vous devez
ins�rer une directive <code>RewriteEngine on</code> dans chaque
h�te virtuel pour lequel vous souhaitez utiliser des r�gles
de r��criture.</p>
<p>Les directives <code class="directive">RewriteMap</code> du type
<code>prg</code> ne sont pas prises en compte au cours de
l'initialisation du serveur si elle ont �t� d�finies dans un
contexte o� la directive <code class="directive">RewriteEngine</code> n'a
pas �t� d�finie � <code>on</code>.</p>
</div>
<div class="directive-section"><h2><a name="RewriteLock" id="RewriteLock">RewriteLock</a> <a name="rewritelock" id="rewritelock">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nom du fichier verrou utilis� pour la
synchronisation de <code class="directive"><a href="#rewritemap">RewriteMap</a></code></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteLock <em>chemin du fichier verrou</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
</table>
<p>Cette directive d�finit le nom du fichier utilis� comme
fichier verrou de synchronisation n�cessaire � mod_rewrite pour
communiquer avec les <em>programmes</em> li�s � <code class="directive"><a href="#rewritemap">RewriteMap</a></code>. D�finissez ce
fichier verrou dans un chemin local (et non sur un montage NFS)
si vous voulez utiliser un programme de comparaison pour la
r��criture. Il n'est pas n�cessaire pour les autres types de
comparaison pour la r��criture.</p>
</div>
<div class="directive-section"><h2><a name="RewriteLog" id="RewriteLog">RewriteLog</a> <a name="rewritelog" id="rewritelog">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit le nom du fichier utilis� pour la journalisation
des traitements du moteur de r��criture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteLog <em>chemin du fichier journal</em></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
</table>
<p>La directive <code class="directive">RewriteLog</code> d�finit le nom
du fichier dans lequel le serveur journalise tout processus de
r��criture qu'il effectue. Si le nom ne commence pas par un
slash ('<code>/</code>'), il est consid�r� comme relatif � la
<em>Racine du serveur</em>. Cette directive ne doit appara�tre
qu'une seule fois dans la configuration du serveur.</p>
<div class="note"> Il est d�conseill� de positionner
pour d�sactiver la journalisation des processus de r��criture,
car m�me si le moteur de r��criture n'envoie plus sa sortie
dans un fichier, il continue � cr�er un fichier journal en
interne, <strong>ce qui va avoir pour effet de ralentir le
serveur sans fournir aucun avantage � l'administrateur !
</strong> Pour d�sactiver la journalisation, vous pouvez
soit supprimer (ou commenter) la directive
<code class="directive">RewriteLog</code>, soit utiliser
<code>RewriteLogLevel 0</code> !
</div>
<div class="note"><h3>S�curit�</h3>
Se r�f�rer au document
<a href="/misc/security_tips.html">Conseils � propos
de la s�curit� dans Apache</a> pour plus de d�tails sur la mani�re
dont votre s�curit� pourrait �tre compromise si le r�pertoire o� se
trouvent les fichiers journaux est accessible en �criture par quiconque
autre que l'utilisateur qui d�marre le serveur.
</div>
<div class="example"><h3>Exemple</h3><p><code>
</code></p></div>
</div>
<div class="directive-section"><h2><a name="RewriteLogLevel" id="RewriteLogLevel">RewriteLogLevel</a> <a name="rewriteloglevel" id="rewriteloglevel">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit la verbosit� du fichier journal utilis�
par le moteur de r��criture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteLogLevel <em>niveau</em></code></td></tr>
<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>RewriteLogLevel 0</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
</table>
<p>La directive <code class="directive">RewriteLogLevel</code> d�finit
le niveau de verbosit� du fichier journal de r��criture. Le
niveau par d�faut 0 signifie aucune journalisation, tandis que
9 ou plus signifie que pratiquement toutes les actions sont
journalis�es.</p>
<p>Pour d�sactiver la journalisation des actions de r��criture,
positionnez simplement <em>niveau</em> � 0. Ceci d�sactive
toute journalisation des actions de r��criture.</p>
<div class="note"> Utiliser une valeur �lev�e pour <em>niveau</em> va ralentir
consid�rablement votre serveur Apache ! N'utilisez une
journalisation de la r��criture � un <em>niveau</em>
sup�rieur � 2 qu'� des fins de d�bogage !
</div>
<div class="example"><h3>Exemple</h3><p><code>
RewriteLogLevel 3
</code></p></div>
</div>
<div class="directive-section"><h2><a name="RewriteMap" id="RewriteMap">RewriteMap</a> <a name="rewritemap" id="rewritemap">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit une fonction de mise en correspondance pour la
recherche de mots-cl�s</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteMap <em>nom de la correspondance</em> <em>type de
correspondance</em>:<em>source de la correspondance</em>
</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Il est possible de choisir entre plusieurs types de
bases de donn�es depuis la version 2.0.41 d'Apache</td></tr>
</table>
<p>La directive <code class="directive">RewriteMap</code> d�finit une
<em>Table de correspondance pour la r��criture</em> que les
fonctions de mise en correspondance
peuvent utiliser dans les cha�nes de substitution des r�gles
pour ins�rer/substituer des champs en recherchant des mots-cl�s.
La source utilis�e pour cette recherche peut �tre de plusieurs
types.</p>
<p><a id="mapfunc" name="mapfunc"><em>nom de la
correspondance</em></a> est le nom de la table de correspondance
et servira � sp�cifier une fonction de mise en correspondance
pour les cha�nes de substitution d'une r�gle de r��criture selon
une des constructions suivantes :</p>
<p class="indent">
<strong><code>${</code> <em>nom de la
correspondance</em> <code>:</code>
<em>mot-cl�</em> <code>}</code><br />
<code>${</code> <em>nom de la
correspondance</em> <code>:</code>
<em>mot-cl�</em> <code>|</code> <em>valeur par d�faut</em>
<code>}</code></strong>
</p>
<p>Lorsqu'une telle construction est rencontr�e, la table de
correspondance <em>Nom de la correspondance</em> est consult�e
et la cl� <em>mot-cl�</em> recherch�e. Si la cl� est trouv�e, la
construction est remplac�e par
la <em>valeur de remplacement</em>. Si la cl� n'est pas trouv�e,
elle est remplac�e par la <em>valeur par d�faut</em>, ou par une
cha�ne vide si aucune <em>valeur par d�faut</em> n'est
sp�cifi�e.</p>
<p>Par exemple, vous pouvez d�finir une directive
<code class="directive">RewriteMap</code> comme suit </p>
<div class="example"><p><code>
</code></p></div>
<p>Vous pourrez ensuite utiliser cette table dans une
directive <code class="directive">RewriteRule</code> comme suit :</p>
<div class="example"><p><code>
RewriteRule ^/ex/(.*) ${map-exemple:$1}
</code></p></div>
<p>Les combinaisons suivantes pour <em>type de correspondance</em>
et <em>source de la correspondance</em>
peuvent �tre utilis�es :</p>
<ul>
<li>
<strong>Format texte standard</strong><br />
type de correspondance : <code>txt</code>, source de la
correspondance : chemin du syst�me de fichiers Unix vers un
fichier r�gulier valide
<p>Il s'agit de la mise en oeuvre standard de la table de
correspondance pour la r��criture o� la
<em>source de la correspondance</em> est un fichier ASCII
dont les diff�rentes lignes sont soit des lignes vides, soit
des lignes de commentaires (commen�ant par un caract�re "#"),
soit des paires de valeurs (une seule paire
par ligne) comme suit :</p>
<p class="indent">
<strong><em>mot-cl�</em>
<em>valeur de remplacement</em></strong>
</p>
<div class="example"><h3>Exemple</h3><pre>
##
## map.txt -- table de correspondance pour la r��criture
##
Ralf.S.Engelschall rse # Bastard Operator From Hell
Mr.Joe.Average joe # Mr. Average
</pre></div>
<div class="example"><p><code>
</code></p></div>
</li>
<li>
<strong>Format texte avec valeurs al�atoires</strong><br />
type de correspondance: <code>rnd</code>,
source de la correspondance : chemin du syst�me de fichiers
Unix vers un fichier r�gulier valide
<p>Ce format se diff�rencie du format texte standard
pr�c�dent par l'ajout d'un traitement suppl�mentaire : en
plus de la recherche de cl�s, le fichier est interpr�t� en
tenant compte de la pr�sence �ventuelle dans les valeurs de
remplacement de caract�res ``<code>|</code>'' signifiant
``ou''. En d'autres termes, ces caract�res ``<code>|</code>''
permettent de sp�cifier un jeu de valeurs parmi lesquelles
la valeur de retour sera choisie al�atoirement. Par exemple,
vous pouvez utiliser les fichier de correspondance et
directives suivants pour mettre en oeuvre une r�partition de
charge al�atoire entre plusieurs serveurs en arri�re-plan,
via un mandataire inverse. Les images sont envoy�es � un des
serveurs de l'ensemble "statique", tandis que tout le
reste est envoy� � un des serveurs de l'ensemble
"dynamique".</p>
<p>Exemple:</p>
<div class="example"><h3>Fichier de correspondances pour la r��criture</h3><pre>
##
## map.txt -- correspondances pour la r��criture
##
static www1|www2|www3|www4
dynamic www5|www6
</pre></div>
<div class="example"><h3>Directives de configuration</h3><p><code>
<br />
RewriteRule ^/(.*\.(png|gif|jpg)) http://${serveurs:static}/$1
[NC,P,L]<br />
RewriteRule ^/(.*) http://${serveurs:dynamic}/$1 [P,L]
</code></p></div>
</li>
<li>
<strong>Fichier � acc�s direct (Hash file)</strong><br />
type de correspondance :
<code>dbm[=<em>type</em>]</code>, source de la
correspondance : chemin du syst�me de fichiers Unix vers un
fichier r�gulier valide
<p>Ici, la source de la correspondance est un fichier binaire
au format DBM contenant les m�mes donn�es qu'un fichier au
format <em>Plein texte</em>, mais selon une repr�sentation
particuli�re optimis�e en vue d'une recherche tr�s rapide.
Le <em>type</em> peut �tre sdbm, gdbm, ndbm, ou db selon la
configuration � la <a href="/install.html#dbm">compilation
</a>. Si <em>type</em> est omis, la valeur retenue
sera la valeur par d�faut d�finie � la compilation.</p>
<p>La cr�ation du fichier dbm � partir d'un fichier texte
<div class="example"><p><code>
$ httxt2dbm -i fichier-source.txt -o fichier-dbm.map
</code></p></div>
</li>
<li>
<strong>Fonction interne</strong><br />
type de la correspondance : <code>int</code>,
source de la correspondance : fonction interne � Apache
<p>Ici, la source de la correspondance est une fonction
interne � Apache. Actuellement, vous ne pouvez pas cr�er
votre propre fonction, mais les fonctions suivantes
existent d�j� :</p>
<ul>
<li><strong>toupper</strong>:<br />
Convertit tous les caract�res de la cl� en majuscules.</li>
<li><strong>tolower</strong>:<br />
Convertit tous les caract�res de la cl� en minuscules.</li>
<li><strong>escape</strong>:<br />
Traduit les caract�res sp�ciaux que contient la cl� en
s�quences hexad�cimales.</li>
<li><strong>unescape</strong>:<br />
Reconvertit les s�quences hexad�cimales que contient la
cl� en caract�res sp�ciaux.</li>
</ul>
</li>
<li>
<strong>Programme de r��criture externe</strong><br />
type de la correspondance : <code>prg</code>,
source de la correspondance :
chemin du syst�me de fichiers Unix vers un
fichier r�gulier valide
<p>Ici, la source n'est pas un fichier de correspondances,
mais un programme. Pour le cr�er, vous pouvez utiliser le
langage de votre choix, mais le programme doit �tre un
ex�cutable (soit du code objet, soit un script
contenant le fameux
premi�re ligne).</p>
<p>Ce programme est lanc� une seule fois au d�marrage du
serveur Apache, puis communique avec le moteur de r��criture
via ses entr�e et sortie standards (<code>stdin</code>
et <code>stdout</code>). A chaque recherche effectu�e par la
fonction de correspondance, il re�oit sur son entr�e standard
la cl� � rechercher sous la forme d'une cha�ne de caract�res
termin�e par le caract�re "nouvelle ligne". Il doit ensuite
renvoyer sur sa sortie standard la valeur recherch�e sous
la forme d'une cha�ne de caract�res termin�e par le caract�re
"nouvelle ligne", ou la cha�ne de quatre
caract�res ``<code>NULL</code>'' en cas d'�chec
(<em>c'est � dire</em>
si aucune valeur ne correspond � la cl� fournie).</p>
<p>Les programmes de r��criture externes ne seront pas lanc�s
s'ils ont �t� d�finis dans un contexte o� la directive
<code class="directive">RewriteEngine</code> n'a pas �t� d�finie �
<code>on</code>.</p>
<p>Voici un
exemple de ce pourrait �tre un programme trivial qui
impl�menterait une correspondance 1:1 (<em>c'est � dire</em>,
cl� == valeur) :</p>
<div class="example"><pre>
$| = 1;
while (<STDIN>) {
# ...ins�rer ici le code de transformation ou de recherche...
print $_;
}
</pre></div>
<p>Mais soyez tr�s prudent :</p>
<ol>
<li>``<em>Ce programme doit �tre simple, basique</em>''
(MERCI).
Si ce programme se bloque, il bloquera aussi Apache
lorsqu'il tentera d'utiliser la r�gle de r��criture
correspondante.</li>
<code>stdout</code> est une erreur courante. Ceci est �
proscrire sous peine de cr�er une boucle infernale ! Pour
�viter ceci, on utilise (en langage Perl) ``<code>$|=1</code>'' comme dans
l'exemple ci-dessus.</li>
<li>On peut d�finir la directive <code class="directive"><a href="#rewritelock">RewriteLock</a></code> pour sp�cifier
un fichier verrou que mod_rewrite pourra utiliser pour
synchroniser les communications avec le programme de
correspondance. Par d�faut, aucune synchronisation de ce
type n'est mise en oeuvre.</li>
</ol>
</li>
<li>
<p><strong>Requ�te SQL</strong><br />
type de correspondance : <code>dbd</code> ou
<code>fastdbd</code>,
source de la correspondance : une requ�te SQL SELECT qui
comporte un seul argument et renvoie une seule valeur.</p>
<p>Ici, on utilise <code class="module"><a href="/mod/mod_dbd.html">mod_dbd</a></code> pour impl�menter
une correspondance pour la r��criture par recherche dans une
base de donn�es SQL. Deux modes sont possibles :
<code>fastdbd</code> met en cache les recherches dans la base
de donn�es en interne, alors que <code>dbd</code> ne le fait
pas. Ainsi, <code>dbd</code> diminue les performances, mais
donnera toujours une r�ponse actualis�e, m�me si le contenu
de la base de donn�es est mise � jour, alors que
<code>fastdbd</code> est plus performant mais ne relira pas
le contenu de la base de donn�es tant que le serveur ne sera
pas red�marr�.</p>
<p>Si une requ�te renvoie plusieurs r�ponses, une de ces
derni�res sera choisie al�atoirement.</p>
<div class="example"><h3>Example</h3><p><code>
RewriteMap ma-requete "fastdbd:SELECT destination FROM rewrite WHERE source = %s"
</code></p></div>
</li>
</ul>
<p>La directive <code class="directive">RewriteMap</code> peut
appara�tre plusieurs fois. Utilisez une directive
<code class="directive">RewriteMap</code> par fonction de correspondance
pour d�clarer son fichier de correspondance pour la r��criture.
Bien que vous ne puissiez pas <strong>d�clarer</strong> une
table de correspondance dans un contexte de r�pertoire, vous
pouvez bien entendu <strong>utiliser</strong> cette table dans un
contexte de r�pertoire. </p>
<div class="note"><h3>Note</h3> En ce qui concerne les fichiers au format DBM
et texte plat, les cl�s de recherches sont mises en cache en interne
jusqu'� ce que le <code>mtime (date de modification)</code> du fichier
soit modifi�, ou que le serveur soit red�marr�. Ainsi, certaines
fonctions de correspondance dans les r�gles peuvent �tre utilis�es pour
<strong>chaque</strong> requ�te. Cela ne pose pas probl�me, car la
recherche externe n'intervient qu'une seule fois !
</div>
</div>
<div class="directive-section"><h2><a name="RewriteOptions" id="RewriteOptions">RewriteOptions</a> <a name="rewriteoptions" id="rewriteoptions">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure certaines options sp�ciales
pour le moteur de r��criture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteOptions <var>Options</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td><code>MaxRedirects</code> n'est plus disponible depuis
la version version 2.1</td></tr>
</table>
<p>La directive <code class="directive">RewriteOptions</code> d�finit
certaines options sp�ciales pour la configuration au niveau du
serveur ou du r�pertoire. La cha�ne de caract�res <em>Option</em>
ne peut actuellement prendre qu'une des valeurs suivantes :</p>
<dl>
<dt><code>inherit</code></dt>
<dd>Ceci force la configuration locale � h�riter de la
configuration du niveau sup�rieur. Dans le contexte des h�tes
virtuels, cela signifie que les correspondances, conditions et
r�gles du serveur principal sont h�rit�es. Dans le contexte des
r�pertoires, cela signifie que les conditions et r�gles de la
configuration <code>.htaccess</code> ou les sections <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> du r�pertoire
parent sont h�rit�es. Les r�gles h�rit�es sont virtuellement
copi�es dans la section o� cette directive est utilis�e. Si elles
sont utilis�es avec des r�gles locales, les r�gles h�rit�es sont
plac�es apr�s ces derni�res. La place de cette directive - avant
ou apr�s les r�gles locales - n'a aucune influance sur ce
comportement. Si des r�gles locales ont forc� l'arr�t de la
r��criture, les r�gles h�rit�es ne seront pas trait�es.
</dd>
</dl>
</div>
<div class="directive-section"><h2><a name="RewriteRule" id="RewriteRule">RewriteRule</a> <a name="rewriterule" id="rewriterule">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit les r�gles pour le moteur de r��criture</td></tr>
<em>Mod�le</em> <em>Substitution</em> [<em>drapeaux</em>]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
</table>
<p>La directive <code class="directive">RewriteRule</code> est le
v�ritable cheval de trait de la r��criture. La directive peut
appara�tre plusieurs fois, chaque instance d�finissant une
r�gle de r��criture particuli�re. L'ordre dans lequel ces r�gles
sont d�finies est important - il s'agit de l'ordre dans lequel
les r�gles seront appliqu�es au cours du processus de
r��criture.</p>
<p><a id="patterns" name="patterns"><em>Mod�le</em></a> est une
<a id="regexp" name="regexp">expression rationnelle</a>
compatible perl. Dans la premi�re r�gle de r��criture,
l'expression est compar�e au (%-encoded)
requ�te ; les expressions suivantes sont compar�es � la sortie de
la derni�re r�gle de r��criture qui a �t� appliqu�e.</p>
<div class="note"><h3>Qu'est-ce qui est compar� ?</h3>
<p>Le <em>Mod�le</em> est d'abord compar� � la partie
de l'URL apr�s le nom d'h�te et le port, et avant la cha�ne de
requ�te. Si vous souhaitez faire une comparaison sur le nom
d'h�te, le port, ou la cha�ne de requ�te, utilisez une
directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
comportant les variables
<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
<code>%{QUERY_STRING}</code>.</p>
</div>
<p>Pour quelques conseils � propos des <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, voir le
document <a href="/rewrite/intro.html#regex">Introduction �
mod_rewrite</a>.</p>
<p>Dans mod_rewrite, on peut aussi utiliser le caract�re NON
('<code>!</code>') comme pr�fixe de mod�le. Ceci vous permet
d'inverser la signification d'un mod�le, soit pour dire
``<em>si l'URL consid�r�e ne correspond <strong>PAS</strong> �
ce mod�le</em>''. Le caract�re NON peut donc �tre utilis� �
titre exceptionnel, lorsqu'il est plus simple d'effectuer une
comparaison avec le mod�le invers�, ou dans la derni�re r�gle
par d�faut.</p>
<div class="note"><h3>Note</h3>
Si vous utilisez le caract�re NON pour inverser la signification d'un
mod�le, vous ne pouvez pas inclure de parties g�n�riques group�es dans
le mod�le. Ceci est d� au fait que, lorsque le mod�le ne correspond
pas (autrement dit, sa n�gation correspond), les groupes sont vides.
Ainsi, si vous utilisez des mod�les invers�s, vous ne pouvez
pas vous r�f�rer aux groupes par <code>$N</code> dans la cha�ne de
substitution !
</div>
<p>Dans une r�gle de r��criture,
<a id="rhs" name="rhs"><em>Substitution</em></a> est la cha�ne
de caract�res qui remplace le chemin de l'URL original qui
correspondait au <em>Mod�le</em>. <em>Substitution</em> peut
�tre :</p>
<dl>
<dt>un chemin du syst�me de fichiers</dt>
<dd>Il indique alors la localisation dans le syst�me de
fichiers de la ressource qui doit �tre envoy�e au client.</dd>
<dt>chemin d'URL</dt>
<dd>Un chemin relatif � la valeur de <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> vers la ressource qui
doit �tre servie. Notez que <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>
essaie de deviner si vous avez sp�cifi� un chemin du syst�me
de fichiers ou un chemin d'URL en v�rifiant si la premi�re
partie du chemin existe � la racine du syst�me de fichiers.
Par exemple, si vous avez sp�cifi� comme cha�ne de
derni�re sera trait�e comme un chemin d'URL <em>� moins</em>
qu'un r�pertoire nomm� <code>www</code> n'existe � la racine
de votre syst�me de fichiers, auquel cas la cha�ne de
substitution sera trait�e comme un chemin du syst�me de
fichiers. Si vous d�sirez que d'autres directives de
correspondance d'URL (comme la directive <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>) soient appliqu�es au
chemin d'URL r�sultant, utilisez le drapeau <code>[PT]</code>
comme d�crit ci-dessous.</dd>
<dt>URL absolue</dt>
<dd>Si une URL absolue est sp�cifi�e,
<code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> v�rifie si le nom d'h�te
correspond � celui de l'h�te local. Si c'est le cas, le
protocole et le nom d'h�te sont supprim�s, et ce qui reste est
trait� comme un chemin d'URL. Dans le cas contraire, une
redirection externe vers l'URL indiqu�e est effectu�e. Pour
forcer une redirection externe vers l'h�te local, voir le
drapeau <code>[R]</code> ci-dessous.</dd>
<dt><code>-</code> (tiret)</dt>
<dd>Un tiret indique qu'aucune substitution ne doit �tre
effectu�e (le chemin consid�r� est transmis sans changement).
Ceci est utile quand un drapeau doit �tre appliqu� sans
modifier le chemin (voir ci-dessous).</dd>
</dl>
<p>En plus du texte, la cha�ne <em>Substition</em> peut
comporter :</p>
<ol>
<li>des r�f�rences arri�res (<code>$N</code>) vers le mod�le
d'une directive RewriteRule</li>
<li>des r�f�rences arri�res (<code>%N</code>) vers le dernier
mod�le d'une directive RewriteCond qui correspondait</li>
<li>des variables du serveur comme dans les cha�nes de test de
condition d'une r�gle (<code>%{VARNAME}</code>)</li>
<li>des appels de
<a href="#mapfunc">fonctions de comparaison</a>
(<code>${nom correspondance:cl�|d�faut}</code>)</li>
</ol>
<p>Les r�f�rences arri�res sont des identificateurs de la forme
<code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
seront remplac�s par le contenu du <strong>N</strong>�me groupe
du <em>Mod�le</em> qui correspondait. Les variables du serveur
sont les m�mes que dans la <em>Cha�ne de test</em> d'une
directive <code>RewriteCond</code>. Les fonctions de comparaison
sont issues de la directive <code>RewriteMap</code> dans la
section de laquelle elles sont d�crites. Ces trois types de
variables sont �valu�es dans l'ordre ci-dessus.</p>
<p>Comme mentionn� pr�c�demment, toutes les r�gles de
r��criture sont appliqu�es � la cha�ne de <em>Substitution</em>
(selon l'ordre dans lequel elles sont d�finies dans le fichier
de configuration). L'URL est <strong>int�gralement
remplac�e</strong> par la cha�ne de <em>Substitution</em> et le
processus de r��criture se poursuit jusqu'� ce que toutes les
r�gles aient �t� appliqu�es, ou qu'il soit explicitement stopp�
par un drapeau <code><strong>L</strong></code>.</p>
<div class="note"><h3>Modifier la cha�ne de requ�te</h3>
<p>Par d�faut, la cha�ne de requ�te est transmise sans
modification. Vous pouvez cependant cr�er dans la cha�ne de
substitution des URLs dont une partie constitue une cha�ne de
requ�te. Pour cela, ajoutez simplement un point d'interrogation
dans la cha�ne de substitution pour indiquer que le texte qui
suit doit �tre r�inject� dans la cha�ne de requ�te. Pour
supprimer une cha�ne de requ�te, terminez simplement la cha�ne de
substitution par un point d'interrogation. Pour combiner les
nouvelles cha�nes de requ�te avec les anciennes, utilisez le
drapeau <code>[QSA]</code>.</p>
</div>
<p>En outre, vous pouvez sp�cifier des <a name="rewriteflags" id="rewriteflags">actions</a> sp�ciales � effectuer en ajoutant
des
<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
comme troisi�me argument de la directive
<code>RewriteRule</code>. S�par�s par des virgules au sein d'une
liste encadr�e par des crochets, les <em>drapeaux</em> peuvent
�tre choisis parmi les suivants : </p>
<dl>
<dt>'<code>B</code>' (r�f�rences arri�re �chapp�es)</dt>
<dd><p>Les URLs ne doivent pas �tre �chapp�es pour pouvoir �tre
compar�es par Apache, si bien que les r�f�rences arri�res
renverront une valeur non �chapp�e au moment o� elles seront
appliqu�es. En utilisant le drapeau B, les caract�res non
alphanum�riques des r�f�rences arri�res seront echapp�s. Par
exemple, consid�rons la r�gle :</p>
<div class="example"><p><code>
RewriteRule ^(/.*)$ /index.php?show=$1
</code></p></div>
<p>Elle va faire correspondre <code>/C++</code> �
correspondre <code>/C%2b%2b</code> �
<code>%2b</code> n'a pas �t� �chapp�. Par contre, avec le
drapeau B, la substitution s'effectuera vers
<p>Ce processus d'�chappement est particuli�rement n�cessaire
dans le contexte du mandataire, o� l'adresse d'arri�re-plan ne
fonctionnera pas si elle se pr�sente sous une forme
non �chapp�e.</p>
</dd>
<dt>'<code>chain|C</code>'
(cha�nage avec la r�gle suivante)</dt><dd>
Ce drapeau effectue un cha�nage entre la r�gle courante et la
suivante (qui peut elle-m�me �tre cha�n�e avec la suivante, et
ainsi de suite). Ceci provoque l'effet suivant : si une r�gle
correspond, le processus continue normalement - le drapeau n'a
aucun effet. Si la r�gle ne correspond <strong>pas</strong>,
toutes les r�gles cha�n�es suivantes sont ignor�es. Par
exemple, ce drapeau peut �tre utilis� pour supprimer la
partie ``<code>.www</code>'', dans un jeu de r�gles au niveau
du r�pertoire, lorsque vous faites intervenir une redirection
externe (o� la partie ``<code>.www</code>'' ne doit pas
figurer !).</dd>
<dt>'<code>cookie|CO=</code><em>NOM</em>:<em>VAL</em>:<em>domaine</em>[:<em>dur�e
de vie</em>[:<em>chemin</em>[:<em>s�curit�</em>[:<em>http
seulement</em>]]]]'
(d�finit un cookie)</dt><dd>
Ce drapeau d�finit un cookie au niveau du navigateur du client.
Le nom du cookie est sp�cifi� par <em>NOM</em>, et sa valeur
par <em>VAL</em>. Le champ <em>domaine</em> est le domaine du
cookie, comme '.apache.org', le champ optionnel
<em>dur�e de vie</em> est la dur�e de vie du cookie en minutes
(0 signifie que le cookie expire � la fin de la session),
et le champ optionnel <em>chemin</em> le chemin du cookie. Si
<em>s�curit�</em> est d�fini � 'secure, 'true' ou '1', le cookie ne peut
�tre transmis que par une connexion s�curis�e. Si <em>http
seulement</em> est d�fini � ''HttpOnly', 'true' ou '1', le
drapeau <code>HttpOnly</code> est utilis�, ce qui rend le cookie
inaccessible au code JavaScript sur les navigateurs qui
supportent ce dernier.</dd>
<dt>'<code>discardpathinfo|DPI'
(ne pas tenir compte de PATH_INFO)</code></dt><dd>
<p>Dans un contexte de r�pertoire, l'URI par rapport auquel
chaque r�gle <code class="directive">RewriteRule</code> effectue ses
comparaisons est la concat�nation de la valeur courante de l'URI
et de PATH_INFO.</p>
<p>L'URI courant est soit l'URI initial tel qu'envoy� par le
client, soit le r�sultat d'un passage � travers le processus de
r��criture, soit le r�sultat de la r�gle pr�c�dente du processus
de r��criture courant.</p>
<p>Par contre, PATH_INFO qui est ajout� � l'URI avant chaque
r�gle refl�te la valeur qu'avait PATH_INFO avant le processus de
r��criture. En cons�quence, si de larges parties de l'URI sont
retenues et copi�es dans une cha�ne de substitution au cours de
multiples directives <code class="directive">RewriteRule</code>, et ceci
sans tenir compte de la part qui revient � PATH_INFO dans l'URI,
il se peut que l'URI final se voit ajouter plusieurs copies de
PATH_INFO.</p>
<p>Utilisez ce drapeau dans toute substitution o� le PATH_INFO
r�sultant de la mise en correspondance pr�c�dente de cette
requ�te avec le syst�me de fichiers ne pr�sente pas d'int�r�t.
Ce drapeau indique qu'il ne faut pas tenir compte du PATH_INFO
construit avant que le processus de r��criture courant ait
commenc�. PATH_INFO ne sera pas recalcul� avant que le processus
de r��criture courant se termine. Les r�gles suivantes
rencontr�es au cours du processus ne verront que le r�sultat
direct des substitutions, sans ajout du PATH_INFO.</p></dd>
<dt>
'<code>env|E=</code><em>VAR</em>:<em>VAL</em>'
(d�finit une variable d'environnement)</dt><dd>
Ce drapeau force une variable d'environnement nomm�e
<em>VAR</em> � prendre la valeur <em>VAL</em>, o�
<em>VAL</em> peut contenir des r�f�rences arri�res vers des
expressions rationnelles (<code>$N</code> et <code>%N</code>)
qui seront �valu�es. Vous pouvez utiliser ce drapeau plusieurs
fois pour d�finir plusieurs variables. Les variables peuvent
ensuite �tre d�r�f�renc�es dans de nombreux cas, et le plus
souvent depuis XSSI (via <code><!--#echo
var="VAR"--></code>) ou CGI (<code>$ENV{'VAR'}</code>).
Vous pouvez d�r�f�rencer la variable dans un mod�le de
directive RewriteCond ult�rieure, en utilisant
<code>%{ENV:VAR}</code>. Ce drapeau permet de supprimer
des informations d'une URL, tout en conservant la trace de
ces informations.</dd>
<dt>'<code>forbidden|F</code>' (force l'interdiction d'une
URL)</dt><dd>
Ce drapeau force l'interdiction de l'URL courante - il renvoie
imm�diatement une r�ponse HTTP 403 (FORBIDDEN). Ce drapeau,
associ� � des directives RewriteCond appropri�es, permet de
bloquer de mani�re conditionnelle certaines URLs.</dd>
<dt>'<code>gone|G</code>' (signale la non-existence d'une
URL)</dt><dd>
Ce drapeau signale la non-existence d'une URL - il renvoie
imm�diatement une r�ponse HTTP 410 (GONE). Il permet de marquer
les pages qui n'existent plus comme "gone".</dd>
<dt>
'<code>handler|H</code>=<em>Gestionnaire de contenu</em>'
(impose un gestionnaire de contenu)</dt><dd>
Impose <em>Gestionnaire de contenu</em> comme gestionnaire de
contenu pour le fichier cible. Ce drapeau permet par exemple
de simuler la directive
module <code class="module"><a href="/mod/mod_alias.html">mod_alias</a></code>, qui impose en interne le
gestionnaire ``<code>cgi-script</code>'' � tous les fichiers
du r�pertoire correspondant.<br />
Dans un contexte de niveau r�pertoire, aucune substitution ne
doit modifier le chemin. N'utilisez ce drapeau dans un contexte
de r�pertoire qu'avec <code>-</code> (tiret) comme
substitution, faute de quoi la requ�te echouera.</dd>
<dt>'<code>last|L</code>'
(derni�re r�gle)</dt><dd>
Termine le processus de r��criture ici et n'applique plus
aucune r�gle de r��criture. Ce drapeau est �quivalent � la
commande Perl <code>last</code> ou la commande C
<code>break</code>. Il permet d'�viter la r��criture par les
r�gles suivantes d'une URL d�j� r��crite. Rappelez-vous
cependant que si une directive
<code class="directive">RewriteRule</code> g�n�re une redirection
interne (ce qui arrive fr�quemment lors d'une r��criture dans
un contexte de r�pertoire), la requ�te sera r�inject�e et le
processus de r��criture sera r�it�r� � partir de la
premi�re directive <code class="directive">RewriteRule</code>.</dd>
<dt>'<code>next|N</code>'
(prochain round)</dt><dd>
Relance le processus de r��criture (toujours � partir de la
premi�re r�gle). Cette fois, l'URL � comparer n'est plus l'URL
originale, mais plut�t l'URL renvoy�e par la derni�re r�gle de
r��criture. Ce drapeau est �quivalent � la commande Perl
<code>next</code> ou la commande C <code>continue</code>. Il
permet de red�marrer le processus de r��criture - en se
positionnant imm�diatement au niveau de la premi�re r�gle.
<strong>Prenez garde � ne pas cr�er de bouclage
infini !</strong></dd>
<dt>'<code>nocase|NC</code>'
(insensible � la casse)</dt><dd>
Ce drapeau rend le <em>Mod�le</em> insensible � la casse,
c'est � dire ne tenant pas compte des majuscules/minuscules
lorsque le <em>Mod�le</em> est compar� avec l'URL
courante.</dd>
<dt>
'<code>noescape|NE</code>'
(pas d'�chappement de l'URI en sortie)</dt><dd>
Ce drapeau emp�che mod_rewrite d'appliquer les r�gles
d'�chappement d'URI usuelles au r�sultat d'une r��criture.
Normalement, les caract�re sp�ciaux (comme '%', '$', ';',
etc...) sont �chapp�s en leurs �quivalents hexad�cimaux
(respectivement '%25', '%24', et '%3B') ; ce drapeau emp�che
cela de se produire. Il permet au symbole '%' d'appara�tre
en sortie, comme dans
<div class="example"><p><code>
RewriteRule ^/foo/(.*) /bar?arg=P1\%3d$1 [R,NE]
</code></p></div>
sure '<code>/bar?arg=P1=zed</code>'.
</dd>
<dt>
'<code>nosubreq|NS</code>'
(sous-requ�tes non concern�es)</dt><dd>
<p>Si ce drapeau est pr�sent, le moteur de r��criture
n'applique pas la r�gle si la requ�te courante est une
sous-requ�te interne. Par exemples, des sous-requ�tes sont
g�n�r�es en interne par Apache lorsque
informations � propos d'�ventuels fichiers de r�pertoire par
sous-requ�te, ce n'est pas toujours utile, et peut m�me
provoquer des erreurs si l'ensemble du jeu de r�gles est
appliqu�. Ce drapeau permet d'exclure certaines r�gles.</p>
<p>Pour d�terminer si l'on doit appliquer une r�gle ou pas,
si une URL est pr�fix�e par un script CGI, pour forcer son
traitement par le script CGI, vous allez probablement
rencontrer des probl�mes (ou tout du moins une surcharge
significative) avec les sous-requ�tes. Dans ce cas,
utilisez ce drapeau</p>
</dd>
<dt>
'<code>proxy|P</code>' (impose le mandataire)</dt><dd>
Ce drapeau force l'envoi de la partie substitution en
interne en tant que requ�te mandataire, et (le processus de
r��criture s'arr�te ici) son envoi imm�diat vers le <a href="mod_proxy.html">module proxy</a>. Vous devez vous
assurer que la cha�ne de substitution est un URI valide
(d�butant typiquement par
<code>http://</code><em>nom d'h�te</em>) pouvant �tre trait�e
par le module proxy d'Apache. Si ce n'est pas le cas, le
module proxy vous renverra une erreur. Utilisez ce drapeau
pour impl�menter de mani�re plus puissante la directive <a href="mod_proxy.html#proxypass">ProxyPass</a>, pour mettre
en correspondance un contenu distant dans l'espace de
nommage du serveur local.
<p>Note: <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> doit �tre activ� pour
pouvoir utiliser ce drapeau..</p>
</dd>
<dt>
'<code>passthrough|PT</code>'
(passage au gestionnaire suivant)</dt><dd>
Ce drapeau force le moteur de r��criture � affecter
la valeur du champ <code>filename</code> au
champ <code>uri</code> de la structure interne
<code>request_rec</code>. Ce drapeau n'est qu'une astuce
permettant un traitement suppl�mentaire de la sortie des
directives <code>RewriteRule</code>, en utilisant
<code>Alias</code>, <code>ScriptAlias</code>,
<code>Redirect</code>, ou d'autres directives en provenance
r��crire <code>/abc</code> vers <code>/def</code> avec
<code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, puis <code>/def</code> vers
<div class="example"><p><code>
RewriteRule ^/abc(.*) /def$1 [PT]<br />
Alias /def /ghi
</code></p></div>
Si le drapeau <code>PT</code> est omis,
<code>mod_rewrite</code> va r��crire
<code>uri=/abc/...</code> vers <code>filename=/def/...</code>
l'API doit le faire. Puis, <code>mod_alias</code> va tenter
une transition URI vers nom de fichier, et va �chouer.
<p>Note: <strong>Vous devez utiliser ce drapeau si vous
voulez m�langer des directives en provenance de diff�rents
modules qui effectuent une traduction
l'utilisation conjointe de <code class="module"><a href="/mod/mod_alias.html">mod_alias</a></code> et de
<p>Le drapeau <code>PT</code> rend implicite la pr�sence du
drapeau <code>L</code> flag : la r��criture sera stopp�e afin
de transmettre la requ�te � la phase suivante du
traitement.</p>
</dd>
<dt>'<code>qsappend|QSA</code>'
(ajout d'une cha�ne de requ�te - query string)</dt><dd>
Ce drapeau force le moteur de r��criture � ajouter la cha�ne
de substitution � la cha�ne de requ�te au lieu de remplacer
cette derni�re par la cha�ne de substitution.
Vous pouvez ainsi ajouter des donn�es � la cha�ne de requ�te
via une r�gle de r��criture.</dd>
<dt>'<code>redirect|R</code>
[=<em>code</em>]' (force une <a id="redirect" name="redirect">redirection</a>)</dt><dd>
<p>Pr�fixe la <em>cha�ne de substitution</em> par
<code>http://h�te[:port]/</code> (ce qui fait de la nouvelle
URL un URI) pour forcer une redirection externe. Si aucun
<em>code</em> n'est d�fini, une r�ponse HTTP 302 (MOVED
TEMPORARILY) sera renvoy�e. Si vous voulez renvoyer un autre
code de r�ponse, sp�cifiez simplement le nombre appropri� ou
utilisez un des noms symboliques suivants : <code>temp</code>
(d�faut), <code>permanent</code> ou <code>seeother</code>.
Vous pouvez utiliser ce drapeau pour que les r�gles mettent
l'URL sous forme canonique et la renvoient au client, pour
traduire ``<code>/~</code>'' en ``<code>/u/</code>'', ou pour
ajouter syst�matiquement un slash �
<code>/u/</code><em>utilisateur</em>, etc...<br />
<strong>Note:</strong> Si vous utilisez ce drapeau,
assurez-vous que le champ de substitution est une URL
valide ! Si ce n'est pas le cas, vous serez redirig� vers
une URL invalide. Souvenez-vous que, s'il est seul, ce
drapeau va seulement pr�fixer l'URL par
<code>http://h�te[:port]/</code>, et que le processus de
r��criture va se poursuivre. En g�n�ral, vous voudrez plut�t
stopper la r��criture � ce point, et rediriger imm�diatement.
Pour stopper la r��criture, vous pouvez ajouter le drapeau
'L'.</p>
<p>Bien qu'on utilise en g�n�ral ce drapeau pour les
redirections, on peut sp�cifier tout code de statut valide.
Si le code de statut est en dehors de la gamme des codes de
redirection (300-399), la cha�ne de <em>Substitution</em> est
supprim�e et le processus de r��criture stopp� comme si le
drapeau <code>L</code> �tait pr�sent.</p>
</dd>
<dt>'<code>skip|S</code>=<em>num</em>'
Ce drapeau force le moteur de r��criture � sauter les
<em>num</em> r�gles cons�cutives suivantes, si la r�gle courante
s'applique. Il permet de simuler une structure if-then-else : la
derni�re r�gle du bloc "then" devient <code>skip=N</code>, o� N
est le nombre de r�gles contenues dans le bloc "else" (ce qui est
un comportement diff�rent de celui du drapeau 'chain|C' !).</dd>
<dt>
'<code>type|T</code>=<em>type MIME</em>'
(force le type MIME)</dt><dd>
Force le <a class="glossarylink" href="/glossary.html#type mime" title="voir glossaire">type MIME</a> du fichier cible �
<em>type MIME</em>. Ceci permet de d�finir le type de contenu
en fonction de certaines conditions.
Dans un contexte de r�pertoire, utilisez exclusivement
<code>-</code> (tiret) comme substitution, faute de quoi le
type MIME d�fini � l'aide de ce drapeau sera perdu � cause d'un
rejeu du traitement en interne.</dd>
</dl>
<div class="note"><h3>D�veloppement du r�pertoire home</h3>
<p> Quand la cha�ne de substitution commence par quelque chose comme
"/~user" (de mani�re explicite ou par r�f�rences arri�res), mod_rewrite
d�veloppe le r�pertoire home sans tenir compte de la pr�sence ou de la
configuration du module <code class="module"><a href="/mod/mod_userdir.html">mod_userdir</a></code>.</p>
<p> Ce d�veloppement n'est pas effectu� si le drapeau <em>PT</em> est
utilis� dans la directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code></p>
</div>
<div class="note"><h3>R��critures dans le contexte de r�pertoire</h3>
<p>Le moteur de r��criture peut �tre utilis� dans les fichiers <a href="/howto/htaccess.html">.htaccess</a>. Pour activer le moteur de
r��criture pour ces fichiers, vous devez pr�ciser "<code>RewriteEngine
On</code>" <strong>et</strong> "<code>Options FollowSymLinks</code>"
doit �tre activ�. Si votre administrateur a interdit la surcharge de
<code>FollowSymLinks</code> pour un r�pertoire utilisateur, vous ne
pouvez pas utiliser le moteur de r��criture. Cette restriction est
n�cessaire pour des raisons de s�curit�.</p>
<p>Lorsqu'on utilise le moteur de r��criture dans les fichiers
<code>.htaccess</code>, le pr�fixe du r�pertoire (qui est
toujours le m�me pour un r�pertoire donn�) est automatiquement
<em>supprim�</em> pour la comparaison du mod�le et automatiquement
<em>ajout�</em> une fois la substitution effectu�e. Cette fonctionnalit�
est n�cessaire pour de nombreux cas de r��criture ; sans elle, vous
seriez oblig� de tenir compte du r�pertoire parent pour la comparaison,
ce qui n'est pas toujours
possible. Il y a une exception : si une cha�ne de substitution commence
par <code>http://</code>, le pr�fixe du r�pertoire ne sera
<strong>pas</strong> ajout�, et une redirection externe (ou le passage
par un mandataire, si le drapeau <strong>P</strong> est utilis�) sera
initi�e. Voir la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de d�tails.</p>
<p>Le moteur de r��criture peut aussi �tre utilis� dans les sections
m�mes r�gles de comparaison des pr�fixes que celles qui s'appliquent
pour les fichiers <code>.htaccess</code>. Cependant, il est en g�n�ral
plus simple, pour �viter la complication des substitutions de pr�fixes,
de d�finir les r�gles de r��criture dans le contexte du serveur
principal ou des h�tes virtuels, plut�t que dans une section
<p>Bien que du point de vue syntaxique, il soit permis de d�finir des
r�gles de r��criture dans les sections <code class="directive"><a href="/mod/core.html#location"><Location></a></code> et <code class="directive"><a href="/mod/core.html#files"><Files></a></code>, ce n'est � priori
d'aucune utilit� et n'est pas support�.</p>
</div>
<p>Voici toutes les combinaisons de substitution et leurs
significations :</p>
<p><strong>Dans la configuration au niveau du serveur principal
pour la requ�te ``<code>GET
</p>
<div class="note"><pre>
<strong>R�gle</strong> <strong>R�sultat de la substitution</strong>
---------------------------------------------- ----------------------------------
^/chemin(.*) autre-chemin$1 non valide, non support�
^/chemin(.*) autre-chemin$1 [R] non valide, non support�
^/chemin(.*) autre-chemin$1 [P] non valide, non support�
---------------------------------------------- ----------------------------------
^/chemin(.*) /autre-chemin$1 /autre-chemin/infochemin
via redirection externe
^/chemin(.*) /autre-chemin$1 [P] n'a pas lieu d'�tre, non support�
---------------------------------------------- ----------------------------------
via redirection externe
---------------------------------------------- ----------------------------------
via redirection externe
via redirection externe
(le drapeau [R] est
redondant)
via un mandataire interne
</pre></div>
<p><strong>Dans une configuration de niveau r�pertoire pour
<code>/chemin</code><br />
<code>RewriteBase /chemin</code>)<br />
pour la requ�te ``<code>GET
</p>
<div class="note"><pre>
<strong>R�gle</strong> <strong>R�sultat de la substitution</strong>
---------------------------------------------- ----------------------------------
via redirection externe
^chemin-local(.*) autre-chemin$1 [P] n'a pas lieu d'�tre, non support�
---------------------------------------------- ----------------------------------
^chemin-local(.*) /autre-chemin$1 /autre-chemin/infochemin
via redirection externe
^chemin-local(.*) /autre-chemin$1 [P] n'a pas lieu d'�tre, non support�
---------------------------------------------- ----------------------------------
via redirection externe
---------------------------------------------- ----------------------------------
via redirection externe
via redirection externe
(le drapeau [R] est
redondant)
via un mandataire interne
</pre></div>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
</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>