mod_rewrite.html.fr revision 9c1260efa52c82c2a58e5b5f20cd6902563d95f5
97a9a944b5887e91042b019776c41d5dd74557aferikabele<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
97a9a944b5887e91042b019776c41d5dd74557aferikabele<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki This file is generated from xml source: DO NOT EDIT
b1ced323143ade589985456a78f3f64d6a6580c5yoshiki XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<link href="/images/favicon.ico" rel="shortcut icon" /></head>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<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>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<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>
ad74a0524a06bfe11b7de9e3b4ce7233ab3bd3f7nd<p><span>Langues Disponibles: </span><a href="/en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
3b3b7fc78d1f5bfc2769903375050048ff41ff26nd<a href="/fr/mod/mod_rewrite.html" title="Fran�ais"> fr </a></p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<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
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4ndr�gles permettant de r��crire les URLs des requ�tes
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>rewrite_module</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_rewrite.c</td></tr></table>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Le module <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> utilise un moteur de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��criture � base de r�gles, bas� sur un interpr�teur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'expressions rationnelles, pour r��crire les URLs � la vol�e. Par
97a9a944b5887e91042b019776c41d5dd74557aferikabele d�faut, <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> met en correspondance une URL
06ba4a61654b3763ad65f52283832ebf058fdf1cslive avec le syst�me de fichiers. Cependant, on peut aussi l'utiliser
97a9a944b5887e91042b019776c41d5dd74557aferikabele pour rediriger une URL vers une autre URL, ou pour invoquer une
97a9a944b5887e91042b019776c41d5dd74557aferikabele requ�te interne � destination du mandataire.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> fournit une m�thode souple et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive puissante pour manipuler les URLs en utilisant un nombre illimit�
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de r�gles. Chaque r�gle peut �tre associ�e � un nombre illimit� de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive conditions, afin de vous permettre de r��crire les URLs en
97a9a944b5887e91042b019776c41d5dd74557aferikabele fonction de variables du serveur, de variables d'environnement,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'en-t�tes HTTP, ou de rep�res temporels.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> agit sur la totalit� de l'URL, y
06ba4a61654b3763ad65f52283832ebf058fdf1cslive compris la partie chemin. Une r�gle de r��criture peut �tre
97a9a944b5887e91042b019776c41d5dd74557aferikabele invoqu�e dans <code>httpd.conf</code> ou dans un fichier
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code>.htaccess</code>. Le chemin g�n�r� par une r�gle de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��criture peut inclure une cha�ne de param�tres, ou peut renvoyer
97a9a944b5887e91042b019776c41d5dd74557aferikabele vers un traitement secondaire interne, une redirection vers une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive requ�te externe ou vers le mandataire interne.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Vous trouverez d'avantage de d�tails, discussions et exemples
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div id="quickview"><h3 class="directives">Directives</h3>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewritebase">RewriteBase</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewritecond">RewriteCond</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewriteengine">RewriteEngine</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewritemap">RewriteMap</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewriteoptions">RewriteOptions</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#rewriterule">RewriteRule</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<li><img alt="" src="/images/down.gif" /> <a href="#logging">Journalisation</a></li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<h2><a name="logging" id="logging">Journalisation</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> offre une journalisation d�taill�e
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de ses actions aux niveaux de journalisation <code>trace1</code> �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>trace8</code>. Le niveau de journalisation peut �tre d�fini de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive mani�re sp�cifique � <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> via la directive
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="directive"><a href="/mod/core.html#loglevel">LogLevel</a></code> : jusqu'au niveau
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>debug</code> aucune action n'est journalis�e, alors qu'elles
06ba4a61654b3763ad65f52283832ebf058fdf1cslive le sont pratiquement toutes au niveau <code>trace8</code>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive L'utilisation d'un niveau de journalisation �lev� pour
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> va ralentir votre serveur HTTP Apache
97a9a944b5887e91042b019776c41d5dd74557aferikabele de mani�re dramatique ! N'utilisez un niveau de journalisation
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sup�rieur � <code>trace2</code> qu'� des fins de d�bogage !
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd LogLevel alert rewrite:trace3
117c1f888a14e73cdd821dc6c23eb0411144a41cnd <p>Ceux qui sont familiers avec les versions pr�c�dentes de
117c1f888a14e73cdd821dc6c23eb0411144a41cnd <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> vont probablement rechercher en vain les
117c1f888a14e73cdd821dc6c23eb0411144a41cnd <code>RewriteLogLevel</code>. Elles ont �t� en effet remplac�es
117c1f888a14e73cdd821dc6c23eb0411144a41cnd par une configuration de la journalisation par module, comme
117c1f888a14e73cdd821dc6c23eb0411144a41cnd mentionn� plus haut.
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>Pour extraire les traces sp�cifiques �
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>, affichez le fichier journal en
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd redirigeant la sortie vers grep :</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd tail -f error_log|fgrep '[rewrite:'
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="directive-section"><h2><a name="RewriteBase" id="RewriteBase">RewriteBase</a> <a name="rewritebase" id="rewritebase">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit l'URL de base pour les r��critures au niveau
97a9a944b5887e91042b019776c41d5dd74557aferikabele<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteBase <em>chemin URL</em></code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>Pas de valeur par d�faut</code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r�pertoire, .htaccess</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>La directive <code class="directive">RewriteBase</code> d�finit
06ba4a61654b3763ad65f52283832ebf058fdf1cslive explicitement le chemin URL de base (et non le chemin du
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�pertoire dans le syst�me de fichiers !) pour les r��critures dans un contexte
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de r�pertoire. Lorsque vous utilisez une directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code> dans un fichier
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>.htaccess</code>, <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> enl�ve le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pr�fixe de r�pertoire local avant d'effectuer le traitement, puis
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��crit ce qui reste de l'URL. Lorsque la r��criture est termin�e,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> rajoute automatiquement le pr�fixe de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�pertoire local au chemin.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Cette directive est <em>requise</em> pour les r��critures
06ba4a61654b3763ad65f52283832ebf058fdf1cslive dans un contexte de r�pertoire d�fini via la directive
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Si votre chemin URL n'existe pas r�ellement dans le syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers, ou ne trouve pas directement sous le r�pertoire d�fini
06ba4a61654b3763ad65f52283832ebf058fdf1cslive par la directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code>, vous devez utiliser la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive <code class="directive">RewriteBase</code> dans chaque fichier
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>.htaccess</code> o� vous voulez utiliser des directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>L'exemple ci-dessous montre comment faire correspondre
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>.htaccess</code>. On suppose que le contenu disponible �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive http://example.com/ se situe sur le disque �
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteEngine On
06ba4a61654b3763ad65f52283832ebf058fdf1cslive# Le chemin URL utilis� pour arriver dans ce contexte, et non le chemin
06ba4a61654b3763ad65f52283832ebf058fdf1cslive# du syst�me de fichiers
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteBase /mon-appli/
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteRule ^index\.html$ nouveau_site.html
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="directive-section"><h2><a name="RewriteCond" id="RewriteCond">RewriteCond</a> <a name="rewritecond" id="rewritecond">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit une condition qui devra �tre satisfaite pour que
06ba4a61654b3763ad65f52283832ebf058fdf1cslivela r��criture soit effectu�e
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>cha�ne de test</em> <em>expression de comparaison</em></code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>La directive <code class="directive">RewriteCond</code> permet de d�finir une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive condition d'ex�cution d'une r�gle. Une ou plusieurs conditions
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="directive">RewriteCond</code> peuvent pr�c�der une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code>. La r�gle de r��criture correspondante n'est
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ainsi ex�cut�e que si ces conditions sont satisfaites,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong>et</strong> si l'URI correspond au mod�le sp�cifi� dans la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><em>TestString</em> est une cha�ne qui peut contenir les
06ba4a61654b3763ad65f52283832ebf058fdf1cslive extensions suivantes en plus du texte simple :</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong>r�f�rences arri�res de r�gle de r��criture</strong> :
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ce sont des r�f�rences arri�res de la forme
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong><code>$N</code></strong> (0 <= N <= 9). $1 � $9
06ba4a61654b3763ad65f52283832ebf058fdf1cslive permettent d'acc�der aux parties regroup�es (entre
06ba4a61654b3763ad65f52283832ebf058fdf1cslive parenth�ses) du mod�le, issues de la <code>RewriteRule</code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive concern�e par le jeu de conditions <code>RewriteCond</code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive courant. $0 donne acc�s � l'ensemble de la cha�ne
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondant au mod�le.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong>R�f�rences arri�res de condition de r��criture
06ba4a61654b3763ad65f52283832ebf058fdf1cslive </strong> : ce sont des r�f�rences arri�res de la forme
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong><code>%N</code></strong> (0 <= N <= 9). %1 � %9
06ba4a61654b3763ad65f52283832ebf058fdf1cslive permettent d'acc�der aux parties regroup�es (entre
06ba4a61654b3763ad65f52283832ebf058fdf1cslive parenth�ses) du mod�le, issues de la <code>RewriteRule</code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive concern�e par le jeu de conditions <code>RewriteCond</code>
97a9a944b5887e91042b019776c41d5dd74557aferikabele courant. %0 donne acc�s � l'ensemble de la cha�ne
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondant au mod�le.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ce sont des extensions de la forme <strong><code>${nomTable:cl�|d�faut}</code></strong>. Voir la <a>href="#mapfunc">documentation sur RewriteMap</a>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pour plus de d�tails.
97a9a944b5887e91042b019776c41d5dd74557aferikabele ce sont des variables de la forme
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong><code>%{</code> <em>NAME_OF_VARIABLE</em> <code>}</code></strong>,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive o� <em>NOM_DE_VARIABLE</em> peut contenir une cha�ne issue
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de la liste suivante :
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <th>En-t�tes HTTP :</th> <th>connexion & requ�te:</th> <th />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_USER_AGENT<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_REFERER<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_COOKIE<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_FORWARDED<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_HOST<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_PROXY_CONNECTION<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP_ACCEPT<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REMOTE_ADDR<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele REMOTE_HOST<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REMOTE_PORT<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REMOTE_USER<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REMOTE_IDENT<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REQUEST_METHOD<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive SCRIPT_FILENAME<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive PATH_INFO<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive QUERY_STRING<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive AUTH_TYPE<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <th>variables internes au serveur :</th> <th>date et heure :</th> <th>sp�ciaux :</th>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive DOCUMENT_ROOT<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive SERVER_ADMIN<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive SERVER_NAME<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele SERVER_ADDR<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele SERVER_PORT<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele SERVER_PROTOCOL<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele SERVER_SOFTWARE<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive TIME_YEAR<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive TIME_MON<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive TIME_DAY<br />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd TIME_HOUR<br />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd TIME_MIN<br />
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd TIME_SEC<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive TIME_WDAY<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive API_VERSION<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive THE_REQUEST<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REQUEST_URI<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive REQUEST_FILENAME<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive IS_SUBREQ<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTPS<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Ces variables correspondent toutes aux en-t�tes MIME
06ba4a61654b3763ad65f52283832ebf058fdf1cslive HTTP de m�mes noms, au variables C du serveur HTTP Apache, ou
06ba4a61654b3763ad65f52283832ebf058fdf1cslive plupart d'entre elles sont document�es ailleurs dans le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive manuel ou dans la sp�cification CGI. Parmi les variables
97a9a944b5887e91042b019776c41d5dd74557aferikabele sp�cifiques � mod_rewrite, ou trouve les suivantes :</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Contient le texte "true" si la requ�te en cours
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de traitement est une sous-requ�te, "false" dans le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive cas contraire. Une sous-requ�te est g�n�r�e quand un
06ba4a61654b3763ad65f52283832ebf058fdf1cslive module a besoin de se r�f�rer � des fichiers ou URIs
06ba4a61654b3763ad65f52283832ebf058fdf1cslive addidionnels pour pouvoir mener � bien sa t�che.</dd>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <dd>C'est la version de l'API des modules Apache httpd
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd (l'interface interne entre le serveur et les modules)
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd pour la construction courante de httpd, telle qu'elle
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd des modules correspond � la version du serveur Apache
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd utilis� (par exemple, pour la version 1.3.14 d'Apache
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd il s'agit de la version 19990320:10), mais int�resse
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd principalement les auteurs de modules.</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>La ligne de requ�te HTTP compl�te envoy�e par le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive navigateur au serveur (par exemple, "<code>GET
06ba4a61654b3763ad65f52283832ebf058fdf1cslive en-t�te ajout� par le navigateur.</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>La ressource demand�e dans la ligne de requ�te
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Le chemin complet local au syst�me de fichiers
06ba4a61654b3763ad65f52283832ebf058fdf1cslive du fichier ou du script correspondant
06ba4a61654b3763ad65f52283832ebf058fdf1cslive � la requ�te, s'il a d�j� �t� d�termin� par le serveur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive au moment o� on y fait r�f�rence. Dans le cas
06ba4a61654b3763ad65f52283832ebf058fdf1cslive contraire, et en particulier dans le cas d'un serveur
97a9a944b5887e91042b019776c41d5dd74557aferikabele virtuel, <code>REQUEST_FILENAME</code> contient la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Contient le texte "on" si la connexion
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (Cette variable peut �tre utilis�e sans probl�me, que
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> soit charg� ou non.</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>REQUEST_FILENAME</code> contiennent toutes deux la valeur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive structure interne <code>request_rec</code>du serveur HTTP Apache.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Le premier nom correspond au nom de variable bien connu CGI,
97a9a944b5887e91042b019776c41d5dd74557aferikabele alors que le second est l'�quivalent de REQUEST_URI (qui
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Si une substitution intervient et si la r��criture se
06ba4a61654b3763ad65f52283832ebf058fdf1cslive poursuit, la valeur des deux variables sera mise � jour en
06ba4a61654b3763ad65f52283832ebf058fdf1cslive cons�quence.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Dans le contexte du serveur principal (c'est � dire avant que
06ba4a61654b3763ad65f52283832ebf058fdf1cslive la requ�te ne soit mise en correspondance avec le syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
06ba4a61654b3763ad65f52283832ebf058fdf1cslive contenir le chemin entier dans le syst�me de fichiers local car
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ce chemin b'est pas connu � ce stade du traitement. Dans ce cas,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive les deux variables contiendront la valeur de REQUEST_URI. Pour
06ba4a61654b3763ad65f52283832ebf058fdf1cslive obtenir le chemin complet de la requ�te dans le syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers local dans le contexte du serveur principal, utilisez une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�f�rence avant � base d'URL
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>%{LA-U:REQUEST_FILENAME}</code> pour d�terminer la valeur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>%{ENV:<em>variable</em>}</code>, o� <em>variable</em> peut
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondre � une variable d'environnement quelconque.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'environnement. Peut �tre consult� via des structures internes
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'Apache httpd et (si on ne les trouve pas ici) via la fonction
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>getenv()</code> � partir du processus du serveur Apache
06ba4a61654b3763ad65f52283832ebf058fdf1cslive httpd.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>Que <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> soit charg� ou non, on peut
06ba4a61654b3763ad65f52283832ebf058fdf1cslive utiliser <code>%{SSL:variable}</code>, o� <em>variable</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive peut �tre remplac� par le nom d'une
97a9a944b5887e91042b019776c41d5dd74557aferikabele d'environnement SSL</a> . Si <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> n'est pas
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd charg�, cette variable contiendra toujours une cha�ne vide.
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd Exemple : <code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> pourra
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <em>en-t�te</em> peut correspondre � tout nom d'en-t�te MIME
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd HTTP, pour extraire la valeur d'un en-t�te envoy� dans la
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd requ�te HTTP. Par exemple, <code>%{HTTP:Proxy-Connection}</code>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd contiendra la valeur de l'en-t�te HTTP
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd Si on utilise un en-t�te HTTP
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd dans une condition, et si cette condition est �valu�e �
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <code>vrai</code> pour la requ�te, cet en-t�te sera ajout� � l'en-t�te Vary de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive la r�ponse. Il ne le sera pas si la condition est �valu�e �
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code>faux</code>. L'ajout de l'en-t�te HTTP � l'en-t�te Vary
06ba4a61654b3763ad65f52283832ebf058fdf1cslive est n�cessaire � une mise en cache appropri�e.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Il faut garder � l'esprit que les conditions suivent une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive logique de cout-circuit si le drapeau
06ba4a61654b3763ad65f52283832ebf058fdf1cslive '<strong><code>ornext|OR</code></strong>' est utilis�, et que de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ce fait, certaines d'entre elles ne seront pas �valu�es.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>A des fins de r�f�rence avant, on peut utiliser,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive permet d'effectuer une sous-requ�te interne � base d'URL, afin
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de d�terminer la valeur finale de <em>variable</em>. Ceci permet
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'acc�der � la valeur d'une variable pour la r��criture inconnue
06ba4a61654b3763ad65f52283832ebf058fdf1cslive � ce stade du traitement, mais qui sera d�finie au
97a9a944b5887e91042b019776c41d5dd74557aferikabele cours d'une phase ult�rieure.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Par exemple, pour effectuer une r��criture d�pendant de la
97a9a944b5887e91042b019776c41d5dd74557aferikabele variable <code>REMOTE_USER</code> dans le contexte du serveur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive principal (fichier <code>httpd.conf</code>), vous devez utiliser
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>%{LA-U:REMOTE_USER}</code> - cette variable est d�finie
06ba4a61654b3763ad65f52283832ebf058fdf1cslive par la phase d'autorisation qui intervient <em>apr�s</em> la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive phase de traduction d'URL (pendant laquelle mod_rewrite op�re).</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Par contre, comme mod_rewrite impl�mente son contexte de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�pertoire (fichier <code>.htaccess</code>) via la phase Fixup
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de l'API, et comme la phase d'autorisation intervient
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>avant</em> cette derni�re, vous pouvez vous contenter
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</p></li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code>%{LA-F:variable}</code> peut �tre utilis�e pour effectuer
06ba4a61654b3763ad65f52283832ebf058fdf1cslive une sous-requ�te interne (bas�e sur le nom de fichier), afin de
97a9a944b5887e91042b019776c41d5dd74557aferikabele d�terminer la valeur finale de <em>variable</em>. La plupart du
06ba4a61654b3763ad65f52283832ebf058fdf1cslive temps, elle est identique � LA-U (voir ci-dessus).</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><em>expression de comparaison</em> est une expression
06ba4a61654b3763ad65f52283832ebf058fdf1cslive rationnelle qui est appliqu�e � l'instance actuelle de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>cha�ne de test</em>. <em>cha�ne de test</em> est d'abord
06ba4a61654b3763ad65f52283832ebf058fdf1cslive �valu�e, puis compar�e �
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p><em>expression de comparaison</em> est en g�n�ral une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>expression rationnelle compatible perl</em>, mais vous
97a9a944b5887e91042b019776c41d5dd74557aferikabele disposez des syntaxes suppl�mentaires suivantes pour effectuer
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>Vous pouvez pr�fixer l'expression avec un caract�re
06ba4a61654b3763ad65f52283832ebf058fdf1cslive '<code>!</code>' (point d'exclamation) pour indiquer une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive expression de <strong>non</strong>-correspondance.</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>Vous pouvez effectuer des comparaisons lexicographiques de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong><expression</strong>' (inf�rieur au sens
06ba4a61654b3763ad65f52283832ebf058fdf1cslive lexicographique)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele caract�res et la compare lexicographiquement �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>cha�ne de test</em>. La condition est satisfaite si
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>'<strong>>expression</strong>' (sup�rieur au sens
97a9a944b5887e91042b019776c41d5dd74557aferikabele lexicographique)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele caract�res et la compare lexicographiquement �
97a9a944b5887e91042b019776c41d5dd74557aferikabele <em>cha�ne de test</em>. La condition est satisfaite si
06ba4a61654b3763ad65f52283832ebf058fdf1cslive lexicographique)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive caract�res et la compare lexicographiquement �
97a9a944b5887e91042b019776c41d5dd74557aferikabele <em>cha�ne de test</em>. La condition est satisfaite si
74a6de79356cd15d2e47065087785e36dd65aa41nd lexicographique � l'<em>expression</em> (les deux cha�nes
97a9a944b5887e91042b019776c41d5dd74557aferikabele sont exactement identiques, caract�re pour caract�re). Si
97a9a944b5887e91042b019776c41d5dd74557aferikabele <em>expression</em> est <code>""</code> (deux guillemets),
97a9a944b5887e91042b019776c41d5dd74557aferikabele <em>cha�ne de test</em> est compar�e � la cha�ne vide.</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>'<strong><=expression de comparaison</strong>' (inf�rieur ou �gal �
97a9a944b5887e91042b019776c41d5dd74557aferikabele au sens lexicographique)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele Consid�re l'<em>expression de comparaison</em> comme une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive cha�ne de caract�res et la compare au sens lexicographique �
97a9a944b5887e91042b019776c41d5dd74557aferikabele la <em>cha�ne de test</em>. Vrai si <em>cha�ne de test</em>
97a9a944b5887e91042b019776c41d5dd74557aferikabele pr�c�de lexicographiquement <em>expression de comparaison</em>, ou est
06ba4a61654b3763ad65f52283832ebf058fdf1cslive �gale � <em>expression de comparaison</em> (les deux cha�nes
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sont identiques, caract�re pour caract�re).</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>'<strong>>=expression de comparaison</strong>'
97a9a944b5887e91042b019776c41d5dd74557aferikabele (sup�rieur ou �gal � au sens lexicographique)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele Consid�re l'<em>expression de comparaison</em> comme une
97a9a944b5887e91042b019776c41d5dd74557aferikabele cha�ne de caract�res et la compare au sens lexicographique �
97a9a944b5887e91042b019776c41d5dd74557aferikabele la <em>cha�ne de test</em>. Vrai si <em>cha�ne de test</em>
97a9a944b5887e91042b019776c41d5dd74557aferikabele suit lexicographiquement <em>expression de comparaison</em>, ou est
97a9a944b5887e91042b019776c41d5dd74557aferikabele �gale � <em>expression de comparaison</em> (les deux cha�nes
97a9a944b5887e91042b019776c41d5dd74557aferikabele sont identiques, caract�re pour caract�re).</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele Vous pouvez effectuer des comparaisons d'entiers :
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-eq</strong>' (est num�riquement �gal �)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele La <em>cha�ne de test</em> est consid�r�e comme un entier,
97a9a944b5887e91042b019776c41d5dd74557aferikabele et est compar�e num�riquement � l'<em>expression de
97a9a944b5887e91042b019776c41d5dd74557aferikabele comparaison</em>. Vrai si les deux expressions sont
97a9a944b5887e91042b019776c41d5dd74557aferikabele num�riquement �gales.</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>'<strong>-ge</strong>' (est num�riquement sup�rieur ou
97a9a944b5887e91042b019776c41d5dd74557aferikabele �gal �)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele La <em>cha�ne de test</em> est consid�r�e comme un entier,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et est compar�e num�riquement � l'<em>expression de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive num�riquement
97a9a944b5887e91042b019776c41d5dd74557aferikabele sup�rieure ou �gale � <em>expression de comparaison</em>.</li>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <li>'<strong>-gt</strong>' (est num�riquement sup�rieur �)<br />
97a9a944b5887e91042b019776c41d5dd74557aferikabele La <em>cha�ne de test</em> est consid�r�e comme un entier,
97a9a944b5887e91042b019776c41d5dd74557aferikabele et est compar�e num�riquement � l'<em>expression de
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum comparaison</em>. Vrai si <em>cha�ne de test</em> est
06ba4a61654b3763ad65f52283832ebf058fdf1cslive num�riquement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-le</strong>' (est num�riquement inf�rieur ou
97a9a944b5887e91042b019776c41d5dd74557aferikabele �gal �)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive La <em>cha�ne de test</em> est consid�r�e comme un entier,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et est compar�e num�riquement � l'<em>expression de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive num�riquement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive inf�rieure ou �gale � <em>expression de comparaison</em>.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Attention � la confusion avec le drapeau <strong>-l</strong>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-lt</strong>' (est num�riquement inf�rieur �)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive La <em>cha�ne de test</em> est consid�r�e comme un entier,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et est compar�e num�riquement � l'<em>expression de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive num�riquement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Attention � la confusion avec le drapeau <strong>-l</strong>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>Vous pouvez effectuer diff�rents tests sur les attributs de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Traite <em>cha�ne de test</em> comme un chemin et v�rifie
06ba4a61654b3763ad65f52283832ebf058fdf1cslive s'il existe ou pas, et s'il s'agit d'un r�pertoire.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Traite <em>cha�ne de test</em> comme un chemin et v�rifie
06ba4a61654b3763ad65f52283832ebf058fdf1cslive s'il existe ou pas, et s'il s'agit d'un fichier r�gulier.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-F</strong>' (test de l'existence d'un fichier
06ba4a61654b3763ad65f52283832ebf058fdf1cslive via une sous-requ�te)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive V�rifie si <em>cha�ne de test</em> est un fichier valide,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive accessible � travers tous les contr�les d'acc�s du serveur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive actuellement configur�s pour ce chemin. C'est une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sous-requ�te interne qui effectue cette v�rification - �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive utiliser avec pr�cautions car les performances du serveur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive peuvent s'en trouver affect�es !</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-H</strong>' (est un lien symbolique, selon la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive convention bash)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-l</strong>' (est un lien symbolique)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Consid�re la <em>cha�ne de test</em> comme un chemin et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive v�rifie son existence et si elle est un lien symbolique. On
06ba4a61654b3763ad65f52283832ebf058fdf1cslive peut aussi utiliser la convention bash <strong>-L</strong>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ou <strong>-h</strong> lorsqu'il y a risque de confusion
06ba4a61654b3763ad65f52283832ebf058fdf1cslive avec les tests <strong>-lt</strong> ou <strong>-le</strong>.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-L</strong>' (est un lien symbolique, selon la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive convention bash)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-s</strong>' (est un fichier r�gulier d'une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive certaine taille)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Consid�re la <em>cha�ne de test</em> comme un chemin et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive v�rifie son existence et si elle est un fichier r�gulier
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'une taille sup�rieure � z�ro.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive V�rifie si <em>cha�ne de test</em> est une URL valide,
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum accessible � travers tous les contr�les d'acc�s du serveur
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum actuellement configur�s pour ce chemin. C'est une
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum sous-requ�te interne qui effectue cette v�rification - �
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum utiliser avec pr�cautions car les performances du serveur
fb82af0f0cd7b58eef19c54b086131b7e1e1e749madhum peuvent s'en trouver affect�es !</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>'<strong>-x</strong>' (a l'attribut d'ex�cution positionn�)<br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Consid�re la <em>cha�ne de test</em> comme un chemin et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive v�rifie son existence et si elle a son attribut d'ex�cution
06ba4a61654b3763ad65f52283832ebf058fdf1cslive positionn�. Ce positionnement est d�termin� en fonction de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive l'OS sous-jacent.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Tous ces tests peuvent aussi �tre pr�fix�s par un point
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'exclamation ('!') pour inverser leur signification.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <li>Vous pouvez aussi d�finir certains drapeaux pour
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive comme troisi�me argument de la directive
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sous-ensemble s�par� par des virgules des drapeaux suivants :
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Rend le test insensible � la casse - il n'est pas fait de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive distinction entre majuscules et minuscules, � la fois dans le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>expression de comparaison</em>. Ce drapeau n'est pris en
06ba4a61654b3763ad65f52283832ebf058fdf1cslive compte que lors d'une comparaison entre <em>cha�ne de test</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et <em>expression de comparaison</em>. Il ne l'est pas pour les
06ba4a61654b3763ad65f52283832ebf058fdf1cslive v�rification par sous-requ�tes ou sur le syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers.</li>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Permet de cha�ner les conditions de r�gles avec un OU au
06ba4a61654b3763ad65f52283832ebf058fdf1cslive lieu du AND implicite. Exemple typique :
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteCond %{REMOTE_HOST} ^host1 [OR]
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteCond %{REMOTE_HOST} ^host2 [OR]
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteCond %{REMOTE_HOST} ^host3
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteRule ...r�gles concernant tous ces h�tes...
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Sans ce drapeau, les paires
06ba4a61654b3763ad65f52283832ebf058fdf1cslive condition/r�gle devraient �tre �crites trois fois.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Si la condition contient un en-t�te HTTP, ce drapeau emp�che
97a9a944b5887e91042b019776c41d5dd74557aferikabele ce dernier d'�tre ajout� � l'en-t�te Vary de la r�ponse. <br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive L'utilisation de ce drapeau peut provoquer une mise en cache
06ba4a61654b3763ad65f52283832ebf058fdf1cslive incorrecte de la r�ponse, si la repr�sentation de cette r�ponse
06ba4a61654b3763ad65f52283832ebf058fdf1cslive varie avec la valeur de l'en-t�te consid�r�. Ce drapeau ne
06ba4a61654b3763ad65f52283832ebf058fdf1cslive devrait donc �tre utilis� que si l'on ma�trise parfaitement le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fonctionnement de l'en-t�te Vary.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Pour r��crire la page d'accueil d'un site en fonction de
97a9a944b5887e91042b019776c41d5dd74557aferikabele l'en-t�te ``<code>User-Agent:</code>'' de la requ�te, vous
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pouvez utiliser ce qui suit : </p>
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteCond %{HTTP_USER_AGENT} ^Mozilla
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteRule ^/$ /homepage.max.html [L]
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteCond %{HTTP_USER_AGENT} ^Lynx
06ba4a61654b3763ad65f52283832ebf058fdf1csliveRewriteRule ^/$ /homepage.min.html [L]
97a9a944b5887e91042b019776c41d5dd74557aferikabeleRewriteRule ^/$ /homepage.std.html [L]
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Explications : si vous utilisez un navigateur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (Netscape Navigator, Mozilla etc) qui s'identifie comme
97a9a944b5887e91042b019776c41d5dd74557aferikabele 'Mozilla', vous acc�derez � la page d'accueil max (qui
06ba4a61654b3763ad65f52283832ebf058fdf1cslive peut contenir des frames, ou d'autres ressources
06ba4a61654b3763ad65f52283832ebf058fdf1cslive particuli�res).
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Si vous utilisez le navigateur Lynx (qui est un navigateur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive en mode texte), vous acc�derez � une page d'accueil min
97a9a944b5887e91042b019776c41d5dd74557aferikabele (qui peut �tre une version con�ue pour une navigation simple
06ba4a61654b3763ad65f52283832ebf058fdf1cslive bas�e sur le texte).
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Si aucune de ces conditions n'est satisfaite (vous utilisez tout
06ba4a61654b3763ad65f52283832ebf058fdf1cslive autre navigateur, ou votre navigateur s'identifie de mani�re non
06ba4a61654b3763ad65f52283832ebf058fdf1cslive standard), vous acc�derez � la page d'accueil std
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (standard).</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
4e3cdb85620921a8a120fe22edbccae708f4f34end<div class="directive-section"><h2><a name="RewriteEngine" id="RewriteEngine">RewriteEngine</a> <a name="rewriteengine" id="rewriteengine">Directive</a></h2>
4e3cdb85620921a8a120fe22edbccae708f4f34end<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Active ou d�sactive l'ex�cution du
4e3cdb85620921a8a120fe22edbccae708f4f34end<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteEngine on|off</code></td></tr>
4e3cdb85620921a8a120fe22edbccae708f4f34end<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>RewriteEngine off</code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>La directive <code class="directive">RewriteEngine</code> active ou
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d�sactive l'ex�cution du moteur de r��criture. Si sa valeur est
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>off</code>, ce module n'ex�cutera aucun traitement et ne
97a9a944b5887e91042b019776c41d5dd74557aferikabele mettra pas � jour les variables d'environnement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Pour d�sactiver le module, il vaut mieux utiliser cette
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive que commenter toutes les directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code> !</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Notez que les h�tes virtuels n'h�ritent pas des
06ba4a61654b3763ad65f52283832ebf058fdf1cslive configurations de r��criture. Ceci implique que vous devez
97a9a944b5887e91042b019776c41d5dd74557aferikabele ins�rer une directive <code>RewriteEngine on</code> dans chaque
06ba4a61654b3763ad65f52283832ebf058fdf1cslive h�te virtuel pour lequel vous souhaitez utiliser des r�gles
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de r��criture.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Les directives <code class="directive">RewriteMap</code> du type
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>prg</code> ne sont pas prises en compte au cours de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive l'initialisation du serveur si elle ont �t� d�finies dans un
06ba4a61654b3763ad65f52283832ebf058fdf1cslive contexte o� la directive <code class="directive">RewriteEngine</code> n'a
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<div class="directive-section"><h2><a name="RewriteMap" id="RewriteMap">RewriteMap</a> <a name="rewritemap" id="rewritemap">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D�finit une fonction de mise en correspondance pour la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteMap <em>nom de la correspondance</em> <em>type de
06ba4a61654b3763ad65f52283832ebf058fdf1cslivecorrespondance</em>:<em>source de la correspondance</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Il est possible de choisir entre plusieurs types de
06ba4a61654b3763ad65f52283832ebf058fdf1cslivebases de donn�es depuis la version 2.0.41 du serveur HTTP Apache</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>La directive <code class="directive">RewriteMap</code> d�finit une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>Table de correspondance pour la r��criture</em> que les
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fonctions de mise en correspondance
06ba4a61654b3763ad65f52283832ebf058fdf1cslive peuvent utiliser dans les cha�nes de substitution des r�gles
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pour ins�rer/substituer des champs en recherchant des mots-cl�s.
97a9a944b5887e91042b019776c41d5dd74557aferikabele La source utilis�e pour cette recherche peut �tre de plusieurs
97a9a944b5887e91042b019776c41d5dd74557aferikabele correspondance</em></a> est le nom de la table de correspondance
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et servira � sp�cifier une fonction de mise en correspondance
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pour les cha�nes de substitution d'une r�gle de r��criture selon
06ba4a61654b3763ad65f52283832ebf058fdf1cslive une des constructions suivantes :</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>mot-cl�</em> <code>|</code> <em>valeur par d�faut</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Lorsqu'une telle construction est rencontr�e, la table de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondance <em>Nom de la correspondance</em> est consult�e
06ba4a61654b3763ad65f52283832ebf058fdf1cslive et la cl� <em>mot-cl�</em> recherch�e. Si la cl� est trouv�e, la
97a9a944b5887e91042b019776c41d5dd74557aferikabele construction est remplac�e par
06ba4a61654b3763ad65f52283832ebf058fdf1cslive la <em>valeur de remplacement</em>. Si la cl� n'est pas trouv�e,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive elle est remplac�e par la <em>valeur par d�faut</em>, ou par une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive cha�ne vide si aucune <em>valeur par d�faut</em> n'est
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sp�cifi�e. La valeur vide se comporte comme si la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive cl� �tait absente ; il est donc impossible de distinguer une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive valeur vide d'une absence de cl�.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Par exemple, vous pouvez d�finir une directive
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="directive">RewriteMap</code> comme suit </p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive RewriteMap map-exemple txt:/chemin/vers/fichier/map.txt
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Vous pourrez ensuite utiliser cette table dans une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive <code class="directive">RewriteRule</code> comme suit :</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd RewriteRule ^/ex/(.*) ${map-exemple:$1}
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>Les combinaisons suivantes pour <em>type de correspondance</em>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd peuvent �tre utilis�es :</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <dd>Un fichier texte contenant des paires cl�-valeur s�par�es
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd par des espaces, une paire par ligne (<a href="/rewrite/rewritemap.html#txt">D�tails ...</a>).</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>S�lection al�atoire d'une entr�e depuis un fichier texte (<a href="/rewrite/rewritemap.html#rnd">D�tails ...</a>).</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Recherche une entr�e dans un fichier dbm contenant des
06ba4a61654b3763ad65f52283832ebf058fdf1cslive paires nom-valeur. Le condens� hash est �labor� � partir d'un
06ba4a61654b3763ad65f52283832ebf058fdf1cslive format de fichier texte via l'utilitaire <code><a href="/programs/httxt2dbm.html">httxt2dbm</a></code> (<a href="/rewrite/rewritemap.html#dbm">D�tails ...</a>).</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Une des quatre fonctions internes disponibles que fournit
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>RewriteMap</code>: toupper, tolower, escape ou unescape
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (<a href="/rewrite/rewritemap.html#int">D�tails ...</a>).</dd>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <dd>Appelle un programme externe ou un script pour effectuer la
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd r��criture (<a href="/rewrite/rewritemap.html#int">D�tails
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <dd>Une commande SQL SELECT � ex�cuter pour rechercher la cible
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd de r��criture (<a href="/rewrite/rewritemap.html#int">D�tails
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<p>Vous trouverez plus de d�tails et de nombreux exemples dans le <a href="/rewrite/rewritemap.html">RewriteMap HowTo</a>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<div class="directive-section"><h2><a name="RewriteOptions" id="RewriteOptions">RewriteOptions</a> <a name="rewriteoptions" id="rewriteoptions">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Configure certaines options sp�ciales
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteOptions <var>Options</var></code></td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td><code>MaxRedirects</code> n'est plus disponible depuis
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>La directive <code class="directive">RewriteOptions</code> d�finit
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd certaines options sp�ciales pour la configuration au niveau du
06ba4a61654b3763ad65f52283832ebf058fdf1cslive serveur ou du r�pertoire. La cha�ne de caract�res <em>Option</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ne peut actuellement prendre qu'une des valeurs suivantes :</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Ceci force la configuration locale � h�riter de la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive configuration du niveau sup�rieur. Dans le contexte des h�tes
06ba4a61654b3763ad65f52283832ebf058fdf1cslive virtuels, cela signifie que les correspondances, conditions et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�gles du serveur principal sont h�rit�es. Dans le contexte des
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�pertoires, cela signifie que les conditions et r�gles de la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive configuration <code>.htaccess</code> ou les sections <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> du r�pertoire
06ba4a61654b3763ad65f52283832ebf058fdf1cslive parent sont h�rit�es. Les r�gles h�rit�es sont virtuellement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive copi�es dans la section o� cette directive est utilis�e. Si elles
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sont utilis�es avec des r�gles locales, les r�gles h�rit�es sont
97a9a944b5887e91042b019776c41d5dd74557aferikabele plac�es apr�s ces derni�res. La place de cette directive - avant
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ou apr�s les r�gles locales - n'a aucune influence sur ce
97a9a944b5887e91042b019776c41d5dd74557aferikabele comportement. Si des r�gles locales ont forc� l'arr�t de la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��criture, les r�gles h�rit�es ne seront pas trait�es.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Les r�gles h�rit�es du niveau parent sont appliqu�es
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong>after</strong> apr�s les r�gles sp�cifi�es dans le niveau
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>M�me effet que l'option <code>Inherit</code> ci-dessus, mais
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd les r�gles sp�cifi�es dans le niveau parent s'appliquent
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <strong>avant</strong> les r�gles sp�cifi�es dans le niveau
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd enfant. Disponible depuis la version 2.3.10 du serveur HTTP
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd Apache.</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="directive-section"><h2><a name="RewriteRule" id="RewriteRule">RewriteRule</a> <a name="rewriterule" id="rewriterule">Directive</a></h2>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<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>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteRule
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>Mod�le</em> <em>Substitution</em> [<em>drapeaux</em>]</code></td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>FileInfo</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>La directive <code class="directive">RewriteRule</code> est le
97a9a944b5887e91042b019776c41d5dd74557aferikabele v�ritable cheval de trait de la r��criture. La directive peut
06ba4a61654b3763ad65f52283832ebf058fdf1cslive appara�tre plusieurs fois, chaque instance d�finissant une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�gle de r��criture particuli�re. L'ordre dans lequel ces r�gles
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sont d�finies est important - il s'agit de l'ordre dans lequel
97a9a944b5887e91042b019776c41d5dd74557aferikabele les r�gles seront appliqu�es au cours du processus de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��criture.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><a id="patterns" name="patterns"><em>Mod�le</em></a> est une
97a9a944b5887e91042b019776c41d5dd74557aferikabele <a id="regexp" name="regexp">expression rationnelle</a>
97a9a944b5887e91042b019776c41d5dd74557aferikabele compatible perl. Dans la premi�re r�gle de r��criture,
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd l'expression est compar�e au (%-encoded)
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <a href="/directive-dict.html#Syntax">chemin de l'URL</a> de la
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd requ�te ; les expressions suivantes sont compar�es � la sortie de
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd la derni�re r�gle de r��criture qui a �t� appliqu�e.</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd de l'URL apr�s le nom d'h�te et le port, et avant la cha�ne de
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd requ�te.</p>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <p>Dans un contexte de r�pertoire, <em>Mod�le</em> est compar� �
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd ce qui reste de l'URL apr�s suppression du pr�fixe qui a conduit
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd Apache httpd � la r�gle courante (voir la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>). Le pr�fixe supprim�
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd se termine toujours par un slash, ce qui signifie que la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondance se fera toujours avec une cha�ne qui ne commence
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pas par un slash. Un <em>Mod�le</em> contenant <code>^/</code> ne
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondra jamais dans un contexte de r�pertoire.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Si vous souhaitez faire une comparaison sur le nom
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'h�te, le port, ou la cha�ne de requ�te, utilisez une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive comportant respectivement les variables
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>%{QUERY_STRING}</code>. Si vous d�sirez effectuer une
97a9a944b5887e91042b019776c41d5dd74557aferikabele correspondance avec l'ensemble du chemin de l'URL dans un contexte
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de r�pertoire (htaccess), utilisez la variable
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Pour quelques conseils � propos des <a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, voir le
97a9a944b5887e91042b019776c41d5dd74557aferikabele document <a href="/rewrite/intro.html#regex">Introduction �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Dans mod_rewrite, on peut aussi utiliser le caract�re NON
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ('<code>!</code>') comme pr�fixe de mod�le. Ceci vous permet
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'inverser la signification d'un mod�le, soit pour dire
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ``<em>si l'URL consid�r�e ne correspond <strong>PAS</strong> �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive ce mod�le</em>''. Le caract�re NON peut donc �tre utilis� �
06ba4a61654b3763ad65f52283832ebf058fdf1cslive titre exceptionnel, lorsqu'il est plus simple d'effectuer une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive comparaison avec le mod�le invers�, ou dans la derni�re r�gle
06ba4a61654b3763ad65f52283832ebf058fdf1cslive par d�faut.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1csliveSi vous utilisez le caract�re NON pour inverser la signification d'un
97a9a944b5887e91042b019776c41d5dd74557aferikabelemod�le, vous ne pouvez pas inclure de parties g�n�riques group�es dans
06ba4a61654b3763ad65f52283832ebf058fdf1cslivele mod�le. Ceci est d� au fait que, lorsque le mod�le ne correspond
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepas (autrement dit, sa n�gation correspond), les groupes sont vides.
06ba4a61654b3763ad65f52283832ebf058fdf1csliveAinsi, si vous utilisez des mod�les invers�s, vous ne pouvez
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepas vous r�f�rer aux groupes par <code>$N</code> dans la cha�ne de
06ba4a61654b3763ad65f52283832ebf058fdf1cslivesubstitution !
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Dans une r�gle de r��criture,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <a id="rhs" name="rhs"><em>Substitution</em></a> est la cha�ne
97a9a944b5887e91042b019776c41d5dd74557aferikabele de caract�res qui remplace le chemin de l'URL original qui
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondait au <em>Mod�le</em>. <em>Substitution</em> peut
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Il indique alors la localisation dans le syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers de la ressource qui doit �tre envoy�e au client.</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Un chemin relatif � la valeur de <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code> vers la ressource qui
97a9a944b5887e91042b019776c41d5dd74557aferikabele doit �tre servie. Notez que <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive essaie de deviner si vous avez sp�cifi� un chemin du syst�me
97a9a944b5887e91042b019776c41d5dd74557aferikabele de fichiers ou un chemin d'URL en v�rifiant si la premi�re
06ba4a61654b3763ad65f52283832ebf058fdf1cslive partie du chemin existe � la racine du syst�me de fichiers.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive Par exemple, si vous avez sp�cifi� comme cha�ne de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>Substitution</em> <code>/www/file.html</code>, cette
97a9a944b5887e91042b019776c41d5dd74557aferikabele derni�re sera trait�e comme un chemin d'URL <em>� moins</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive qu'un r�pertoire nomm� <code>www</code> n'existe � la racine
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de votre syst�me de fichiers, auquel cas la cha�ne de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive substitution sera trait�e comme un chemin du syst�me de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive fichiers. Si vous d�sirez que d'autres directives de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspondance d'URL (comme la directive <code class="directive"><a href="/mod/mod_alias.html#alias">Alias</a></code>) soient appliqu�es au
06ba4a61654b3763ad65f52283832ebf058fdf1cslive chemin d'URL r�sultant, utilisez le drapeau <code>[PT]</code>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive comme d�crit ci-dessous.</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <dd>Si une URL absolue est sp�cifi�e,
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code class="module"><a href="/mod/mod_rewrite.html">mod_rewrite</a></code> v�rifie si le nom d'h�te
06ba4a61654b3763ad65f52283832ebf058fdf1cslive correspond � celui de l'h�te local. Si c'est le cas, le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive protocole et le nom d'h�te sont supprim�s, et ce qui reste est
97a9a944b5887e91042b019776c41d5dd74557aferikabele trait� comme un chemin d'URL. Dans le cas contraire, une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive redirection externe vers l'URL indiqu�e est effectu�e. Pour
06ba4a61654b3763ad65f52283832ebf058fdf1cslive forcer une redirection externe vers l'h�te local, voir le
97a9a944b5887e91042b019776c41d5dd74557aferikabele <dd>Un tiret indique qu'aucune substitution ne doit �tre
06ba4a61654b3763ad65f52283832ebf058fdf1cslive effectu�e (le chemin consid�r� est transmis sans changement).
97a9a944b5887e91042b019776c41d5dd74557aferikabele Ceci est utile quand un drapeau doit �tre appliqu� sans
06ba4a61654b3763ad65f52283832ebf058fdf1cslive modifier le chemin (voir ci-dessous).</dd>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>En plus du texte, la cha�ne <em>Substition</em> peut
97a9a944b5887e91042b019776c41d5dd74557aferikabele comporter :</p>
1578daeec017d3bb20cecdcdc3b0261c999730d5slive <li>des r�f�rences arri�res (<code>$N</code>) vers le mod�le
1578daeec017d3bb20cecdcdc3b0261c999730d5slive d'une directive RewriteRule</li>
1578daeec017d3bb20cecdcdc3b0261c999730d5slive <li>des r�f�rences arri�res (<code>%N</code>) vers le dernier
1578daeec017d3bb20cecdcdc3b0261c999730d5slive mod�le d'une directive RewriteCond qui correspondait</li>
ab6f5669a4cb16dbff7d791d434ba1b9c9b50928nd <li>des variables du serveur comme dans les cha�nes de test de
1578daeec017d3bb20cecdcdc3b0261c999730d5slive <li>des appels de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>Les r�f�rences arri�res sont des identificateurs de la forme
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
06ba4a61654b3763ad65f52283832ebf058fdf1cslive seront remplac�s par le contenu du <strong>N</strong>�me groupe
06ba4a61654b3763ad65f52283832ebf058fdf1cslive du <em>Mod�le</em> qui correspondait. Les variables du serveur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sont les m�mes que dans la <em>Cha�ne de test</em> d'une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive directive <code>RewriteCond</code>. Les fonctions de comparaison
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sont issues de la directive <code>RewriteMap</code> dans la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive section de laquelle elles sont d�crites. Ces trois types de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive variables sont �valu�es dans l'ordre ci-dessus.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Comme mentionn� pr�c�demment, toutes les r�gles de
97a9a944b5887e91042b019776c41d5dd74557aferikabele r��criture sont appliqu�es � la cha�ne de <em>Substitution</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (selon l'ordre dans lequel elles sont d�finies dans le fichier
06ba4a61654b3763ad65f52283832ebf058fdf1cslive de configuration). L'URL est <strong>int�gralement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive remplac�e</strong> par la cha�ne de <em>Substitution</em> et le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive processus de r��criture se poursuit jusqu'� ce que toutes les
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�gles aient �t� appliqu�es, ou qu'il soit explicitement stopp�
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <div class="note"><h3>Modifier la cha�ne de requ�te</h3>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <p>Par d�faut, la cha�ne de requ�te est transmise sans
06ba4a61654b3763ad65f52283832ebf058fdf1cslive modification. Vous pouvez cependant cr�er dans la cha�ne de
97a9a944b5887e91042b019776c41d5dd74557aferikabele substitution des URLs dont une partie constitue une cha�ne de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive requ�te. Pour cela, ajoutez simplement un point d'interrogation
97a9a944b5887e91042b019776c41d5dd74557aferikabele dans la cha�ne de substitution pour indiquer que le texte qui
06ba4a61654b3763ad65f52283832ebf058fdf1cslive suit doit �tre r�inject� dans la cha�ne de requ�te. Pour
06ba4a61654b3763ad65f52283832ebf058fdf1cslive supprimer une cha�ne de requ�te, terminez simplement la cha�ne de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive substitution par un point d'interrogation. Pour combiner les
97a9a944b5887e91042b019776c41d5dd74557aferikabele nouvelles cha�nes de requ�te avec les anciennes, utilisez le
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p>En outre, vous pouvez sp�cifier des <a name="rewriteflags" id="rewriteflags">actions</a> sp�ciales � effectuer en ajoutant
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <strong><code>[</code><em>drapeaux</em><code>]</code></strong>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive comme troisi�me argument de la directive
97a9a944b5887e91042b019776c41d5dd74557aferikabele <code>RewriteRule</code>. S�par�s par des virgules au sein d'une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive liste encadr�e par des crochets, les <em>drapeaux</em> peuvent
06ba4a61654b3763ad65f52283832ebf058fdf1cslive �tre choisis dans la table suivante. Vous trouverez plus de
97a9a944b5887e91042b019776c41d5dd74557aferikabele d�tails, et des exemples pour chaque drapeau dans le <a href="/rewrite/flags.html">document � propos des drapeaux de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Echappe les caract�res non-alphanum�riques <em>avant</em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive d'appliquer la transformation. <em><a href="/rewrite/flags.html#flag_b">d�tails ...</a></em></td>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <td>La r�gle est cha�n�e avec la r�gle suivante. Si la r�gle
06ba4a61654b3763ad65f52283832ebf058fdf1cslive �choue, la ou les r�gles avec lesquelles elle est est cha�n�e
06ba4a61654b3763ad65f52283832ebf058fdf1cslive seront saut�es. <em><a href="/rewrite/flags.html#flag_c">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>D�finit un cookie au niveau du navigateur client. La syntaxe
06ba4a61654b3763ad65f52283832ebf058fdf1cslive compl�te est :
06ba4a61654b3763ad65f52283832ebf058fdf1cslive CO=<em>NAME</em>:<em>VAL</em>[:<em>domain</em>[:<em>lifetime</em>[:<em>path</em>[:<em>secure</em>[:<em>httponly</em>]]]]]
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em><a href="/rewrite/flags.html#flag_co">d�tails ...</a></em>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Supprime la partie PATH_INFO de l'URI r��crit. <em><a href="/rewrite/flags.html#flag_dpi">d�tails
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>D�finit la variable d'environnement <em>VAR</em> (� la valeur
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em>VAL</em> si elle est fournie). <em><a href="/rewrite/flags.html#flag_e">d�tails ...</a></em></td>
97a9a944b5887e91042b019776c41d5dd74557aferikabele <td>Renvoie une r�ponse 403 FORBIDDEN au navigateur client.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em><a href="/rewrite/flags.html#flag_f">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Renvoie un message d'erreur 410 GONE au navigateur client. <em><a href="/rewrite/flags.html#flag_g">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive contenu</em> pour traitement. <em><a href="/rewrite/flags.html#flag_h">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Arr�te le processus de r��criture imm�diatement et n'applique
06ba4a61654b3763ad65f52283832ebf058fdf1cslive plus aucune r�gle. Pr�tez une attention particuli�re aux mises
06ba4a61654b3763ad65f52283832ebf058fdf1cslive en garde concernant les contextes de niveau r�pertoire et
06ba4a61654b3763ad65f52283832ebf058fdf1cslive .htaccess (voir aussi le drapeau END). <em><a href="/rewrite/flags.html#flag_l">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>R�ex�cute le processus de r��criture � partir de la premi�re
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r�gle, en utilisant le r�sultat du jeu de r�gles, sous r�serve
06ba4a61654b3763ad65f52283832ebf058fdf1cslive qu'il y ait un point de d�part. <em><a href="/rewrite/flags.html#flag_n">d�tails
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Rend la comparaison entre mod�les insensible � la casse.
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <em><a href="/rewrite/flags.html#flag_nc">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Emp�che mod_rewrite d'effectuer un �chappement hexad�cimal
97a9a944b5887e91042b019776c41d5dd74557aferikabele des caract�res sp�ciaux dans le r�sultat de la r��criture. <em><a href="/rewrite/flags.html#flag_ne">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>La r�gle est saut�e si la requ�te courante est une
06ba4a61654b3763ad65f52283832ebf058fdf1cslive sous-requ�te interne. <em><a href="/rewrite/flags.html#flag_ns">d�tails ...</a></em></td>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <td>Force l'envoi en interne de l'URL de substitution en tant
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd que requ�te mandataire. <em><a href="/rewrite/flags.html#flag_p">d�tails
0203b896e484dfb877111aceffb812401d0f216and <td>L'URI r�sultant est repass� au moteur de mise en
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd correspondance des URLs pour y �tre trait� par d'autres
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd traducteurs URI-vers-nom de fichier, comme <code>Alias</code> ou
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <code>Redirect</code>. <em><a href="/rewrite/flags.html#flag_pt">d�tails ...</a></em></td>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <td>Ajoute toute cha�ne de param�tres cr��e dans la cible de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive r��criture � toute cha�ne de param�tres pr�sente dans l'URL de la
06ba4a61654b3763ad65f52283832ebf058fdf1cslive requ�te originale. <em><a href="/rewrite/flags.html#flag_qsa">d�tails ...</a></em></td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <td>Supprime toute cha�ne de param�tres de l'URI entrant. <em><a href="/rewrite/flags.html#flag_qsd">d�tails
0203b896e484dfb877111aceffb812401d0f216and <td>Force une redirection externe, avec un code de statut HTTP
0203b896e484dfb877111aceffb812401d0f216and optionnel. <em><a href="/rewrite/flags.html#flag_r">d�tails ...</a></em>
0203b896e484dfb877111aceffb812401d0f216and <td>Arr�te le processus de r��criture imm�diatement et
0203b896e484dfb877111aceffb812401d0f216and n'applique plus aucune r�gle. Emp�che aussi l'ex�cution
0203b896e484dfb877111aceffb812401d0f216and ult�rieure de r�gles de r��criture dans des contextes de
0203b896e484dfb877111aceffb812401d0f216and r�pertoire et des fichiers .htaccess (disponible depuis la
0203b896e484dfb877111aceffb812401d0f216and version 2.3.9) <em><a href="/rewrite/flags.html#flag_l">d�tails ...</a></em></td>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <td>Si la r�gle courante s'applique, le moteur de r��criture
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd doit sauter les <em>nombre</em> r�gles suivantes. <em><a href="/rewrite/flags.html#flag_s">d�tails ...</a></em></td>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd <td>Force l'attribution du <a class="glossarylink" href="/glossary.html#type-mime" title="voir glossaire">Type-MIME</a>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd sp�cifi� au fichier cible. <em><a href="/rewrite/flags.html#flag_t">d�tails ...</a></em></td>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<div class="note"><h3>D�veloppement du r�pertoire home</h3>
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd<p> Quand la cha�ne de substitution commence par quelque chose comme
0c4abc32c00611fe1d52c9661f5cc79a3f74c6d4nd"/~user" (de mani�re explicite ou par r�f�rences arri�res), mod_rewrite
06ba4a61654b3763ad65f52283832ebf058fdf1cslived�veloppe le r�pertoire home sans tenir compte de la pr�sence ou de la
06ba4a61654b3763ad65f52283832ebf058fdf1csliveconfiguration du module <code class="module"><a href="/mod/mod_userdir.html">mod_userdir</a></code>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<p> Ce d�veloppement n'est pas effectu� si le drapeau <em>PT</em> est
06ba4a61654b3763ad65f52283832ebf058fdf1csliveutilis� dans la directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code></p>
630c456b6461158be6cc5c5483735e27b13b4ad5nd<div class="note"><h3>R��critures dans le contexte de r�pertoire</h3>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<p>Le moteur de r��criture peut �tre utilis� dans les fichiers <a href="/howto/htaccess.html">.htaccess</a>. Pour activer le moteur de
06ba4a61654b3763ad65f52283832ebf058fdf1csliver��criture pour ces fichiers, vous devez pr�ciser "<code>RewriteEngine
06ba4a61654b3763ad65f52283832ebf058fdf1csliveOn</code>" <strong>et</strong> "<code>Options FollowSymLinks</code>"
06ba4a61654b3763ad65f52283832ebf058fdf1cslivedoit �tre activ�. Si votre administrateur a interdit la surcharge de
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<code>FollowSymLinks</code> pour un r�pertoire utilisateur, vous ne
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepouvez pas utiliser le moteur de r��criture. Cette restriction est
06ba4a61654b3763ad65f52283832ebf058fdf1csliven�cessaire pour des raisons de s�curit�.</p>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<p>Lorsqu'on utilise le moteur de r��criture dans les fichiers
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<code>.htaccess</code>, le pr�fixe du r�pertoire (qui est
06ba4a61654b3763ad65f52283832ebf058fdf1cslivetoujours le m�me pour un r�pertoire donn�) est automatiquement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<em>supprim�</em> pour la comparaison du mod�le et automatiquement
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<em>ajout�</em> une fois la substitution effectu�e. Cette fonctionnalit�
06ba4a61654b3763ad65f52283832ebf058fdf1csliveest n�cessaire pour de nombreux cas de r��criture ; sans elle, vous
06ba4a61654b3763ad65f52283832ebf058fdf1csliveseriez oblig� de tenir compte du r�pertoire parent pour la comparaison,
06ba4a61654b3763ad65f52283832ebf058fdf1cslivece qui n'est pas toujours
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepossible. Il y a une exception : si une cha�ne de substitution commence
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepar <code>http://</code>, le pr�fixe du r�pertoire ne sera
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<strong>pas</strong> ajout�, et une redirection externe (ou le passage
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepar un mandataire, si le drapeau <strong>P</strong> est utilis�) sera
06ba4a61654b3763ad65f52283832ebf058fdf1csliveiniti�e. Voir la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de d�tails.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<p>Le moteur de r��criture peut aussi �tre utilis� dans les sections
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> avec les
06ba4a61654b3763ad65f52283832ebf058fdf1cslivem�mes r�gles de comparaison des pr�fixes que celles qui s'appliquent
06ba4a61654b3763ad65f52283832ebf058fdf1cslivepour les fichiers <code>.htaccess</code>. Cependant, il est en g�n�ral
06ba4a61654b3763ad65f52283832ebf058fdf1csliveplus simple, pour �viter la complication des substitutions de pr�fixes,
06ba4a61654b3763ad65f52283832ebf058fdf1cslivede d�finir les r�gles de r��criture dans le contexte du serveur
06ba4a61654b3763ad65f52283832ebf058fdf1csliveprincipal ou des h�tes virtuels, plut�t que dans une section
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<code class="directive"><a href="/mod/core.html#directory"><Directory></a></code>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<p>Bien que du point de vue syntaxique, il soit permis de d�finir des
06ba4a61654b3763ad65f52283832ebf058fdf1csliver�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
97a9a944b5887e91042b019776c41d5dd74557aferikabeled'aucune utilit� et n'est pas support�.</p>
630c456b6461158be6cc5c5483735e27b13b4ad5nd <p>Voici toutes les combinaisons de substitution et leurs
06ba4a61654b3763ad65f52283832ebf058fdf1cslive significations :</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><strong>Dans la configuration au niveau du serveur principal
97a9a944b5887e91042b019776c41d5dd74557aferikabele pour la requ�te ``<code>GET
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [R]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://autre_hote/autre_chemin/info_chemin via une redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1 [R]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://autre_hote/autre_chemin/info_chemin (le drapeau [R] est
06ba4a61654b3763ad65f52283832ebf058fdf1csliveredondant)</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^/somepath(.*) http://otherhost/otherpath$1 [P]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://otherhost/otherpath/pathinfo via internal proxy</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive <p><strong>Dans une configuration de niveau r�pertoire pour
06ba4a61654b3763ad65f52283832ebf058fdf1cslive (<code>/chemin/physique/vers/chemin/.htacccess</code>, avec
06ba4a61654b3763ad65f52283832ebf058fdf1cslive pour la requ�te ``<code>GET
06ba4a61654b3763ad65f52283832ebf058fdf1cslive /chemin/chemin-local/infochemin</code>'':</strong><br />
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://cet-h�te/chemin/autre-chemin/infochemin via redirection
06ba4a61654b3763ad65f52283832ebf058fdf1csliveexterne</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://cet-h�te/autre-chemin/infochemin via redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://cet-h�te/autre-chemin$1</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://cet-h�te/autre-chemin$1 [R]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://cet-h�te/autre-chemin/infochemin via redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://cet-h�te/autre-chemin$1 [P]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://autre h�te/autre-chemin$1</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://autre h�te/autre-chemin/infochemin via redirection externe</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://autre h�te/autre-chemin$1 [R]</td>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<td>http://autre h�te/autre-chemin/infochemin via redirection externe
06ba4a61654b3763ad65f52283832ebf058fdf1cslive(le drapeau [R] est redondant)</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>^chemin-local(.*) http://autre h�te/autre-chemin$1 [P]</td>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<td>http://autre h�te/autre-chemin/infochemin via un mandataire interne</td>
97a9a944b5887e91042b019776c41d5dd74557aferikabele<p><span>Langues Disponibles: </span><a href="/en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<a href="/fr/mod/mod_rewrite.html" title="Fran�ais"> fr </a></p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
06ba4a61654b3763ad65f52283832ebf058fdf1cslive<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>