diff options
Diffstat (limited to 'docs/manual/rewrite')
22 files changed, 190 insertions, 185 deletions
diff --git a/docs/manual/rewrite/access.html.en b/docs/manual/rewrite/access.html.en index 05f6170b..e7528395 100644 --- a/docs/manual/rewrite/access.html.en +++ b/docs/manual/rewrite/access.html.en @@ -45,7 +45,7 @@ configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#blocking-of-robots">Blocking of Robots</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#host-deny">Denying Hosts in a Blacklist</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#referer-deflector">Referer-based Deflector</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="blocked-inline-images" id="blocked-inline-images">Forbidding Image "Hotlinking"</a></h2> @@ -280,12 +280,12 @@ RewriteRule "^" "${deflector:%{HTTP_REFERER}}" [R,L]</pre> we just wish to redirect back to where they came from, a "-" is placed in the map:</p> -<pre class="prettyprint lang-config">##<br /> -## deflector.map<br /> -##<br /> -<br /> -http://badguys.example.com/bad/index.html -<br /> -http://badguys.example.com/bad/index2.html -<br /> +<pre class="prettyprint lang-config">## +## deflector.map +## + +http://badguys.example.com/bad/index.html - +http://badguys.example.com/bad/index2.html - http://badguys.example.com/bad/index3.html http://somewhere.example.com/</pre> diff --git a/docs/manual/rewrite/access.html.fr b/docs/manual/rewrite/access.html.fr index e5c1389f..2663202a 100644 --- a/docs/manual/rewrite/access.html.fr +++ b/docs/manual/rewrite/access.html.fr @@ -46,7 +46,7 @@ copier/coller dans vos fichiers de configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#host-deny">Rejet des clients contenus dans une liste noire</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#referer-deflector">Aiguillage basé sur l'en-tête Referer</a></li> </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 -correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="blocked-inline-images" id="blocked-inline-images">Blocage du référencement à chaud (Hotlinking) d'images</a></h2> @@ -288,13 +288,13 @@ RewriteRule "^" "${deflector:%{HTTP_REFERER}}" [R,L]</pre> simplement rediriger les requêtes vers leur Referer, un "-" est inscrit dans le fichier de correspondances :</p> -<pre class="prettyprint lang-config">##<br /> -## deflector.map<br /> -##<br /> -<br /> -http://www.mauvais-gars.example.com/mauvais/index.html -<br /> -http://www.mauvais-gars.example.com/mauvais/index2.html -<br /> -http://www.mauvais-gars.example.com/mauvais/index3.html http://quelque-part.example.com/</pre> +<pre class="prettyprint lang-config">## +## deflector.map +## + +http://badguys.example.com/bad/index.html - +http://badguys.example.com/bad/index2.html - +http://badguys.example.com/bad/index3.html http://somewhere.example.com/</pre> </dd> diff --git a/docs/manual/rewrite/advanced.html.en b/docs/manual/rewrite/advanced.html.en index aed810af..360aea5b 100644 --- a/docs/manual/rewrite/advanced.html.en +++ b/docs/manual/rewrite/advanced.html.en @@ -45,7 +45,7 @@ configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#redirectanchors">Redirecting Anchors</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#time-dependent">Time-Dependent Rewriting</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#setenvvars">Set Environment Variables Based On URL Parts</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="sharding" id="sharding">URL-based sharding across multiple backends</a></h2> diff --git a/docs/manual/rewrite/advanced.html.fr b/docs/manual/rewrite/advanced.html.fr index 9a562d3e..3f630b4c 100644 --- a/docs/manual/rewrite/advanced.html.fr +++ b/docs/manual/rewrite/advanced.html.fr @@ -49,7 +49,7 @@ simplement les copier/coller dans votre configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#setenvvars">Définir des variables d'environnement en fonction de certaines parties de l'URL</a></li> </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en -correspondance</a></li><li><a href="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">serveurs virtuels</a></li><li><a href="proxy.html">serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +correspondance</a></li><li><a href="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">serveurs virtuels</a></li><li><a href="proxy.html">serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="sharding" id="sharding">Distribution de la charge entre plusieurs serveurs diff --git a/docs/manual/rewrite/avoid.html.en b/docs/manual/rewrite/avoid.html.en index 9cbdefec..b0f9cc84 100644 --- a/docs/manual/rewrite/avoid.html.en +++ b/docs/manual/rewrite/avoid.html.en @@ -58,7 +58,7 @@ files to work with, you may need to resort to <li><img alt="" src="../images/down.gif" /> <a href="#vhosts">Virtual Hosting</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#proxy">Simple Proxying</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#setenv">Environment Variable Testing</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="#comments_section">Comments</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="redirect" id="redirect">Simple Redirection</a></h2> diff --git a/docs/manual/rewrite/avoid.html.fr b/docs/manual/rewrite/avoid.html.fr index 4f87c63f..50bf33da 100644 --- a/docs/manual/rewrite/avoid.html.fr +++ b/docs/manual/rewrite/avoid.html.fr @@ -60,7 +60,7 @@ vous tourner vers <code class="module"><a href="../mod/mod_rewrite.html">mod_rew <li><img alt="" src="../images/down.gif" /> <a href="#proxy">Mandat simple</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#setenv">Test de variables d'environnement</a></li> </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 -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">Serveurs mandataires</a></li><li><a href="rewritemap.html">Utilisation de RewriteMap</a></li><li><a href="advanced.html">Techniques avancées</a></li></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +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">Serveurs mandataires</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="#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="redirect" id="redirect">Redirection simple</a></h2> diff --git a/docs/manual/rewrite/flags.html.en b/docs/manual/rewrite/flags.html.en index d48dde14..450e10e1 100644 --- a/docs/manual/rewrite/flags.html.en +++ b/docs/manual/rewrite/flags.html.en @@ -54,7 +54,7 @@ providing detailed explanations and examples.</p> <li><img alt="" src="../images/down.gif" /> <a href="#flag_r">R|redirect</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#flag_s">S|skip</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#flag_t">T|type</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2> diff --git a/docs/manual/rewrite/flags.html.fr b/docs/manual/rewrite/flags.html.fr index 4aa98d0d..e44696ae 100644 --- a/docs/manual/rewrite/flags.html.fr +++ b/docs/manual/rewrite/flags.html.fr @@ -55,7 +55,7 @@ des explications détaillées et des exemples.</p> <li><img alt="" src="../images/down.gif" /> <a href="#flag_s">S|skip</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#flag_t">T|type</a></li> </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection and remise en -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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="introduction" id="introduction">Introduction</a></h2> diff --git a/docs/manual/rewrite/htaccess.html.en b/docs/manual/rewrite/htaccess.html.en index 9e010ebc..cd9a8056 100644 --- a/docs/manual/rewrite/htaccess.html.en +++ b/docs/manual/rewrite/htaccess.html.en @@ -34,7 +34,7 @@ the way that the rules change when you use mod_rewrite in .htaccess files, and how to deal with these changes.</p> </div> -<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</a></li></ul></div> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../en/rewrite/htaccess.html" title="English"> en </a> | diff --git a/docs/manual/rewrite/htaccess.html.fr b/docs/manual/rewrite/htaccess.html.fr index a1ff81a0..ea72a62c 100644 --- a/docs/manual/rewrite/htaccess.html.fr +++ b/docs/manual/rewrite/htaccess.html.fr @@ -35,7 +35,7 @@ travailler avec ces changements.</p> </div> <div id="quickview"><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 -correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +correspondance</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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> </div> <div class="bottomlang"> <p><span>Langues Disponibles: </span><a href="../en/rewrite/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> | diff --git a/docs/manual/rewrite/intro.html.en b/docs/manual/rewrite/intro.html.en index b3518373..38ab4762 100644 --- a/docs/manual/rewrite/intro.html.en +++ b/docs/manual/rewrite/intro.html.en @@ -41,7 +41,7 @@ but this doc should help the beginner get their feet wet. <li><img alt="" src="../images/down.gif" /> <a href="#rewritecond">Rewrite Conditions</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rewritemap">Rewrite maps</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#htaccess">.htaccess files</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2> diff --git a/docs/manual/rewrite/intro.html.fr b/docs/manual/rewrite/intro.html.fr index 4b1363af..a2470375 100644 --- a/docs/manual/rewrite/intro.html.fr +++ b/docs/manual/rewrite/intro.html.fr @@ -44,7 +44,7 @@ pieds. <li><img alt="" src="../images/down.gif" /> <a href="#htaccess">Fichiers .htaccess</a></li> </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="remapping.html">Redirection and remise en -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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="introduction" id="introduction">Introduction</a></h2> diff --git a/docs/manual/rewrite/proxy.html.en b/docs/manual/rewrite/proxy.html.en index e70cb1c1..c07b8c11 100644 --- a/docs/manual/rewrite/proxy.html.en +++ b/docs/manual/rewrite/proxy.html.en @@ -34,7 +34,7 @@ how to use the RewriteRule's [P] flag to proxy content to another server. A number of recipes are provided that describe common scenarios.</p> </div> -<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +<div id="quickview"><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="dynamic-proxy" id="dynamic-proxy">Proxying Content with mod_rewrite</a></h2> diff --git a/docs/manual/rewrite/proxy.html.fr b/docs/manual/rewrite/proxy.html.fr index f38b32c5..d055a021 100644 --- a/docs/manual/rewrite/proxy.html.fr +++ b/docs/manual/rewrite/proxy.html.fr @@ -36,7 +36,7 @@ fournies.</p> </div> <div id="quickview"><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en -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="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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +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="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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="dynamic-proxy" id="dynamic-proxy">Mandater du contenu avec mod_rewrite</a></h2> diff --git a/docs/manual/rewrite/remapping.html.en b/docs/manual/rewrite/remapping.html.en index 26edf44b..6900cd91 100644 --- a/docs/manual/rewrite/remapping.html.en +++ b/docs/manual/rewrite/remapping.html.en @@ -53,7 +53,7 @@ configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Moved <code>DocumentRoot</code></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Fallback Resource</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rewrite-query">Rewrite query string</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="old-to-new" id="old-to-new">From Old to New (internal)</a></h2> diff --git a/docs/manual/rewrite/remapping.html.fr b/docs/manual/rewrite/remapping.html.fr index cb26eb92..21c72d41 100644 --- a/docs/manual/rewrite/remapping.html.fr +++ b/docs/manual/rewrite/remapping.html.fr @@ -55,7 +55,7 @@ copier/coller dans vos fichiers de configuration.</div> <li><img alt="" src="../images/down.gif" /> <a href="#moveddocroot">Déplacement du répertoire <code>DocumentRoot</code></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#fallback-resource">Ressource par défaut</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rewrite-query">Rewrite query string</a></li> -</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="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +</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="access.html">Contrôler l'accès</a></li><li><a href="vhosts.html">Serveurs virtuels</a></li><li><a href="proxy.html">Serveurs mandataires</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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="old-to-new" id="old-to-new">De l'ancienne à la nouvelle URL (en interne)</a></h2> diff --git a/docs/manual/rewrite/rewritemap.html.en b/docs/manual/rewrite/rewritemap.html.en index 5b13bbc7..6281dbda 100644 --- a/docs/manual/rewrite/rewritemap.html.en +++ b/docs/manual/rewrite/rewritemap.html.en @@ -31,7 +31,7 @@ <p>This document supplements the <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> <a href="../mod/mod_rewrite.html">reference documentation</a>. It describes the use of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive, -and provides examples of each of the various <code>RewriteMap</code> types.</p> +and provides examples of each of the various <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> types.</p> <div class="warning">Note that many of these examples won't work unchanged in your particular server configuration, so it's important that you understand @@ -40,14 +40,14 @@ configuration.</div> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Internal Function</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: Plain text maps</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Randomized Plain Text</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: DBM Hash File</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Internal Function</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: External Rewriting Program</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd or fastdbd: SQL Query</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#summary">Summary</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="introduction" id="introduction">Introduction</a></h2> @@ -64,8 +64,8 @@ configuration.</div> the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> reference documentation.</p> - <p>The syntax of the <code>RewriteMap</code> directive is as - follows:</p> + <p>The syntax of the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> + directive is as follows:</p> <pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em> </pre> @@ -91,13 +91,13 @@ configuration.</div> substituted by <em>DefaultValue</em> or by the empty string if no <em>DefaultValue</em> was specified.</p> - <p>For example, you might define a - <code class="directive">RewriteMap</code> as:</p> + <p>For example, you can define a + <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> as:</p> <pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre> <p>You would then be able to use this map in a - <code class="directive">RewriteRule</code> as follows:</p> -<pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre> + <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> as follows:</p> + <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre> <p>A default value can be specified in the event that nothing is found @@ -108,41 +108,85 @@ in the map:</p> <div class="note"><h3>Per-directory and .htaccess context</h3> <p> -The <code>RewriteMap</code> directive may not be used in -<Directory> sections or <code>.htaccess</code> files. You must +The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive may not be +used in <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> sections or +<code>.htaccess</code> files. You must declare the map in server or virtualhost context. You may use the map, -once created, in your <code>RewriteRule</code> and -<code>RewriteCond</code> directives in those scopes. You just can't -<strong>declare</strong> it in those scopes. -</p> +once created, in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> and +<code class="directive"><a href="../mod/mod_rewrite.html#rewritecond">RewriteCond</a></code> directives in those +scopes. You just can't <strong>declare</strong> it in those scopes.</p> </div> <p>The sections that follow describe the various <em>MapType</em>s that may be used, and give examples of each.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> +<h2><a name="int" id="int">int: Internal Function</a></h2> + + + <p>When a MapType of <code>int</code> is used, the MapSource is one + of the available internal <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> + functions. Module authors can provide + additional internal functions by registering them with the + <code>ap_register_rewrite_mapfunc</code> API. + The functions that are provided by default are: + </p> + + <ul> + <li><strong>toupper</strong>:<br /> + Converts the key to all upper case.</li> + <li><strong>tolower</strong>:<br /> + Converts the key to all lower case.</li> + <li><strong>escape</strong>:<br /> + Translates special characters in the key to + hex-encodings.</li> + <li><strong>unescape</strong>:<br /> + Translates hex-encodings in the key back to + special characters.</li> + </ul> + + <p> + To use one of these functions, create a <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> referencing + the int function, and then use that in your <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>: + </p> + + <p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p> + <pre class="prettyprint lang-config">RewriteMap lc int:tolower +RewriteRule "(.*)" "${lc:$1}" [R]</pre> + + + <div class="note"> + <p>Please note that the example offered here is for + illustration purposes only, and is not a recommendation. If you want + to make URLs case-insensitive, consider using + <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> instead. + </p> + </div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> <h2><a name="txt" id="txt">txt: Plain text maps</a></h2> <p>When a MapType of <code>txt</code> is used, the MapSource is a filesystem path to a - plain-text mapping file, containing space-separated key/value pair - per line. Optionally, a line may be contain a comment, starting with + plain-text mapping file, containing one space-separated key/value pair + per line. Optionally, a line may contain a comment, starting with a '#' character.</p> - <p>For example, the following might be valid entries in a map - file.</p> + <p>A valid text rewrite map file will have the following syntax:</p> - <p class="indent"> + <div class="example"><p><code> # Comment line<br /> <strong><em>MatchingKey</em> <em>SubstValue</em></strong><br /> <strong><em>MatchingKey</em> <em>SubstValue</em></strong> # comment<br /> - </p> + </code></p></div> - <p>When the RewriteMap is invoked the argument is looked for in the + <p>When the <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> is invoked + the argument is looked for in the first argument of a line, and, if found, the substitution value is returned.</p> - <p>For example, we might use a mapfile to translate product names to + <p>For example, we can use a mapfile to translate product names to product IDs for easier-to-remember URLs, using the following recipe:</p> <p><strong>Product to ID configuration</strong></p> @@ -170,7 +214,8 @@ telephone 328 </code></p></div> <p>Thus, when <code>http://example.com/product/television</code> is - requested, the <code>RewriteRule</code> is applied, and the request + requested, the <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> is + applied, and the request is internally mapped to <code>/prods.php?id=993</code>.</p> <div class="note"><h3>Note: .htaccess files</h3> @@ -202,7 +247,7 @@ telephone 328 One of these values will be chosen at random if the key is matched.</p> - <p>For example, you might use the following map + <p>For example, you can use the following map file and directives to provide a random load balancing between several back-end servers, via a reverse-proxy. Images are sent to one of the servers in the 'static' pool, while everything @@ -219,15 +264,15 @@ dynamic www5|www6 <p><strong>Configuration directives</strong></p> <pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt" -RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L] -RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre> +RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L] +RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre> <p>So, when an image is requested and the first of these rules is - matched, <code>RewriteMap</code> looks up the string + matched, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> looks up the string <code>static</code> in the map file, which returns one of the specified hostnames at random, which is then used in the - <code>RewriteRule</code> target.</p> + <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> target.</p> <p>If you wanted to have one of the servers more likely to be chosen (for example, if one of the server has more memory than the others, @@ -255,7 +300,8 @@ static www1|www1|www2|www3|www4 <pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre> - <p>The type can be sdbm, gdbm, ndbm or db. + <p>The type can be <code>sdbm</code>, <code>gdbm</code>, <code>ndbm</code> + or <code>db</code>. However, it is recommended that you just use the <a href="../programs/httxt2dbm.html">httxt2dbm</a> utility that is provided with Apache HTTP Server, as it will use the correct DBM library, matching the one that was used when httpd itself was built.</p> @@ -269,7 +315,7 @@ $ httxt2dbm -i mapfile.txt -o mapfile.map </code></p></div> <p>You can then reference the resulting file in your -<code>RewriteMap</code> directive:</p> +<code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive:</p> <pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre> @@ -279,7 +325,7 @@ $ httxt2dbm -i mapfile.txt -o mapfile.map a common base name. For example, you may have two files named <code>mapfile.map.dir</code> and <code>mapfiile.map.pag</code>. This is normal, and you need only use the base name <code>mapfile.map</code> in -your <code>RewriteMap</code> directive.</p> +your <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive.</p> </div> <div class="note"><h3>Cached lookups</h3> @@ -293,49 +339,6 @@ by many requests. </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="int" id="int">int: Internal Function</a></h2> - - - <p>When a MapType of <code>int</code> is used, the MapSource is one - of the available internal RewriteMap functions. Module authors can provide - additional internal functions by registering them with the - <code>ap_register_rewrite_mapfunc</code> API. - The functions that are provided by default are: - </p> - - <ul> - <li><strong>toupper</strong>:<br /> - Converts the key to all upper case.</li> - <li><strong>tolower</strong>:<br /> - Converts the key to all lower case.</li> - <li><strong>escape</strong>:<br /> - Translates special characters in the key to - hex-encodings.</li> - <li><strong>unescape</strong>:<br /> - Translates hex-encodings in the key back to - special characters.</li> - </ul> - - <p> - To use one of these functions, create a <code>RewriteMap</code> referencing - the int function, and then use that in your <code>RewriteRule</code>: - </p> - - <p> <strong>Redirect a URI to an all-lowercase version of itself</strong></p> - <pre class="prettyprint lang-config">RewriteMap lc int:tolower -RewriteRule "(.*)" "${lc:$1}" [R]</pre> - - - <div class="note"> - <p>Please note that the example offered here is for - illustration purposes only, and is not a recommendation. If you want - to make URLs case-insensitive, consider using - <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code> instead. - </p> - </div> - - </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"> <h2><a name="prg" id="prg">prg: External Rewriting Program</a></h2> <p>When a MapType of <code>prg</code> is used, the MapSource is a @@ -363,9 +366,9 @@ RewriteRule "(.*)" "${lc:$1}" [R]</pre> <p>A simple example is shown here which will replace all dashes with underscores in a request URI.</p> - -<p><strong>Rewrite configuration</strong></p> - <pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl"<br /> + + <p><strong>Rewrite configuration</strong></p> + <pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl" RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre> @@ -416,9 +419,9 @@ this process, or if the script itself is very slow.</li> restarted.</p> <p>If a query returns more than one row, a random row from -the result set is used.</p> + the result set is used.</p> - <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RewriteMap myquery "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre> + <div class="example"><h3>Example</h3><pre class="prettyprint lang-config">RewriteMap myquery "fastdbd:SELECT destination FROM rewrite WHERE source = %s"</pre> </div> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> @@ -426,15 +429,15 @@ the result set is used.</p> <h2><a name="summary" id="summary">Summary</a></h2> - <p>The <code class="directive">RewriteMap</code> directive can occur more than - once. For each mapping-function use one - <code class="directive">RewriteMap</code> directive to declare its rewriting - mapfile.</p> + <p>The <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive can + occur more than once. For each mapping-function use one + <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> directive to declare + its rewriting mapfile.</p> <p>While you cannot <strong>declare</strong> a map in per-directory context (<code>.htaccess</code> files or - <Directory> blocks) it is possible to - <strong>use</strong> this map in per-directory context. </p> + <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> blocks) it is + possible to <strong>use</strong> this map in per-directory context.</p> </div></div> <div class="bottomlang"> diff --git a/docs/manual/rewrite/rewritemap.html.fr b/docs/manual/rewrite/rewritemap.html.fr index f14c7f38..91e9ffa0 100644 --- a/docs/manual/rewrite/rewritemap.html.fr +++ b/docs/manual/rewrite/rewritemap.html.fr @@ -32,7 +32,7 @@ module <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Il décrit l'utilisation de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>, et fournit des exemples pour chacun des différents types de - <code>RewriteMap</code>.</p> + <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> <div class="warning">Notez que la plupart de ces exemples ne fonctionneront pas en l'état dans le contexte de votre configuration @@ -42,17 +42,17 @@ </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#introduction">Introduction</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Fonction interne</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#txt">txt: tables de correspondances au format texte</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#rnd">rnd: Fichier texte à valeurs de substitution multiples choisies de manière aléatoire</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#dbm">dbm: Fichier condensé DBM</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#int">int: Fonction interne</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#prg">prg: Programme de réécriture externe</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#dbd">dbd ou fastdbd: requête SQL</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#summary">Résumé</a></li> </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 - 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="advanced.html">Techniques avancées</a></li><li><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> + 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="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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="introduction" id="introduction">Introduction</a></h2> @@ -69,7 +69,7 @@ données, ceux-ci étant par ailleurs énumérés dans la documentation de référence de <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> - <p>La syntaxe de la directive <code>RewriteMap</code> est la suivante + <p>La syntaxe de la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> est la suivante :</p> <pre class="prettyprint lang-config">RewriteMap <em>MapName</em> <em>MapType</em>:<em>MapSource</em></pre> @@ -99,11 +99,11 @@ vide si aucune <em>DefaultValue</em> n'a été spécifiée.</p> <p>Par exemple, vous pouvez définir une directive - <code class="directive">RewriteMap</code> comme suit :</p> + <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> comme suit :</p> <pre class="prettyprint lang-config">RewriteMap examplemap "txt:/path/to/file/map.txt"</pre> <p>Vous pourrez par la suite utiliser cette table de correspondances - dans une directive <code class="directive">RewriteRule</code> comme suit :</p> + dans une directive <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> comme suit :</p> <pre class="prettyprint lang-config">RewriteRule "^/ex/(.*)" "${examplemap:$1}"</pre> @@ -115,8 +115,8 @@ si la recherche dans la table de correspondances est infructueuse :</p> <div class="note"><h3>Contexte de répertoire et fichiers.htaccess</h3> <p> -Vous ne pouvez utiliser la directive <code>RewriteMap</code> ni dans -les sections <Directory>, ni dans les fichiers +Vous ne pouvez utiliser la directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> ni dans +les sections <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, ni dans les fichiers <code>.htaccess</code>. Vous devez déclarer la table de correspondances au niveau du serveur principal ou dans un contexte de serveur virtuel. En revanche, si vous ne pouvez pas déclarer la table dans une section @@ -131,6 +131,50 @@ correspondances <em>type-map</em> disponibles, et fournissent des exemples pour chacun d'entre eux.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> +<h2><a name="int" id="int">int: Fonction interne</a></h2> + + + <p>Lorsque le type-map <code>int</code> est spécifié, la source est + une des fonctions RewriteMap internes disponibles. Les développeurs + de modules peuvent fournir des fonctions internes supplémentaires en + les enregistrant via l'API <code>ap_register_rewrite_mapfunc</code>. + Les fonctions fournies par défaut sont : + </p> + + <ul> + <li><strong>toupper</strong>:<br /> + Met tous les caractères de la clé en majuscules.</li> + <li><strong>tolower</strong>:<br /> + Met tous les caractères de la clé en minuscules.</li> + <li><strong>escape</strong>:<br /> + Protège les caractères spéciaux de la clé en les + transformant en leur code hexadécimal.</li> + <li><strong>unescape</strong>:<br /> + Retraduit les codes hexadécimaux de la clé en caractères + spéciaux.</li> + </ul> + + <p> + Pour utiliser une de ces fonctions, créez une + <code>RewriteMap</code> faisant référence à cette fonction int, et + utilisez-la dans votre règle <code>RewriteRule</code> : + </p> + + <p> <strong>Redirige un URI vers son équivalent en minuscules</strong></p> + <pre class="prettyprint lang-config">RewriteMap lc int:tolower +RewriteRule "(.*)" "${lc:$1}" [R]</pre> + + + <div class="note"> + <p>Notez que cet exemple n'est fourni qu'à titre d'illustration, + et ne constitue en aucun cas une recommandation. Si vous voulez + rendre des URLs insensibles à la casse, vous devez plutôt vous + tourner vers <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code>. + </p> + </div> + + </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="section"> <h2><a name="txt" id="txt">txt: tables de correspondances au format texte</a></h2> @@ -144,11 +188,11 @@ exemples pour chacun d'entre eux.</p> <p>Voici un exemple d'entrées valides dans un fichier de correspondances :</p> - <p class="indent"> + <div class="example"><p><code> # Ligne de commentaires<br /> <strong><em>clé</em> <em>valeur-substitution</em></strong><br /> <strong><em>clé</em> <em>valeur-substitution</em></strong> # commentaire<br /> - </p> + </code></p></div> <p>Lorsque la table de correspondance fait l'objet d'une recherche, la valeur spécifiée est recherchée dans le premier champ, et si elle @@ -185,8 +229,9 @@ TELEPHONE 328 </code></p></div> <p>Ainsi, lorsqu'une requête pour - <code>http://example.com/produit/TELEVISION</code> arrive, elle est - transformée en interne en <code>/prods.php?id=993</code>.</p> + <code>http://example.com/produit/TELEVISION</code> arrive, la directive + <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> s'applique, et la + requête est transformée en interne en <code>/prods.php?id=993</code>.</p> <div class="note"><h3>Note: fichiers .htaccess</h3> L'exemple donné est conçu pour être utilisé dans un contexte de @@ -240,16 +285,16 @@ dynamique www5|www6 <pre class="prettyprint lang-config">RewriteMap servers "rnd:/path/to/file/map.txt" RewriteRule "^/(.*\.(png|gif|jpg))" "http://${servers:static}/$1" [NC,P,L] -RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre> +RewriteRule "^/(.*)" "http://${servers:dynamic}/$1" [P,L]</pre> <p>Ainsi, lorsqu'une image est demandée et que la première règle - convient, <code>RewriteMap</code> recherche la chaîne + convient, <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> recherche la chaîne <code>statique</code> dans le fichier de correspondances qui renvoie un des noms de serveurs spécifiés de manière aléatoire, ce dernier étant utilisé dans la cible de la règle - <code>RewriteRule</code>.</p> + <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>.</p> <p>Si vous voulez qu'un des serveurs soit plus souvent sollicité que les autres (par exemple s'il possède plus de mémoire, et peut donc @@ -278,7 +323,8 @@ statique www1|www1|www2|www3|www4 <pre class="prettyprint lang-config">RewriteMap examplemap "dbm=sdbm:/etc/apache/mapfile.dbm"</pre> - <p>Ce type peut être choisi parmi sdbm, gdbm, ndbm ou db. Il est + <p>Ce type peut être choisi parmi <code>sdbm</code>, <code>gdbm</code>, + <code>ndbm</code> ou <code>db</code>. Il est cependant recommandé d'utiliser l'utilitaire <a href="../programs/httxt2dbm.html">httxt2dbm</a> fourni avec le serveur HTTP Apache, car il utilise la bibliothèque DBM appropriée, à savoir celle qui a été utilisée lors de la compilation de httpd.</p> @@ -292,7 +338,7 @@ $ httxt2dbm -i fichier-map.txt -o fichier-map.map </code></p></div> <p>Vous pouvez alors faire référence au fichier obtenu dans votre -directive <code>RewriteMap</code> :</p> +directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> :</p> <pre class="prettyprint lang-config">RewriteMap mapname "dbm:/etc/apache/mapfile.map"</pre> @@ -302,7 +348,7 @@ même nom de base sont créés. Par exemple, vous pouvez obtenir deux fichiers nommés <code>fichier-map.map.dir</code> et <code>fichier-map.map.pag</code>. Ceci est tout à fait normal, et vous ne devez utiliser que le nom de base <code>fichier-map.map</code> dans votre -directive <code>RewriteMap</code>.</p> +directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>.</p> </div> <div class="note"><h3>Mise en cache des recherches</h3> @@ -317,50 +363,6 @@ directive <code>RewriteMap</code>.</p> </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> -<h2><a name="int" id="int">int: Fonction interne</a></h2> - - - <p>Lorsque le type-map <code>int</code> est spécifié, la source est - une des fonctions RewriteMap internes disponibles. Les développeurs - de modules peuvent fournir des fonctions internes supplémentaires en - les enregistrant via l'API <code>ap_register_rewrite_mapfunc</code>. - Les fonctions fournies par défaut sont : - </p> - - <ul> - <li><strong>toupper</strong>:<br /> - Met tous les caractères de la clé en majuscules.</li> - <li><strong>tolower</strong>:<br /> - Met tous les caractères de la clé en minuscules.</li> - <li><strong>escape</strong>:<br /> - Protège les caractères spéciaux de la clé en les - transformant en leur code hexadécimal.</li> - <li><strong>unescape</strong>:<br /> - Retraduit les codes hexadécimaux de la clé en caractères - spéciaux.</li> - </ul> - - <p> - Pour utiliser une de ces fonctions, créez une - <code>RewriteMap</code> faisant référence à cette fonction int, et - utilisez-la dans votre règle <code>RewriteRule</code> : - </p> - - <p> <strong>Redirige un URI vers son équivalent en minuscules</strong></p> - <pre class="prettyprint lang-config">RewriteMap lc int:tolower -RewriteRule "(.*)" "${lc:$1}" [R]</pre> - - - <div class="note"> - <p>Notez que cet exemple n'est fourni qu'à titre d'illustration, - et ne constitue en aucun cas une recommandation. Si vous voulez - rendre des URLs insensibles à la casse, vous devez plutôt vous - tourner vers <code class="module"><a href="../mod/mod_speling.html">mod_speling</a></code>. - </p> - </div> - - </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="section"> <h2><a name="prg" id="prg">prg: Programme de réécriture externe</a></h2> <p>Lorque le type-map <code>prg</code> est spécifié, la source est @@ -392,7 +394,7 @@ RewriteRule "(.*)" "${lc:$1}" [R]</pre> caractères de soulignement dans l'URI de la requête.</p> <p><strong>Configuration de la réécriture</strong></p> - <pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl"<br /> + <pre class="prettyprint lang-config">RewriteMap d2u "prg:/www/bin/dash2under.pl" RewriteRule "-" "${d2u:%{REQUEST_URI}}"</pre> @@ -457,14 +459,14 @@ script lui-même est très lent.</li> <h2><a name="summary" id="summary">Résumé</a></h2> - <p>La directive <code class="directive">RewriteMap</code> peut apparaître + <p>La directive <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> peut apparaître plusieurs fois. Utilisez une directive - <code class="directive">RewriteMap</code> pour chaque fonction de mise en + <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code> pour chaque fonction de mise en correspondance pour déclarer son fichier de correspondances.</p> <p>Bien que l'on ne puisse pas <strong>déclarer</strong> de fonction de mise en correspondance dans un contexte de répertoire (fichier - <code>.htaccess</code> ou section <Directory>), il est + <code>.htaccess</code> ou section <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>), il est possible d'utiliser cette fonction dans un tel contexte.</p> </div></div> diff --git a/docs/manual/rewrite/tech.html.en b/docs/manual/rewrite/tech.html.en index ebfa2c95..13363ad8 100644 --- a/docs/manual/rewrite/tech.html.en +++ b/docs/manual/rewrite/tech.html.en @@ -32,7 +32,7 @@ and URL matching.</p> </div> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#InternalAPI">API Phases</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#InternalRuleset">Ruleset Processing</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="vhosts.html">Virtual hosts</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">Using RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="InternalAPI" id="InternalAPI">API Phases</a></h2> diff --git a/docs/manual/rewrite/tech.html.fr b/docs/manual/rewrite/tech.html.fr index c5be8bbe..3c30d462 100644 --- a/docs/manual/rewrite/tech.html.fr +++ b/docs/manual/rewrite/tech.html.fr @@ -33,7 +33,7 @@ module mod_rewrite et de la mise en correspondance des URLs</p> <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#InternalAPI">Phases de l'API</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#InternalRuleset">Traitement du jeu de règles</a></li> </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 -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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="InternalAPI" id="InternalAPI">Phases de l'API</a></h2> diff --git a/docs/manual/rewrite/vhosts.html.en b/docs/manual/rewrite/vhosts.html.en index 63ffb067..7ddd5fdb 100644 --- a/docs/manual/rewrite/vhosts.html.en +++ b/docs/manual/rewrite/vhosts.html.en @@ -43,7 +43,7 @@ mod_rewrite</a> document.</div> <li><img alt="" src="../images/down.gif" /> <a href="#simple.rewrite">Dynamic Virtual Hosts Using <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code></a></li> <li><img alt="" src="../images/down.gif" /> <a href="#xtra-conf">Using a Separate Virtual Host Configuration File</a></li> -</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li></ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div> +</ul><h3>See also</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Module documentation</a></li><li><a href="intro.html">mod_rewrite introduction</a></li><li><a href="remapping.html">Redirection and remapping</a></li><li><a href="access.html">Controlling access</a></li><li><a href="proxy.html">Proxying</a></li><li><a href="rewritemap.html">RewriteMap</a></li><li><a href="advanced.html">Advanced techniques</a></li><li><a href="avoid.html">When not to use mod_rewrite</a></li><li><a href="#comments_section">Comments</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="per-hostname" id="per-hostname">Virtual Hosts For Arbitrary Hostnames</a></h2> diff --git a/docs/manual/rewrite/vhosts.html.fr b/docs/manual/rewrite/vhosts.html.fr index 027f0d03..0db4a38a 100644 --- a/docs/manual/rewrite/vhosts.html.fr +++ b/docs/manual/rewrite/vhosts.html.fr @@ -47,7 +47,7 @@ virtuels via <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite< <li><img alt="" src="../images/down.gif" /> <a href="#xtra-conf">Utilisation d'un fichier de configuration du serveur virtuel séparé</a></li> </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="../mod/mod_rewrite.html">Documentation du module</a></li><li><a href="intro.html">Introduction à mod_rewrite</a></li><li><a href="remapping.html">Redirection et remise en -correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="proxy.html">Serveurs mandataires</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></ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> +correspondance</a></li><li><a href="access.html">Contrôle d'accès</a></li><li><a href="proxy.html">Serveurs mandataires</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> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="section"> <h2><a name="per-hostname" id="per-hostname">Serveurs virtuels pour des noms d'hôtes arbitraires</a></h2> |