mirror of
https://github.com/apache/httpd.git
synced 2025-07-07 09:41:11 +03:00
458fb36436
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1744964 13f79535-47bb-0310-9956-ffa450edef68
1659 lines
79 KiB
Plaintext
1659 lines
79 KiB
Plaintext
<?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>
|
||
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
|
||
<!--
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
This file is generated from xml source: DO NOT EDIT
|
||
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
-->
|
||
<title>mod_rewrite - Serveur Apache HTTP Version 2.5</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.min.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/quickreference.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.png" /></div>
|
||
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
|
||
<div id="path">
|
||
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
|
||
<div id="page-content">
|
||
<div id="preamble"><h1>Module Apache mod_rewrite</h1>
|
||
<div class="toplang">
|
||
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
|
||
<a href="../fr/mod/mod_rewrite.html" title="Fran<61>ais"> fr </a></p>
|
||
</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>Sujets</h3>
|
||
<ul id="topics">
|
||
<li><img alt="" src="../images/down.gif" /> <a href="#logging">Journalisation</a></li>
|
||
</ul><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>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mod_rewrite">Probl<62>mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mod_rewrite">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
|
||
<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">Directive</a> <a name="RewriteBase" id="RewriteBase">RewriteBase</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"><a href="#rewriterule">RewriteRule</a></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, se
|
||
situent par raport <20> la valeur de la directive
|
||
<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"><a href="#rewriterule">RewriteRule</a></code>, suffix<69> par
|
||
la substitution relative est aussi valide en tant qu'URL sur
|
||
le serveur (ce qui est rare).</li>
|
||
<li>A partir de la version 2.4.16 du serveur HTTP Apache,
|
||
cette directive peut <20>tre omise lorsque la requ<71>te est mise en
|
||
correspondance avec le syst<73>me de fichiers via la directive
|
||
<code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code> ou le module
|
||
<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code>.</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"
|
||
AliasMatch "^/myapp" "/opt/myapp-1.2.3"
|
||
<Directory "/opt/myapp-1.2.3">
|
||
RewriteEngine On
|
||
RewriteBase "/myapp/"
|
||
RewriteRule "^index\.html$" "welcome.html"
|
||
</Directory></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">Directive</a> <a name="RewriteCond" id="RewriteCond">RewriteCond</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 <= N <= 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 <= N <= 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 derni<6E>re
|
||
condition <code>RewriteCond</code> satisfaite du 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">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 & requ<71>te:</th> <th />
|
||
</tr>
|
||
|
||
<tr>
|
||
<td>
|
||
HTTP_ACCEPT<br />
|
||
HTTP_COOKIE<br />
|
||
HTTP_FORWARDED<br />
|
||
HTTP_HOST<br />
|
||
HTTP_PROXY_CONNECTION<br />
|
||
HTTP_REFERER<br />
|
||
HTTP_USER_AGENT<br />
|
||
</td>
|
||
|
||
<td>
|
||
AUTH_TYPE<br />
|
||
CONN_REMOTE_ADDR<br />
|
||
CONTEXT_PREFIX<br />
|
||
CONTEXT_DOCUMENT_ROOT<br />
|
||
IPV6<br />
|
||
PATH_INFO<br />
|
||
QUERY_STRING<br />
|
||
REMOTE_ADDR<br />
|
||
REMOTE_HOST<br />
|
||
REMOTE_IDENT<br />
|
||
REMOTE_PORT<br />
|
||
REMOTE_USER<br />
|
||
REQUEST_METHOD<br />
|
||
SCRIPT_FILENAME<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 />
|
||
SCRIPT_GROUP<br />
|
||
SCRIPT_USER<br />
|
||
SERVER_ADDR<br />
|
||
SERVER_ADMIN<br />
|
||
SERVER_NAME<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 />
|
||
CONN_REMOTE_ADDR<br />
|
||
HTTPS<br />
|
||
IS_SUBREQ<br />
|
||
REMOTE_ADDR<br />
|
||
REQUEST_FILENAME<br />
|
||
REQUEST_SCHEME<br />
|
||
REQUEST_URI<br />
|
||
THE_REQUEST<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 <a href="../expr.html#vars">ici</a>, dans la
|
||
sp<73>cification CGI ou ailleurs dans le
|
||
manuel.</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>
|
||
|
||
<dl>
|
||
<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>CONN_REMOTE_ADDR</code></dt>
|
||
|
||
<dd>A partir de la version 2.4.8 : l'adresse IP distante de
|
||
la connexion (voir le module
|
||
<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></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>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>REMOTE_ADDR</code></dt>
|
||
<dd>L'adresse IP de l'h<>te distant (se r<>f<EFBFBD>rer au
|
||
module <code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></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>. En fonction de la
|
||
valeur de la directive <code class="directive"><a href="../mod/core.html#acceptpathinfo">AcceptPathInfo</a></code>, le serveur
|
||
peut n'utiliser que certains <20>l<EFBFBD>ments de t<>te du
|
||
<code>REQUEST_URI</code> pour d<>terminer <20> quel
|
||
fichier correspond la requ<71>te.</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>
|
||
|
||
<dt><code>REQUEST_URI</code></dt>
|
||
|
||
<dd>La partie chemin de l'URI de la requ<71>te, comme
|
||
"/index.html". Ceci exclut en particulier la cha<68>ne de
|
||
param<61>tres de la requ<71>te qui est contenue dans la
|
||
variable <code>QUERY_STRING</code>.</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>
|
||
</dl>
|
||
|
||
</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>. Si des en-t<>tes HTTP sont
|
||
r<>f<EFBFBD>renc<6E>s dans l'expression rationnelle, et si le drapeau
|
||
<code>novary</code> n'est pas activ<69>, ils seront ajout<75>s <20>
|
||
l'en-t<>te Vary.</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>. Ces variables sont
|
||
disponibles m<>me si l'option <code>StdEnvVars</code> de la
|
||
directive <code class="directive"><a href="../mod/mod_ssl.html#ssloptions">SSLOptions</a></code> n'a
|
||
pas <20>t<EFBFBD> d<>finie.</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,
|
||
<a id="LA-U" name="LA-U"><code>%{LA-U:variable}</code></a>, 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 inverser le r<>sultat
|
||
de la condition, quelle que soit l'<em>expression de
|
||
comparaison</em> utilis<69>e.</li>
|
||
|
||
<li>Vous pouvez effectuer des comparaisons lexicographiques de
|
||
cha<68>nes :
|
||
|
||
<dl>
|
||
<dt><strong><expression</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>>expression</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>=expression</strong></dt>
|
||
<dd><3E>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.</dd>
|
||
|
||
<dt><strong><=expression de comparaison</strong></dt>
|
||
<dd>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).</dd>
|
||
|
||
<dt><strong>>=expression de comparaison</strong></dt>
|
||
<dd>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).</dd>
|
||
</dl>
|
||
</li>
|
||
|
||
<li>
|
||
Vous pouvez effectuer des comparaisons d'entiers :
|
||
<dl>
|
||
|
||
<dt><strong>-eq</strong></dt>
|
||
<dd>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.</dd>
|
||
|
||
<dt><strong>-ge</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>-gt</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>-le</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>-lt</strong></dt>
|
||
<dd>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>.</dd>
|
||
|
||
<dt><strong>-ne</strong></dt>
|
||
<dd>Est num<75>riquement <strong>n</strong>on <strong><3E></strong>gal <20><br />
|
||
La <em>Cha<68>ne de test</em> est consid<69>r<EFBFBD>e comme un entier et est
|
||
num<75>riquement compar<61>e <20> l'<em>expression de comparaison</em>. Vrai
|
||
si les deux <20>l<EFBFBD>ments compar<61>s sont num<75>riquement diff<66>rents.
|
||
Equivalent <20> <code>!-eq</code>.</dd>
|
||
|
||
</dl>
|
||
</li>
|
||
|
||
<li>Vous pouvez effectuer diff<66>rents tests sur les attributs de
|
||
fichier :
|
||
<dl>
|
||
|
||
<dt><strong>-d</strong></dt>
|
||
<dd>est un <strong>r</strong><3E>pertoire<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.</dd>
|
||
|
||
<dt><strong>-f</strong></dt>
|
||
<dd>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.</dd>
|
||
|
||
<dt><strong>-F</strong></dt>
|
||
<dd>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 !</dd>
|
||
|
||
<dt><strong>-h</strong></dt>
|
||
<dd>est un lien symbolique, selon la convention bash<br />
|
||
Voir <strong>-l</strong>.</dd>
|
||
|
||
<dt><strong>-l</strong></dt>
|
||
<dd>est un <strong>l</strong>ien 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>.</dd>
|
||
|
||
<dt><strong>-L</strong></dt>
|
||
<dd>est un lien symbolique, selon la convention bash<br />
|
||
Voir <strong>-l</strong>.</dd>
|
||
|
||
<dt><strong>-s</strong></dt>
|
||
<dd>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.</dd>
|
||
|
||
<dt><strong>-U</strong></dt>
|
||
<dd><p>test de l'existence d'une
|
||
URL 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 !</p>
|
||
<p>Ce drapeau ne renvoie <em>que</em> des informations
|
||
concernant le contr<74>le d'acc<63>s, l'authentification et
|
||
l'autorisation. Il ne renvoie <em>pas</em> d'informations
|
||
concernant le code d'<27>tat que le gestionnaire configur<75>
|
||
(static file, CGI, proxy, etc...) aurait, quant <20> lui,
|
||
retourn<72>.</p></dd>
|
||
|
||
<dt><strong>-x</strong></dt>
|
||
<dd>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.</dd>
|
||
|
||
</dl>
|
||
|
||
Par exemple:
|
||
|
||
<pre class="prettyprint lang-config">RewriteCond /var/www/%{REQUEST_URI} !-f
|
||
RewriteRule ^(.+) /other/archive/$1 [R]</pre>
|
||
|
||
|
||
</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}/*'"
|
||
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}" "(iPhone|Blackberry|Android)"
|
||
RewriteRule "^/$" "/homepage.mobile.html" [L]
|
||
|
||
RewriteRule "^/$" "/homepage.std.html" [L]</pre>
|
||
|
||
|
||
<p>Explications : si vous utilisez un navigateur
|
||
qui s'identifie comme un
|
||
navigateur de plateforme mobile (notez que l'exemple est
|
||
incomplet car il existe de nombreuses autres plateformes
|
||
mobiles), c'est la version pour mobile de la page d'accueil qui
|
||
sera renvoy<6F>e. Dans le cas contraire, ce sera la page d'accueil
|
||
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">Directive</a> <a name="RewriteEngine" id="RewriteEngine">RewriteEngine</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>Plut<75>t que de commenter toutes les directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code>, il est pr<70>f<EFBFBD>rable
|
||
d'utiliser cette directive si l'on souhaite d<>sactiver les
|
||
r<>gles de r<><72>criture dans un contexte particulier.</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"><a href="#rewritemap">RewriteMap</a></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">Directive</a> <a name="RewriteMap" id="RewriteMap">RewriteMap</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>MapName</em> <em>MapType</em>:<em>MapSource</em> <em>MapTypeOptions</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>
|
||
</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>MapName</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>MapName</em> <code>:</code>
|
||
<em>mot-cl<63></em> <code>}</code><br />
|
||
<code>${</code> <em>MapName</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>MapName</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>La signification de l'argument <em>MapTypeOptions</em> d<>pend du <em>MapType</em>
|
||
sp<73>cifi<66>. Veuillez vous r<>f<EFBFBD>rer au document <a href="../rewrite/rewritemap.html">Utiliser RewriteMap</a> pour
|
||
plus de d<>tails.</p>
|
||
|
||
<p>Les combinaisons suivantes pour <em>type de correspondance</em>
|
||
et <em>MapSource</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#prg">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#dbd">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">Directive</a> <a name="RewriteOptions" id="RewriteOptions">RewriteOptions</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>
|
||
</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"><Directory></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.<br />
|
||
Disponible depuis la version 2.3.10 du serveur HTTP Apache.</p>
|
||
</dd>
|
||
|
||
<dt><code>InheritDown</code></dt>
|
||
<dd>
|
||
|
||
<p>Si cette option est activ<69>e, toutes les configurations enfants
|
||
h<>riteront de la configuration courante. Il en est de m<>me si l'on
|
||
sp<73>cifie <code>RewriteOptions Inherit</code> dans toutes les
|
||
configurations enfants. Voir l'option <code>Inherit</code> pour
|
||
plus de d<>tails <20> propos de la mani<6E>re dont les relations
|
||
parent-enfants sont trait<69>es.<br />
|
||
Cette option est disponible <20> partir
|
||
de la version 2.4.8 du serveur HTTP Apache.</p>
|
||
</dd>
|
||
|
||
<dt><code>InheritDownBefore</code></dt>
|
||
<dd>
|
||
|
||
<p>L'effet de cette option est <20>quivalent <20> celui de l'option
|
||
<code>InheritDown</code> ci-dessus, mais les r<>gles de la
|
||
configuration parente s'appliquent <strong>avant</strong> toute
|
||
r<>gle de la configuration enfant.<br />
|
||
Cette option est disponible <20> partir
|
||
de la version 2.4.8 du serveur HTTP Apache.</p>
|
||
</dd>
|
||
|
||
<dt><code>IgnoreInherit</code></dt>
|
||
<dd>
|
||
|
||
<p>Si cette option est activ<69>e, les configurations courante et
|
||
enfants ignoreront toute r<>gle h<>rit<69>e d'une configuration parente
|
||
via les options <code>InheritDown</code> ou
|
||
<code>InheritDownBefore</code>.<br />
|
||
Cette option est disponible <20> partir
|
||
de la version 2.4.8 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.<br />
|
||
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.<br />
|
||
Disponible depuis la version 2.4.3 du serveur HTTP Apache.</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>
|
||
|
||
<dt><code>MergeBase</code></dt>
|
||
<dd>
|
||
|
||
<p>Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est recopi<70>e depuis
|
||
une valeur explicitement d<>finie dans tout sous-r<>pertoire qui ne
|
||
d<>finit pas sa propre directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code>. Il s'agissait du
|
||
comportement par d<>faut avec les versions 2.4.0 <20> 2.4.3, et ce
|
||
drapeau qui permet de retrouver ce comportement est disponible
|
||
depuis la version 2.4.4 du serveur HTTP Apache.</p>
|
||
</dd>
|
||
|
||
<dt><code>IgnoreContextInfo</code></dt>
|
||
<dd>
|
||
|
||
<p>Lors d'une
|
||
substitution relative dans un contexte de r<>pertoire (htaccess),
|
||
et si la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> n'a pas <20>t<EFBFBD> d<>finie,
|
||
ce module utilise des informations en provenance d'une extension
|
||
d'URL et du contexte du syst<73>me de fichiers pour transformer la
|
||
sustitution relative en URL. Par exemple, les modules
|
||
<code class="module"><a href="../mod/mod_userdir.html">mod_userdir</a></code> et <code class="module"><a href="../mod/mod_alias.html">mod_alias</a></code>
|
||
utilisent ces informations de contexte <20>tendu. Disponible <20> partir de la
|
||
version 2.4.16 du serveur HTTP Apache.</p>
|
||
</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">Directive</a> <a name="RewriteRule" id="RewriteRule">RewriteRule</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> de la
|
||
requ<71>te, ou, dans un contexte de r<>pertoire (voir
|
||
ci-dessous), au chemin de l'URL relativement <20> ce contexte de
|
||
r<>pertoire. 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>
|
||
|
||
<p>Dans tous les cas, il faut garder <20> l'esprit que les expressions
|
||
rationnelles permettent de rechercher des correspondances de sous-cha<68>nes.
|
||
En d'autres termes, l'expression rationnelle n'a pas besoin de correspondre <20>
|
||
l'ensemble de la cha<68>ne, mais seulement <20> la partie que vous souhaitez
|
||
voir correspondre. Ainsi, l'utilisation de l'expression <code>.</code> est
|
||
souvent suffisante et pr<70>f<EFBFBD>rable <20> <code>.*</code>, et l'expression
|
||
<code>abc</code> <strong>n'est pas</strong> identique <20> l'expression
|
||
<code>^abc$</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"><Directory></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"><a href="#rewritecond">RewriteCond</a></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"><Location></a></code> et <code class="directive"><a href="../mod/core.html#files"><Files></a></code> (y compris leurs versions sous forme
|
||
d'expression rationnelle), elles n'y sont pas prises en compte, et
|
||
n'y sont <20> priori d'aucune utilit<69>. Les substitutions
|
||
relatives sont une fonctionnalit<69> qui n'est, elle non-plus pas support<72>e
|
||
dans ce genre de contexte.</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 (ou dans le cas d'une
|
||
r<><72>criture au sein d'un fichier <code>.htaccess</code>,
|
||
relativement <20> la racine des documents), 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 class="directive"><a href="#rewritecond">RewriteCond</a></code>. Les
|
||
fonctions de comparaison sont issues de la directive <code class="directive"><a href="#rewritemap">RewriteMap</a></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 class="directive">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 class="header"><th>Drapeaux et syntaxe</th>
|
||
<th>Fonction</th>
|
||
</tr>
|
||
<tr>
|
||
<td>B</td>
|
||
<td>Echappe les caract<63>res non-alphanum<75>riques
|
||
dans les r<>f<EFBFBD>rences arri<72>res <em>avant</em>
|
||
d'appliquer la transformation. <em><a href="../rewrite/flags.html#flag_b">d<>tails ...</a></em></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td>backrefnoplus|BNP</td>
|
||
<td>Avec ce drapeau, si les r<>f<EFBFBD>rences arri<72>res sont <20>chapp<70>es,
|
||
les espaces seront <20>chapp<70>s en %20 au lieu de +. Ceci s'av<61>re
|
||
utile lorsqu'une r<>f<EFBFBD>rence arri<72>re est utilis<69>e dans la partie
|
||
chemin, et non dans la cha<68>ne de param<61>tres de la requ<71>te ;
|
||
pour plus de d<>tails, voir <em><a href="../rewrite/flags.html#flag_bnp">ici.</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 class="odd">
|
||
<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 class="odd">
|
||
<td>END</td>
|
||
<td>Stoppe le processus de r<><72>criture imm<6D>diatement et
|
||
n'applique plus aucune r<>gle. Emp<6D>che aussi l'application
|
||
ult<6C>rieure de r<>gles de r<><72>criture dans les contextes de
|
||
r<>pertoire et de fichier .htaccess (disponible <20> partir de la
|
||
version 2.3.9 du serveur HTTP Apache). <em><a href="../rewrite/flags.html#flag_end">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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<td>qslast|QSL</td>
|
||
<td>Interpr<70>te le dernier (le plus <20> droite) point d'interrogation comme
|
||
le d<>limiteur de la cha<68>ne de param<61>tres de la requ<71>te, au lieu du
|
||
premier (le plus <20> gauche) comme c'est le cas habituellement. Disponble
|
||
<09> partir de la version 2.4.19 du serveur HTTP Apache. <em><a href="../rewrite/flags.html#flag_qsl">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 class="odd">
|
||
<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 class="header">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="header">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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 class="odd">
|
||
<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"> en </a> |
|
||
<a href="../fr/mod/mod_rewrite.html" title="Fran<61>ais"> fr </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&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 2016 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/quickreference.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> |