granicus.if.org Git - apache/blob - docs/manual/rewrite/tech.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Détails techniques sur le module Apache mod_rewrite - Serveur Apache HTTP Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <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>
  20 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Rewrite</a></div><div id="page-content"><div id="preamble"><h1>Détails techniques sur le module Apache mod_rewrite</h1>
  25 <div class="toplang">
  26 <p><span>Langues Disponibles: </span><a href="../en/rewrite/tech.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  27 <a href="../fr/rewrite/tech.html" title="Français">&nbsp;fr&nbsp;</a></p>
  28 </div>
  29
  30 <p>Ce document passe en revue certains détails techniques à propos du
  31 module mod_rewrite et de la mise en correspondance des URLs</p>
  32 </div>
  33 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#InternalAPI">Phases de l'API</a></li>
  34 <li><img alt="" src="../images/down.gif" /> <a href="#InternalRuleset">Traitement du jeu de règles</a></li>
  35 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en
  36 correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Mise en cache</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li><li><a href="#comments_section">Commentaires</a></li></ul></div>
  37 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  38 <div class="section">
  39 <h2><a name="InternalAPI" id="InternalAPI">Phases de l'API</a></h2>
  40
  41       <p>Le traitement des requêtes par le serveur HTTP Apache se
  42       déroule en plusieurs phases. Au cours de chaque phase, un ou
  43       plusieurs modules peuvent être appelés pour traiter la partie
  44       concernée du cycle de vie de la requête. Les différentes phases
  45       peuvent consister en traduction d'URL en nom de fichier,
  46       authentification, autorisation, gestion de contenu ou journalisation (la
  47       liste n'est pas exhaustive).</p>
  48
  49     <p>mod_rewrite agit dans deux de ces phases (ou accroches - hooks -
  50     comme on les nomme souvent) pour la réécriture des URLs.</p>
  51
  52     <p>Tout d'abord, il utilise le hook traduction URL vers nom de
  53     fichier qui intervient après la lecture de la requête HTTP, mais
  54     avant le processus d'autorisation. Ensuite, il utilise le hook
  55     Fixup, qui intervient après les phases d'autorisation, après la
  56     lecture des fichiers de configuration de niveau répertoire (fichiers
  57     <code>.htaccess</code>), mais avant l'appel du gestionnaire de
  58     contenu.</p>
  59
  60     <p>Lorsqu'une requête arrive et une fois le serveur
  61     correspondant ou le serveur virtuel déterminé, le moteur de
  62     réécriture commence à traiter toute directive apparaissant dans la
  63     configuration de niveau serveur (autrement dit dans le
  64     fichier de configuration principal du serveur et les sections
  65     <code class="directive"><a href="../mod/core.html#virtualhost">&lt;Virtualhost&gt;</a></code>).
  66     Tout ce processus s'exécute au cours de la phase de traduction URL
  67     vers nom de fichier.</p>
  68
  69     <p>Quelques étapes plus loin, une fois les répertoires de données
  70     finaux trouvés, les directives de configuration de niveau répertoire
  71     (fichiers <code>.htaccess</code> et sections <code class="directive"><a href="../mod/core.html#directory">&lt;Directory&gt;</a></code>) sont appliquées. Ce processus
  72     s'exécute au cours de la phase Fixup.</p>
  73
  74     <p>Dans tous ces cas, mod_rewrite réécrit le
  75     <code>REQUEST_URI</code> soit vers une nouvelle URL, soit vers un
  76     nom de fichier.</p>
  77
  78     <p>Dans un contexte de niveau répertoire (autrement dit dans les
  79     fichiers <code>.htaccess</code> et les sections
  80     <code>Directory</code>), les règles de réécriture s'appliquent après
  81     la traduction de l'URL en nom de fichier. C'est pourquoi le chemin
  82     URL auquel mod_rewrite compare initialement les directives
  83     <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> est le
  84     chemin complet vers le nom de fichier traduit amputé de la partie
  85     répertoires (y compris le dernier slash).</p>
  86
  87     <p>Un exemple : si les règles se trouvent dans
  88     /var/www/foo/.htaccess et si une requête pour /foo/bar/baz est
  89     traité, une expression comme ^bar/baz$ correspondra.</p>
  90
  91     <p>Si une substitution intervient dans un contexte de répertoire,
  92     une nouvelle sous-requête interne est générée avec la nouvelle URL,
  93     ce qui relance le traitement des phases de la requête. Si la
  94     substitution est un chemin relatif, la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritebase">RewriteBase</a></code> détermine le chemin URL
  95     devant préfixer cette substitution. Dans un contexte de répertoire,
  96     il faut s'assurer de créer des règles qui
  97     n'effectueront pas de substitution au
  98     cours d'une passe ultérieure du processus de réécriture au niveau
  99     répertoire afin d'éviter les bouclages . Voir <a href="http://wiki.apache.org/httpd/RewriteLooping">Bouclage dans le
 100     processus de réécriture</a> pour une discussion plus détaillée à
 101     propos de ce problème.</p>
 102
 103     <p>En conséquence de cette manipulation de l'URL , vous devrez
 104     pensez à confectionner différemment vos règles de réécriture dans un
 105     contexte de niveau répertoire. En particulier, rappelez-vous que le
 106     chemin de répertoire sera absent de l'URL que vos règles de
 107     réécriture verront. Voici quelques exemples qui permettront de
 108     clarifier les choses :</p>
 109
 110     <table class="bordered">
 111
 112         <tr>
 113             <th>Position de la règle</th>
 114             <th>Règle</th>
 115         </tr>
 116
 117         <tr>
 118             <td>Section VirtualHost</td>
 119             <td>RewriteRule "^/images/(.+)\.jpg" "/images/$1.gif"</td>
 120         </tr>
 121
 122         <tr>
 123             <td>Fichier .htaccess à la racine des documents</td>
 124             <td>RewriteRule "^images/(.+)\.jpg" "images/$1.gif"</td>
 125         </tr>
 126
 127         <tr>
 128             <td>Fichier .htaccess dans le répertoire images</td>
 129             <td>RewriteRule "^(.+)\.jpg" "$1.gif"</td>
 130         </tr>
 131
 132     </table>
 133
 134     <p>Pour une étude plus approfondie de la manière dont mod_rewrite
 135     manipule les URLs dans les différents contextes, vous pouvez
 136     consulter les <a href="../mod/mod_rewrite.html#logging">entrées du
 137     journal</a> générées au cours du processus de réécriture.</p>
 138
 139 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 140 <div class="section">
 141 <h2><a name="InternalRuleset" id="InternalRuleset">Traitement du jeu de règles</a></h2>
 142
 143       <p>Maintenant, quand mod_rewrite se lance dans ces deux phases de
 144       l'API, il lit le jeu de règles configurées depuis la structure
 145       contenant sa configuration (qui a été elle-même créée soit au
 146       démarrage d'Apache pour le contexte du serveur, soit lors du
 147       parcours des répertoires par le noyau d'Apache pour le contexte de
 148       répertoire). Puis le moteur de réécriture est démarré avec le jeu
 149       de règles contenu (une ou plusieurs règles associées à leurs
 150       conditions). En lui-même, le mode opératoire du moteur de
 151       réécriture d'URLs est exactement le même dans les deux contextes
 152       de configuration. Seul le traitement du résultat final diffère.</p>
 153
 154       <p>L'ordre dans lequel les règles sont définies est important car
 155       le moteur de réécriture les traite selon une chronologie
 156       particulière (et pas très évidente). Le principe est le suivant :
 157       le moteur de réécriture traite les règles (les directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>) les unes
 158       à la suite des autres, et lorsqu'une règle s'applique, il parcourt
 159       les éventuelles conditions (directives
 160       <code>RewriteCond</code>directives) associées.
 161       Pour des raisons historiques, les
 162       conditions précèdent les règles, si bien que le déroulement du
 163       contrôle est un peu compliqué. Voir la figure 1 pour plus de
 164       détails.</p>
 165 <p class="figure">
 166       <img src="../images/rewrite_process_uri.png" alt="Flux des comparaisons des directives RewriteRule et RewriteCond" /><br />
 167       <dfn>Figure 1:</dfn>Déroulement du contrôle à travers le jeu de
 168       règles de réécriture
 169 </p>
 170       <p>L'URL est tout d'abord comparée au
 171       <em>Modèle</em> de chaque règle. Lorsqu'une règle ne s'applique
 172       pas, mod_rewrite stoppe immédiatement le traitement de cette règle
 173       et passe à la règle suivante. Si l'URL correspond au
 174       <em>Modèle</em>, mod_rewrite recherche la présence de conditions
 175       correspondantes (les directives Rewritecond apparaissant dans la
 176       configuration juste
 177       avant les règles de réécriture). S'il n'y en a pas, mod_rewrite remplace
 178       l'URL par une chaîne élaborée à partir de la chaîne de
 179       <em>Substitution</em>, puis passe à la règle suivante. Si des
 180       conditions sont présentes, mod_rewrite lance un bouclage
 181       secondaire afin de les traiter selon l'ordre dans lequel elles
 182       sont définies. La logique de traitement des conditions est
 183       différente : on ne compare pas l'URL à un modèle. Une chaîne de
 184       test <em>TestString</em> est tout d'abord élaborée en développant
 185       des variables, des références arrières, des recherches dans des
 186       tables de correspondances, etc..., puis cette chaîne de test est
 187       comparée au modèle de condition <em>CondPattern</em>. Si le modèle
 188       ne correspond pas, les autres conditions du jeu ne sont pas
 189       examinées et la règle correspondante ne s'applique pas. Si le
 190       modèle correspond, la condition suivante est examinée et ainsi de
 191       suite jusqu'à la dernière condition. Si toutes les conditions sont
 192       satisfaites, le traitement de la règle en cours se poursuit avec
 193       le remplacement de l'URL par la chaîne de <em>Substitution</em>.</p>
 194
 195 </div></div>
 196 <div class="bottomlang">
 197 <p><span>Langues Disponibles: </span><a href="../en/rewrite/tech.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 198 <a href="../fr/rewrite/tech.html" title="Français">&nbsp;fr&nbsp;</a></p>
 199 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 200 <script type="text/javascript"><!--//--><![CDATA[//><!--
 201 var comments_shortname = 'httpd';
 202 var comments_identifier = 'http://httpd.apache.org/docs/trunk/rewrite/tech.html';
 203 (function(w, d) {
 204     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 205         d.write('<div id="comments_thread"><\/div>');
 206         var s = d.createElement('script');
 207         s.type = 'text/javascript';
 208         s.async = true;
 209         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 210         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 211     }
 212     else {
 213         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 214     }
 215 })(window, document);
 216 //--><!]]></script></div><div id="footer">
 217 <p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 218 <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[//><!--
 219 if (typeof(prettyPrint) !== 'undefined') {
 220     prettyPrint();
 221 }
 222 //--><!]]></script>
 223 </body></html>