www/apache
1
0
Fork 0
mirror of https://github.com/apache/httpd.git synced 2025-11-03 17:53:20 +03:00
Code Activity
Files
241fc01bd988f29f3a30e9178b153ceed95861b5
apache/docs/manual/mod/mod_rewrite.html.fr
Daniel Gruno 21ecea0c58 xforms 
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1364344 13f79535-47bb-0310-9956-ffa450edef68
2012-07-22 16:05:59 +00:00

1561 lines
72 KiB
Plaintext
Raw Blame History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_rewrite - Serveur Apache HTTP</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
<script src="../style/scripts/prettify.js" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
<p class="apache">Serveur Apache HTTP Version 2.5</p>
<img alt="" src="../images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <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">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_rewrite.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a></p>
</div>
<div class="outofdate">Cette traduction peut <20>tre p<>rim<69>e. V<>rifiez la version
anglaise pour les changements r<>cents.</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de r<><72>criture <20> base de
r<EFBFBD>gles permettant de r<><72>crire les URLs des requ<71>tes
<EFBFBD> la vol<6F>e</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur<75>de<64>Module:</a></th><td>rewrite_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier<65>Source:</a></th><td>mod_rewrite.c</td></tr></table>
<h3>Sommaire</h3>
<p>Le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> utilise un moteur de
r<><72>criture <20> base de r<>gles, bas<61> sur un interpr<70>teur
d'expressions rationnelles PCRE, pour r<><72>crire les URLs <20> la vol<6F>e. Par
d<>faut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> met en correspondance une URL
avec le syst<73>me de fichiers. Cependant, on peut aussi l'utiliser
pour rediriger une URL vers une autre URL, ou pour invoquer une
requ<71>te interne <20> destination du mandataire.</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> fournit une m<>thode souple et
puissante pour manipuler les URLs en utilisant un nombre illimit<69>
de r<>gles. Chaque r<>gle peut <20>tre associ<63>e <20> un nombre illimit<69> de
conditions, afin de vous permettre de r<><72>crire les URLs en
fonction de variables du serveur, de variables d'environnement,
d'en-t<>tes HTTP, ou de rep<65>res temporels.</p>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> agit sur la totalit<69> de l'URL, y
compris la partie chemin. Une r<>gle de r<><72>criture peut <20>tre
invoqu<71>e dans <code>httpd.conf</code> ou dans un fichier
<code>.htaccess</code>. Le chemin g<>n<EFBFBD>r<EFBFBD> par une r<>gle de
r<><72>criture peut inclure une cha<68>ne de param<61>tres, ou peut renvoyer
vers un traitement secondaire interne, une redirection vers une
requ<71>te externe ou vers le mandataire interne.</p>
<p>Vous trouverez d'avantage de d<>tails, discussions et exemples
dans la
<a href="../rewrite/">documentation d<>taill<6C>e
sur mod_rewrite</a>.</p>
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif" /> <a href="#rewritebase">RewriteBase</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritecond">RewriteCond</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewriteengine">RewriteEngine</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewritemap">RewriteMap</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewriteoptions">RewriteOptions</a></li>
<li><img alt="" src="../images/down.gif" /> <a href="#rewriterule">RewriteRule</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#logging">Journalisation</a></li>
</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="logging" id="logging">Journalisation</a></h2>
<p><code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> offre une journalisation d<>taill<6C>e
de ses actions aux niveaux de journalisation <code>trace1</code> <20>
<code>trace8</code>. Le niveau de journalisation peut <20>tre d<>fini de
mani<6E>re sp<73>cifique <20> <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> via la directive
<code class="directive"><a href="../mod/core.html#loglevel">LogLevel</a></code> : jusqu'au niveau
<code>debug</code> aucune action n'est journalis<69>e, alors qu'elles
le sont pratiquement toutes au niveau <code>trace8</code>.</p>
<div class="note">
L'utilisation d'un niveau de journalisation <20>lev<65> pour
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> va ralentir votre serveur HTTP Apache
de mani<6E>re dramatique ! N'utilisez un niveau de journalisation
sup<75>rieur <20> <code>trace2</code> qu'<27> des fins de d<>bogage !
</div>
<div class="example"><h3>Exemple</h3><pre class="prettyprint lang-config">
LogLevel alert rewrite:trace3
</pre>
</div>
<div class="note"><h3>RewriteLog</h3>
<p>Ceux qui sont familiers avec les versions pr<70>c<EFBFBD>dentes de
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> vont probablement rechercher en vain les
directives <code>RewriteLog</code> et
<code>RewriteLogLevel</code>. Elles ont <20>t<EFBFBD> en effet remplac<61>es
par une configuration de la journalisation par module, comme
mentionn<6E> plus haut.
</p>
<p>Pour extraire les traces sp<73>cifiques <20>
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, affichez le fichier journal en
redirigeant la sortie vers grep :</p>
<div class="example"><p><code>
tail -f error_log|fgrep '[rewrite:'
</code></p></div>
</div>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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<><72>critures au niveau
r<EFBFBD>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>Pas de valeur par d<>faut</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>r<>pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
<p>La directive <code class="directive">RewriteBase</code> permet de
sp<73>cifier le pr<70>fixe d'URL <20> utiliser dans un contexte de
r<>pertoire (htaccess) pour les directives
<code class="directive">RewriteRule</code> qui r<><72>crivent vers un chemin
relatif.</p>
<p>Cette directive est <em>obligatoire</em> si vous utilisez un
chemin relatif dans une substitution, et dans un contexte de
r<>pertoire (htaccess), sauf si au moins une de ces conditions est
v<>rifi<66>e :</p>
<ul>
<li>La requ<71>te initiale, ainsi que la substitution, sont dans
la <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est <20>
dire que pour y acc<63>der, il n'est pas n<>cessaire d'utiliser
une directive telle qu'<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>).</li>
<li>Le chemin du syst<73>me de fichiers vers le r<>pertoire
contenant la <code class="directive">RewriteRule</code>, suffix<69> par
la substitution relative est aussi valide en tant qu'URL sur
le serveur (ce qui est rare).</li>
</ul>
<p>Dans l'exemple ci-dessous, la directive
<code class="directive">RewriteBase</code> est n<>cessaire afin d'<27>viter une
r<EFBFBD><EFBFBD>criture en http://example.com/opt/myapp-1.2.3/welcome.html car la
ressource n'<27>tait pas relative <20> la racine des documents. Cette erreur
de configuration aurait conduit le serveur <20> rechercher un r<>pertoire
"opt" <20> la racine des documents.</p>
<pre class="prettyprint lang-config">
DocumentRoot /var/www/example.com
Alias /myapp /opt/myapp-1.2.3
&lt;Directory /opt/myapp-1.2.3&gt;
RewriteEngine On
RewriteBase /myapp/
RewriteRule ^index\.html$ welcome.html
&lt;/Directory&gt;
</pre>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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 <20>tre satisfaite pour que
la r<><72>criture soit effectu<74>e
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
<em>cha<68>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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
<p>La directive <code class="directive">RewriteCond</code> permet de d<>finir une
condition d'ex<65>cution d'une r<>gle. Une ou plusieurs conditions
<code class="directive">RewriteCond</code> peuvent pr<70>c<EFBFBD>der une
directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code>. La r<>gle de r<><72>criture correspondante n'est
ainsi ex<65>cut<75>e que si ces conditions sont satisfaites,
<strong>et</strong> si l'URI correspond au mod<6F>le sp<73>cifi<66> dans la
r<>gle.</p>
<p><em>TestString</em> est une cha<68>ne qui peut contenir les
extensions suivantes en plus du texte simple :</p>
<ul>
<li>
<strong>r<>f<EFBFBD>rences arri<72>res de r<>gle de r<><72>criture</strong> :
ce sont des r<>f<EFBFBD>rences arri<72>res de la forme
<strong><code>$N</code></strong> (0 &lt;= N &lt;= 9). $1 <20> $9
permettent d'acc<63>der aux parties regroup<75>es (entre
parenth<74>ses) du mod<6F>le, issues de la <code>RewriteRule</code>
concern<72>e par le jeu de conditions <code>RewriteCond</code>
courant. $0 donne acc<63>s <20> l'ensemble de la cha<68>ne
correspondant au mod<6F>le.</li>
<li>
<strong>R<>f<EFBFBD>rences arri<72>res de condition de r<><72>criture
</strong> : ce sont des r<>f<EFBFBD>rences arri<72>res de la forme
<strong><code>%N</code></strong> (0 &lt;= N &lt;= 9). %1 <20> %9
permettent d'acc<63>der aux parties regroup<75>es (entre
parenth<74>ses) du mod<6F>le, issues de la <code>RewriteRule</code>
concern<72>e par le jeu de conditions <code>RewriteCond</code>
courant. %0 donne acc<63>s <20> l'ensemble de la cha<68>ne
correspondant au mod<6F>le.</li>
<li>
<strong>extensions de table de r<><72>criture</strong> :
ce sont des extensions de la forme <strong><code>${nomTable:cl<63>|d<>faut}</code></strong>. Voir la <a>href="#mapfunc"&gt;documentation sur 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>NAME_OF_VARIABLE</em> <code>}</code></strong>,
o<> <em>NOM_DE_VARIABLE</em> peut contenir une cha<68>ne issue
de la liste suivante :
<table>
<tr>
<th>En-t<>tes HTTP :</th> <th>connexion &amp; requ<71>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<73>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 />
REQUEST_SCHEME<br />
</td>
</tr>
</table>
<p>Ces variables correspondent toutes aux en-t<>tes MIME
HTTP de m<>mes noms, au variables C du serveur HTTP Apache, ou
aux champs <code>struct tm</code> du syst<73>me Unix. La
plupart d'entre elles sont document<6E>es ailleurs dans le
manuel ou dans la sp<73>cification CGI.</p>
<p>SERVER_NAME et SERVER_PORT d<>pendent respectivement
des valeurs des directives <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> et <code class="directive"><a href="../mod/core.html#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code>.</p>
<p>Parmi les variables
sp<73>cifiques <20> mod_rewrite, ou trouve les suivantes :</p>
<div class="note">
<dl>
<dt><code>IS_SUBREQ</code></dt>
<dd>Contient le texte "true" si la requ<71>te en cours
de traitement est une sous-requ<71>te, "false" dans le
cas contraire. Une sous-requ<71>te est g<>n<EFBFBD>r<EFBFBD>e quand un
module a besoin de se r<>f<EFBFBD>rer <20> des fichiers ou URIs
addidionnels pour pouvoir mener <20> bien sa t<>che.</dd>
<dt><code>API_VERSION</code></dt>
<dd>C'est la version de l'API des modules Apache httpd
(l'interface interne entre le serveur et les modules)
pour la construction courante de httpd, telle qu'elle
est d<>finie dans include/ap_mmn.h. La version de l'API
des modules correspond <20> la version du serveur Apache
httpd
utilis<69> (par exemple, pour la version 1.3.14 d'Apache
httpd,
il s'agit de la version 19990320:10), mais int<6E>resse
principalement les auteurs de modules.</dd>
<dt><code>THE_REQUEST</code></dt>
<dd>La ligne de requ<71>te HTTP compl<70>te envoy<6F>e par le
navigateur au serveur (par exemple, "<code>GET
/index.html HTTP/1.1</code>"), <20> l'exclusion de tout
en-t<>te ajout<75> par le navigateur. Cette
valeur n'a pas <20>t<EFBFBD> d<>s<EFBFBD>chapp<70>e (d<>cod<6F>e), <20> la
diff<66>rence de la plupart des variables suivantes.</dd>
<dt><code>REQUEST_URI</code></dt>
<dd>La partie chemin de l'URI de la requ<71>te, comme
"/index.html". En particulier, ceci exclut la cha<68>ne
de param<61>tres qui est quant <20> elle disponible via sa
propre variable <code>QUERY_STRING</code>.</dd>
<dt><code>REQUEST_FILENAME</code></dt>
<dd>Le chemin complet local au syst<73>me de fichiers
du fichier ou du script correspondant
<20> la requ<71>te, s'il a d<>j<EFBFBD> <20>t<EFBFBD> d<>termin<69> par le serveur
au moment o<> on y fait r<>f<EFBFBD>rence. Dans le cas
contraire, et en particulier dans le cas d'un serveur
virtuel, <code>REQUEST_FILENAME</code> contient la
valeur de <code>REQUEST_URI</code>.</dd>
<dt><code>HTTPS</code></dt>
<dd>Contient le texte "on" si la connexion
utilise SSL/TLS, "off" dans le cas contraire
(Cette variable peut <20>tre utilis<69>e sans probl<62>me, que
<code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> soit charg<72> ou non.</dd>
<dt><code>REQUEST_SCHEME</code></dt>
<dd>Contient le protocole de la requ<71>te (en g<>n<EFBFBD>ral
"http" ou "https"). La valeur peut <20>tre modifi<66>e par
la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>.</dd>
</dl>
</div>
</li>
</ul>
<p>Si la <em>cha<68>ne de test</em> contient la valeur sp<73>ciale
<code>expr</code>, <em>expression de comparaison</em> sera trait<69>
en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>.</p>
<p>Autres points <20> conna<6E>tre ::</p>
<ol>
<li>
<p>Les variables <code>SCRIPT_FILENAME</code> et
<code>REQUEST_FILENAME</code> contiennent toutes deux la valeur
du champ <code>filename</code> de la
structure interne <code>request_rec</code>du serveur HTTP Apache.
Le premier nom correspond au nom de variable bien connu CGI,
alors que le second est l'<27>quivalent de REQUEST_URI (qui
contient la valeur du champ <code>uri</code> de
<code>request_rec</code>).</p>
<p>Si une substitution intervient et si la r<><72>criture se
poursuit, la valeur des deux variables sera mise <20> jour en
cons<6E>quence.</p>
<p>Dans le contexte du serveur principal (c'est <20> dire avant que
la requ<71>te ne soit mise en correspondance avec le syst<73>me de
fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
contenir le chemin entier dans le syst<73>me de fichiers local car
ce chemin b'est pas connu <20> ce stade du traitement. Dans ce cas,
les deux variables contiendront la valeur de REQUEST_URI. Pour
obtenir le chemin complet de la requ<71>te dans le syst<73>me de
fichiers local dans le contexte du serveur principal, utilisez une
r<>f<EFBFBD>rence avant <20> base d'URL
<code>%{LA-U:REQUEST_FILENAME}</code> pour d<>terminer la valeur
finale de REQUEST_FILENAME.</p></li>
<li>
<code>%{ENV:<em>variable</em>}</code>, o<> <em>variable</em> peut
correspondre <20> une variable d'environnement quelconque.</li>
<li>
<code>%{ENV:variable}</code> est aussi disponible, o<>
<em>variable</em> peut correspondre <20> toute variable
d'environnement. Peut <20>tre consult<6C> via des structures internes
d'Apache httpd et (si on ne les trouve pas ici) via la fonction
<code>getenv()</code> <20> partir du processus du serveur Apache
httpd.</li>
<li>Que <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> soit charg<72> ou non, on peut
utiliser <code>%{SSL:variable}</code>, o<> <em>variable</em>
peut <20>tre remplac<61> par le nom d'une
<a href="mod_ssl.html#envvars">variable
d'environnement SSL</a> . Si <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> n'est pas
charg<72>, cette variable contiendra toujours une cha<68>ne vide.
Exemple : <code>%{SSL:SSL_CIPHER_USEKEYSIZE}</code> pourra
contenir la valeur <code>128</code>.</li>
<li>
On peut utiliser <code>%{HTTP:en-t<>te}</code>, o<>
<em>en-t<>te</em> peut correspondre <20> tout nom d'en-t<>te MIME
HTTP, pour extraire la valeur d'un en-t<>te envoy<6F> dans la
requ<71>te HTTP. Par exemple, <code>%{HTTP:Proxy-Connection}</code>
contiendra la valeur de l'en-t<>te HTTP
"<code>Proxy-Connection:</code>".
Si on utilise un en-t<>te HTTP
dans une condition, et si cette condition est <20>valu<6C>e <20>
<code>vrai</code> pour la requ<71>te, cet en-t<>te sera ajout<75> <20> l'en-t<>te Vary de
la r<>ponse. Il ne le sera pas si la condition est <20>valu<6C>e <20>
<code>faux</code>. L'ajout de l'en-t<>te HTTP <20> l'en-t<>te Vary
est n<>cessaire <20> une mise en cache appropri<72>e.
<p>Il faut garder <20> l'esprit que les conditions suivent une
logique de cout-circuit si le drapeau
'<strong><code>ornext|OR</code></strong>' est utilis<69>, et que de
ce fait, certaines d'entre elles ne seront pas <20>valu<6C>es.</p>
</li>
<li>A des fins de r<>f<EFBFBD>rence avant, on peut utiliser,
<code>%{LA-U:variable}</code>, qui
permet d'effectuer une sous-requ<71>te interne <20> base d'URL, afin
de d<>terminer la valeur finale de <em>variable</em>. Ceci permet
d'acc<63>der <20> la valeur d'une variable pour la r<><72>criture inconnue
<09> ce stade du traitement, mais qui sera d<>finie au
cours d'une phase ult<6C>rieure.
<p>Par exemple, pour effectuer une r<><72>criture d<>pendant de la
variable <code>REMOTE_USER</code> dans le contexte du serveur
principal (fichier <code>httpd.conf</code>), vous devez utiliser
<code>%{LA-U:REMOTE_USER}</code> - cette variable est d<>finie
par la phase d'autorisation qui intervient <em>apr<70>s</em> la
phase de traduction d'URL (pendant laquelle mod_rewrite op<6F>re).</p>
<p>Par contre, comme mod_rewrite impl<70>mente son contexte de
r<>pertoire (fichier <code>.htaccess</code>) via la phase Fixup
de l'API, et comme la phase d'autorisation intervient
<em>avant</em> cette derni<6E>re, vous pouvez vous contenter
d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</p></li>
<li>
<code>%{LA-F:variable}</code> peut <20>tre utilis<69>e pour effectuer
une sous-requ<71>te interne (bas<61>e sur le nom de fichier), afin de
d<>terminer la valeur finale de <em>variable</em>. La plupart du
temps, elle est identique <20> LA-U (voir ci-dessus).</li>
</ol>
<p><em>expression de comparaison</em> est une expression
rationnelle qui est appliqu<71>e <20> l'instance actuelle de
<em>cha<68>ne de test</em>. <em>cha<68>ne de test</em> est d'abord
<20>valu<6C>e, puis compar<61>e <20>
l'<em>expression de comparaison</em>.</p>
<p><em>expression de comparaison</em> est en g<>n<EFBFBD>ral une
<em>expression rationnelle compatible perl</em>, mais vous
disposez des syntaxes suppl<70>mentaires suivantes pour effectuer
d'autres tests utiles sur <em>cha<68>ne de test</em> :
</p>
<ol>
<li>Vous pouvez pr<70>fixer l'expression avec un caract<63>re
'<code>!</code>' (point d'exclamation) pour indiquer une
expression de <strong>non</strong>-correspondance.</li>
<li>Vous pouvez effectuer des comparaisons lexicographiques de
cha<68>nes :
<ul>
<li>'<strong>&lt;expression</strong>' (inf<6E>rieur au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha<68>ne de
caract<63>res et la compare lexicographiquement <20>
<em>cha<68>ne de test</em>. La condition est satisfaite si
<em>cha<68>ne de test</em> est inf<6E>rieure au sens
lexicographique <20> l'<em>expression</em>.</li>
<li>'<strong>&gt;expression</strong>' (sup<75>rieur au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha<68>ne de
caract<63>res et la compare lexicographiquement <20>
<em>cha<68>ne de test</em>. La condition est satisfaite si
<em>cha<68>ne de test</em> est sup<75>rieure au sens
lexicographique <20> l'<em>expression</em>.</li>
<li>'<strong>=expression</strong>' (<28>gal au sens
lexicographique)<br />
Traite l'<em>expression</em> comme une cha<68>ne de
caract<63>res et la compare lexicographiquement <20>
<em>cha<68>ne de test</em>. La condition est satisfaite si
<em>cha<68>ne de test</em> est <20>gale au sens
lexicographique <20> l'<em>expression</em> (les deux cha<68>nes
sont exactement identiques, caract<63>re pour caract<63>re). Si
<em>expression</em> est <code>""</code> (deux guillemets),
<em>cha<68>ne de test</em> est compar<61>e <20> la cha<68>ne vide.</li>
<li>'<strong>&lt;=expression de comparaison</strong>' (inf<6E>rieur ou <20>gal <20>
au sens lexicographique)<br />
Consid<69>re l'<em>expression de comparaison</em> comme une
cha<68>ne de caract<63>res et la compare au sens lexicographique <20>
la <em>cha<68>ne de test</em>. Vrai si <em>cha<68>ne de test</em>
pr<70>c<EFBFBD>de lexicographiquement <em>expression de comparaison</em>, ou est
<20>gale <20> <em>expression de comparaison</em> (les deux cha<68>nes
sont identiques, caract<63>re pour caract<63>re).</li>
<li>'<strong>&gt;=expression de comparaison</strong>'
(sup<75>rieur ou <20>gal <20> au sens lexicographique)<br />
Consid<69>re l'<em>expression de comparaison</em> comme une
cha<68>ne de caract<63>res et la compare au sens lexicographique <20>
la <em>cha<68>ne de test</em>. Vrai si <em>cha<68>ne de test</em>
suit lexicographiquement <em>expression de comparaison</em>, ou est
<20>gale <20> <em>expression de comparaison</em> (les deux cha<68>nes
sont identiques, caract<63>re pour caract<63>re).</li>
</ul></li>
<li>
Vous pouvez effectuer des comparaisons d'entiers :
<ul>
<li>'<strong>-eq</strong>' (est num<75>riquement <20>gal <20>)<br />
La <em>cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier,
et est compar<61>e num<75>riquement <20> l'<em>expression de
comparaison</em>. Vrai si les deux expressions sont
num<75>riquement <20>gales.</li>
<li>'<strong>-ge</strong>' (est num<75>riquement sup<75>rieur ou
<20>gal <20>)<br />
La <em>cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier,
et est compar<61>e num<75>riquement <20> l'<em>expression de
comparaison</em>. Vrai si <em>cha<68>ne de test</em> est
num<75>riquement
sup<75>rieure ou <20>gale <20> <em>expression de comparaison</em>.</li>
<li>'<strong>-gt</strong>' (est num<75>riquement sup<75>rieur <20>)<br />
La <em>cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier,
et est compar<61>e num<75>riquement <20> l'<em>expression de
comparaison</em>. Vrai si <em>cha<68>ne de test</em> est
num<75>riquement
sup<75>rieure <20> <em>expression de comparaison</em>.</li>
<li>'<strong>-le</strong>' (est num<75>riquement inf<6E>rieur ou
<20>gal <20>)<br />
La <em>cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier,
et est compar<61>e num<75>riquement <20> l'<em>expression de
comparaison</em>. Vrai si <em>cha<68>ne de test</em> est
num<75>riquement
inf<6E>rieure ou <20>gale <20> <em>expression de comparaison</em>.
Attention <20> la confusion avec le drapeau <strong>-l</strong>
en utilisant la variante the <strong>-L</strong> ou
<strong>-h</strong>.</li>
<li>'<strong>-lt</strong>' (est num<75>riquement inf<6E>rieur <20>)<br />
La <em>cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier,
et est compar<61>e num<75>riquement <20> l'<em>expression de
comparaison</em>. Vrai si <em>cha<68>ne de test</em> est
num<75>riquement
inf<6E>rieure <20> <em>expression de comparaison</em>.
Attention <20> la confusion avec le drapeau <strong>-l</strong>
en utilisant la variante the <strong>-L</strong> ou
<strong>-h</strong>.</li>
</ul>
</li>
<li>Vous pouvez effectuer diff<66>rents tests sur les attributs de
fichier :
<ul>
<li>'<strong>-d</strong>' (est un r<>pertoire -
<strong>d</strong>irectory)<br />
Traite <em>cha<68>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<68>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>-F</strong>' (test de l'existence d'un fichier
via une sous-requ<71>te)<br />
V<>rifie si <em>cha<68>ne de test</em> est un fichier valide,
accessible <20> travers tous les contr<74>les d'acc<63>s du serveur
actuellement configur<75>s pour ce chemin. C'est une
sous-requ<71>te interne qui effectue cette v<>rification - <20>
utiliser avec pr<70>cautions car les performances du serveur
peuvent s'en trouver affect<63>es !</li>
<li>'<strong>-H</strong>' (est un lien symbolique, selon la
convention bash)<br />
Voir <strong>-l</strong>.</li>
<li>'<strong>-l</strong>' (est un lien symbolique)<br />
Consid<69>re la <em>cha<68>ne de test</em> comme un chemin et
v<>rifie son existence et si elle est un lien symbolique. On
peut aussi utiliser la convention bash <strong>-L</strong>
ou <strong>-h</strong> lorsqu'il y a risque de confusion
avec les tests <strong>-lt</strong> ou <strong>-le</strong>.</li>
<li>'<strong>-L</strong>' (est un lien symbolique, selon la
convention bash)<br />
Voir <strong>-l</strong>.</li>
<li>'<strong>-s</strong>' (est un fichier r<>gulier d'une
certaine taille)<br />
Consid<69>re la <em>cha<68>ne de test</em> comme un chemin et
v<>rifie son existence et si elle est un fichier r<>gulier
d'une taille sup<75>rieure <20> z<>ro.</li>
<li>'<strong>-U</strong>' (test de l'existence d'une
<strong>U</strong>RL via une sous-requ<71>te)<br />
V<>rifie si <em>cha<68>ne de test</em> est une URL valide,
accessible <20> travers tous les contr<74>les d'acc<63>s du serveur
actuellement configur<75>s pour ce chemin. C'est une
sous-requ<71>te interne qui effectue cette v<>rification - <20>
utiliser avec pr<70>cautions car les performances du serveur
peuvent s'en trouver affect<63>es !</li>
<li>'<strong>-x</strong>' (a l'attribut d'ex<65>cution positionn<6E>)<br />
Consid<69>re la <em>cha<68>ne de test</em> comme un chemin et
v<>rifie son existence et si elle a son attribut d'ex<65>cution
positionn<6E>. Ce positionnement est d<>termin<69> en fonction de
l'OS sous-jacent.</li>
</ul>
<div class="note"><h3>Note :</h3>
Tous ces tests peuvent aussi <20>tre pr<70>fix<69>s par un point
d'exclamation ('!') pour inverser leur signification.
</div>
</li>
<li>
<p>Si la <em>cha<68>ne de test</em> contient la valeur sp<73>ciale
<code>expr</code>, la <em>cha<68>ne de comparaison</em> sera
trait<69>e en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>.</p>
<p>
Dans l'exemple ci-dessous, on utilise <code>-strmatch</code>
pour comparer le <code>REFERER</code> avec le nom d'h<>te du
site afin de bloquer le hotlinking (r<>f<EFBFBD>rencement direct)
non d<>sir<69>.
</p>
<pre class="prettyprint lang-config">
RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"<br />
RewriteRule ^/images - [F]
</pre>
</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<73>me argument de la directive
<code>RewriteCond</code>, o<> <em>drapeaux</em> est un
sous-ensemble s<>par<61> 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 <20> la casse - il n'est pas fait de
distinction entre majuscules et minuscules, <20> la fois dans le
d<>veloppement de <em>cha<68>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<68>ne de test</em>
et <em>expression de comparaison</em>. Il ne l'est pas pour les
v<>rification par sous-requ<71>tes ou sur le syst<73>me de
fichiers.</li>
<li>
'<strong><code>ornext|OR</code></strong>'
(<strong>ou</strong> condition suivante)<br />
Permet de cha<68>ner les conditions de r<>gles avec un OU au
lieu du AND implicite. Exemple typique :
<pre class="prettyprint lang-config">
RewriteCond %{REMOTE_HOST} ^host1 [OR]
RewriteCond %{REMOTE_HOST} ^host2 [OR]
RewriteCond %{REMOTE_HOST} ^host3
RewriteRule ...r<>gles concernant tous ces h<>tes...
</pre>
Sans ce drapeau, les paires
condition/r<>gle devraient <20>tre <20>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<6D>che
ce dernier d'<27>tre ajout<75> <20> 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<70>sentation de cette r<>ponse
varie avec la valeur de l'en-t<>te consid<69>r<EFBFBD>. Ce drapeau ne
devrait donc <20>tre utilis<69> que si l'on ma<6D>trise parfaitement le
fonctionnement de l'en-t<>te Vary.
</li>
</ul>
</li>
</ol>
<p><strong>Exemple :</strong></p>
<p>Pour r<><72>crire la page d'accueil d'un site en fonction de
l'en-t<>te ``<code>User-Agent:</code>'' de la requ<71>te, vous
pouvez utiliser ce qui suit : </p>
<pre class="prettyprint lang-config">
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>
<p>Explications : si vous utilisez un navigateur
(Netscape Navigator, Mozilla etc) qui s'identifie comme
'Mozilla', vous acc<63>derez <20> la page d'accueil max (qui
peut contenir des frames, ou d'autres ressources
particuli<6C>res).
Si vous utilisez le navigateur Lynx (qui est un navigateur
en mode texte), vous acc<63>derez <20> une page d'accueil min
(qui peut <20>tre une version con<6F>ue pour une navigation simple
bas<61>e sur le texte).
Si aucune de ces conditions n'est satisfaite (vous utilisez tout
autre navigateur, ou votre navigateur s'identifie de mani<6E>re non
standard), vous acc<63>derez <20> la page d'accueil std
(standard).</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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<65>cution du
moteur de r<><72>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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
<p>La directive <code class="directive">RewriteEngine</code> active ou
d<>sactive l'ex<65>cution du moteur de r<><72>criture. Si sa valeur est
<code>off</code>, ce module n'ex<65>cutera aucun traitement et ne
mettra pas <20> 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<><72>criture. Ceci implique que vous devez
ins<6E>rer une directive <code>RewriteEngine on</code> dans chaque
h<>te virtuel pour lequel vous souhaitez utiliser des r<>gles
de r<><72>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 <20>t<EFBFBD> d<>finies dans un
contexte o<> la directive <code class="directive">RewriteEngine</code> n'a
pas <20>t<EFBFBD> d<>finie <20> <code>on</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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<63>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#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</a></th><td>Il est possible de choisir entre plusieurs types de
bases de donn<6E>es depuis la version 2.0.41 du serveur HTTP Apache</td></tr>
</table>
<p>La directive <code class="directive">RewriteMap</code> d<>finit une
<em>Table de correspondance pour la r<><72>criture</em> que les
fonctions de mise en correspondance
peuvent utiliser dans les cha<68>nes de substitution des r<>gles
pour ins<6E>rer/substituer des champs en recherchant des mots-cl<63>s.
La source utilis<69>e pour cette recherche peut <20>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 <20> sp<73>cifier une fonction de mise en correspondance
pour les cha<68>nes de substitution d'une r<>gle de r<><72>criture selon
une des constructions suivantes :</p>
<p class="indent">
<strong><code>${</code> <em>nom de la
correspondance</em> <code>:</code>
<em>mot-cl<63></em> <code>}</code><br />
<code>${</code> <em>nom de la
correspondance</em> <code>:</code>
<em>mot-cl<63></em> <code>|</code> <em>valeur par d<>faut</em>
<code>}</code></strong>
</p>
<p>Lorsqu'une telle construction est rencontr<74>e, la table de
correspondance <em>Nom de la correspondance</em> est consult<6C>e
et la cl<63> <em>mot-cl<63></em> recherch<63>e. Si la cl<63> est trouv<75>e, la
construction est remplac<61>e par
la <em>valeur de remplacement</em>. Si la cl<63> n'est pas trouv<75>e,
elle est remplac<61>e par la <em>valeur par d<>faut</em>, ou par une
cha<68>ne vide si aucune <em>valeur par d<>faut</em> n'est
sp<73>cifi<66>e. La valeur vide se comporte comme si la
cl<63> <20>tait absente ; il est donc impossible de distinguer une
valeur vide d'une absence de cl<63>.</p>
<p>Par exemple, vous pouvez d<>finir une directive
<code class="directive">RewriteMap</code> comme suit </p>
<pre class="prettyprint lang-config">
RewriteMap map-exemple txt:/chemin/vers/fichier/map.txt
</pre>
<p>Vous pourrez ensuite utiliser cette table dans une
directive <code class="directive">RewriteRule</code> comme suit :</p>
<pre class="prettyprint lang-config">
RewriteRule ^/ex/(.*) ${map-exemple:$1}
</pre>
<p>Les combinaisons suivantes pour <em>type de correspondance</em>
et <em>source de la correspondance</em>
peuvent <20>tre utilis<69>es :</p>
<dl>
<dt>txt</dt>
<dd>Un fichier texte contenant des paires cl<63>-valeur s<>par<61>es
par des espaces, une paire par ligne (<a href="../rewrite/rewritemap.html#txt">D<>tails ...</a>).</dd>
<dt>rnd</dt>
<dd>S<>lection al<61>atoire d'une entr<74>e depuis un fichier texte (<a href="../rewrite/rewritemap.html#rnd">D<>tails ...</a>).</dd>
<dt>dbm</dt>
<dd>Recherche une entr<74>e dans un fichier dbm contenant des
paires nom-valeur. Le condens<6E> hash est <20>labor<6F> <20> partir d'un
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>
<dt>int</dt>
<dd>Une des quatre fonctions internes disponibles que fournit
<code>RewriteMap</code>: toupper, tolower, escape ou unescape
(<a href="../rewrite/rewritemap.html#int">D<>tails ...</a>).</dd>
<dt>prg</dt>
<dd>Appelle un programme externe ou un script pour effectuer la
r<><72>criture (<a href="../rewrite/rewritemap.html#int">D<>tails
...</a>).</dd>
<dt>dbd or fastdbd</dt>
<dd>Une commande SQL SELECT <20> ex<65>cuter pour rechercher la cible
de r<><72>criture (<a href="../rewrite/rewritemap.html#int">D<>tails
...</a>).</dd>
</dl>
<p>Vous trouverez plus de d<>tails et de nombreux exemples dans le <a href="../rewrite/rewritemap.html">RewriteMap HowTo</a>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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<73>ciales
pour le moteur de r<><72>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#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit<69>:</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<73>ciales pour la configuration au niveau du
serveur ou du r<>pertoire. La cha<68>ne de caract<63>res <em>Option</em>
ne peut actuellement prendre qu'une des valeurs suivantes :</p>
<dl>
<dt><code>Inherit</code></dt>
<dd>
<p>Ceci force la configuration locale <20> h<>riter de la
configuration du niveau sup<75>rieur. Dans le contexte des h<>tes
virtuels, cela signifie que les correspondances, conditions et
r<>gles du serveur principal sont h<>rit<69>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">&lt;Directory&gt;</a></code> du r<>pertoire
parent sont h<>rit<69>es. Les r<>gles h<>rit<69>es sont virtuellement
copi<70>es dans la section o<> cette directive est utilis<69>e. Si elles
sont utilis<69>es avec des r<>gles locales, les r<>gles h<>rit<69>es sont
plac<61>es apr<70>s ces derni<6E>res. La place de cette directive - avant
ou apr<70>s les r<>gles locales - n'a aucune influence sur ce
comportement. Si des r<>gles locales ont forc<72> l'arr<72>t de la
r<><72>criture, les r<>gles h<>rit<69>es ne seront pas trait<69>es.</p>
<div class="warning">
Les r<>gles h<>rit<69>es du niveau parent sont appliqu<71>es
<strong>after</strong> apr<70>s les r<>gles sp<73>cifi<66>es dans le niveau
enfant.
</div>
</dd>
<dt><code>InheritBefore</code></dt>
<dd>
<p>M<>me effet que l'option <code>Inherit</code> ci-dessus, mais
les r<>gles sp<73>cifi<66>es dans le niveau parent s'appliquent
<strong>avant</strong> les r<>gles sp<73>cifi<66>es dans le niveau
enfant. Disponible depuis la version 2.3.10 du serveur HTTP
Apache.</p>
</dd>
<dt><code>AllowNoSlash</code></dt>
<dd>
<p>Par d<>faut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ignore les URLs qui
correspondent <20> un r<>pertoire sur disque, mais ne comportent pas
de slash final, afin que le module <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code>
redirige le client vers l'URL canonique avec un slash final.</p>
<p>Lorsque la directive <code class="directive"><a href="../mod/mod_dir.html#directoryslash">DirectorySlash</a></code> est d<>finie <20> off, il
est possible de sp<73>cifier l'option <code>AllowNoSlash</code> pour
s'assurer que les r<>gles de r<><72>criture ne soient plus ignor<6F>es.
Si on le souhaite, cette option permet de faire s'appliquer des
r<>gles de r<><72>criture qui correspondent <20> un r<>pertoire sans slash
final au sein de fichiers .htaccess. Elle est disponible <20>
partir de la version 2.4.0 du serveur HTTP Apache.</p>
</dd>
<dt><code>AllowAnyURI</code></dt>
<dd>
<p>A partir de la version 2.2.22 de httpd, lorsqu'une directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code> se situe dans un
contexte de <code>serveur virtuel</code> ou de serveur principal,
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ne traitera les r<>gles de r<><72>criture
que si l'URI de la requ<71>te respecte la syntaxe d'un <a href="./directive-dict.html#Syntax">chemin URL</a>. Ceci permet
d'<27>viter certains probl<62>mes de s<>curit<69> o<> des r<>gles
particuli<6C>res pourraient permettre des d<>veloppements de mod<6F>les
inattendus (voir <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-3368">CVE-2011-3368</a>
et <a href="http://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2011-4317">CVE-2011-4317</a>).
Pour s'affranchir de la restriction relative <20> la syntaxe des chemins URL, on peut
utiliser l'option <code>AllowAnyURI</code>, afin de permettre <20>
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> d'appliquer le jeu de r<>gles <20> toute
cha<68>ne de requ<71>te URI, sans v<>rifier si cette derni<6E>re respecte la
grammaire des chemins URL d<>finie dans la sp<73>cification HTTP.</p>
<div class="warning">
<h3>Avertissement <20> propos de la s<>curit<69></h3>
<p>L'utilisation de cette option rendra le serveur vuln<6C>rable <20>
certains probl<62>mes de s<>curit<69> si les r<>gles de r<><72>critures
concern<72>es n'ont pas <20>t<EFBFBD> r<>dig<69>es avec soin. Il est par cons<6E>quent
<strong>fortement recommand<6E></strong> de ne pas utiliser cette
option. En particulier, pr<70>tez attention aux cha<68>nes en entr<74>e contenant le
caract<63>re '<code>@</code>', qui peuvent modifier l'interpr<70>tation
de l'URI r<><72>crite, comme indiqu<71> dans les liens ci-dessus.</p>
</div>
</dd>
</dl>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></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<><72>criture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteRule
<em>Mod<6F>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>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_rewrite</td></tr>
</table>
<p>La directive <code class="directive">RewriteRule</code> est le
v<>ritable cheval de trait de la r<><72>criture. La directive peut
appara<72>tre plusieurs fois, chaque instance d<>finissant une
r<>gle de r<><72>criture particuli<6C>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<71>es au cours du processus de
r<><72>criture.</p>
<p><a id="patterns" name="patterns"><em>Mod<6F>le</em></a> est une
<a id="regexp" name="regexp">expression rationnelle</a>
compatible perl. Dans la premi<6D>re r<>gle de r<><72>criture,
l'expression est compar<61>e au (%-decoded)
<a href="./directive-dict.html#Syntax">chemin de l'URL</a> (ou au
<a href="./directive-dict.html#Syntax">chemin fichier</a>, en
fonction du contexte) de la
requ<71>te. Les expressions suivantes sont compar<61>es <20> la sortie de
la derni<6E>re r<>gle de r<><72>criture qui
correspondait.</p>
<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est compar<61> ?</a></h3>
<p>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le <em>mod<6F>le</em> est tout
d'abord compar<61> <20> la portion de l'URL situ<74>e entre le nom d'h<>te
<20>ventuellement accompagn<67> du port, et la cha<68>ne de param<61>tres (par
exemple "/app1/index.html").</p>
<p>Dans les contextes de r<>pertoire <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et htaccess, le
<em>mod<6F>le</em> est tout d'abord compar<61> au chemin du <em>syst<73>me
de fichiers</em>, apr<70>s suppression du pr<70>fixe ou chemin de base
ayant conduit le serveur vers la r<>gle <code class="directive">RewriteRule</code> (par
exemple "app1/index.html" ou
"index.html" selon l'endroit o<> les directives sont d<>finies).</p>
<p>Si vous souhaitez faire une comparaison sur le nom
d'h<>te, le port, ou la cha<68>ne de requ<71>te, utilisez une
directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
comportant respectivement les variables
<code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
<code>%{QUERY_STRING}</code>.</p>
</div>
<div class="note"><h3>R<><52>critures dans un contexte de r<>pertoire</h3>
<ul>
<li>L'utilisation du moteur de r<><72>criture dans les
fichiers <a href="../howto/htaccess.html">.htaccess</a> et les sections
<code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code> est un peu plus
complexe.</li>
<li>Pour activer le moteur de r<><72>criture dans ces contextes, vous devez
d<EFBFBD>finir "<code>RewriteEngine On</code>" <strong>et</strong>
"<code>Options FollowSymLinks</code>". Si l'administrateur a d<>sactiv<69>
la possibilit<69> de modifier l'option <code>FollowSymLinks</code> au
niveau du r<>pertoire d'un utilisateur, vous ne pouvez pas utiliser le
moteur de r<><72>criture. Cette restriction a <20>t<EFBFBD> instaur<75>e <20> des fins de
s<EFBFBD>curit<EFBFBD>.</li>
<li>Lorsqu'on utilise le moteur de r<><72>criture dans un fichier
<code>.htaccess</code>, le chemin de base du r<>pertoire courant (qui est
toujours le m<>me pour ce m<>me r<>pertoire) est automatiquement
<em>supprim<69></em> au cours de la comparaison avec le mod<6F>le de la r<>gle
de r<><72>criture, et automatiquement <em>ajout<75></em> lorsqu'une
substitution relative (ne d<>butant pas par un slash ou un nom de
protocole) arrive <20> la fin d'un jeu de r<>gles. Voir la directive
<code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de
d<EFBFBD>tails <20> propos de l'ajout du pr<70>fixe apr<70>s les substitutions
relatives.</li>
<li>Si vous souhaitez effectuer une comparaison en prenant en compte
l'int<6E>gralit<69> du
chemin de l'URL dans un contexte de r<>pertoire (htaccess), vous devez
utiliser la variable <code>%{REQUEST_URI}</code> dans la directive
<code class="directive">RewriteCond</code>.</li>
<li>Le prefixe supprim<69> se termine toujours par un slash, ce qui
signifie que la comparaison s'effectue avec une cha<68>ne qui ne comporte
<em>jamais</em> de slash de d<>but. Ainsi, un <em>mod<6F>le</em> contenant
<code>^/</code> ne correspondra jamais dans un contexte de r<>pertoire.</li>
<li>Bien que les r<>gles de r<><72>criture soient permises du point de vue de
la syntaxe dans les sections <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> et <code class="directive"><a href="../mod/core.html#files">&lt;Files&gt;</a></code>, elles n'y sont pas prises en compte, et
n'y sont <20> priori d'aucune utilit<69>.</li>
</ul>
</div>
<p>Pour quelques conseils <20> 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 <20>
mod_rewrite</a>.</p>
<p>Dans mod_rewrite, on peut aussi utiliser le caract<63>re NON
('<code>!</code>') comme pr<70>fixe de mod<6F>le. Ceci vous permet
d'inverser la signification d'un mod<6F>le, soit pour dire
``<em>si l'URL consid<69>r<EFBFBD>e ne correspond <strong>PAS</strong> <20>
ce mod<6F>le</em>''. Le caract<63>re NON peut donc <20>tre utilis<69> <20>
titre exceptionnel, lorsqu'il est plus simple d'effectuer une
comparaison avec le mod<6F>le invers<72>, ou dans la derni<6E>re r<>gle
par d<>faut.</p>
<div class="note"><h3>Note</h3>
Si vous utilisez le caract<63>re NON pour inverser la signification d'un
mod<EFBFBD>le, vous ne pouvez pas inclure de parties g<>n<EFBFBD>riques group<75>es dans
le mod<6F>le. Ceci est d<> au fait que, lorsque le mod<6F>le ne correspond
pas (autrement dit, sa n<>gation correspond), les groupes sont vides.
Ainsi, si vous utilisez des mod<6F>les invers<72>s, vous ne pouvez
pas vous r<>f<EFBFBD>rer aux groupes par <code>$N</code> dans la cha<68>ne de
substitution !
</div>
<p>Dans une r<>gle de r<><72>criture,
<a id="rhs" name="rhs"><em>Substitution</em></a> est la cha<68>ne
de caract<63>res qui remplace le chemin de l'URL original qui
correspondait au <em>Mod<6F>le</em>. <em>Substitution</em> peut
<20>tre :</p>
<dl>
<dt>un chemin du syst<73>me de fichiers</dt>
<dd>Il indique alors la localisation dans le syst<73>me de
fichiers de la ressource qui doit <20>tre envoy<6F>e au
client. Les substitutions ne sont trait<69>es en tant que chemins du
syst<73>me de fichiers que si la r<>gle est configur<75>e dans un
contexte de serveur (serveur virtuel), et si le premier
composant du chemin dans la substitution existe dans le syst<73>me
de fichiers.</dd>
<dt>chemin d'URL</dt>
<dd>Un chemin relatif <20> la valeur de <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> vers la ressource qui
doit <20>tre servie. Notez que <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
essaie de deviner si vous avez sp<73>cifi<66> un chemin du syst<73>me
de fichiers ou un chemin d'URL en v<>rifiant si la premi<6D>re
partie du chemin existe <20> la racine du syst<73>me de fichiers.
Par exemple, si vous avez sp<73>cifi<66> comme cha<68>ne de
<em>Substitution</em> <code>/www/file.html</code>, cette
derni<6E>re sera trait<69>e comme un chemin d'URL <em><3E> moins</em>
qu'un r<>pertoire nomm<6D> <code>www</code> n'existe <20> la racine
de votre syst<73>me de fichiers, auquel cas la cha<68>ne de
substitution sera trait<69>e comme un chemin du syst<73>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<71>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<73>cifi<66>e,
<code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> v<>rifie si le nom d'h<>te
correspond <20> celui de l'h<>te local. Si c'est le cas, le
protocole et le nom d'h<>te sont supprim<69>s, et ce qui reste est
trait<69> comme un chemin d'URL. Dans le cas contraire, une
redirection externe vers l'URL indiqu<71>e est effectu<74>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 <20>tre
effectu<74>e (le chemin consid<69>r<EFBFBD> est transmis sans changement).
Ceci est utile quand un drapeau doit <20>tre appliqu<71> sans
modifier le chemin (voir ci-dessous).</dd>
</dl>
<p>En plus du texte, la cha<68>ne <em>Substition</em> peut
comporter :</p>
<ol>
<li>des r<>f<EFBFBD>rences arri<72>res (<code>$N</code>) vers le mod<6F>le
d'une directive RewriteRule</li>
<li>des r<>f<EFBFBD>rences arri<72>res (<code>%N</code>) vers le dernier
mod<6F>le d'une directive RewriteCond qui correspondait</li>
<li>des variables du serveur comme dans les cha<68>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<63>|d<>faut}</code>)</li>
</ol>
<p>Les r<>f<EFBFBD>rences arri<72>res sont des identificateurs de la forme
<code>$</code><strong>N</strong> (<strong>N</strong>=0..9), qui
seront remplac<61>s par le contenu du <strong>N</strong><3E>me groupe
du <em>Mod<6F>le</em> qui correspondait. Les variables du serveur
sont les m<>mes que dans la <em>Cha<68>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 <20>valu<6C>es dans l'ordre ci-dessus.</p>
<p>Chaque r<>gle de r<><72>criture s'applique au r<>sultat de la r<>gle
pr<70>c<EFBFBD>dente, selon l'ordre dans lequel elles ont <20>t<EFBFBD> d<>finies dans
le fichier de configuration. Le chemin de l'URL ou du syst<73>me de fichier (voir
ci-dessus <a href="#what_is_matched">Qu'est-ce qui est
compar<61> ?</a>) est <strong>int<6E>gralement
remplac<61>e</strong> par la cha<68>ne de <em>Substitution</em> et le
processus de r<><72>criture se poursuit jusqu'<27> ce que toutes les
r<>gles aient <20>t<EFBFBD> appliqu<71>es, ou qu'il soit explicitement stopp<70>
par un drapeau <a href="../rewrite/flags.html#flag_l"><code><strong>L</strong></code></a>,
ou par un autre drapeau qui implique un arr<72>t imm<6D>diat, comme
<code><strong>END</strong></code> ou
<code><strong>F</strong></code>.</p>
<div class="note"><h3>Modifier la cha<68>ne de requ<71>te</h3>
<p>Par d<>faut, la cha<68>ne de requ<71>te est transmise sans
modification. Vous pouvez cependant cr<63>er dans la cha<68>ne de
substitution des URLs dont une partie constitue une cha<68>ne de
requ<71>te. Pour cela, ajoutez simplement un point d'interrogation
dans la cha<68>ne de substitution pour indiquer que le texte qui
suit doit <20>tre r<>inject<63> dans la cha<68>ne de requ<71>te. Pour
supprimer une cha<68>ne de requ<71>te, terminez simplement la cha<68>ne de
substitution par un point d'interrogation. Pour combiner les
nouvelles cha<68>nes de requ<71>te avec les anciennes, utilisez le
drapeau <code>[QSA]</code>.</p>
</div>
<p>En outre, vous pouvez sp<73>cifier des <a name="rewriteflags" id="rewriteflags">actions</a> sp<73>ciales <20> effectuer en ajoutant
des
<strong><code>[</code><em>drapeaux</em><code>]</code></strong>
comme troisi<73>me argument de la directive
<code>RewriteRule</code>. S<>par<61>s par des virgules au sein d'une
liste encadr<64>e par des crochets, les <em>drapeaux</em> peuvent
<20>tre choisis dans la table suivante. Vous trouverez plus de
d<>tails, et des exemples pour chaque drapeau dans le <a href="../rewrite/flags.html">document <20> propos des drapeaux de
r<><72>criture.</a></p>
<table class="bordered">
<tr><th>Drapeaux et syntaxe</th>
<th>Fonction</th>
</tr>
<tr>
<td>B</td>
<td>Echappe les caract<63>res non-alphanum<75>riques <em>avant</em>
d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">d<>tails ...</a></em></td>
</tr>
<tr>
<td>chain|C</td>
<td>La r<>gle est cha<68>n<EFBFBD>e avec la r<>gle suivante. Si la r<>gle
<09>choue, la ou les r<>gles avec lesquelles elle est est cha<68>n<EFBFBD>e
seront saut<75>es. <em><a href="../rewrite/flags.html#flag_c">d<>tails ...</a></em></td>
</tr>
<tr>
<td>cookie|CO=<em>NAME</em>:<em>VAL</em></td>
<td>D<>finit un cookie au niveau du navigateur client. La syntaxe
compl<70>te est :
CO=<em>NAME</em>:<em>VAL</em>:<em>domain</em>[:<em>lifetime</em>[:<em>path</em>[:<em>secure</em>[:<em>httponly</em>]]]] <em><a href="../rewrite/flags.html#flag_co">details ...</a></em>
<em><a href="../rewrite/flags.html#flag_co">d<>tails ...</a></em>
</td>
</tr>
<tr>
<td>discardpath|DPI</td>
<td>Supprime la partie PATH_INFO de l'URI r<><72>crit. <em><a href="../rewrite/flags.html#flag_dpi">d<>tails
...</a></em></td>
</tr>
<tr>
<td>env|E=[!]<em>VAR</em>[:<em>VAL</em>]</td>
<td>D<>finit la variable d'environnement <em>VAR</em> (<28> la valeur
<em>VAL</em> si elle est fournie). La variante !<em>VAR</em>
annule la d<>finition de la variable <em>VAR</em>.<em><a href="../rewrite/flags.html#flag_e">d<>tails ...</a></em></td>
</tr>
<tr>
<td>forbidden|F</td>
<td>Renvoie une r<>ponse 403 FORBIDDEN au navigateur client.
<em><a href="../rewrite/flags.html#flag_f">d<>tails ...</a></em></td>
</tr>
<tr>
<td>gone|G</td>
<td>Renvoie un message d'erreur 410 GONE au navigateur client. <em><a href="../rewrite/flags.html#flag_g">d<>tails ...</a></em></td>
</tr>
<tr>
<td>Handler|H=<em>Gestionnaire de contenu</em></td>
<td>L'URI r<>sultant est envoy<6F> au <em>Gestionnaire de
contenu</em> pour traitement. <em><a href="../rewrite/flags.html#flag_h">d<>tails ...</a></em></td>
</tr>
<tr>
<td>last|L</td>
<td>Arr<72>te le processus de r<><72>criture imm<6D>diatement et n'applique
plus aucune r<>gle. Pr<50>tez une attention particuli<6C>re aux mises
en garde concernant les contextes de niveau r<>pertoire et
.htaccess (voir aussi le drapeau END). <em><a href="../rewrite/flags.html#flag_l">d<>tails ...</a></em></td>
</tr>
<tr>
<td>next|N</td>
<td>R<>ex<65>cute le processus de r<><72>criture <20> partir de la premi<6D>re
r<>gle, en utilisant le r<>sultat du jeu de r<>gles, sous r<>serve
qu'il y ait un point de d<>part. <em><a href="../rewrite/flags.html#flag_n">d<>tails
...</a></em></td>
</tr>
<tr>
<td>nocase|NC</td>
<td>Rend la comparaison entre mod<6F>les insensible <20> la casse.
<em><a href="../rewrite/flags.html#flag_nc">d<>tails ...</a></em></td>
</tr>
<tr>
<td>noescape|NE</td>
<td>Emp<6D>che mod_rewrite d'effectuer un <20>chappement hexad<61>cimal
des caract<63>res sp<73>ciaux dans le r<>sultat de la r<><72>criture. <em><a href="../rewrite/flags.html#flag_ne">d<>tails ...</a></em></td>
</tr>
<tr>
<td>nosubreq|NS</td>
<td>La r<>gle est saut<75>e si la requ<71>te courante est une
sous-requ<71>te interne. <em><a href="../rewrite/flags.html#flag_ns">d<>tails ...</a></em></td>
</tr>
<tr>
<td>proxy|P</td>
<td>Force l'envoi en interne de l'URL de substitution en tant
que requ<71>te mandataire. <em><a href="../rewrite/flags.html#flag_p">d<>tails
...</a></em></td>
</tr>
<tr>
<td>passthrough|PT</td>
<td>L'URI r<>sultant est repass<73> au moteur de mise en
correspondance des URLs pour y <20>tre trait<69> par d'autres
traducteurs URI-vers-nom de fichier, comme <code>Alias</code> ou
<code>Redirect</code>. <em><a href="../rewrite/flags.html#flag_pt">d<>tails ...</a></em></td>
</tr>
<tr>
<td>qsappend|QSA</td>
<td>Ajoute toute cha<68>ne de param<61>tres pr<70>sente dans l'URL de la
requ<71>te originale <20> toute cha<68>ne de param<61>tres cr<63><72>e dans la
cible de r<><72>criture. <em><a href="../rewrite/flags.html#flag_qsa">d<>tails ...</a></em></td>
</tr>
<tr>
<td>qsdiscard|QSD</td>
<td>Supprime toute cha<68>ne de param<61>tres de l'URI entrant. <em><a href="../rewrite/flags.html#flag_qsd">d<>tails
...</a></em></td>
</tr>
<tr>
<td>redirect|R[=<em>code</em>]</td>
<td>Force une redirection externe, avec un code de statut HTTP
optionnel. <em><a href="../rewrite/flags.html#flag_r">d<>tails ...</a></em>
</td>
</tr>
<tr>
<td>END</td>
<td>Arr<72>te le processus de r<><72>criture imm<6D>diatement et
n'applique plus aucune r<>gle. Emp<6D>che aussi l'ex<65>cution
ult<6C>rieure de r<>gles de r<><72>criture dans des contextes de
r<>pertoire et des fichiers .htaccess (disponible depuis la
version 2.3.9) <em><a href="../rewrite/flags.html#flag_l">d<>tails ...</a></em></td>
</tr>
<tr>
<td>skip|S=<em>nombre</em></td>
<td>Si la r<>gle courante s'applique, le moteur de r<><72>criture
doit sauter les <em>nombre</em> r<>gles suivantes. <em><a href="../rewrite/flags.html#flag_s">d<>tails ...</a></em></td>
</tr>
<tr>
<td>type|T=<em>MIME-type</em></td>
<td>Force l'attribution du <a class="glossarylink" href="../glossary.html#type-mime" title="voir glossaire">Type-MIME</a>
sp<73>cifi<66> au fichier cible. <em><a href="../rewrite/flags.html#flag_t">d<>tails ...</a></em></td>
</tr>
</table>
<div class="note"><h3>D<>veloppement du r<>pertoire home</h3>
<p> Quand la cha<68>ne de substitution commence par quelque chose comme
"/~user" (de mani<6E>re explicite ou par r<>f<EFBFBD>rences arri<72>res), mod_rewrite
d<EFBFBD>veloppe le r<>pertoire home sans tenir compte de la pr<70>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<74> si le drapeau <em>PT</em> est
utilis<EFBFBD> dans la directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code></p>
</div>
<p>Voici toutes les combinaisons de substitution et leurs
significations :</p>
<p><strong>Dans la configuration au niveau du serveur principal
(<code>httpd.conf</code>)<br />
pour la requ<71>te ``<code>GET
/chemin/infochemin</code>'':</strong><br />
</p>
<table class="bordered">
<tr>
<th>R<>gle</th>
<th>R<>sultat de la substitution</th>
</tr>
<tr>
<td>^/un_chemin(.*) autre_chemin$1</td>
<td>invalide, non support<72></td>
</tr>
<tr>
<td>^/un_chemin(.*) autre_chemin$1 [R]</td>
<td>invalide, non support<72></td>
</tr>
<tr>
<td>^/un_chemin(.*) autre_chemin$1 [P]</td>
<td>invalide, non support<72></td>
</tr>
<tr>
<td>^/un_chemin(.*) /autre_chemin$1</td>
<td>/autre_chemin/info_chemin</td>
</tr>
<tr>
<td>^/un_chemin(.*) /autre_chemin$1 [R]</td>
<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr>
<td>^/un_chemin(.*) /autre_chemin$1 [P]</td>
<td>sans objet, non support<72></td>
</tr>
<tr>
<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1</td>
<td>/autre_chemin/info_chemin</td>
</tr>
<tr>
<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [R]</td>
<td>http://cet_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr>
<td>^/un_chemin(.*) http://cet_hote/autre_chemin$1 [P]</td>
<td>sans objet, non support<72></td>
</tr>
<tr>
<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1</td>
<td>http://autre_hote/autre_chemin/info_chemin via une redirection externe</td>
</tr>
<tr>
<td>^/un_chemin(.*) http://autre_hote/autre_chemin$1 [R]</td>
<td>http://autre_hote/autre_chemin/info_chemin (le drapeau [R] est
redondant)</td>
</tr>
<tr>
<td>^/somepath(.*) http://otherhost/otherpath$1 [P]</td>
<td>http://otherhost/otherpath/pathinfo via internal proxy</td>
</tr>
</table>
<p><strong>Dans une configuration de niveau r<>pertoire pour
<code>/chemin</code><br />
(<code>/chemin/physique/vers/chemin/.htacccess</code>, avec
<code>RewriteBase /chemin</code>)<br />
pour la requ<71>te ``<code>GET
/chemin/chemin-local/infochemin</code>'':</strong><br />
</p>
<table class="bordered">
<tr>
<th>R<>gle</th>
<th>R<>sultat de la substitution</th>
</tr>
<tr>
<td>^chemin-local(.*) autre-chemin$1</td>
<td>/chemin/autre-chemin/infochemin</td>
</tr>
<tr>
<td>^chemin-local(.*) autre-chemin$1 [R]</td>
<td>http://cet-h<>te/chemin/autre-chemin/infochemin via redirection
externe</td>
</tr>
<tr>
<td>^chemin-local(.*) autre-chemin$1 [P]</td>
<td>n'a pas lieu d'<27>tre, non support<72></td>
</tr>
<tr>
<td>^chemin-local(.*) /autre-chemin$1</td>
<td>/autre-chemin/infochemin</td>
</tr>
<tr>
<td>^chemin-local(.*) /autre-chemin$1 [R]</td>
<td>http://cet-h<>te/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr>
<td>^chemin-local(.*) /autre-chemin$1 [P]</td>
<td>n'a pas lieu d'<27>tre, non support<72></td>
</tr>
<tr>
<td>^chemin-local(.*) http://cet-h<>te/autre-chemin$1</td>
<td>/autre-chemin/infochemin</td>
</tr>
<tr>
<td>^chemin-local(.*) http://cet-h<>te/autre-chemin$1 [R]</td>
<td>http://cet-h<>te/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr>
<td>^chemin-local(.*) http://cet-h<>te/autre-chemin$1 [P]</td>
<td>n'a pas lieu d'<27>tre, non support<72></td>
</tr>
<tr>
<td>^chemin-local(.*) http://autre h<>te/autre-chemin$1</td>
<td>http://autre h<>te/autre-chemin/infochemin via redirection externe</td>
</tr>
<tr>
<td>^chemin-local(.*) http://autre h<>te/autre-chemin$1 [R]</td>
<td>http://autre h<>te/autre-chemin/infochemin via redirection externe
(le drapeau [R] est redondant)</td>
</tr>
<tr>
<td>^chemin-local(.*) http://autre h<>te/autre-chemin$1 [P]</td>
<td>http://autre h<>te/autre-chemin/infochemin via un mandataire interne</td>
</tr>
</table>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_rewrite.html" title="Fran<61>ais">&nbsp;fr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_rewrite.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2012 The Apache Software Foundation.<br />Autoris<69> sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
View Git Blame Copy Permalink