Quellcode-Bibliothek mod_rewrite.html.fr.utf8 Sprache: unbekannt

Columbo aufrufen.utf8 Download desUnknown {[0] [0] [0]}Datei anzeigen

<?xml version="1.0" encoding="UTF-8"?>
<!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=UTF-8" http-equiv="Content-Type" />

<title>mod_rewrite - Serveur HTTP Apache Version 2.4</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">
<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>
Serveur HTTP Apache Version 2.4
<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.4</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_rewrite</h1>
<div class="toplang">
Langues Disponibles: <a href="../en/mod/mod_rewrite.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/mod_rewrite.html" title="Français"> fr </a>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Ce module fournit un moteur de réécriture à base de
règles permettant de réécrire les URLs des requêtes
à la volée</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Extension</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>rewrite_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_rewrite.c</td></tr></table>
<h3>Sommaire</h3>

 Le module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> utilise un moteur de
 réécriture à base de règles, basé sur un interpréteur
 d'expressions rationnelles PCRE, pour réécrire les URLs à la volé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ème de fichiers. Cependant, on peut aussi l'utiliser
 pour rediriger une URL vers une autre URL, ou pour invoquer une
 requête interne à destination du mandataire.
 <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é
 de règles. Chaque règle peut être associée à un nombre illimité de
 conditions, afin de vous permettre de réécrire les URLs en
 fonction de variables du serveur, de variables d'environnement,
 d'en-têtes HTTP, ou de repères temporels.
 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> agit sur la totalité de l'URL, y
 compris la partie chemin. Une règle de réécriture peut être
 invoquée dans <code>httpd.conf</code> ou dans un fichier
 <code>.htaccess</code>. Le chemin généré par une règle de
 réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
 vers un traitement secondaire interne, une redirection vers une
 requête externe ou vers le mandataire interne.

 Vous trouverez d'avantage de détails, discussions et exemples
 dans la
 <a href="../rewrite/">documentation détaillée
 sur mod_rewrite</a>.
</div>
<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><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è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>

 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> offre une journalisation détaillée
 de ses actions aux niveaux de journalisation <code>trace1</code> à
 <code>trace8</code>. Le niveau de journalisation peut être défini de
 manière spécifique à <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ée, alors qu'elles
 le sont pratiquement toutes au niveau <code>trace8</code>.

 <div class="note">
 L'utilisation d'un niveau de journalisation élevé pour
 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> va ralentir votre serveur HTTP Apache
 de manière dramatique ! N'utilisez un niveau de journalisation
 supérieur à <code>trace2</code> qu'à 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>
 Ceux qui sont familiers avec les versions précé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 été en effet remplacées
 par une configuration de la journalisation par module, comme
 mentionné plus haut.
 

 Pour extraire les traces spécifiques à
 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, affichez le fichier journal en
 redirigeant la sortie vers grep :
 <div class="example"><code>
 tail -f error_log|fgrep '[rewrite:'
 </code></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éécritures au niveau
répertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteBase chemin_URL</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">Surcharges autorisées:</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>
 La directive <code class="directive">RewriteBase</code> permet de
 spécifier le préfixe d'URL à utiliser dans un contexte de
 répertoire (htaccess) pour les directives
 <code class="directive"><a href="#rewriterule">RewriteRule</a></code> qui réécrivent vers un chemin
 relatif.
 Cette directive est obligatoire 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ée :
 <ul>
 <li>La requête initiale, ainsi que la substitution, se
 situent par raport à la valeur de la directive
 <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> (c'est à
 dire que pour y accé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ème de fichiers vers le répertoire
 contenant la <code class="directive"><a href="#rewriterule">RewriteRule</a></code>, suffixé 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 être omise lorsque la requête est mise en
 correspondance avec le systè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>

Dans l'exemple ci-dessous, la directive
<code class="directive">RewriteBase</code> est nécessaire afin d'éviter une
réécriture en http://example.com/opt/myapp-1.2.3/welcome.html car la
ressource n'était pas relative à la racine des documents. Cette erreur
de configuration aurait conduit le serveur à rechercher un répertoire
"opt" à la racine des documents.

<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 être satisfaite pour que
la réécriture soit effectuée
</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> RewriteCond
 chaîne_de_test expression_de_comparaison [drapeaux]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</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>
 La directive <code class="directive">RewriteCond</code> permet de définir une
 condition d'exécution d'une règle. Une ou plusieurs conditions
 <code class="directive">RewriteCond</code> peuvent précéder une
 directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code>. La règle de réécriture correspondante n'est
 ainsi exécutée que si ces conditions sont satisfaites,
 et si l'URI correspond au modèle spécifié dans la
 règle.

 TestString est une chaîne qui peut contenir les
 extensions suivantes en plus du texte simple :

 <ul>
 <li>
 références arrières de règle de réécriture :
 ce sont des références arrières de la forme
 <code>$N</code> (0 <= N <= 9). $1 à $9
 permettent d'accéder aux parties regroupées (entre
 parenthèses) du modèle, issues de la <code>RewriteRule</code>
 concernée par le jeu de conditions <code>RewriteCond</code>
 courant. $0 donne accès à l'ensemble de la chaîne
 correspondant au modèle.</li>
 <li>
 Références arrières de condition de réécriture
 : ce sont des références arrières de la forme
 <code>%N</code> (0 <= N <= 9). %1 à %9
 permettent d'accéder aux parties regroupées (entre
 parenthèses) du modèle, issues de la dernière
 condition <code>RewriteCond</code> satisfaite du jeu de conditions <code>RewriteCond</code>
 courant. %0 donne accès à l'ensemble de la chaîne
 correspondant au modèle.</li>
 <li>
 extensions de table de réécriture :
 ce sont des extensions de la forme <code>${nomTable:clé|défaut}</code>. Voir la <a>href="#mapfunc">documentation sur RewriteMap</a>
 pour plus de détails.
 </li>
 <li>
 Variables du serveur :
 ce sont des variables de la forme
 <code>%{</code> NAME_OF_VARIABLE <code>}</code>,
 où NOM_DE_VARIABLE peut contenir une chaîne issue
 de la liste suivante :

 <table>

 <tr>
 <th>En-têtes HTTP :</th> <th>connexion & requête:</th> <th />
 </tr>

 <tr>
 <td>
 HTTP_ACCEPT 
 HTTP_COOKIE 
 HTTP_FORWARDED 
 HTTP_HOST 
 HTTP_PROXY_CONNECTION 
 HTTP_REFERER 
 HTTP_USER_AGENT 
 </td>

 <td>
 AUTH_TYPE 
 CONN_REMOTE_ADDR 
 CONTEXT_PREFIX 
 CONTEXT_DOCUMENT_ROOT 
 IPV6 
 PATH_INFO 
 QUERY_STRING 
 REMOTE_ADDR 
 REMOTE_HOST 
 REMOTE_IDENT 
 REMOTE_PORT 
 REMOTE_USER 
 REQUEST_METHOD 
 SCRIPT_FILENAME 
 </td>

 <td />
 </tr>

 <tr>
 <th>variables internes au serveur :</th> <th>date et heure :</th> <th>spéciaux :</th>
 </tr>

 <tr>
 <td>
 DOCUMENT_ROOT 
 SCRIPT_GROUP 
 SCRIPT_USER 
 SERVER_ADDR 
 SERVER_ADMIN 
 SERVER_NAME 
 SERVER_PORT 
 SERVER_PROTOCOL 
 SERVER_SOFTWARE 
 </td>

 <td>
 TIME_YEAR 
 TIME_MON 
 TIME_DAY 
 TIME_HOUR 
 TIME_MIN 
 TIME_SEC 
 TIME_WDAY 
 TIME 
 </td>

 <td>
 API_VERSION 
 CONN_REMOTE_ADDR 
 HTTPS 
 IS_SUBREQ 
 REMOTE_ADDR 
 REQUEST_FILENAME 
 REQUEST_SCHEME 
 REQUEST_URI 
 THE_REQUEST 
 </td>
 </tr>
 </table>

 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ème Unix. La
 plupart d'entre elles sont documentées <a href="../expr.html#vars">ici</a>, dans la
 spécification CGI ou ailleurs dans le
 manuel.

 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>.

 Parmi les variables
 spécifiques à <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, ou trouve les suivantes :

 <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 à la version du serveur Apache
 httpd
 utilisé (par exemple, pour la version 1.3.14 d'Apache
 httpd,
 il s'agit de la version 19990320:10), mais inté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 être utilisée sans problème, que
 <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> soit chargé ou non).</dd>

 <dt><code>IS_SUBREQ</code></dt>

 <dd>Contient le texte "true" si la requête en cours
 de traitement est une sous-requête, "false" dans le
 cas contraire. Une sous-requête est générée quand un
 module a besoin de se référer à des fichiers ou URIs
 addidionnels pour pouvoir mener à bien sa tâche.</dd>

 <dt><code>REMOTE_ADDR</code></dt>
 <dd>L'adresse IP de l'hôte distant (se réfé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ème de fichiers
 du fichier ou du script correspondant
 à la requête, s'il a déjà été déterminé par le serveur
 au moment où on y fait réfé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 éléments de tête du
 <code>REQUEST_URI</code> pour déterminer à quel
 fichier correspond la requête.</dd>

 <dt><code>REQUEST_SCHEME</code></dt>

 <dd>Contient le protocole de la requête (en général
 "http" ou "https"). La valeur peut être modifié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ête, comme
 "/index.html". Ceci exclut en particulier la chaîne de
 paramètres de la requête qui est contenue dans la
 variable <code>QUERY_STRING</code>. La valeur renvoyée pour
 <code>REQUEST_URI</code> a déjà été %-décodée ; pour la
 recoder, passez-la à la <a href="#mapfunc">fonction de
 mappage</a> "escape".
 </dd>

 <dt><code>THE_REQUEST</code></dt>

 <dd>La ligne de requête HTTP complète envoyée par le
 navigateur au serveur (par exemple, "<code>GET
 /index.html HTTP/1.1</code>"), à l'exclusion de tout
 en-tête ajouté par le navigateur. Cette
 valeur n'a pas été déséchappée (décodée), à la
 différence de la plupart des variables suivantes.</dd>
 </dl>

 </li>
 </ul>

 Si la chaîne_de_test contient la valeur spéciale
 <code>expr</code>, expression_de_comparaison sera traité
 en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>. Si des en-têtes HTTP sont
 référencés dans l'expression rationnelle, et si le drapeau
 <code>novary</code> n'est pas activé, ils seront ajoutés à
 l'en-tête Vary.

 Autres points à connaître ::
 <ol>
 <li>
 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'équivalent de REQUEST_URI (qui
contient la valeur du champ <code>uri</code> de
<code>request_rec</code>).
 Si une substitution intervient et si la réécriture se
poursuit, la valeur des deux variables sera mise à jour en
conséquence.
 Dans le contexte du serveur principal (c'est à dire avant que
la requête ne soit mise en correspondance avec le système de
fichiers), SCRIPT_FILENAME et REQUEST_FILENAME ne peuvent pas
contenir le chemin entier dans le système de fichiers local car
ce chemin b'est pas connu à ce stade du traitement. Dans ce cas,
les deux variables contiendront la valeur de REQUEST_URI. Pour
obtenir le chemin complet de la requête dans le système de
fichiers local dans le contexte du serveur principal, utilisez une
référence avant à base d'URL
<code>%{LA-U:REQUEST_FILENAME}</code> pour déterminer la valeur
finale de REQUEST_FILENAME.</li>

 <li>
<code>%{ENV:variable}</code>, où variable peut
correspondre à une variable d'environnement quelconque.</li>
<li>
 <code>%{ENV:variable}</code> est aussi disponible, où
variable peut correspondre à toute variable
d'environnement. Peut être consulté via des structures internes
d'Apache httpd et (si on ne les trouve pas ici) via la fonction
<code>getenv()</code> à 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é ou non, on peut
utiliser <code>%{SSL:variable}</code>, où variable
peut être remplacé 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é, cette variable contiendra toujours une chaî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 été définie.</li>

<li>
 On peut utiliser <code>%{HTTP:en-tête}</code>, où
en-tête peut correspondre à tout nom d'en-tête MIME
HTTP, pour extraire la valeur d'un en-tête envoyé dans la
requê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 évaluée à
<code>vrai</code> pour la requête, cet en-tête sera ajouté à l'en-tête Vary de
la réponse. Il ne le sera pas si la condition est évaluée à
<code>faux</code>. L'ajout de l'en-tête HTTP à l'en-tête Vary
est nécessaire à une mise en cache appropriée.
Il faut garder à l'esprit que les conditions suivent une
logique de cout-circuit si le drapeau
'<code>ornext|OR</code>' est utilisé, et que de
ce fait, certaines d'entre elles ne seront pas évaluées.
</li>

 <li>A des fins de réfé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ête interne à base d'URL, afin
de déterminer la valeur finale de variable. Ceci permet
d'accéder à la valeur d'une variable pour la réécriture inconnue
à ce stade du traitement, mais qui sera définie au
cours d'une phase ultérieure.
Par exemple, pour effectuer une réé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 après la
phase de traduction d'URL (pendant laquelle <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>
opère).
 Par contre, comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> implémente son contexte de
répertoire (fichier <code>.htaccess</code>) via la phase Fixup
de l'API, et comme la phase d'autorisation intervient
avant cette dernière, vous pouvez vous contenter
d'utiliser <code>%{REMOTE_USER}</code> dans ce contexte.</li>

 <li>
 <code>%{LA-F:variable}</code> peut être utilisée pour effectuer
une sous-requête interne (basée sur le nom de fichier), afin de
déterminer la valeur finale de variable. La plupart du
temps, elle est identique à LA-U (voir ci-dessus).</li>
 </ol>

 expression_de_comparaison est une expression
 rationnelle qui est appliquée à l'instance actuelle de
 chaîne_de_test. chaîne_de_test est d'abord
 évaluée, puis comparée à
 l'expression_de_comparaison.

 expression_de_comparaison est en général une
 expression rationnelle compatible perl, mais vous
 disposez des syntaxes supplémentaires suivantes pour effectuer
 d'autres tests utiles sur chaîne_de_test :
 

 <ol>
 <li>Vous pouvez préfixer l'expression avec un caractère
'<code>!</code>' (point d'exclamation) pour inverser le résultat
de la condition, quelle que soit l'expression de
comparaison utilisée.</li>

 <li>Vous pouvez effectuer des comparaisons lexicographiques de
chaînes :

 <dl>
 <dt><expression</dt>
 <dd>inférieur au sens lexicographique 
 Traite l'expression comme une chaîne de
 caractères et la compare lexicographiquement à
 chaîne_de_test. La condition est satisfaite si
 chaîne_de_test est inférieure au sens
 lexicographique à l'expression.</dd>

 <dt>>expression</dt>
 <dd>supérieur au sens lexicographique 
 Traite l'expression comme une chaîne de
 caractères et la compare lexicographiquement à
 chaîne_de_test. La condition est satisfaite si
 chaîne_de_test est supérieure au sens
 lexicographique à l'expression.</dd>

 <dt>=expression</dt>
 <dd>égal au sens lexicographique 
 Traite l'expression comme une chaîne de
 caractères et la compare lexicographiquement à
 chaîne_de_test. La condition est satisfaite si
 chaîne_de_test est égale au sens
 lexicographique à l'expression (les deux chaînes
 sont exactement identiques, caractère pour caractère). Si
 expression est <code>""</code> (deux guillemets),
 chaîne_de_test est comparée à la
 chaîne vide.</dd>

 <dt><=expression de comparaison</dt>
 <dd>inférieur ou égal à au sens lexicographique 
 Considère l'expression_de_comparaison comme une
 chaîne de caractères et la compare au sens lexicographique à
 la chaîne_de_test. Vrai si chaîne_de_test
 précède lexicographiquement expression_de_comparaison, ou est
 égale à expression_de_comparaison (les deux chaînes
 sont identiques, caractère pour caractère).</dd>

 <dt>>=expression de comparaison</dt>
 <dd>supérieur ou égal à au sens lexicographique 
 Considère l'expression_de_comparaison comme une
 chaîne de caractères et la compare au sens lexicographique à
 la chaîne_de_test. Vrai si chaîne_de_test
 suit lexicographiquement expression_de_comparaison, ou est
 égale à expression_de_comparaison (les deux chaînes
 sont identiques, caractère pour caractère).</dd>
 </dl>
<div class="note"><h3>Note</h3>
 L'opérateur de comparaison de chaînes fait partie des arguments de la
CondPattern et doit par conséquent se trouver entre les
guillemets s'ils sont présents. Exemple :

 <pre class="prettyprint lang-config">RewriteCond %{HTTP_USER_AGENT} "=This Robot/1.0"</pre>

 </div>

</li>

 <li>
 Vous pouvez effectuer des comparaisons d'entiers :
 <dl>

 <dt>-eq</dt>
 <dd>est numériquement égal à 
 La chaîne_de_test est considérée comme un entier,
 et est comparée numériquement à l'expression de
 comparaison. Vrai si les deux expressions sont
 numériquement égales.</dd>

 <dt>-ge</dt>
 <dd>est numériquement supérieur ou égal à 
 La chaîne_de_test est considérée comme un entier,
 et est comparée numériquement à l'expression de
 comparaison. Vrai si chaîne_de_test est
 numériquement supérieure ou égale à
 expression_de_comparaison.</dd>

 <dt>-gt</dt>
 <dd>est numériquement supérieur à 
 La chaîne_de_test est considérée comme un entier,
 et est comparée numériquement à l'expression de
 comparaison. Vrai si chaîne_de_test est
 numériquement
 supérieure à expression_de_comparaison.</dd>

 <dt>-le</dt>
 <dd>est numériquement inférieur ou égal à 
 La chaîne_de_test est considérée comme un entier,
 et est comparée numériquement à l'expression de
 comparaison. Vrai si chaîne_de_test est
 numériquement
 inférieure ou égale à expression_de_comparaison.
 Attention à la confusion avec le drapeau -l
 en utilisant la variante the -L ou
 -h.</dd>

 <dt>-lt</dt>
 <dd>est numériquement inférieur à 
 La chaîne_de_test est considérée comme un entier,
 et est comparée numériquement à l'expression de
 comparaison. Vrai si chaîne_de_test est
 numériquement
 inférieure à expression_de_comparaison.
 Attention à la confusion avec le drapeau -l
 en utilisant la variante the -L ou
 -h.</dd>

 <dt>-ne</dt>
 <dd>Est numériquement non égal à 
 La Chaîne de test est considérée comme un entier et est
 numériquement comparée à l'expression de comparaison. Vrai
 si les deux éléments comparés sont numériquement différents.
 Equivalent à <code>!-eq</code>.</dd>

 </dl>
 </li>

 <li>Vous pouvez effectuer différents tests sur les attributs de
fichier :
 <dl>

 <dt>-d</dt>
 <dd>est un répertoire 
 Traite chaîne_de_test comme un chemin et vérifie
 s'il existe ou pas, et s'il s'agit d'un répertoire.</dd>

 <dt>-f</dt>
 <dd>est un fichier régulier 
 Traite chaîne_de_test comme un chemin et vérifie
 s'il existe ou pas, et s'il s'agit d'un fichier régulier.</dd>

 <dt>-F</dt>
 <dd>test de l'existence d'un fichier via une sous-requête 
 Vérifie si chaîne_de_test est un fichier valide,
 accessible à travers tous les contrôles d'accès du serveur
 actuellement configurés pour ce chemin. C'est une
 sous-requête interne qui effectue cette vérification - à
 utiliser avec précautions car les performances du serveur
 peuvent s'en trouver affectées !</dd>

 <dt>-h</dt>
 <dd>est un lien symbolique, selon la convention bash 
 Voir -l.</dd>

 <dt>-l</dt>
 <dd>est un lien symbolique 
 Considère la chaîne_de_test comme un chemin et
 vérifie son existence et si elle est un lien symbolique. On
 peut aussi utiliser la convention bash -L
 ou -h lorsqu'il y a risque de confusion
 avec les tests -lt ou -le.</dd>

 <dt>-L</dt>
 <dd>est un lien symbolique, selon la convention bash 
 Voir -l.</dd>

 <dt>-s</dt>
 <dd>est un fichier régulier d'une certaine taille 
 Considère la chaîne_de_test comme un chemin et
 vérifie son existence et si elle est un fichier régulier
 d'une taille supérieure à zéro.</dd>

 <dt>-U</dt>
 <dd>test de l'existence d'une
 URL via une sous-requête 
 Vérifie si chaîne_de_test est une URL valide,
 accessible à travers tous les contrôles d'accès du serveur
 actuellement configurés pour ce chemin. C'est une
 sous-requête interne qui effectue cette vérification - à
 utiliser avec précautions car les performances du serveur
 peuvent s'en trouver affectées !
 Ce drapeau ne renvoie que des informations
 concernant le contrôle d'accès, l'authentification et
 l'autorisation. Il ne renvoie pas d'informations
 concernant le code d'état que le gestionnaire configuré
 (static file, CGI, proxy, etc...) aurait, quant à lui,
 retourné.</dd>

 <dt>-x</dt>
 <dd>a l'attribut d'exécution positionné 
 Considère la chaîne_de_test comme un chemin et
 vérifie son existence et si elle a son attribut d'exécution
 positionné. Ce positionnement est déterminé 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>
 Si la chaîne_de_test contient la valeur spéciale
 <code>expr</code>, la chaîne de comparaison sera
 traitée en tant qu'expression rationnelle de type <a href="../expr.html">ap_expr</a>.

 
 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érencement direct)
 non désiré.
 

 <pre class="prettyprint lang-config"> RewriteCond expr "! %{HTTP_REFERER} -strmatch '*://%{HTTP_HOST}/*'"
 RewriteRule "^/images" "-" [F]</pre>

 </li>
 </ol>

Vous pouvez aussi définir certains drapeaux pour
l'expression_de_comparaison en ajoutant ces
<code>[</code>drapeaux<code>]</code>
comme troisième argument de la directive
<code class="directive">RewriteCond</code>, où drapeaux est un
sous-ensemble séparé par des virgules des drapeaux suivants :

 <ul>
 <li>'<code>nocase|NC</code>'
(no case) 
Rend le test insensible à la casse - il n'est pas fait de
distinction entre majuscules et minuscules, à la fois dans le
développement de chaîne_de_test et dans
expression_de_comparaison. Ce drapeau n'est pris en
compte que lors d'une comparaison entre chaîne_de_test
et expression_de_comparaison. Il ne l'est pas pour les
vérification par sous-requêtes ou sur le système de
fichiers.</li>

 <li>
 '<code>ornext|OR</code>'
 (ou condition suivante) 
 Permet de chaî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 être écrites trois fois.
 </li>

 <li>'<code>novary|NV</code>'
(no vary) 
Si la condition contient un en-tête HTTP, ce drapeau empêche
ce dernier d'être ajouté à l'en-tête Vary de la réponse. 
L'utilisation de ce drapeau peut provoquer une mise en cache
incorrecte de la réponse, si la représentation de cette réponse
varie avec la valeur de l'en-tête considéré. Ce drapeau ne
devrait donc être utilisé que si l'on maîtrise parfaitement le
fonctionnement de l'en-tête Vary.
 </li>
 </ul>


 Exemple :

 Pour réécrire la page d'accueil d'un site en fonction de
 l'en-tête ``<code>User-Agent:</code>'' de la requête, vous
 pouvez utiliser ce qui suit : 

<pre class="prettyprint lang-config">RewriteCond "%{HTTP_USER_AGENT}" "(iPhone|Blackberry|Android)"
RewriteRule "^/$" "/homepage.mobile.html" [L]

RewriteRule "^/$" "/homepage.std.html" [L]</pre>

 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ée. Dans le cas contraire, ce sera la page d'accueil
standard.

Par défaut, plusieurs directives <code class="directive">RewriteCond</code>
sont évaluées de manière séquentielle et combinées à l'aide d'un
ET logique. Si une condition n'est pas vérifiée et en
l'absence d'un opérateur logique <code>OU</code>,
l'ensemble du jeu de règles est abandonné et les conditions restantes ne
sont pas évaluées.
 

</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écution du
moteur de réécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteEngine on|off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>RewriteEngine off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</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>

 La directive <code class="directive">RewriteEngine</code> active ou
 désactive l'exécution du moteur de réécriture. Si sa valeur est
 <code>off</code>, ce module n'exécutera aucun traitement et ne
 mettra pas à jour les variables d'environnement
 <code>SCRIPT_URx</code>.

 Plutôt que de commenter toutes les directives <code class="directive"><a href="#rewriterule">RewriteRule</a></code>, il est préférable
 d'utiliser cette directive si l'on souhaite désactiver les
 règles de réécriture dans un contexte particulier.

 Notez que les hôtes virtuels n'héritent pas des
 configurations de réécriture. Ceci implique que vous devez
 insérer une directive <code>RewriteEngine on</code> dans chaque
 hôte virtuel pour lequel vous souhaitez utiliser des règles
 de réécriture.

 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 été définies dans un
 contexte où la directive <code class="directive">RewriteEngine</code> n'a
 pas été définie à <code>on</code>.

</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és</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteMap MapName MapType:MapSource [MapTypeOptions]
</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, 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é:</a></th><td>Le troisième paramètre, MapTypeOptions, est disponible à partir
de la version 2.4.29 du serveur HTTP Apache</td></tr>
</table>
 La directive <code class="directive">RewriteMap</code> définit une
 Table de correspondance pour la réécriture que les
 fonctions de mise en correspondance
 peuvent utiliser dans les chaînes de substitution des règles
 pour insérer/substituer des champs en recherchant des mots-clés.
 La source utilisée pour cette recherche peut être de plusieurs
 types.

 <a id="mapfunc" name="mapfunc">MapName</a> est le nom de la table de correspondance
 et servira à spécifier une fonction de mise en correspondance
 pour les chaînes de substitution d'une règle de réécriture selon
 une des constructions suivantes :

 
 <code>${</code> MapName <code>:</code>
 mot-clé <code>}</code> 
 <code>${</code> MapName <code>:</code>
 mot-clé <code>|</code> valeur par défaut
 <code>}</code>
 

 Lorsqu'une telle construction est rencontrée, la table de
 correspondance MapName est consultée
 et la clé mot-clé recherchée. Si la clé est trouvée, la
 construction est remplacée par
 la valeur de remplacement. Si la clé n'est pas trouvée,
 elle est remplacée par la valeur par défaut, ou par une
 chaîne vide si aucune valeur par défaut n'est
 spécifiée. La valeur vide se comporte comme si la
 clé était absente ; il est donc impossible de distinguer une
 valeur vide d'une absence de clé.

 Par exemple, vous pouvez définir une directive
 <code class="directive">RewriteMap</code> comme suit 

 <pre class="prettyprint lang-config">RewriteMap map-exemple "txt:/chemin/vers/fichier/map.txt"</pre>

 Vous pourrez ensuite utiliser cette table dans une
 directive <code class="directive"><a href="#rewriterule">RewriteRule</a></code> comme suit :

 <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${map-exemple:$1}"</pre>

 La signification de l'argument MapTypeOptions dépend du MapType
 spécifié. Veuillez vous référer au document <a href="../rewrite/rewritemap.html">Utiliser RewriteMap</a> pour
 plus de détails.

 Les combinaisons suivantes pour type de correspondance
 et MapSource
 peuvent être utilisées :

<dl>
 <dt>txt</dt>
 <dd>Un fichier texte contenant des paires clé-valeur séparé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éatoire d'une entrée depuis un fichier texte (<a href="../rewrite/rewritemap.html#rnd">Détails ...</a>).</dd>

 <dt>dbm</dt>
 <dd>Recherche une entrée dans un fichier dbm contenant des
paires nom-valeur. Le condensé hash est élaboré à 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éécriture (<a href="../rewrite/rewritemap.html#prg">Détails
...</a>).</dd>

 <dt>dbd or fastdbd</dt>
 <dd>Une commande SQL SELECT à exécuter pour rechercher la cible
de réécriture (<a href="../rewrite/rewritemap.html#dbd">Détails
...</a>).</dd>
 </dl>

Vous trouverez plus de détails et de nombreux exemples dans le <a href="../rewrite/rewritemap.html">RewriteMap HowTo</a>.

</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éciales
pour le moteur de réécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteOptions <var>Options</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</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>

 La directive <code class="directive">RewriteOptions</code> définit
 certaines options spéciales pour la configuration au niveau du
 serveur ou du répertoire. La chaîne de caractères Option
 ne peut actuellement prendre qu'une des valeurs suivantes :

 <dl>
 <dt><code>Inherit</code></dt>
 <dd>

 Ceci force la configuration locale à hériter de la
 configuration du niveau supérieur. Dans le contexte des hôtes
 virtuels, cela signifie que les correspondances, conditions et
 règles du serveur principal sont héritées. Dans le contexte des
 répertoires, cela signifie que les conditions et règles de la
 configuration <code>.htaccess</code> ou les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> du répertoire
 parent sont héritées. Les règles héritées sont virtuellement
 copiées dans la section où cette directive est utilisée. Si elles
 sont utilisées avec des règles locales, les règles héritées sont
 placées après ces dernières. La place de cette directive - avant
 ou après les règles locales - n'a aucune influence sur ce
 comportement. Si des règles locales ont forcé l'arrêt de la
 réécriture, les règles héritées ne seront pas traitées.

 <div class="warning">
 Les règles héritées du niveau parent sont appliquées
 after après les règles spécifiées dans le niveau
 enfant.
 </div>
 </dd>

 <dt><code>InheritBefore</code></dt>
 <dd>
 Même effet que l'option <code>Inherit</code> ci-dessus, mais
 les règles spécifiées dans le niveau parent s'appliquent
 avant les règles spécifiées dans le niveau
 enfant. 
 Disponible depuis la version 2.3.10 du serveur HTTP Apache.
 </dd>

 <dt><code>InheritDown</code></dt>
 <dd>

 Si cette option est activée, toutes les configurations enfants
 hériteront de la configuration courante. Il en est de même si l'on
 spécifie <code>RewriteOptions Inherit</code> dans toutes les
 configurations enfants. Voir l'option <code>Inherit</code> pour
 plus de détails à propos de la manière dont les relations
 parent-enfants sont traitées. 
 Cette option est disponible à partir
 de la version 2.4.8 du serveur HTTP Apache.
 </dd>

 <dt><code>InheritDownBefore</code></dt>
 <dd>

 L'effet de cette option est équivalent à celui de l'option
 <code>InheritDown</code> ci-dessus, mais les règles de la
 configuration parente s'appliquent avant toute
 règle de la configuration enfant. 
 Cette option est disponible à partir
 de la version 2.4.8 du serveur HTTP Apache.
 </dd>

 <dt><code>IgnoreInherit</code></dt>
 <dd>

 Si cette option est activée, les configurations courante et
 enfants ignoreront toute règle héritée d'une configuration parente
 via les options <code>InheritDown</code> ou
 <code>InheritDownBefore</code>. 
 Cette option est disponible à partir
 de la version 2.4.8 du serveur HTTP Apache.
 </dd>

 <dt><code>AllowNoSlash</code></dt>
 <dd>
 Par défaut, <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> ignore les URLs qui
 correspondent à 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.

 Lorsque la directive <code class="directive"><a href="../mod/mod_dir.html#directoryslash">DirectorySlash</a></code> est définie à off, il
 est possible de spécifier l'option <code>AllowNoSlash</code> pour
 s'assurer que les règles de réécriture ne soient plus ignorées.
 Si on le souhaite, cette option permet de faire s'appliquer des
 règles de réécriture qui correspondent à un répertoire sans slash
 final au sein de fichiers .htaccess. 
 Elle est disponible à
 partir de la version 2.4.0 du serveur HTTP Apache.
 </dd>

 <dt><code>AllowAnyURI</code></dt>
 <dd>

 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éécriture
 que si l'URI de la requête respecte la syntaxe d'un <a href="directive-dict.html#Syntax">chemin URL</a>. Ceci permet
 d'éviter certains problèmes de sécurité où des règles
 particulières pourraient permettre des développements de modè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 à la syntaxe des chemins URL, on peut
 utiliser l'option <code>AllowAnyURI</code>, afin de permettre à
 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> d'appliquer le jeu de règles à toute
 chaîne de requête URI, sans vérifier si cette dernière respecte la
 grammaire des chemins URL définie dans la spécification HTTP. 
 Disponible depuis la version 2.4.3 du serveur HTTP Apache.

 <div class="warning">
 <h3>Avertissement à propos de la sécurité</h3>

 L'utilisation de cette option rendra le serveur vulnérable à
 certains problèmes de sécurité si les règles de réécritures
 concernées n'ont pas été rédigées avec soin. Il est par conséquent
 fortement recommandé de ne pas utiliser cette
 option. En particulier, prêtez attention aux chaînes en entrée contenant le
 caractère '<code>@</code>', qui peuvent modifier l'interprétation
 de l'URI réécrite, comme indiqué dans les liens ci-dessus.
 </div>
 </dd>

 <dt><code>MergeBase</code></dt>
 <dd>

 Avec cette option, la valeur de la directive <code class="directive"><a href="#rewritebase">RewriteBase</a></code> est recopié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 à 2.4.3, et ce
 drapeau qui permet de retrouver ce comportement est disponible
 depuis la version 2.4.4 du serveur HTTP Apache.
 </dd>

 <dt><code>IgnoreContextInfo</code></dt>
 <dd>

 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 été définie,
 ce module utilise des informations en provenance d'une extension
 d'URL et du contexte du systè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 étendu. Disponible à partir de la
 version 2.4.16 du serveur HTTP Apache.
 </dd>

 <dt><code>LegacyPrefixDocRoot</code></dt>
 <dd>

 Avant la version 2.4.26, si une substitution était une URL absolue qui
 correspondait au serveur virtuel courant, l'URL pouvait être tout d'abord
 réduite à sa partie chemin, puis enfin en chemin local. Comme l'URL peut
 être réduite en chemin local, le chemin doit être préfixé par la
 valeur de la directive DocumentRoot, ce qui permet d'interdire l'accès à
 un fichier tel que /tmp/myfile suite à une requête pour
 http://host/file/myfile avec la <code class="directive"><a href="#rewriterule">RewriteRule</a></code> suivante :
 <pre class="prettyprint lang-config">RewriteRule /file/(.*) http://localhost/tmp/$1</pre>

 Cette option permet de restaurer l'ancien comportement lorsqu'un chemin
 local obtenu à partir de la réduction d'une URL n'est pas préfixé par la
 valeur de la directive DocumentRoot. Disponible à partir de la version
 2.4.26 du serveur HTTP Apache.
 </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éécriture</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>RewriteRule
 Modèle Substitution [drapeaux]</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, répertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">Surcharges autorisées:</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>
 La directive <code class="directive">RewriteRule</code> est le
 véritable cheval de trait de la réécriture. La directive peut
 apparaître plusieurs fois, chaque instance définissant une
 règle de réécriture particulière. L'ordre dans lequel ces règles
 sont définies est important - il s'agit de l'ordre dans lequel
 les règles seront appliquées au cours du processus de
 réécriture.

 <a id="patterns" name="patterns">Modèle</a> est une
 <a id="regexp" name="regexp">expression rationnelle</a>
 compatible perl. Ce avec quoi ce modèle est comparé dépend de l'endroit où
 la directive <code class="directive">RewriteRule</code> est définie.

<div class="note"><h3><a id="what_is_matched" name="what_is_matched">Qu'est-ce qui est comparé ?</a></h3>

<ul>
 <li>Dans un contexte de serveur virtuel <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code>, le modèle est tout
 d'abord comparé à la portion de l'URL située entre le nom d'hôte
 éventuellement accompagné du port, et la chaîne de paramètres (par
 exemple "/app1/index.html"). Il s'agit du <a href="directive-dict.html#Syntax">URL-path</a> décodé de sa valeur "%xx".</li>

 <li>Dans un contexte de répertoire (sections <code class="directive"><a href="../mod/core.html#directory">Directory</a></code> et fichiers .htaccess), le
 Modèle est comparé avec une partie de chemin ; par exemple une
 requête pour "/app1/index.html" entraînera une comparaison avec
 "app1/index.html" ou "index.html" selon l'endroit où la directive
 <code class="directive">RewriteRule</code> est définie.

 Le chemin où la règle est défini est supprimé du chemin correspondant
 du système de fichiers avant comparaison (jusqu'au slash final compris).
 En conséquence de cette suppression, les règles définies dans
 ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
 du système de fichiers "en dessous" de l'endroit où la règle est définie.

 Le chemin correspondant actuel du système de fichiers est déterminé par
 des directives telles que <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> et
 <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, ou même le résultat de
 substitutions dans des règles <code class="directive">RewriteRule</code> précédentes.
 
 </li>

 <li>Si vous souhaitez faire une comparaison sur le nom
 d'hôte, le port, ou la chaîne de requête, utilisez une
 directive <code class="directive"><a href="#rewritecond">RewriteCond</a></code>
 comportant respectivement les variables
 <code>%{HTTP_HOST}</code>, <code>%{SERVER_PORT}</code>, ou
 <code>%{QUERY_STRING}</code>.</li>
</ul>

</div>

<div class="note"><h3>Réécritures dans un contexte de répertoire</h3>
<ul>
<li>L'utilisation du moteur de réé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éécriture dans ces contextes, vous devez
définir "<code>RewriteEngine On</code>" et
"<code>Options FollowSymLinks</code>". Si l'administrateur a désactivé
la possibilité de modifier l'option <code>FollowSymLinks</code> au
niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
moteur de réécriture. Cette restriction a été instaurée à des fins de
sécurité.</li>

<li>Voir la directive
<code class="directive"><a href="#rewritebase">RewriteBase</a></code> pour plus de détails à
propos de l'ajout du préfixe après les substitutions relatives.</li>

<li>Si vous souhaitez effectuer une comparaison en prenant en compte
l'intégralité 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é se termine toujours par un slash, ce qui
signifie que la comparaison s'effectue avec une chaîne qui ne comporte
jamais de slash de début. Ainsi, un modèle contenant
<code>^/</code> ne correspondra jamais dans un contexte de répertoire.</li>

<li>Bien que les règles de réé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 à priori d'aucune utilité. Les substitutions
relatives sont une fonctionnalité qui n'est, elle non-plus pas supportée
dans ce genre de contexte.</li>

<li>Les blocs <code class="directive"><a href="../mod/core.html#if">If</a></code> suivent les règles
du contexte de répertoire.</li>

<li>Par défaut, mod_rewrite écrase les règles précédentes au sein de <a href="../sections.html#merging">sections combinées</a> appartenant au même
contexte. Pour modifier ce comportement, on peut utiliser la directive
<code class="directive"><a href="#rewriteoptions">RewriteOptions</a></code> pour définir par
exemple l'option Inherit.</li>

<li>La directive <code class="directive"><a href="#rewriteoptions">RewriteOptions</a></code>
permet aussi de contrôler le comportement des sections définies au même niveau
d'imbrication dans la configuration. Dans l'exemple suivant, par défaut seule la
règle RewriteRules définie dans le second bloc <code class="directive"><a href="../mod/core.html#if">If</a></code> est prise en compte car celle définie dans le
premier bloc est écrasée. Définir <code class="directive"><a href="#rewriteoptions">RewriteOptions</a></code> Inherit force mod_rewrite à
combiner les deux sections en prenant en compte les deux règles et pas seulement
la dernière.</li>
</ul>
<div class="example"><pre class="prettyprint lang-config"><If "true">
 # Sans RewriteOptions Inherit, cette règle est écrasée par celle de la section
 # suivante et aucune redirection ne sera effectuée pour les URIs contenant
 # 'foo'
 RewriteRule foo http://example.com/foo [R]
</If>
<If "true">
 RewriteRule bar http://example.com/bar [R]
</If></pre>
</div>
</div>

Pour quelques conseils à propos des <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, voir le
document <a href="../rewrite/intro.html#regex">Introduction à
mod_rewrite</a>.

 Dans <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, on peut aussi utiliser le caractère
 NOT ('<code>!</code>') comme préfixe de modèle. Ceci vous permet
 d'inverser la signification d'un modèle, soit pour dire
 ``si l'URL considérée ne correspond PAS à
 ce modèle''. Le caractère NON peut donc être utilisé à
 titre exceptionnel, lorsqu'il est plus simple d'effectuer une
 comparaison avec le modèle inversé, ou dans la dernière règle
 par défaut.

<div class="note"><h3>Note</h3>
Si vous utilisez le caractère NON pour inverser la signification d'un
modèle, vous ne pouvez pas inclure de parties génériques groupées dans
le modèle. Ceci est dû au fait que, lorsque le modèle ne correspond
pas (autrement dit, sa négation correspond), les groupes sont vides.
Ainsi, si vous utilisez des modèles inversés, vous ne pouvez
pas vous référer aux groupes par <code>$N</code> dans la chaîne de
substitution !
</div>

 Dans une règle de réécriture,
 <a id="rhs" name="rhs">Substitution</a> est la chaîne
 de caractères qui remplace le chemin de l'URL original qui
 correspondait au Modèle. Substitution peut
 être :

 <dl>

 <dt>un chemin du système de fichiers</dt>

--> --------------------

--> maximum size reached

--> --------------------

Quellcode-Bibliothek mod_rewrite.html.fr.utf8 Sprache: unbekannt

[ 0.101Quellennavigators ]