<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1906518:1933541 (outdated) -->
+<!-- English Revision: 1933541 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
contrôler la quantité de mémoire partagée allouée pour le stockage
des données heartbeat lorsqu'on utilise
<module>mod_slotmem_shm</module>.</p>
- <p>Pour utiliser un stockage de type fichier bidimensionnel (flat-file)
- lorque le module <module>mod_slotmem_shm</module> n'est pas chargé, cette
- directive doit être définie à 0. La valeur doit être soit égale à 0, soit
- supérieure ou égale à 10.</p>
+ <p>Définissez cette directive à <code>0</code> pour utiliser un stockage de
+ type fichier bidimensionnel (flat-file) au lieu de la mémoire partagée
+ (c’est-à-dire sans charger <module>mod_slotmem_shm</module>). Lorsqu’on
+ utilise la mémoire partagée, la valeur doit être supérieure ou égale à 10.</p>
</usage>
</directivesynopsis>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1932808:1934652 (outdated) -->
+<!-- English Revision: 1934652 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<example><title>Exemple</title>
<highlight language="config">
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\""
-TransferLog logs/access_log
+TransferLog "logs/access_log"
</highlight>
</example>
</usage>
<directivesynopsis>
<name>GlobalLog</name>
<description>Définit le nom et le format du fichier journal</description>
-<syntax>GlobalLog<var>file</var>|<var>pipe</var>
+<syntax>GlobalLog <var>file</var>|<var>pipe</var>
<var>format</var>|<var>nickname</var>
[env=[!]<var>environment-variable</var>|
expr=<var>expression</var>]</syntax>
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1932665:1933511 (outdated) -->
+<!-- English Revision: 1933511 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
<li>Les temps des machines sont synchronisés via NTP ou tout autre
protocole de synchronisation du temps en réseau.</li>
- <li>Les nom d'hôtes des machines sont tous différents, de façon à
- ce que le module puisse recevoir une adresse IP différente pour
- chaque machine du cluster en effectuant une recherche sur le nom
- d'hôte.</li>
</ul>
+ <note><title>Changements à partir de la version 2.4.29</title>
+ <p>Dans les versions précédentes, l’unicité nécessitait aussi que chaque
+ machine ait une adresse IP distincte. Depuis la version 2.4.29, le module
+ utilise un générateur de nombres pseudo-aléatoires cryptographique (PRNG)
+ ensemencé au démarrage, tout en supprimant l’adresse IP et le PID de
+ l’identifiant et en ne nécessitant plus de noms d’hôte distincts ou de
+ délai au démarrage.</p></note>
+
<p>Au vu des caractéristiques actuelles du système d'exploitation,
nous supposerons que les pids (identifiants processus) sont codés
sur 32 bits. Si le système d'exploitation utilise plus de 32 bits
pour un pid, la correction est triviale mais doit être effectuée
dans le code.</p>
- <p>Ces hypothèses posées, à un instant donné, nous pouvons
- distinguer tout processus httpd sur toute machine du cluster de tous
- les autres processus httpd. Pour ce faire, il suffit d'utiliser
- l'adresse IP de la machine et le pid du processus httpd. Un
- processus httpd peut traiter plusieurs requêtes simultanément si
- vous utilisez un module MPM multi-threadé. Pour identifier les
- threads, Apache httpd utilise en interne un index de threads. Ainsi,
- afin de générer des identifiants uniques pour chaque requête, il
- suffit d'effectuer une distinction en fonction du temps.</p>
+ <p>Ces hypothèses posées, à un instant donné, nous pouvons distinguer tout
+ processus httpd sur toute machine du cluster de tous les autres processus
+ httpd. La valeur racine générée par PRNG et l’index des threads permettent
+ d’accomplir cette tâche. Un processus httpd peut traiter plusieurs requêtes
+ simultanément si vous utilisez un module MPM multi-threadé. Pour identifier
+ les threads, Apache httpd utilise en interne un index de threads. Ainsi,
+ afin de générer des identifiants uniques pour chaque requête, il suffit
+ d'effectuer une distinction en fonction du temps.</p>
<p>Pour déterminer le temps, nous utiliserons un repère de temps
Unix (les secondes écoulées depuis le 1er janvier 1970 UTC), et un
redémarrage.</p>
<!-- FIXME: thread_index is unsigned int, so not always 32bit.-->
- <p>La variable d'environnement <code>UNIQUE_ID</code> est construite par
- codage du quadruplet de 144 bits (adresse IP sur 32 bits, pid sur 32 bits,
- repère de temps sur 32 bits, compteur 16 bits et index de threads sur
- 32 bits) en utilisant l'alphabet <code>[A-Za-z0-9_-]</code>
- (<code>[A-Za-z0-9@-]</code>) avant la version 2.4.47) d'une manière
- similaire à celle du codage MIME base64, et sa valeur se
- présente sous la forme d'une chaîne de 24 caractères.
- L'alphabet MIME base64 est en fait <code>[A-Za-z0-9+/]</code> ; cependant,
- les caractères <code>+</code> et <code>/</code> nécessitent un
- codage particulier dans les URLs, ce qui rend leur utilisation peu commode.
- Toutes les valeurs sont codées dans l'ordre des octets d'une adresse
- réseau de façon à ce que le codage soit comparable
- entre des architectures où l'ordre des octets est différent.
- L'ordre réel de codage est : repère de temps, adresse IP, pid,
- compteur. Cet ordre de codage possède un but précis, mais il
- faut souligner que les applications n'ont aucun intérêt
- à entrer dans les détails de ce codage. Les applications
- doivent se contenter de traiter la variable <code>UNIQUE_ID</code> comme un
- symbole opaque, qui peut être comparé avec d'autres
- <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p>
+ <p>Depuis la version 2.4.29, la variable d'environnement
+ <code>UNIQUE_ID</code> est construite par codage d’une valeur de 160 bits
+ (32 bits pour l’horodatage, 80 bits pour la racine PRNG, 16 bits pour le
+ compteur et 32 bits pour l’index des threads)) en utilisant l'alphabet
+ <code>[A-Za-z0-9_-]</code> d'une manière similaire à celle du codage MIME
+ base64 (avant la version 2.4.47, <code>[A-Za-z0-9@-]</code>), et sa valeur
+ se présente sous la forme d'une chaîne de 27 caractères. L'alphabet MIME
+ base64 est en fait <code>[A-Za-z0-9+/]</code> ; cependant, les caractères
+ <code>+</code> et <code>/</code> nécessitent un codage particulier dans les
+ URLs, ce qui rend leur utilisation peu commode. Toutes les valeurs sont
+ codées dans l'ordre des octets d'une adresse réseau de façon à ce que le
+ codage soit comparable entre des architectures où l'ordre des octets est
+ différent. L'ordre réel de codage est : horodatage, racine, compteur, index
+ des threads. Cet ordre de codage possède un but précis, mais il faut
+ souligner que les applications n'ont aucun intérêt à entrer dans les détails
+ de ce codage. Les applications doivent se contenter de traiter la variable
+ <code>UNIQUE_ID</code> comme un symbole opaque, qui peut être comparé avec
+ d'autres <code>UNIQUE_ID</code>s en ne testant que leur égalité.</p>
<p>L'ordre a été choisi de façon à ce qu'il soit possible de
modifier le codage dans le futur sans avoir à se préoccuper de
machines du cluster (seule la synchronisation NTP est requise, ce
qui représente une charge très faible), et aucune communication
entre les processus httpd n'est nécessaire (la communication est
- implicite et incluse dans le pid assigné par le noyau). Dans des
- situations très spécifiques, l'identifiant peut être raccourci, mais
- dans ce cas, d'avantage d'informations doivent être admises (par
- exemple, les 32 bits de l'adresse IP sont excessifs pour la plupart
- des sites, mais il n'existe pas de valeur de remplacement portable
- plus courte).</p>
+ implicite dans la graine PRNG assignée au démarrage)..</p>
</section>
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933061:1933621 (outdated) -->
+<!-- English Revision: 1933621 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<title>Utiliser mod_rewrite pour le contrôle d'accès</title>
<summary>
-
-<p>Ce document est un complément à la <a
-href="../mod/mod_rewrite.html">documentation de référence</a> de
-<module>mod_rewrite</module>. Il explique comment utiliser
-<module>mod_rewrite</module> pour contrôler l'accès à diverses
-ressources, ainsi que d'autres techniques en rapport. Il contient de
-nombreux exemples d'utilisation courante de <module>mod_rewrite</module> avec une
-description détaillée de leur fonctionnement.</p>
-
-<note type="warning">Vous devez vous attacher à comprendre le
-fonctionnement des exemples, car la plupart d'entre eux ne
-fonctionneront pas sur votre système si vous vous contentez de les
-copier/coller dans vos fichiers de configuration.</note>
+<note type="warning">Ce document est obsolète. Son contenu a été réorganisé dans
+le document <a href="avoid.html">Quand ne pas utiliser mod_rewrite</a>, car les
+recettes qui étaient décrites sont appliquées de manière plus efficace en
+utilisant d’autres fonctionnalités de httpd. Il sera supprimé dans une prochaine
+version de cette documentation.</note>
+
+<ul>
+<li><strong>Interdiction du hotlinking d’images</strong> - Voir
+ <a href="avoid.html#blocked-inline-images">Quand ne pas utiliser mod_rewrite</a></li>
+<li><strong>Blocage des robots</strong> - Voir
+ <a href="avoid.html#blocking-of-robots">Quand ne pas utiliser mod_rewrite</a></li>
+<li><strong>Interdire les hôtes enregistrés dans une liste de rejet</strong> -
+Voir
+ <a href="avoid.html#host-deny">Quand ne pas utiliser mod_rewrite</a></li>
+</ul>
</summary>
-<seealso><a href="../mod/mod_rewrite.html">Documentation du module mod_rewrite</a></seealso>
-<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
-<seealso><a href="remapping.html">Redirection et remise en
-correspondance</a></seealso>
-<!-- <seealso><a href="access.html">Contrôler l'accès</a></seealso> -->
-<seealso><a href="vhosts.html">Serveurs virtuels</a></seealso>
-<seealso><a href="proxy.html">Serveurs mandataires</a></seealso>
-<seealso><a href="rewritemap.html">Utilisation de RewriteMap</a></seealso>
-<seealso><a href="advanced.html">Techniques avancées</a></seealso>
-<seealso><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></seealso>
-
- <section id="blocked-inline-images">
-
- <title>Blocage du référencement à chaud (Hotlinking) d'images</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Cette technique vous permet d'interdire à d'autres sites
- d'inclure directement vos images dans leurs pages. On fait
- souvent référence à cette pratique sous le nom de
- référencement à chaud (Hotlinking) qui entraîne l'utilisation
- de votre bande passante pour servir des contenus faisant
- partie du site de quelqu'un d'autre.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Cette technique repose sur la valeur de la variable
- optionnelle <code>HTTP_REFERER</code>. Certaines personnes
- pourront donc contourner cette limitation. Pour la plupart des
- utilisateurs cependant, la requête échouera, en ce sens que
- l'image ne sera pas affichée depuis le site tiers.</p>
- <p>Il y a plusieurs manières de gérer cette situation.</p>
-
- <p>Dans le premier exemple, nous rejetons tout simplement la
- requête si elle ne provenait pas d'une page appartenant à notre
- site. Pour les besoins de cet exemple, nous supposons que le nom
- de votre site est <code>www.example.com</code>.</p>
-
-<!-- TODO: Add discussion here of why we have !^$ in there. -->
-
-<highlight language="config">
-RewriteCond "%{HTTP_REFERER}" "!^$"
-RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
-RewriteRule "\.(gif|jpg|png)$" "-" [F,NC]
-</highlight>
-
- <p>Dans le second exemple, plutôt que de rejeter la requête,
- nous affichons une autre image à la place.</p>
-
-<highlight language="config">
-RewriteCond "%{HTTP_REFERER}" "!^$"
-RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
-RewriteRule "\.(gif|jpg|png)$" "/images/go-away.png" [R,NC]
-</highlight>
-
- <p>Dans le troisième exemple, nous redirigeons la requête vers
- une image appartenant à un autre site.</p>
-
-<highlight language="config">
-RewriteCond "%{HTTP_REFERER}" "!^$"
-RewriteCond "%{HTTP_REFERER}" "!www.example.com" [NC]
-RewriteRule "\.(gif|jpg|png)$" "http://other.example.com/image.gif" [R,NC]
-</highlight>
-
- <p>De tous ces exemples, les deux derniers semblent les plus
- efficaces pour faire en sorte que les gens arrêtent de
- référencer vos images à chaud, car il ne verront pas les images
- qu'ils s'attendent à voir.</p>
-
- </dd>
-
- <dt>Discussion :</dt>
-
- <dd>
- <p>Si vous ne voulez pas rediriger la requête, mais
- simplement interdire l'accès à la ressource, vous pouvez y
- parvenir sans utiliser <module>mod_rewrite</module> :</p>
-
- <highlight language="config">
-SetEnvIf Referer "example\.com" localreferer
-<FilesMatch "\.(jpg|png|gif)$">
- Require env localreferer
-</FilesMatch>
- </highlight>
- </dd>
- </dl>
-
- </section>
-
- <section id="blocking-of-robots">
-
- <title>Blocage des robots</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>
- Dans cet exemple, nous allons discuter d'une méthode permettant
- de bloquer les requêtes persistentes en provenance d'un robot
- particulier, ou d'un navigateur.</p>
-
- <p>La méthode classique pour exclure un robot consiste à définir
- un fichier, <code>/robots.txt</code> qui spécifie les parties de
- votre site web pour lesquelles vous voulez exclure les robots.
- Malheureusement, certains robots ne tiennent pas compte de ces
- fichiers.
- </p>
-
- <p>Notez qu'il existe des méthodes d'exclusion qui n'utilisent
- pas <module>mod_rewrite</module>. Notez aussi que toute technique qui repose sur
- le contenu de la chaîne client <code>USER_AGENT</code> peut être
- contournée très facilement car cette chaîne peut être modifiée.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>On utilise un jeu de règles qui spécifie le répertoire à
- protéger, ainsi que la chaîne client <code>USER_AGENT</code> qui
- identifie le robot malin ou envahissant.</p>
-
- <p>Dans cet exemple, nous bloquons un robot nommé
- <code>Vilain_Robot</code> pour le répertoire
- <code>/secret/fichiers</code>. Si vous voulez bloquer ce client
- seulement depuis une source particulière, vous pouvez aussi
- spécifier un intervalle d'adresses IP.</p>
-
-<highlight language="config">
-RewriteCond "%{HTTP_USER_AGENT}" "^NameOfBadRobot"
-RewriteCond "%{REMOTE_ADDR}" "=123\.45\.67\.[8-9]"
-RewriteRule "^/secret/files/" "-" [F]
-</highlight>
- </dd>
-
- <dt>Discussion :</dt>
-
- <dd>
- <p>
- Vous pouvez cependant parvenir au même résultat sans utiliser
- <module>mod_rewrite</module> via la méthode alternative suivante :
- </p>
- <highlight language="config">
-SetEnvIfNoCase User-Agent "^NameOfBadRobot" goaway
-<Location "/secret/files">
- <RequireAll>
- Require all granted
- Require not env goaway
- </RequireAll>
-</Location>
- </highlight>
- <p>
- Comme indiqué plus haut, il est aisé de contourner cette
- technique, simplement en modifiant le contenu de l'en-tête
- <code>USER_AGENT</code>. Si vous subissez une attaque en règle,
- vous allez devoir réfléchir à un blocage à un niveau supérieur,
- par exemple une règle de filtrage de votre pare-feu.
- </p>
-
- </dd>
-
- </dl>
-
- </section>
-
-<section id="host-deny">
-
- <title>Rejet des clients contenus dans une liste de proscrits</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Nous voulons interdire l'accès à notre serveur aux clients
- contenus dans une liste de proscrits similaire à
- <code>hosts.deny</code>.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
-<highlight language="config">
-RewriteEngine on
-RewriteMap hosts-deny "txt:/path/to/hosts.deny"
-RewriteCond "${hosts-deny:%{REMOTE_ADDR}|NOT-FOUND}" "!=NOT-FOUND" [OR]
-RewriteCond "${hosts-deny:%{REMOTE_HOST}|NOT-FOUND}" "!=NOT-FOUND"
-RewriteRule "^" "-" [F]
-</highlight>
-
-<example>
-##<br />
-## hosts.deny<br />
-##<br />
-## ATTENTION! Ceci est une table de correspondances, non une liste,<br />
-## même si elle est traitée comme telle. mod_rewrite<br />
-## l'interprète comme une liste de paires clé/valeur, et<br />
-## chaque entrée doit au moins posséder une valeur par<br />
-## défaut "-".<br />
-<br />
-193.102.180.41 -<br />
-bsdti1.sdm.de -<br />
-192.76.162.40 -<br />
-</example>
- </dd>
-
- <dt>Discussion :</dt>
- <dd>
- <p>
- La seconde condition RewriteCond présuppose que HostNameLookups est
- défini à On, de façon à ce que les adresses IP des clients puissent
- être résolues. Dans le cas contraire, vous devez supprimer la
- seconde condition, ainsi que le drapeau <code>[OR]</code> de la
- première.
- </p>
- </dd>
- </dl>
-
-</section>
-
-<section id="referer-deflector">
-
- <title>Aiguillage basé sur l'en-tête Referer</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Redirige les requêtes en fonction du Referer de provenance de
- la requête, avec des cibles différentes pour chaque Referer.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Le jeu de règles suivant utilise un fichier de correspondances pour
- associer chaque Referer à une cible de redirection.</p>
-
-<highlight language="config">
-RewriteMap deflector "txt:/path/to/deflector.map"
-
-RewriteCond "%{HTTP_REFERER}" !=""
-RewriteCond "${deflector:%{HTTP_REFERER}}" "=-"
-RewriteRule "^" "%{HTTP_REFERER}" [R,L]
-
-RewriteCond "%{HTTP_REFERER}" !=""
-RewriteCond "${deflector:%{HTTP_REFERER}|NOT-FOUND}" "!=NOT-FOUND"
-RewriteRule "^" "${deflector:%{HTTP_REFERER}}" [R,L]
-</highlight>
-
- <p>Le fichier de correspondances contient les cibles de
- redirection associées à chaque Referer, ou, si nous voulons
- simplement rediriger les requêtes vers leur Referer, un "-" est
- inscrit dans le fichier de correspondances :</p>
-
-<highlight language="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/
-</highlight>
-
- </dd>
- </dl>
-
-</section>
-
</manualpage>
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1933066:1933614 (outdated) -->
+<!-- English Revision: 1933614 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<summary>
-<p>Ce document complète la <a
- href="../mod/mod_rewrite.html">documentation de référence</a> du
- module <module>mod_rewrite</module>. Il présente un certain nombre
- de techniques avancées quant à
- l'utilisation de <module>mod_rewrite</module>.</p>
-
-<note type="warning">Notez que la plupart des exemples ne fonctionneront
-pas en l'état dans la configuration particulière de votre serveur ; il
-est donc important de bien comprendre leur fonctionnement, plutôt que de
-simplement les copier/coller dans votre configuration.</note>
+<note type="warning">Ce document est obsolète. Son contenu a été réparti entre
+les documents d’actualité suivants, où l’on trouvera en parallèle des recettes
+et exemples en rapport. Il sera supprimé dans une future version de cette
+documentation.</note>
+
+<ul>
+<li><strong>Partitionnement basé sur l'URL</strong> - Voir
+ <a href="rewritemap.html#sharding">Utilisation de RewriteMap</a></li>
+<li><strong>Régénération de contenu à la volée</strong> - Voir
+ <a href="remapping.html#on-the-fly-content">Redirection et remappage</a></li>
+<li><strong>Répartition de charge</strong> - Voir
+ <a href="avoid.html#load-balancing">Quand ne pas utiliser mod_rewrite</a></li>
+<li><strong>Répertoires utilisateur structurés</strong> - Voir
+ <a href="remapping.html#structuredhomedirs">Redirection et remappage</a></li>
+<li><strong>Redirection des ancres</strong> - Voir
+ <a href="remapping.html#redirectanchors">Redirection et remappage</a></li>
+<li><strong>Réécriture en fonction du temps</strong> - Voir
+ <a href="remapping.html#time-dependent">Redirection et remappage</a></li>
+<li><strong>Définir des variables d’environnement en fonction de l’URL</strong>
+- Voir
+ <a href="flags.html#flag_e">Drapeaux de RewriteRule</a></li>
+</ul>
</summary>
-<seealso><a href="../mod/mod_rewrite.html">Documentation du module</a></seealso>
-<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
-<seealso><a href="remapping.html">Redirection et remise en
-correspondance</a></seealso>
-<seealso><a href="access.html">Contrôler l'accès</a></seealso>
-<seealso><a href="vhosts.html">serveurs virtuels</a></seealso>
-<seealso><a href="proxy.html">serveurs mandataires</a></seealso>
-<seealso><a href="rewritemap.html">Utilisation de RewriteMap</a></seealso>
-<!--<seealso><a href="advanced.html">Techniques avancées</a></seealso>-->
-<seealso><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></seealso>
-
-<section id="sharding">
-
- <title>Distribution de la charge entre plusieurs serveurs
- d'arrière-plan en fonction de l'adresse IP</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>La fragmentation ou "sharding" est une technique courante de
- distribution de la charge du serveur ou de l'espace de stockage.
- Quand on utilise cette méthode, un serveur frontal utilise l'URL
- pour répartir de manière appropriée les utilisateurs et objets
- entre différents serveurs d'arrière-plan.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>On maintient une table de correspondance entre utilisateurs et
- serveurs cibles dans des fichiers externes. Ces derniers se
- présentent comme suit :</p>
-
-<example>
-utilisateur1 serveur_physique_utilisateur1<br />
-utilisateur2 serveur_physique_utilisateur2<br />
-# etc ...
-</example>
-
- <p>Tout ceci est enregistré dans un fichier
- <code>correspondances-utilisateurs-serveurs</code>. Le but est de
- faire correspondre</p>
-
-<example>
-/u/utilisateur1/chemin
-</example>
-
- <p>avec</p>
-
-<example>
-http://serveur_physique_utilisateur1/u/utilisateur/chemin
-</example>
-
- <p>il n'est ainsi pas nécessaire que tous les chemins URL soient
- valides sur tous les serveurs physiques d'arrière-plan. Le jeu de
- règles suivant fait tout ceci pour nous, en s'appuyant sur les
- fichiers de correspondances, en supposant que serveur0 est un
- serveur par défaut qui sera utilisé lorsqu'un utilisateur ne
- possèdera pas d'entrée dans la table de correspondances :</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteMap users-to-hosts "txt:/path/to/map.users-to-hosts"
-RewriteRule "^/u/([^/]+)/?(.*)" "http://${users-to-hosts:$1|server0}/u/$1/$2"
-</highlight>
- </dd>
- </dl>
-
- <p>Voir la documentation de <directive
- module="mod_rewrite">RewriteMap</directive> et le <a
- href="./rewritemap.html">RewriteMap HowTo</a> pour une description plus
- approfondie de la syntaxe de cette directive.</p>
-
-</section>
-
-<section id="on-the-fly-content">
-
- <title>Régéneration de contenu à la volée</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Nous voulons générer du contenu de manière dynamique, mais le
- conserver de manière statique lorsqu'il a été généré. La règle
- suivante vérifie l'existence du fichier statique, et le génère
- s'il est absent. Les fichiers statiques peuvent être supprimés
- périodiquement si on le désire (par exemple via cron), et seront
- régénérés à la demande.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- A cet effet, on utilise le jeu de règles suivant :
-
-<highlight language="config">
-# Cet exemple n'est valable que dans un contexte de répertoire
-RewriteCond "%{REQUEST_URI}" "!-U"
-RewriteRule "^(.+)\.html$" "/regenerate_page.cgi" [PT,L]
-</highlight>
-
- <p>L'opérateur <code>-U</code> permet de déterminer si la chaîne
- de test (dans ce cas <code>REQUEST_URI</code>) est une URL valide.
- Pour ce faire, il utilise une sous-requête. Si cette sous-requête
- échoue, ou en d'autres termes, si la ressource demandée n'existe pas,
- cette règle invoque le programme CGI
- <code>/regenerate_page.cgi</code> qui génère la ressource
- demandée et la sauvegarde dans le répertoire des documents, de
- façon à ce qu'une copie statique puisse être servie lors d'une
- demande ultérieure.</p>
-
- <p>De cette façon, les documents qui ne sont pas mis à jour
- régulièrement peuvent être servis sous une forme statique. Si ces
- documents doivent être réactualisés, on peut les supprimer du
- répertoire des documents, et ils seront ainsi régénérés à la
- prochaine demande.</p>
- </dd>
- </dl>
-
-</section>
-
-<section id="load-balancing">
-
- <title>Répartition de charge</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Nous voulons répartir la charge de manière aléatoire entre
- plusieurs serveurs en utilisant <module>mod_rewrite</module>.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Pour y parvenir, nous allons utiliser la directive <directive
- module="mod_rewrite">RewriteMap</directive> et une liste de
- serveurs.</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteMap lb "rnd:/path/to/serverlist.txt"
-RewriteRule "^/(.*)" "http://${lb:servers}/$1" [P,L]
-</highlight>
-
-<p><code>liste-serveurs.txt</code> contiendra la liste des serveurs :</p>
-
-<example>
-## liste-serveurs.txt<br />
-<br />
-serveurs un.example.com|deux.example.com|trois.example.com<br />
-</example>
-
-<p>Si vous voulez qu'un serveur se voit confier d'avantage de charge que
-les autres, faites le figurer plusieurs fois dans la liste.</p>
-
- </dd>
-
- <dt>Discussion</dt>
- <dd>
-<p>Apache possède un module de répartition de charge -
-<module>mod_proxy_balancer</module> - beaucoup plus souple et présentant
-plus de fonctionnalités dans ce domaine que <module>mod_rewrite</module>.</p>
- </dd>
- </dl>
-
-</section>
-
-<section id="structuredhomedirs">
-
- <title>Répertoires Home structurés</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Certains sites avec des milliers d'utilisateurs organisent
- les répertoires utilisateurs de manière structurée, c'est à
- dire que chaque répertoire utilisateur se trouve dans un
- sous-répertoire dont le nom commence (par exemple) par le
- premier caractère du nom de l'utilisateur. Ainsi,
- <code>/~larry/chemin</code> correspond à
- <code>/home/<strong>l</strong>/larry/public_html/chemin</code>, alors
- que <code>/~waldo/chemin</code> correspond à
- <code>/home/<strong>w</strong>/waldo/public_html/chemin</code>.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>On utilise le jeu de règles suivant pour développer les
- URLs avec tilde selon l'organisation structurée précédente.</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteRule "^/~(<strong>([a-z])</strong>[a-z0-9]+)(.*)" "/home/<strong>$2</strong>/$1/public_html$3"
-</highlight>
- </dd>
- </dl>
-
-</section>
-
-<section id="redirectanchors">
-
- <title>Redirection des ancrages</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Par défaut, la redirection vers un ancrage HTML ne fonctionne
- pas, car <module>mod_rewrite</module> échappe le caractère <code>#</code> en le
- transformant en <code>%23</code>, ce qui rend la redirection
- inopérante.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>On utilise le drapeau <code>[NE]</code> dans la règle
- <code>RewriteRule</code>. NE signifie "No Escape".
- </p>
- </dd>
-
- <dt>Discussion :</dt>
- <dd>Cette technique fonctionne bien entendu pour tout autre
- caractère spécial que <module>mod_rewrite</module>, par défaut, code pour insertion
- dans une URL.</dd>
- </dl>
-
-</section>
-
-<section id="time-dependent">
-
- <title>Réécriture dépendant de l'heure</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Nous voulons servir des contenus différents selon l'heure du
- jour en utilisant <module>mod_rewrite</module>.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Il existe de nombreuses variables nommées
- <code>TIME_xxx</code> utilisables dans les conditions de
- réécriture. Utilisées en conjonction avec les modèles de
- comparaison lexicographique spéciaux <code><STRING</code>,
- <code>>STRING</code> et <code>=STRING</code>, elles
- permettent d'effectuer des redirections dépendant de
- l'heure :</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteCond "%{TIME_HOUR}%{TIME_MIN}" ">0700"
-RewriteCond "%{TIME_HOUR}%{TIME_MIN}" "<1900"
-RewriteRule "^foo\.html$" "foo.day.html" [L]
-RewriteRule "^foo\.html$" "foo.night.html"
-</highlight>
-
- <p>Avec cet exemple, l'URL <code>foo.html</code> renvoie
- le contenu de <code>foo.jour.html</code> durant le
- créneau horaire <code>07:01-18:59</code>, et le contenu de
- <code>foo.nuit.html</code> le reste du temps.</p>
-
- <note type="warning"><module>mod_cache</module>, les mandataires
- intermédiaires et les navigateurs peuvent chacun mettre en cache
- les réponses et ainsi afficher une des deux pages en dehors de
- la fenêtre de temps configurée. On peut utiliser
- <module>mod_expires</module> pour contourner ce problème. Il est
- cependant bien plus commode de servir un contenu dynamique, et
- de le personnaliser en fonction de l'heure du jour.</note> </dd>
- </dl>
-
-</section>
-
-<section id="setenvvars">
-
- <title>Définir des variables d'environnement en fonction de
- certaines parties de l'URL</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>Nous voulons parfois conserver une certaine forme de statut
- lorsqu'une réécriture a eu lieu. Par exemple, vous souhaitez
- consigner le fait que cette réécriture a eu lieu, et vous servir
- plus tard de cette information pour déterminer si une requête était
- concernée par cette réécriture. Pour ce faire, on peut utiliser
- une variable d'environnement.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Utiliser le drapeau [E] pour définir une variable
- d'environnement.</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteRule "^/cheval/(.*)" "/poney/$1" [E=<strong>rewritten:1</strong>]
-</highlight>
-
- <p>Plus loin dans votre jeu de règles, vous pouvez vérifier le
- contenu de cette variable d'environnement via une directive
- RewriteCond :</p>
-
-<highlight language="config">
-RewriteCond "%{ENV:rewritten}" "=1"
-</highlight>
-
- <p>Notez que les variables d'environnement ne survivent pas à une
- redirection externe. Vous devez alors utiliser le drapeau [CO] pour définir
- un cookie. Pour les redirections de niveau répertoire et htaccess où la
- substitution finale est traitée en tant que redirection interne, les
- variables d'environnement du tour de réécriture précédent sont préfixées par
- "REDIRECT_".</p>
-
- </dd>
- </dl>
-
-</section>
</manualpage>
-<?xml version="1.0" ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933954:1934664 (outdated) -->
+<!-- English Revision: 1934664 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<title>Guide pour le module Apache mod_rewrite</title>
<summary>
+<p><em>Le point fort de mod_rewrite réside dans le fait qu'il possède toutes les
+capacités de configuration et la flexibilité de Sendmail ;mais c'est aussi son
+point faible.</em>
+-- Brian Behlendorf</p>
+
+<p><em>Malgré la multitude d'exemples et de documentations, mod_rewrite est de
+la magie noire. De la magie noire très "cool", mais de la magie noire
+quand-même.</em></p>
<p><module>mod_rewrite</module> permet de modifier les requêtes
entrantes dynamiquement, en fonction de règles manipulant des <a
ainsi relier des URLs arbitraires à votre propre structure d'URLs
interne comme vous le souhaitez.</p>
- <p>Il fournit un
- mécanisme de manipulation d'URL particulièrement souple et
- puissant en supportant un nombre illimité de règles et de
- conditions attachées à chaque règle. Les manipulations d'URLs
- peuvent dépendre de tests variés : les URLs peuvent
- être finement caractérisées en fonction de variables du serveur,
- de variables d'environnement, d'en-têtes HTTP, de repères
- temporels, de recherches dans des bases de données
- externes, ou même de requêtes vers des bases de données externes
- et de différents gestionnaires ou programmes externes.</p>
-
- <p>Les règles de réécriture peuvent agir sur l'ensemble des URLs (la partie chemin
- et la chaîne de paramètres) et peuvent être utilisées dans le contexte du serveur principal
- (<code>httpd.conf</code>), mais aussi dans le contexte des
- serveurs virtuels (sections <directive
- type="section" module="core">VirtualHost</directive>), ou dans le
- <glossary ref="perdirectory">contexte des répertoires</glossary> (fichiers <code>.htaccess</code> et blocs
- <code><Directory></code>. Le résultat
- réécrit peut conduire vers d'autres règles à un
- traitement secondaire interne, une redirection vers une requête
- externe ou même l'envoi vers un serveur mandataire, en fonction
- des <a href="flags.html">drapeaux</a> que vous attachez aux
- règles</p>
-
- <p><module>mod_rewrite</module> étant très puissant, il peut par
- conséquent être très complexe. Ce guide
- complète la <a
- href="../mod/mod_rewrite.html">documentation de
- référence du module mod_rewrite</a>, et est sensé alléger un
- peu cette complexité, et présenter des exemples largement
- commentés, ainsi que des situations courantes que vous
- pourrez traiter avec <module>mod_rewrite</module>. Mais nous voulons aussi vous
- montrer des situations où vous ne devrez pas utiliser
- <module>mod_rewrite</module>, et lui préférer d'autres
- fonctionnalités standard d'Apache, évitant ainsi
- d'entrer dans une complexité inutile.</p>
-
-<ul>
-<li><a href="../mod/mod_rewrite.html">documentation de
-référence de mod_rewrite</a></li>
-<li><a href="intro.html">Introduction aux expressions rationnelles et à
-mod_rewrite</a></li>
-<li><a href="rewritemap.html">Utilisation de RewriteMap</a></li>
-<li><a href="avoid.html">Quand <strong>NE PAS</strong> utiliser mod_rewrite</a></li>
-<li><a href="remapping.html">Using mod_rewrite for redirection and remapping of URLs</a></li>
-<li><a href="vhosts.html">Dynamic virtual hosts with mod_rewrite</a></li>
-<li><a href="tech.html">Détails techniques</a></li>
-</ul>
+<p>Ce guide est un complément du <a href="../mod/mod_rewrite.html">manuel de
+référence</a> avec des exemples commentés, des explications conceptuelles et des
+conseils pratiques. Il est organisé comme suit :</p>
+
+<dl>
+<dt><a href="intro.html">Introduction</a></dt>
+<dd>Concepts de base : syntaxe des expressions rationnelles, les bases des
+directives RewriteRule et RewriteCond et la manière dont mod_rewrite s'insère
+dans le cycle de vie du traitement des requêtes.</dd>
+
+<dt><a href="htaccess.html">Réécritures en fonction du répertoire</a></dt>
+<dd>Les principales différences entre l'utilisation des règles de réécriture au
+niveau de la configuration globale du serveur et leur utilisation dans un
+contexte de <glossary ref="perdirectory">répertoire</glossary>, y compris la
+suppression du chemin, RewriteBase et la gestion du bouclage par le drapeau [L].</dd>
+
+<dt><a href="flags.html">Drapeaux des règles de réécriture</a></dt>
+<dd>Une référence complète de tous les drapeaux qui peuvent modifier le
+comportement d'une règle de réécriture avec des exemples pour chacun d'entre
+eux.</dd>
+
+<dt><a href="rewritemap.html">Utiliser RewriteMap</a></dt>
+<dd>Comment utiliser des sources de recherche externes — fichiers texte,
+bases de données DBM, requêtes SQL et fonctions internes — pour piloter
+vos règles de réécriture.</dd>
+
+<dt><a href="remapping.html">Redirection et remappage</a></dt>
+<dd>Des recettes pour les tâches courantes : redirection HTTPS, noms d'hôte
+canoniques, normalisation des barres obliques de fin, routage du contrôleur
+frontal, et plus encore.</dd>
+
+<dt><a href="vhosts.html">Serveurs virtuels dynamiques</a></dt>
+<dd>Utilisation de mod_rewrite pour associer dynamiquement les noms d'hôte aux
+racines de document sans devoir créer des blocs VirtualHost individuels.</dd>
+
+<dt><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></dt>
+<dd>De nombreuses tâches courantes sont accomplies de manière bien plus efficace
+avec des directives plus simples. Ce document vous propose des solutions de
+remplacement et vous indique quand il est préférable de les utiliser.</dd>
+
+<dt><a href="tech.html">Détails techniques</a></dt>
+<dd>Comment mod_rewrite s'insère dans les phases de traitement des requêtes par
+httpd et l'ordre dans lequel les règles et les conditions sont évaluées.</dd>
+</dl>
</summary>
<seealso><a href="../mod/mod_rewrite.html">Documentation de
</manualpage>
-
<?xml version="1.0" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1933066:1933623 (outdated) -->
+<!-- English Revision: 1933623 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<summary>
-<p>Ce document est un complément de la <a
-href="../mod/mod_rewrite.html">documentation de référence</a> du module
-<module>mod_rewrite</module>. Il décrit comment utiliser le drapeau [P]
-de la directive RewriteRule pour mandater un contenu vers un autre
-serveur. Plusieurs recettes décrivant des scénarios courants sont
-fournies.</p>
+<note type="warning">Ce document est obsolète. Son contenu a été fusionné avec
+le document <a href="avoid.html#proxy">Quand ne pas utiliser mod_rewrite</a>,
+car le mandatement simple est accompli de manière plus efficace en utilisant la
+directive <directive module="mod_proxy">ProxyPass</directive>. Il sera supprimé
+dans une prochaine version de cette documentation.</note>
</summary>
-<seealso><a href="../mod/mod_rewrite.html">Documentation du module</a></seealso>
-<seealso><a href="intro.html">Introduction à mod_rewrite</a></seealso>
-<seealso><a href="remapping.html">Redirection et remise en
-correspondance</a></seealso>
-<seealso><a href="access.html">Contrôle d'accès</a></seealso>
-<seealso><a href="vhosts.html">Serveurs virtuels</a></seealso>
-<!--<seealso><a href="proxy.html">Serveurs mandataires</a></seealso>-->
-<seealso><a href="rewritemap.html">Utilisation de RewriteMap</a></seealso>
-<seealso><a href="advanced.html">Techniques avancées</a></seealso>
-<seealso><a href="avoid.html">Quand ne pas utiliser mod_rewrite</a></seealso>
-
-<section id="dynamic-proxy">
-
- <title>Mandater du contenu avec mod_rewrite</title>
-
- <dl>
- <dt>Description :</dt>
-
- <dd>
- <p>
- <module>mod_rewrite</module> implémente le drapeau [P] qui permet de passer des URLs,
- via <module>mod_proxy</module>, à un autre serveur. Deux exemples sont fournis ici.
- Dans le premier, une URL est passée directement à un autre serveur,
- et servie comme si c'était une URL locale. Dans le deuxième, nous
- mandatons un contenu manquant vers un serveur d'arrière-plan.</p>
- </dd>
-
- <dt>Solution :</dt>
-
- <dd>
- <p>Pour passer une URL à un autre serveur, on utilise le drapeau
- [P] comme suit :</p>
-
-<highlight language="config">
-RewriteEngine on
-RewriteBase "/produits/"
-RewriteRule "^widget/(.*)$" "http://produits.example.com/widget/$1" [P]
-ProxyPassReverse "/produits/objet/" "http://produits.example.com/objet/"
-</highlight>
-
- <p>Dans le deuxième exemple, nous ne mandatons la requête que si nous
- ne trouvons pas la ressource localement. Ceci peut s'avérer très
- utile lorsque vous effectuez une migration d'un serveur vers un
- autre, et que vous n'êtes pas certain que tout le contenu a déjà été
- migré.</p>
-
-<highlight language="config">
-RewriteCond "%{REQUEST_FILENAME}" !-f
-RewriteCond "%{REQUEST_FILENAME}" !-d
-RewriteRule "^/(.*)" "http://ancien.exemple.com/$1" [P]
-ProxyPassReverse "/" "http://ancien.exemple.com/"
-</highlight>
- </dd>
-
- <dt>Discussion :</dt>
-
- <dd><p>Dans les deux cas, on ajoute une directive <directive
- module="mod_proxy">ProxyPassReverse</directive> afin de s'assurer
- que toute redirection en provenance du serveur d'arrière-plan est
- renvoyée correctement au client.</p>
-
- <p>Chaque fois que cela est possible, préférez l'utilisation de la
- directive <directive module="mod_proxy">ProxyPass</directive> ou
- <directive module="mod_proxy">ProxyPassMatch</directive> à
- <module>mod_rewrite</module>.</p>
- </dd>
- </dl>
-
-</section>
</manualpage>
projects / thirdparty / apache / httpd.git / commitdiff
