diff --git a/docs/manual/rewrite/index.html.fr b/docs/manual/rewrite/index.html.fr new file mode 100644 index 0000000000..407e98c55f --- /dev/null +++ b/docs/manual/rewrite/index.html.fr @@ -0,0 +1,100 @@ + + + +Le module Apache mod_rewrite - Serveur Apache HTTP + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3

Le module Apache mod_rewrite

Langues Disponibles: en | + fr | + tr

+ +

+
``Ce qui est super avec mod_rewrite, c'est qui permet + autant de configuration et de flexibilité que Sendmail. + L'inconvénient de mod_rewrite, c'est qu'il permet autant de + configuration et de flexibilité que Sendmail.''
+ +
-- Brian Behlendorf
+ Groupe Apache
+ +

+ +

+
``Malgré les tonnes d'exemples et de documentations, + mod_rewrite relève de la magie vaudoue. De la magie vaudoue super + géniale, mais de la magie vaudoue.''
+ +
-- Brian Moore
+ bem@news.cmc.net
+ +

+ +

Bienvenue dans mod_rewrite, le couteau suisse de la + manipulation d'URL !

+ +

Ce module met en oeuvre un moteur de réécriture à base de + règles (basé sur un interpréteur d'expressions rationnelles) pour + réécrire les URLs issues des requêtes à la volée. 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 : par exemple, 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, ou même de requêtes vers des bases de données externes + sous différents formats.

+ +

Ce module agit sur l'ensemble des URLs (la partie chemin + incluse) non seulement dans le contexte du serveur principal + (httpd.conf), mais aussi dans le contexte des + répertoires (fichiers .htaccess et blocs + <Directory>), et peut même générer des chaînes + de requête comme résultat. Le résultat réécrit peut conduire à un + traitement secondaire interne, une redirection vers une requête + externe ou même l'envoi vers un serveur mandataire.

+ +

Mais toutes ces fonctionnalités et cette souplesse ont un + inconvénient : la complexité. N'espérez donc pas comprendre ce + module dans les détails en un seul jour.

+ +

Voir aussi

Documentation

Langues Disponibles: en | + fr | + tr

+ \ No newline at end of file diff --git a/docs/manual/rewrite/index.xml.fr b/docs/manual/rewrite/index.xml.fr new file mode 100644 index 0000000000..8cf8c0b6d5 --- /dev/null +++ b/docs/manual/rewrite/index.xml.fr @@ -0,0 +1,103 @@ + + + + + + + + + + + + + Le module Apache mod_rewrite + +

+
``Ce qui est super avec mod_rewrite, c'est qui permet + autant de configuration et de flexibilité que Sendmail. + L'inconvénient de mod_rewrite, c'est qu'il permet autant de + configuration et de flexibilité que Sendmail.''
+ +
-- Brian Behlendorf
+ Groupe Apache
+ +

+ +

+
``Malgré les tonnes d'exemples et de documentations, + mod_rewrite relève de la magie vaudoue. De la magie vaudoue super + géniale, mais de la magie vaudoue.''
+ +
-- Brian Moore
+ bem@news.cmc.net
+ +

+ +

Bienvenue dans mod_rewrite, le couteau suisse de la + manipulation d'URL !

+ +

Mais toutes ces fonctionnalités et cette souplesse ont un + inconvénient : la complexité. N'espérez donc pas comprendre ce + module dans les détails en un seul jour.

+ +

+ +Mise en correspondance des URLs +avec le système de fichiers +wiki mod_rewrite + +Glossaire + +

Documentation +

+ + + + diff --git a/docs/manual/rewrite/index.xml.meta b/docs/manual/rewrite/index.xml.meta index cb40e2fd55..504832fb24 100644 --- a/docs/manual/rewrite/index.xml.meta +++ b/docs/manual/rewrite/index.xml.meta @@ -8,6 +8,7 @@ en + fr tr diff --git a/docs/manual/rewrite/rewrite_guide.html b/docs/manual/rewrite/rewrite_guide.html index 69c288c8ed..a97a1f378a 100644 --- a/docs/manual/rewrite/rewrite_guide.html +++ b/docs/manual/rewrite/rewrite_guide.html @@ -3,3 +3,7 @@ URI: rewrite_guide.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: rewrite_guide.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/rewrite/rewrite_guide.html.en b/docs/manual/rewrite/rewrite_guide.html.en index e14b991b81..1f4faebb96 100644 --- a/docs/manual/rewrite/rewrite_guide.html.en +++ b/docs/manual/rewrite/rewrite_guide.html.en @@ -18,7 +18,8 @@

Apache > HTTP Server > Documentation > Version 2.3 > Rewrite

URL Rewriting Guide

Available Languages: en

Available Languages: en | + fr

@@ -827,7 +828,8 @@ while (<>) {

Available Languages: en

Available Languages: en | + fr

diff --git a/docs/manual/rewrite/rewrite_guide.html.fr b/docs/manual/rewrite/rewrite_guide.html.fr new file mode 100644 index 0000000000..63e4b3e174 --- /dev/null +++ b/docs/manual/rewrite/rewrite_guide.html.fr @@ -0,0 +1,872 @@ + + + +Guide de réécriture des URLs - Serveur Apache HTTP + + + + + +

+Apache > Serveur HTTP > Documentation > Version 2.3 > Rewrite

Guide de réécriture des URLs

Langues Disponibles: en | + fr

+ + +

Ce document complète la documentation de référence du + module mod_rewrite. Il décrit de quelle manière on + peut utiliser le module Apache mod_rewrite pour + résoudre les problèmes typiques relatifs aux URLs auxquels les + webmasters sont souvent confrontés. La résolution de chaque problème + par la configuration des jeux de règles de réécriture d'URLs fait + l'objet d'une description détaillée.

+ +

ATTENTION : l'adaptation des exemples à votre + situation en fonction de la configuration de votre serveur pourra + s'avérer nécessaire, par exemple l'ajout du drapeau + [PT] si vous utilisez les modules + mod_alias, mod_userdir, etc... Un + jeu de règles défini dans le contexte du serveur devra aussi être + adapté pour être utilisé dans un contexte .htaccess. + Efforcez-vous toujours de bien comprendre l'effet produit par un jeu + de règles avant de l'utiliser, ce qui pourra vous éviter bien des + problèmes.

+ +

URLs canoniques
Noms d'hôtes canoniques
DocumentRootdéplacé
Problème du slash de fin
Déplacement des répertoires home vers un autre serveur
Recherche de pages dans plus d'un répertoire
Définir des variables d'environnement en fonction de + certaines parties de l'URL
Hôtes virtuels basés sur l'utilisateur
Redirection des répertoires d'accueil pour les étrangers
Redirection des ancrages
Réécriture dépendant de l'heure
Compatibilité ascendante pour une migration de YYYY vers + XXXX
De l'ancien au nouveau (en interne)
De l'ancien au nouveau (en externe)
De statique à dynamique
Blocage des robots
Blocage du référencement à chaud (Hotlinking) d'images
Interdiction du mandataire
Moteur de réécriture externe

Voir aussi

URLs canoniques

+ + + +

Description :

Sur certains serveurs web, une ressource peut être accessible + depuis plusieurs URLs. On trouve en général des URLs canoniques + (qui sont réellement utilisables et distribuables), mais aussi des + URLs à usage interne, ou celles qui ne sont que des raccourcis, + etc... On souhaite que, quelle que soit l'URL que l'utilisateur + a fournie avec sa requête, il ne doit en voir en fin de compte + que la forme canonique.

Solution :

On effectue une redirection HTTP externe pour toutes les URLs + non canoniques afin de les rendre compréhensibles au navigateur + et ceci pour toutes les requêtes sous-jacentes. Dans l'exemple de + jeux de règles ci-dessous, /~user est remplacé par + l'expression canonique /u/user, et une éventuelle + absence du slash à la fin de /u/user est corrigée.

+ +

+RewriteRule   ^/~([^/]+)/?(.*)    /u/$1/$2  [R]
+RewriteRule   ^/u/([^/]+)$  /$1/$2/   [R]
+

+ +

Noms d'hôtes canoniques

+ +

Description :

Le but de cette règle est de préférer l'utilisation d'un nom + d'hôte particulier par rapport à d'autres noms d'hôte utilisables + pour atteindre le même site. Par exemple, si vous voulez + utiliser www.example.com à la place de + example.com, vous devez utiliser une solution + de ce style.

Solution :

Pour les sites écoutant sur un port autre que 80:

+RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST}   !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*)         http://www.exemple.com:%{SERVER_PORT}/$1
+[L,R,NE]
+

+ +

Et pour un site écoutant sur le port 80

+RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST}   !^$
+RewriteRule ^/?(.*)         http://www.exemple.com/$1 [L,R,NE]
+

+ Si vous souhaitez que cette règle s'applique à tous les noms de + domaine - en d'autres termes, si vous voulez rediriger + example.com vers + www.example.com pour toutes les valeurs + possibles de example.com, vous pouvez utiliser + le jeu de règles suivants :

+ +

+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+

+ Vous pouvez utiliser ce jeu de règles aussi bien dans le fichier + de configuration de votre serveur principal que dans un fichier + .htaccess placé dans le répertoire défini par la + directive DocumentRoot du serveur.

+ +

`DocumentRoot`déplacé

+ + + +

Description :

En général, la directive DocumentRoot correspond directement à l'URL +"/" du serveur web. Mais souvent, les données qui s'y +trouvent ne sont pas de la première priorité. Par exemple, il peut être +intéressant, pour les visiteurs qui entrent sur le site pour la première +fois, d'être redirigés vers un sous-répertoire particulier +/a-propos-de/. Pour ce faire, on peut utiliser le jeu de +règles suivant :

Solution :

On redirige l'URL / vers + /a-propos-de/: +

+ +

+RewriteEngine on
+RewriteRule   ^/$  /a-propos-de/  [R]
+

+ +

Notez que le même effet peut être obtenu à l'aide de la directive + RedirectMatch :

+ +

+RedirectMatch ^/$ http://exemple.com/apropos/ +

Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres +termes, il réécrit une requête pour http://example.com/, +mais ne réécrira pas une requête pour +http://example.com/page.html. En fait, si vous avez modifié +la racine de vos documents - c'est à dire si tous vos contenus se +trouvent dans ce sous-répertoire, il vaut mieux simplement modifier +votre directive DocumentRoot que de +procéder à une réécriture d'URLs.

+ +

Problème du slash de fin

+ + + +

Description :

La plupart des problèmes de "slash de fin" peuvent être + résolus grâce aux techniques décrites dans ce sujet + de la FAQ. Cependant, dans certaines situations où l'absence de slash de fin + peut rendre une URL inopérante, l'utilisation de + mod_rewrite s'avère nécessaire. Le cas peut se présenter, par exemple, + après une série complexe de règles de réécriture.

Solution :

La solution à ce problème subtil consiste à laisser le + serveur ajouter le slash de fin automatiquement. Pour y + parvenir, il faut utiliser une redirection externe, afin que + le navigateur demande correctement les images sous-jacentes, + etc... Une réécriture en interne ne fonctionnerait que pour la + page du répertoire, mais échouerait pour toute image incluse + dans cette page via des liens relatifs, car le navigateur + demanderait un objet inséré. Par exemple, une requête pour + image.gif dans /~quux/foo/index.html + deviendrait /~quux/image.gif sans la redirection + externe !

+ +

Pour y parvenir, on peut utiliser des règles de ce style :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo$  foo/  [R]
+

+ +

Vous pouvez aussi ajouter ce qui suit dans un fichier + .htaccess situé dans le répertoire contenant la + ressource. Notez cependant que cela augmente la charge du processeur.

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteCond    %{REQUEST_FILENAME}  -d
+RewriteRule    ^(.+[^/])$           $1/  [R]
+

+ +

Déplacement des répertoires home vers un autre serveur

+ + + +

Description :

De nombreux webmasters ont demandé comment résoudre le + problème suivant : ils voudraient tout simplement rediriger + les répertoires home d'un serveur web vers un autre serveur + web. Cette situation se présente en général lorsqu'on installe + un nouveau serveur web destiné à terme à en remplacer un autre + plus ancien.

Solution :

Avec mod_rewrite, la solution est + évidente. Sur l'ancien serveur web, on redirige simplement + toutes les URLs du style /~user/chemin vers + http://nouveau-serveur/~user/chemin.

+ +

+RewriteEngine on
+RewriteRule   ^/~(.+)  http://nouveau-serveur/~$1  [R,L]
+

+ +

Recherche de pages dans plus d'un répertoire

+ + + +

Description :

Le serveur web doit parfois rechercher des pages dans plus + d'un répertoire. Dans ce cas, les vues multiples ou autres + techniques similaires ne sont d'aucun secours.

Solution :

On définit explicitement un jeu de règles qui recherche les + fichiers dans les répertoires.

+ +

+RewriteEngine on
+
+#   on cherche tout d'abord dans dir1/...
+#   ... et si on trouve, on est content et on arrête :
+RewriteCond         %{DOCUMENT_ROOT}/dir1/%{REQUEST_URI}  -f
+RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/dir1/$1  [L]
+
+#   on cherche ensuite dans dir2/...
+#   ... et si on trouve, on est content et on arrête :
+RewriteCond         %{DOCUMENT_ROOT}/dir2/%{REQUEST_URI}  -f
+RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/dir2/$1  [L]
+
+#   sinon, on continue la recherche avec d'autres directives Alias
+#   ou ScriptAlias, etc...
+RewriteRule   ^(.+)  -  [PT]
+

+ +

Définir des variables d'environnement en fonction de + certaines parties de l'URL

+ + + +

Description :

Comment conserver des informations + d'état d'une requête à l'autre et utiliser l'URL pour les + encoder, sans utiliser d'encapsulateur CGI + pour toutes les pages pour seulement supprimer ces + informations.

Solution :

On utilise une règle de réécriture pour supprimer + l'information d'état et l'enregistrer dans une variable + d'environnement dont on pourra plus tard extraire la valeur + dans XSSI ou CGI. De cette façon, une URL telle que + /foo/S=java/bar/ sera traduite en + /foo/bar/ et la variable d'environnement + STATUS aura pour valeur "java".

+ +

+RewriteEngine on
+RewriteRule   ^(.*)/S=([^/]+)/(.*)    $1/$3 [E=STATUS:$2]
+

+ +

Hôtes virtuels basés sur l'utilisateur

+ + + +

Description :

Supposons que vous vouliez atteindre la page d'accueil des + utilisateurs sur une même machine au moyen de l'URL + www.nom-utilisateur.hôte.domaine.com, + en vous basant + seulement sur les enregistrements DNS de type A, et ceci sans qu'aucun + hôte virtuel ne soit installé sur cette machine.

Solution :

Dans le cas des requêtes HTTP/1.0, il n'y a pas de solution + ; par contre, avec une requête HTTP/1.1 qui contient un + en-tête HTTP Host:, on peut utiliser le jeu de règles suivant + pour réécrire en interne + http://www.nom-utilisateur.hôte.com/chemin vers + /home/nom-utilisateur/chemin :

+ +

+RewriteEngine on
+RewriteCond   %{HTTP_HOST}                 ^www\.([^.]+)\.host\.com$
+RewriteRule   ^(.*) /home/%1$1
+

Les parenthèses utilisées dans une directive RewriteCond sont capturées dans les +références arrières %1, %2, etc..., alors que +les parenthèses utilisées dans une directive RewriteRule sont capturées dans les +références arrières $1, $2, etc...

+ +

Redirection des répertoires d'accueil pour les étrangers

+ + + +

Description :

On veut rediriger les URLs des répertoires d'accueil vers + un autre serveur www.quelque-part.com lorsque + l'utilisateur demandeur n'appartient pas au domaine local + notre-domaine.com. On rencontre parfois cette + situation dans un contexte d'hôtes virtuels.

Solution :

Juste une condition de réécriture :

+ +

+RewriteEngine on
+RewriteCond   %{REMOTE_HOST}  !^.+\.notre-domaine\.com$
+RewriteRule   ^(/~.+)         http://www.quelque-part.com/$1 [R,L]
+

+ +

Redirection des ancrages

+ + + +

Description :: +
Par défaut, la redirection vers un ancrage HTML ne fonctionne + pas, car mod_rewrite échappe le caractère # en le + transformant en %23, ce qui rend la redirection + inopérante.
+
Solution :: +
On utilise le drapeau [NE] dans la règle + RewriteRule. NE signifie "No Escape". +
+

+ +

Réécriture dépendant de l'heure

+ + + +

Description :

Lorsqu'il s'agit de distribuer des contenus dont la nature + dépend de l'heure, de nombreux webmasters utilisent encore des + scripts CGI qui redirigent par exemple vers des pages + spécifiques. Comment peut-on y parvenir à tenir compte de + l'heure à l'aide de mod_rewrite ?

Solution :

Il existe de nombreuses variables nommées + TIME_xxx utilisables dans les conditions de + réécriture. Utilisées en conjonction avec les modèles de + comparaison lexicographique spéciaux <STRING, + >STRING et =STRING, elles + permettent d'effectuer des redirections dépendant de + l'heure :

+ +

+RewriteEngine on
+RewriteCond   %{TIME_HOUR}%{TIME_MIN} >0700
+RewriteCond   %{TIME_HOUR}%{TIME_MIN} <1900
+RewriteRule   ^foo\.html$             foo.jour.html
+RewriteRule   ^foo\.html$             foo.nuit.html
+

+ +

Avec cet exemple, l'URL foo.html renvoie + le contenu de foo.jour.html durant le + créneau horaire 07:00-19:00, et le contenu de + foo.nuit.html le reste du temps. Agréable + fonctionnalité pour une page d'accueil...

+ +

Compatibilité ascendante pour une migration de YYYY vers + XXXX

+ + + +

Description :

Comment conférer une compatibilité ascendante aux URLs + (existant encore virtuellement) après avoir migré + document.YYYY vers document.XXXX, + c'est à dire après avoir par exemple traduit un lot de + fichiers .html en fichiers .phtml + ?

Solution :

On réécrit simplement le nom du fichier en son nom + de base et vérifie s'il existe aussi avec la nouvelle + extension. Si c'est le cas, on utilise ce nom, sinon on + réécrit l'URL sous sa forme originale.

+ + +

+#   jeu de règles assurant une compatibilité ascendante en réécrivant
+#   document.html en document.phtml si et seulement si document.phtml
+#   existe et document.html n'existe plus
+RewriteEngine on
+RewriteBase   /~quux/
+#   réécriture du fichier en son nom de base,
+#   mais garde en mémoire le fait qu'il s'agit
+#   d'un fichier html
+RewriteRule   ^(.*)\.html$              $1      [C,E=WasHTML:yes]
+#   réécrit vers document.phtml s'il existe
+#   Note : il s'agit d'un exemple de niveau répertoire, si bien que
+#   %{REQUEST_FILENAME} contient le chemin complet du système de fichier
+#   tel qu'il a été construit par le serveur.
+RewriteCond   %{REQUEST_FILENAME}.phtml -f
+RewriteRule   ^(.*)$ $1.phtml                   [S=1]
+#   sinon, restauration du nom de fichier complet original
+RewriteCond   %{ENV:WasHTML}            ^yes$
+RewriteRule   ^(.*)$ $1.html
+

+ +

De l'ancien au nouveau (en interne)

+ + + +

Description :

Supposons que nous ayons récemment renommé la page + foo.html en bar.html, et voulions + maintenant que l'ancienne URL soit toujours valide à des fins + de compatibilité ascendante. En fait, on voudrait que le + changement de nom soit transparent aux utilisateurs de + l'ancienne URL.

Solution :

On réécrit l'ancienne URL en interne vers la nouvelle via + la règle suivante :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  bar.html
+

+ +

De l'ancien au nouveau (en externe)

+ + + +

Description :

Supposons toujours que nous ayons récemment renommé la page + foo.html en bar.html, et voulions + maintenant que l'ancienne URL soit toujours valide à des fins + de compatibilité ascendante. Par contre, nous voulons cette + fois que les utilisateurs de l'ancienne URL soient redirigés + vers la nouvelle, c'est à dire que l'adresse tapée + dans leur navigateur doit aussi être modifiée.

Solution :

On force une redirection HTTP vers la nouvelle URL, ce qui + entraîne une modification de celle du navigateur et aussi de ce + que voit l'utilisateur :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  bar.html  [R]
+

+ +

De statique à dynamique

+ + + +

Description :

Comment transformer une page statique foo.html + en sa variante dynamique foo.cgi de manière + transparente, c'est à dire sans en avertir le + navigateur/utilisateur.

Solution :

On réécrit simplement l'URL en script CGI et force le + gestionnaire de contenu à cgi-script de façon + à ce que le script s'exécute en tant que programme CGI. + Ainsi, une requête vers /~quux/foo.html conduit + en interne à l'invocation de + /~quux/foo.cgi.

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  foo.cgi  [H=cgi-script]
+

+ +

Blocage des robots

+ + + +

Description :

Comment empêcher un robot vraiment gênant de collecter les + pages d'une partie spécifique du site web ? Un fichier + /robots.txt comportant les entrées du "Protocole + d'Exclusion des Robots" ne suffit généralement pas à en venir + à bout.

Solution :

On utilise un jeu de règles qui interdit les URLs de la + partie du site web concernée /~quux/foo/arc/ + (peut-être une partie du serveur avec une arborescence très + développée à travers laquelle le parcours du + robot induirait une charge importante pour le serveur). Nous + devons nous assurer de n'interdire l'accès qu'à ce robot + particulier, c'est à dire qu'il ne suffit pas d'interdire + l'accès à l'hôte sur lequel le robot fonctionne, ce qui + bloquerait aussi les utilisateurs de cet hôte. Pour y + parvenir, on tient aussi compte des informations contenues + dans l'en-tête HTTP User-Agent.

+ +

+RewriteCond %{HTTP_USER_AGENT}   ^NameOfBadRobot.*
+RewriteCond %{REMOTE_ADDR}       ^123\.45\.67\.[8-9]$
+RewriteRule ^/~quux/foo/arc/.+   -   [F]
+

+ +

Blocage du référencement à chaud (Hotlinking) d'images

+ + + +

Description :

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.

Solution :

Cette technique repose sur la valeur de la variable + optionnelle HTTP_REFERER. 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.

Il y a plusieurs manières de gérer cette situation.

+ +

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 www.example.com.

+ +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$    -   [F,NC]
+

+ +

Dans le second exemple, plutôt que de rejeter la requête, + nous affichons une autre image à la place.

+ +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$    /images/go-away.png   [R,NC]
+

+ +

Dans le troisième exemple, nous redirigeons la requête vers + une image appartenant à un site tiers.

+ + +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$ http://other.site.com/image.gif   [R,NC]
+

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.

+ +

Interdiction du mandataire

+ + + +

Description :

Comment interdire l'utilisation du mandataire d'Apache à un + certain hôte, ou même à un utilisateur d'un certain hôte ?

Solution :

Nous devons tout d'abord nous assurer que + mod_rewrite se situe en dessous (!) de + mod_proxy dans le fichier de configuration + lors de la compilation du serveur web Apache. De cette façon, + il est appelé avant mod_proxy. Nous + pouvons alors utiliser la règle suivante pour une interdiction + concernant un hôte...

+ +

+RewriteCond %{REMOTE_HOST} ^mauvais-hôte\.mon-domaine\.com$
+RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
+

+ +

...et celle-ci pour une interdiction concernant un + utilisateur d'un certain hôte :

+ +

+RewriteCond %{REMOTE_IDENT}@%{REMOTE_HOST}
+^mauvais-sujet@mauvais-hôte\.mon-domaine\.com$
+RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
+

+ +

Moteur de réécriture externe

+ + + +

Description :

Une question de la Faq : comment résoudre le problème + FOO/BAR/QUUX/etc. ? mod_rewrite ne semble pas + devoir y apporter de solution...

Solution :

Utiliser une RewriteMap ou table de réécriture externe, c'est + à dire un programme qui agit de la même façon qu'une + RewriteMap. Il + doit être lancé une fois au démarrage d'Apache, recevoir les + URLs des requêtes sur STDIN, et restituer l'URL + résultante (en général réécrite) sur STDOUT (dans + cet ordre !).

+ +

+RewriteEngine on
+RewriteMap    quux-table       prg:/chemin/vers/table.quux.pl
+RewriteRule   ^/~quux/(.*)$  /~quux/${quux-table:$1}
+

+ +

+#!/chemin/vers/perl
+
+#   désactive la mise en tampon des entrées/sorties, qui risque
+#   de provoquer des bouclages infinis pour le serveur Apache
+$| = 1;
+
+#   lit les URLs (une par ligne) depuis stdin et
+#   génère l'URL transformée sur stdout
+
+#   read URLs one per line from stdin and
+#   generate substitution URL on stdout
+while (<>) {
+    s|^foo/|bar/|;
+    print $_;
+}
+

+ +

Ceci n'est qu'un exemple de démonstration qui ne fait que + réécrire les URLs du style /~quux/foo/... vers + /~quux/bar/.... En fait, vous pouvez programmer + la substitution que vous voulez. Notez cependant que si de + tels programmes peuvent aussi être utilisés + par un utilisateur standard, seul l'administrateur du système + peut les écrire.

+ +

Langues Disponibles: en | + fr

+ \ No newline at end of file diff --git a/docs/manual/rewrite/rewrite_guide.xml.fr b/docs/manual/rewrite/rewrite_guide.xml.fr new file mode 100644 index 0000000000..0070e20fd3 --- /dev/null +++ b/docs/manual/rewrite/rewrite_guide.xml.fr @@ -0,0 +1,863 @@ + + + + + + + + + + + Rewrite + + Guide de réécriture des URLs + +

+ +

Ce document complète la documentation de référence du + module mod_rewrite. Il décrit de quelle manière on + peut utiliser le module Apache mod_rewrite pour + résoudre les problèmes typiques relatifs aux URLs auxquels les + webmasters sont souvent confrontés. La résolution de chaque problème + par la configuration des jeux de règles de réécriture d'URLs fait + l'objet d'une description détaillée.

+ + ATTENTION : l'adaptation des exemples à votre + situation en fonction de la configuration de votre serveur pourra + s'avérer nécessaire, par exemple l'ajout du drapeau + [PT] si vous utilisez les modules + mod_alias, mod_userdir, etc... Un + jeu de règles défini dans le contexte du serveur devra aussi être + adapté pour être utilisé dans un contexte .htaccess. + Efforcez-vous toujours de bien comprendre l'effet produit par un jeu + de règles avant de l'utiliser, ce qui pourra vous éviter bien des + problèmes. + +

+Documentation du module +Introduction à mod_rewrite +Guide de réécriture +avancé - exemples utiles avancés +Détails techniques + + +

+ +URLs canoniques + +

Description :

Solution :

+ +

+RewriteRule   ^/~([^/]+)/?(.*)    /u/$1/$2  [R]
+RewriteRule   ^/u/([^/]+)$  /$1/$2/   [R]
+

+ +

Noms d'hôtes canoniques + +

Description :

Solution :

Pour les sites écoutant sur un port autre que 80:

+RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST}   !^$
+RewriteCond %{SERVER_PORT} !^80$
+RewriteRule ^/?(.*)         http://www.exemple.com:%{SERVER_PORT}/$1
+[L,R,NE]
+

+ +

Et pour un site écoutant sur le port 80

+RewriteCond %{HTTP_HOST}   !^www\.exemple\.com [NC]
+RewriteCond %{HTTP_HOST}   !^$
+RewriteRule ^/?(.*)         http://www.exemple.com/$1 [L,R,NE]
+

+ +

+RewriteCond %{HTTP_HOST} !^www\. [NC]
+RewriteCond %{HTTP_HOST} !^$
+RewriteRule ^/?(.*) http://www.%{HTTP_HOST}/$1 [L,R,NE]
+

+ +

+ + <code>DocumentRoot</code>déplacé + +

Description :

En général, la directive DocumentRoot correspond directement à l'URL +"/" du serveur web. Mais souvent, les données qui s'y +trouvent ne sont pas de la première priorité. Par exemple, il peut être +intéressant, pour les visiteurs qui entrent sur le site pour la première +fois, d'être redirigés vers un sous-répertoire particulier +/a-propos-de/. Pour ce faire, on peut utiliser le jeu de +règles suivant :

Solution :

On redirige l'URL / vers + /a-propos-de/: +

+ +

+RewriteEngine on
+RewriteRule   ^/$  /a-propos-de/  [R]
+

+ +

Notez que le même effet peut être obtenu à l'aide de la directive + RedirectMatch :

+ + +RedirectMatch ^/$ http://exemple.com/apropos/ + +

Notez aussi que cet exemple ne réécrit que l'URL racine. En d'autres +termes, il réécrit une requête pour http://example.com/, +mais ne réécrira pas une requête pour +http://example.com/page.html. En fait, si vous avez modifié +la racine de vos documents - c'est à dire si tous vos contenus se +trouvent dans ce sous-répertoire, il vaut mieux simplement modifier +votre directive DocumentRoot que de +procéder à une réécriture d'URLs.

+ +

+ + Problème du slash de fin + +

Description :

Solution :

+ +

Pour y parvenir, on peut utiliser des règles de ce style :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo$  foo/  [R]
+

+ +

Vous pouvez aussi ajouter ce qui suit dans un fichier + .htaccess situé dans le répertoire contenant la + ressource. Notez cependant que cela augmente la charge du processeur.

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteCond    %{REQUEST_FILENAME}  -d
+RewriteRule    ^(.+[^/])$           $1/  [R]
+

+ +

+ + Déplacement des répertoires home vers un autre serveur + +

Description :

Solution :

Avec mod_rewrite, la solution est + évidente. Sur l'ancien serveur web, on redirige simplement + toutes les URLs du style /~user/chemin vers + http://nouveau-serveur/~user/chemin.

+ +

+RewriteEngine on
+RewriteRule   ^/~(.+)  http://nouveau-serveur/~$1  [R,L]
+

+ +

+ + Recherche de pages dans plus d'un répertoire + +

Description :

Le serveur web doit parfois rechercher des pages dans plus + d'un répertoire. Dans ce cas, les vues multiples ou autres + techniques similaires ne sont d'aucun secours.

Solution :

On définit explicitement un jeu de règles qui recherche les + fichiers dans les répertoires.

+ +

+RewriteEngine on
+
+#   on cherche tout d'abord dans dir1/...
+#   ... et si on trouve, on est content et on arrête :
+RewriteCond         %{DOCUMENT_ROOT}/dir1/%{REQUEST_URI}  -f
+RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/dir1/$1  [L]
+
+#   on cherche ensuite dans dir2/...
+#   ... et si on trouve, on est content et on arrête :
+RewriteCond         %{DOCUMENT_ROOT}/dir2/%{REQUEST_URI}  -f
+RewriteRule  ^(.+)  %{DOCUMENT_ROOT}/dir2/$1  [L]
+
+#   sinon, on continue la recherche avec d'autres directives Alias
+#   ou ScriptAlias, etc...
+RewriteRule   ^(.+)  -  [PT]
+

+ +

+ + Définir des variables d'environnement en fonction de + certaines parties de l'URL + +

Description :

Solution :

+ +

+RewriteEngine on
+RewriteRule   ^(.*)/S=([^/]+)/(.*)    $1/$3 [E=STATUS:$2]
+

+ +

+ + Hôtes virtuels basés sur l'utilisateur + +

Description :

Solution :

+ +

+RewriteEngine on
+RewriteCond   %{HTTP_HOST}                 ^www\.([^.]+)\.host\.com$
+RewriteRule   ^(.*) /home/%1$1
+

Les parenthèses utilisées dans une directive RewriteCond sont capturées dans les +références arrières %1, %2, etc..., alors que +les parenthèses utilisées dans une directive RewriteRule sont capturées dans les +références arrières $1, $2, etc...

+ +

+ + Redirection des répertoires d'accueil pour les étrangers + +

Description :

Solution :

Juste une condition de réécriture :

+ +

+RewriteEngine on
+RewriteCond   %{REMOTE_HOST}  !^.+\.notre-domaine\.com$
+RewriteRule   ^(/~.+)         http://www.quelque-part.com/$1 [R,L]
+

+ +

+ + Redirection des ancrages + +

Description :: +
Par défaut, la redirection vers un ancrage HTML ne fonctionne + pas, car mod_rewrite échappe le caractère # en le + transformant en %23, ce qui rend la redirection + inopérante.
+
Solution :: +
On utilise le drapeau [NE] dans la règle + RewriteRule. NE signifie "No Escape". +
+

+ +

+ + Réécriture dépendant de l'heure + +

Description :

Solution :

+ +

+RewriteEngine on
+RewriteCond   %{TIME_HOUR}%{TIME_MIN} >0700
+RewriteCond   %{TIME_HOUR}%{TIME_MIN} <1900
+RewriteRule   ^foo\.html$             foo.jour.html
+RewriteRule   ^foo\.html$             foo.nuit.html
+

+ +

+ + Compatibilité ascendante pour une migration de YYYY vers + XXXX + +

Description :

Solution :

+ + +

+#   jeu de règles assurant une compatibilité ascendante en réécrivant
+#   document.html en document.phtml si et seulement si document.phtml
+#   existe et document.html n'existe plus
+RewriteEngine on
+RewriteBase   /~quux/
+#   réécriture du fichier en son nom de base,
+#   mais garde en mémoire le fait qu'il s'agit
+#   d'un fichier html
+RewriteRule   ^(.*)\.html$              $1      [C,E=WasHTML:yes]
+#   réécrit vers document.phtml s'il existe
+#   Note : il s'agit d'un exemple de niveau répertoire, si bien que
+#   %{REQUEST_FILENAME} contient le chemin complet du système de fichier
+#   tel qu'il a été construit par le serveur.
+RewriteCond   %{REQUEST_FILENAME}.phtml -f
+RewriteRule   ^(.*)$ $1.phtml                   [S=1]
+#   sinon, restauration du nom de fichier complet original
+RewriteCond   %{ENV:WasHTML}            ^yes$
+RewriteRule   ^(.*)$ $1.html
+

+ +

+ + De l'ancien au nouveau (en interne) + +

Description :

Solution :

On réécrit l'ancienne URL en interne vers la nouvelle via + la règle suivante :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  bar.html
+

+ +

+ + De l'ancien au nouveau (en externe) + +

Description :

Solution :

On force une redirection HTTP vers la nouvelle URL, ce qui + entraîne une modification de celle du navigateur et aussi de ce + que voit l'utilisateur :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  bar.html  [R]
+

+ +

+ + De statique à dynamique + +

Description :

Comment transformer une page statique foo.html + en sa variante dynamique foo.cgi de manière + transparente, c'est à dire sans en avertir le + navigateur/utilisateur.

Solution :

+ +

+RewriteEngine  on
+RewriteBase    /~quux/
+RewriteRule    ^foo\.html$  foo.cgi  [H=cgi-script]
+

+ +

+ + Blocage des robots + +

Description :

Solution :

+ +

+RewriteCond %{HTTP_USER_AGENT}   ^NameOfBadRobot.*
+RewriteCond %{REMOTE_ADDR}       ^123\.45\.67\.[8-9]$
+RewriteRule ^/~quux/foo/arc/.+   -   [F]
+

+ +

+ + Blocage du référencement à chaud (Hotlinking) d'images + +

Description :

Solution :

Il y a plusieurs manières de gérer cette situation.

+ +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$    -   [F,NC]
+

+ +

Dans le second exemple, plutôt que de rejeter la requête, + nous affichons une autre image à la place.

+ +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$    /images/go-away.png   [R,NC]
+

+ +

Dans le troisième exemple, nous redirigeons la requête vers + une image appartenant à un site tiers.

+ + +

+RewriteCond %{HTTP_REFERER} !^$
+RewriteCond %{HTTP_REFERER} !www.example.com [NC]
+RewriteRule \.(gif|jpg|png)$ http://other.site.com/image.gif   [R,NC]
+

+ +

+ + Interdiction du mandataire + +

Description :

Comment interdire l'utilisation du mandataire d'Apache à un + certain hôte, ou même à un utilisateur d'un certain hôte ?

Solution :

Nous devons tout d'abord nous assurer que + mod_rewrite se situe en dessous (!) de + mod_proxy dans le fichier de configuration + lors de la compilation du serveur web Apache. De cette façon, + il est appelé avant mod_proxy. Nous + pouvons alors utiliser la règle suivante pour une interdiction + concernant un hôte...

+ +

+RewriteCond %{REMOTE_HOST} ^mauvais-hôte\.mon-domaine\.com$
+RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
+

+ +

...et celle-ci pour une interdiction concernant un + utilisateur d'un certain hôte :

+ +

+RewriteCond %{REMOTE_IDENT}@%{REMOTE_HOST}
+^mauvais-sujet@mauvais-hôte\.mon-domaine\.com$
+RewriteRule !^http://[^/.]\.mon-domaine.com.*  - [F]
+

+ +

+ + Moteur de réécriture externe + +

Description :

Une question de la Faq : comment résoudre le problème + FOO/BAR/QUUX/etc. ? mod_rewrite ne semble pas + devoir y apporter de solution...

Solution :

Utiliser une RewriteMap ou table de réécriture externe, c'est + à dire un programme qui agit de la même façon qu'une + RewriteMap. Il + doit être lancé une fois au démarrage d'Apache, recevoir les + URLs des requêtes sur STDIN, et restituer l'URL + résultante (en général réécrite) sur STDOUT (dans + cet ordre !).

+ +

+RewriteEngine on
+RewriteMap    quux-table       prg:/chemin/vers/table.quux.pl
+RewriteRule   ^/~quux/(.*)$  /~quux/${quux-table:$1}
+

+ +

+#!/chemin/vers/perl
+
+#   désactive la mise en tampon des entrées/sorties, qui risque
+#   de provoquer des bouclages infinis pour le serveur Apache
+$| = 1;
+
+#   lit les URLs (une par ligne) depuis stdin et
+#   génère l'URL transformée sur stdout
+
+#   read URLs one per line from stdin and
+#   generate substitution URL on stdout
+while (<>) {
+    s|^foo/|bar/|;
+    print $_;
+}
+

+ +

+ + + diff --git a/docs/manual/rewrite/rewrite_guide.xml.meta b/docs/manual/rewrite/rewrite_guide.xml.meta index 20f07d7eea..747d300f66 100644 --- a/docs/manual/rewrite/rewrite_guide.xml.meta +++ b/docs/manual/rewrite/rewrite_guide.xml.meta @@ -8,5 +8,6 @@ en + fr diff --git a/docs/manual/rewrite/rewrite_intro.html b/docs/manual/rewrite/rewrite_intro.html index e6e697d2ff..0e3459c3a8 100644 --- a/docs/manual/rewrite/rewrite_intro.html +++ b/docs/manual/rewrite/rewrite_intro.html @@ -3,3 +3,7 @@ URI: rewrite_intro.html.en Content-Language: en Content-type: text/html; charset=ISO-8859-1 + +URI: rewrite_intro.html.fr +Content-Language: fr +Content-type: text/html; charset=ISO-8859-1 diff --git a/docs/manual/rewrite/rewrite_intro.html.en b/docs/manual/rewrite/rewrite_intro.html.en index 0c07ca1b4f..47db2ac461 100644 --- a/docs/manual/rewrite/rewrite_intro.html.en +++ b/docs/manual/rewrite/rewrite_intro.html.en @@ -18,7 +18,8 @@

Apache > HTTP Server > Documentation > Version 2.3 > Rewrite

Apache mod_rewrite Introduction

Available Languages: en

Available Languages: en | + fr

This document supplements the mod_rewrite @@ -305,7 +306,8 @@ the Rewrit


 
-Available Languages:  en 
+Available Languages:  en  |
+ fr 
 

 Copyright 2009 The Apache Software Foundation.
Licensed under the Apache License, Version 2.0.
 Modules | Directives | FAQ | Glossary | Sitemap
diff --git a/docs/manual/rewrite/rewrite_intro.html.fr b/docs/manual/rewrite/rewrite_intro.html.fr
new file mode 100644
index 0000000000..1c652d9158
--- /dev/null
+++ b/docs/manual/rewrite/rewrite_intro.html.fr
@@ -0,0 +1,333 @@
+
+
+
+Introduction au module Apache mod_rewrite - Serveur Apache HTTP
+
+
+
+
+
+Modules | Directives | FAQ | Glossaire | Plan du site
+Serveur Apache HTTP Version 2.3
+
+
+
+Apache > Serveur HTTP > Documentation > Version 2.3 > Rewrite
Introduction au module Apache mod_rewrite
+
+Langues Disponibles:  en  |
+ fr 
+
+
+Ce document est un complément à la documentation de référence du module
+mod_rewrite. Il décrit les concepts de base dont la
+connaissance est nécessaire pour l'utilisation de
+mod_rewrite. D'autres documents entrent d'avantage dans
+les détails, mais celui-ci devrait aider le débutant à se mouiller les
+pieds.
+
+
+ Introduction
+ Expressions rationnelles
+ Les bases des règles de réécriture
+ Drapeaux de réécriture
+ Conditions de réécriture
+ Tables de réécriture
+ Fichiers .htaccess
+
Voir aussi
Documentation du
+module
Détails techniques
Solutions pratiques aux problèmes
+courants
Solutions pratiques aux
+problèmes plus complexes
+
+
+Introduction
+Le module Apache mod_rewrite est un module puissant
+et sophistiqué qui permet la réécriture des URLs. Grâce à lui, vous
+pouvez effectuer quasiment tous les types de réécriture d'URLs dont vous
+avez besoin. Il est cependant assez complexe, et peut paraître
+intimidant au débutant. Certains ont aussi tendance à traiter les
+règles de réécriture comme des incantations magiques, et à les utiliser
+sans vraiment comprendre leur manière d'agir.
+
+Ce document a pour ambition d'être suffisamment explicite pour
+permettre la compréhension, et non la copie en aveugle, de ce qui suit.
+
+
+Gardez à l'esprit que de nombreuses tâches de manipulation d'URLs
+courantes n'ont pas besoin de la puissance et de la complexité de
+mod_rewrite. Pour les tâches simples, voir
+mod_alias et la documentation sur la Mise en correspondance des URLs avec le
+système de fichiers.
+
+Enfin, avant de procéder, assurez-vous d'avoir configuré la directive
+RewriteLog. Bien que ce
+fichier journal puisse contenir une quantité impressionnante d'informations,
+il s'avère indispensable pour le débogage des problèmes avec la
+configuration de mod_rewrite, car il vous indiquera
+exactement la manière dont chaque règle est traitée.
+

+
+Expressions rationnelles
+
+mod_rewrite utilise le vocabulaire des Expressions rationnelles compatibles Perl.
+Ce document n'a pas pour prétention d'être une référence détaillée des
+expressions rationnelles. A cet effet, nous recommandons les pages de manuel de PCRE, la page de manuel des
+expressions rationnelles Perl, et l'ouvrage Mastering
+Regular Expressions, by Jeffrey Friedl.
+
+Dans ce document, nous avons pour but de vous fournir suffisamment de
+vocabulaire des expressions rationnelles pour vous mettre le pied à
+l'étrier, sans être dépassé, en espérant que les directives RewriteRule vous apparaîtront comme des
+formules scientifiques, plutôt que comme des incantations magiques.
+
+Vocabulaire des expressions rationnelles
+
+Vous trouverez dans ce qui suit le minimum à connaître pour être en
+mesure d'écrire des expressions rationnelles et des règles RewriteRule. Ceci ne représente
+certainement pas un vocabulaire des expressions rationnelles complet,
+mais constitue un bon point de départ, et devrait vous aider à
+déchiffrer les expressions rationnelles simples, et à écrire vos propres
+expressions.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Motif Signification Exemple
. Correspond à tout caractère unique
+ c.t correspondra à cat,
+cot, cut, etc.
+ Répète le caractère de correspondance
+précédent une ou plusieurs fois a+ correspond à a, aa,
+aaa, etc.
* Répète le caractère de correspondance
+précédent zéro ou plusieurs fois a* correspond à tout ce à quoi correspond
+a+, mais correspond aussi à la chaîne vide.
? Rend la correspondance optionnelle. 
+colou?r correspondra à color et colour.
^ Appelé ancrage, correspond au début de la
+chaîne ^a correspond à une chaîne qui commence par
+a
$ L'autre ancrage, correspond à la fin de
+la chaîne. a$ correspond à une chaîne qui se termine par
+a.
( ) Regroupe plusieurs caractères en une
+seule entité, et conserve une correspondance à des fins d'utilisation
+dans une référence arrière. (ab)+
+correspond à ababab - à savoir, le +
+s'applique au groupe.
+Pour plus de détails sur les références arrières, voir ci-dessous.
[ ] Une classe de caractères - correspond à
+un des caractères de la classe c[uoa]t correspond à cut,
+cot ou cat.
[^ ] Négation de la classe de caractères -
+correspond à tout caractère ne faisant pas partie de la classe c[^/]t correspond à cat ou
+c=t mais pas à c/t
+
+Avec mod_rewrite, le caractère ! peut
+préfixer une expression rationnelle afin d'en exprimer la négation.
+Autrement dit, une chaîne ne correspondra que si elle ne correspond pas
+à l'expression située après le !.
+
+
+
+Disponibilité des références
+arrières dans les expressions rationnelles
+
+      Vous devez vous souvenir d'une chose importante : chaque fois
+      que vous utilisez des parenthèses dans un Modèle ou dans
+      un des modèles de conditions, des références arrières
+      sont créées en interne et peuvent être rappelées via les chaînes
+      $N et %N (voir ci-dessous). Ces
+      références sont disponibles lors de la création des chaînes de
+      Substitution et des Chaînes de test. La figure 2
+      montre à quels endroits les références arrières sont suceptibles
+      d'être développées.
+
+
+      

+      Figure 2: Le cheminement d'une référence arrière à
+      travers une règle.
+
+
+
+

+
+Les bases des règles de réécriture
+Une règle de réécriture RewriteRule est constituée de trois
+arguments séparés par des espaces. Les arguments sont :
+
+Modèle: le modèle des URLs auxquelles la règle doit
+s'appliquer;
+Substitution: vers quoi la requête correspondante doit être
+transformée;
+[drapeaux]: options affectant la requête réécrite.
+
+
+Le Modèle est toujours une expression
+rationnelle comparée au chemin de l'URL de la requête entrante (la
+partie située après le nom d'hôte mais avant tout point d'interrogation
+qui indique le début d'une chaîne de requête).
+
+La chaîne de Substitution peut, quant à elle, être de
+trois types :
+
+
+Un chemin complet du système de fichiers vers une ressource
+
+
+RewriteRule ^/jeux.* /usr/local/jeux/web
+
+Ceci peut faire correspondre une requête à toute localisation voulue de
+votre système de fichiers, un peu comme la directive Alias.
+
+
+Un chemin web vers une ressource
+
+
+RewriteRule ^/foo$ /bar
+
+Si la directive DocumentRoot a
+pour valeur /usr/local/apache2/htdocs, cette règle va faire
+correspondre les requêtes pour http://example.com/foo au
+chemin /usr/local/apache2/htdocs/bar.
+
+
+Une URL absolue
+
+
+RewriteRule ^/produits/vues$ http://site2.exemple.com/voirproduits.html [R]
+
+Ceci informe le client qu'il doit effectuer une nouvelle requête vers
+l'URL spécifiée.
+
+
+
+La chaîne de Substitution peut aussi contenir des
+références arrières vers des parties du chemin d'URL entrant
+correspondant au Modèle. Considérons ce qui suit :
+
+RewriteRule ^/produits/(.*)/view$ /var/web/produitsdb/$1
+
+La variable $1 sera remplacée par tout texte
+correspondant à l'expression située entre les parenthèses dans le
+Modèle. Par exemple, une requête pour
+http://example.com/produits/r14df/vue correspondra au
+chemin /var/web/produitsdb/r14df.
+
+S'il y a plus d'une expression entre parenthèses, elle seront
+accessibles selon leur ordre d'apparition via les variables
+$1, $2, $3, etc...
+
+
+

+
+Drapeaux de réécriture
+Le comportement d'une règle RewriteRule peut être modifié par la
+présence d'un ou plusieurs drapeaux en fin de règle. Par exemple, les
+conditions de correspondance d'une règle peuvent être rendues
+insensibles à la casse par la présence du drapeau [NC] :
+
+
+RewriteRule ^puppy.html petitchien.html [NC]
+
+
+Pour une liste des drapeaux disponibles, leurs significations, et des
+exemples, voir le document Drapeaux de
+réécriture.
+
+

+
+Conditions de réécriture
+Il est possible d'utiliser une ou plusieurs directives RewriteCond pour restreindre les types
+de requêtes auxquelles devra s'appliquer la règle RewriteRule suivante. Le premier
+argument est une variable décrivant une caractéristique de la requête,
+le second argument est une expression rationnelle
+qui doit correspondre à la variable, et un troisième argument optionnel
+est une liste de drapeaux qui modifient la manière dont la
+correspondance est évaluée.
+
+Par exemple, pour renvoyer toutes les requêtes en provenance d'une
+certaine tranche d'adresses IP vers un autre serveur, vous pouvez
+utiliser :
+
+RewriteCond %{REMOTE_ADDR} ^10\.2\.

+RewriteRule (.*) http://intranet.exemple.com$1
+
+
+Si vous spécifiez plus d'une directive RewriteCond, ces directives
+doivent toutes être satisfaites pour que la règle RewriteRule suivante s'applique. Par exemple,
+pour interdire les requêtes qui contiennent le mot "hack" dans la chaîne
+de requête, sauf si elles contiennent aussi un cookie contenant le mot
+"go", vous pouvez utiliser :
+
+RewriteCond %{QUERY_STRING} hack

+RewriteCond %{HTTP_COOKIE} !go

+RewriteRule .* - [F]
+
+Notez que le point d'exclamation indique une correspondance négative
+; ainsi, la règle n'est appliquée que si le cookie ne contient pas "go"
+
+Les correspondances dans les expressions rationnelles contenues dans
+les directives RewriteCond
+peuvent constituer des parties de la chaîne de Substitution
+de la règle RewriteRule via
+les variables %1, %2, etc... Par
+exemple, ce qui suit va diriger la requête vers un répertoire différent
+en fonction du nom d'hôte utilisé pour accéder au site :
+
+RewriteCond %{HTTP_HOST} (.*)

+RewriteRule ^/(.*) /sites/%1/$1
+
+Si la requête concernait http://example.com/foo/bar,
+alors %1 contiendrait example.com et
+$1 contiendrait foo/bar.
+
+
+
+

+
+Tables de réécriture
+Voir la directive
+RewriteMap.
+

+
+Fichiers .htaccess
+
+La réécriture est en général définie au niveau de la configuration du
+serveur principal (en dehors de toute section <Directory>) ou dans une section  <VirtualHost>. Il s'agit là de la
+manière la plus simple de mettre en oeuvre la réécriture et nous la
+recommandons. Il est possible, cependant, de mettre en oeuvre la
+réécriture au sein d'une section <Directory> ou d'un fichier .htaccess ; ce type de
+configuration est cependant plus complexe. Cette technique est appelée
+réécriture par répertoire.
+
+La principale différence avec les réécritures au niveau du serveur réside
+dans le fait que le préfixe du chemin du répertoire contenant le fichier
+.htaccess est supprimé avant la mise en correspondance dans
+la règle RewriteRule. De
+plus, on doit utiliser la directive RewriteBase pour s'assurer que la
+requête est correctement mise en correspondance.
+
+
+
+Langues Disponibles:  en  |
+ fr 
+

+Copyright 2009 The Apache Software Foundation.
Autorisé sous Apache License, Version 2.0.
+Modules | Directives | FAQ | Glossaire | Plan du site
+
\ No newline at end of file
diff --git a/docs/manual/rewrite/rewrite_intro.xml.fr b/docs/manual/rewrite/rewrite_intro.xml.fr
new file mode 100644
index 0000000000..8b8228d596
--- /dev/null
+++ b/docs/manual/rewrite/rewrite_intro.xml.fr
@@ -0,0 +1,354 @@
+
+
+
+
+
+
+
+
+
+
+Rewrite
+
+  Introduction au module Apache mod_rewrite
+
+
+Ce document est un complément à la documentation de référence du module
+mod_rewrite. Il décrit les concepts de base dont la
+connaissance est nécessaire pour l'utilisation de
+mod_rewrite. D'autres documents entrent d'avantage dans
+les détails, mais celui-ci devrait aider le débutant à se mouiller les
+pieds.
+
+
+
+Documentation du
+module
+Détails techniques
+Solutions pratiques aux problèmes
+courants
+Solutions pratiques aux
+problèmes plus complexes
+
+Introduction
+Le module Apache mod_rewrite est un module puissant
+et sophistiqué qui permet la réécriture des URLs. Grâce à lui, vous
+pouvez effectuer quasiment tous les types de réécriture d'URLs dont vous
+avez besoin. Il est cependant assez complexe, et peut paraître
+intimidant au débutant. Certains ont aussi tendance à traiter les
+règles de réécriture comme des incantations magiques, et à les utiliser
+sans vraiment comprendre leur manière d'agir.
+
+Ce document a pour ambition d'être suffisamment explicite pour
+permettre la compréhension, et non la copie en aveugle, de ce qui suit.
+
+
+Gardez à l'esprit que de nombreuses tâches de manipulation d'URLs
+courantes n'ont pas besoin de la puissance et de la complexité de
+mod_rewrite. Pour les tâches simples, voir
+mod_alias et la documentation sur la Mise en correspondance des URLs avec le
+système de fichiers.
+
+Enfin, avant de procéder, assurez-vous d'avoir configuré la directive
+RewriteLog. Bien que ce
+fichier journal puisse contenir une quantité impressionnante d'informations,
+il s'avère indispensable pour le débogage des problèmes avec la
+configuration de mod_rewrite, car il vous indiquera
+exactement la manière dont chaque règle est traitée.
+
+
+Expressions rationnelles
+
+mod_rewrite utilise le vocabulaire des Expressions rationnelles compatibles Perl.
+Ce document n'a pas pour prétention d'être une référence détaillée des
+expressions rationnelles. A cet effet, nous recommandons les pages de manuel de PCRE, la page de manuel des
+expressions rationnelles Perl, et l'ouvrage Mastering
+Regular Expressions, by Jeffrey Friedl.
+
+Dans ce document, nous avons pour but de vous fournir suffisamment de
+vocabulaire des expressions rationnelles pour vous mettre le pied à
+l'étrier, sans être dépassé, en espérant que les directives RewriteRule vous apparaîtront comme des
+formules scientifiques, plutôt que comme des incantations magiques.
+
+Vocabulaire des expressions rationnelles
+
+Vous trouverez dans ce qui suit le minimum à connaître pour être en
+mesure d'écrire des expressions rationnelles et des règles RewriteRule. Ceci ne représente
+certainement pas un vocabulaire des expressions rationnelles complet,
+mais constitue un bon point de départ, et devrait vous aider à
+déchiffrer les expressions rationnelles simples, et à écrire vos propres
+expressions.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+Motif Signification Exemple
. Correspond à tout caractère unique
+ c.t correspondra à cat,
+cot, cut, etc.
+ Répète le caractère de correspondance
+précédent une ou plusieurs fois a+ correspond à a, aa,
+aaa, etc.
* Répète le caractère de correspondance
+précédent zéro ou plusieurs fois a* correspond à tout ce à quoi correspond
+a+, mais correspond aussi à la chaîne vide.
? Rend la correspondance optionnelle. 
+colou?r correspondra à color et colour.
^ Appelé ancrage, correspond au début de la
+chaîne ^a correspond à une chaîne qui commence par
+a
$ L'autre ancrage, correspond à la fin de
+la chaîne. a$ correspond à une chaîne qui se termine par
+a.
( ) Regroupe plusieurs caractères en une
+seule entité, et conserve une correspondance à des fins d'utilisation
+dans une référence arrière. (ab)+
+correspond à ababab - à savoir, le +
+s'applique au groupe.
+Pour plus de détails sur les références arrières, voir ci-dessous.
[ ] Une classe de caractères - correspond à
+un des caractères de la classe c[uoa]t correspond à cut,
+cot ou cat.
[^ ] Négation de la classe de caractères -
+correspond à tout caractère ne faisant pas partie de la classe c[^/]t correspond à cat ou
+c=t mais pas à c/t
+
+Avec mod_rewrite, le caractère ! peut
+préfixer une expression rationnelle afin d'en exprimer la négation.
+Autrement dit, une chaîne ne correspondra que si elle ne correspond pas
+à l'expression située après le !.
+
+
+
+Disponibilité des références
+arrières dans les expressions rationnelles
+
+      Vous devez vous souvenir d'une chose importante : chaque fois
+      que vous utilisez des parenthèses dans un Modèle ou dans
+      un des modèles de conditions, des références arrières
+      sont créées en interne et peuvent être rappelées via les chaînes
+      $N et %N (voir ci-dessous). Ces
+      références sont disponibles lors de la création des chaînes de
+      Substitution et des Chaînes de test. La figure 2
+      montre à quels endroits les références arrières sont suceptibles
+      d'être développées.
+
+
+      

+      Figure 2: Le cheminement d'une référence arrière à
+      travers une règle.
+
+
+
+
+
+Les bases des règles de réécriture
+Une règle de réécriture RewriteRule est constituée de trois
+arguments séparés par des espaces. Les arguments sont :
+
+Modèle: le modèle des URLs auxquelles la règle doit
+s'appliquer;
+Substitution: vers quoi la requête correspondante doit être
+transformée;
+[drapeaux]: options affectant la requête réécrite.
+
+
+Le Modèle est toujours une expression
+rationnelle comparée au chemin de l'URL de la requête entrante (la
+partie située après le nom d'hôte mais avant tout point d'interrogation
+qui indique le début d'une chaîne de requête).
+
+La chaîne de Substitution peut, quant à elle, être de
+trois types :
+
+
+Un chemin complet du système de fichiers vers une ressource
+
+
+RewriteRule ^/jeux.* /usr/local/jeux/web
+
+Ceci peut faire correspondre une requête à toute localisation voulue de
+votre système de fichiers, un peu comme la directive Alias.
+
+
+Un chemin web vers une ressource
+
+
+RewriteRule ^/foo$ /bar
+
+Si la directive DocumentRoot a
+pour valeur /usr/local/apache2/htdocs, cette règle va faire
+correspondre les requêtes pour http://example.com/foo au
+chemin /usr/local/apache2/htdocs/bar.
+
+
+Une URL absolue
+
+
+RewriteRule ^/produits/vues$ http://site2.exemple.com/voirproduits.html [R]
+
+Ceci informe le client qu'il doit effectuer une nouvelle requête vers
+l'URL spécifiée.
+
+
+
+La chaîne de Substitution peut aussi contenir des
+références arrières vers des parties du chemin d'URL entrant
+correspondant au Modèle. Considérons ce qui suit :
+
+RewriteRule ^/produits/(.*)/view$ /var/web/produitsdb/$1
+
+La variable $1 sera remplacée par tout texte
+correspondant à l'expression située entre les parenthèses dans le
+Modèle. Par exemple, une requête pour
+http://example.com/produits/r14df/vue correspondra au
+chemin /var/web/produitsdb/r14df.
+
+S'il y a plus d'une expression entre parenthèses, elle seront
+accessibles selon leur ordre d'apparition via les variables
+$1, $2, $3, etc...
+
+
+
+
+Drapeaux de réécriture
+Le comportement d'une règle RewriteRule peut être modifié par la
+présence d'un ou plusieurs drapeaux en fin de règle. Par exemple, les
+conditions de correspondance d'une règle peuvent être rendues
+insensibles à la casse par la présence du drapeau [NC] :
+
+
+RewriteRule ^puppy.html petitchien.html [NC]
+
+
+Pour une liste des drapeaux disponibles, leurs significations, et des
+exemples, voir le document Drapeaux de
+réécriture.
+
+
+
+
+Conditions de réécriture
+Il est possible d'utiliser une ou plusieurs directives RewriteCond pour restreindre les types
+de requêtes auxquelles devra s'appliquer la règle RewriteRule suivante. Le premier
+argument est une variable décrivant une caractéristique de la requête,
+le second argument est une expression rationnelle
+qui doit correspondre à la variable, et un troisième argument optionnel
+est une liste de drapeaux qui modifient la manière dont la
+correspondance est évaluée.
+
+Par exemple, pour renvoyer toutes les requêtes en provenance d'une
+certaine tranche d'adresses IP vers un autre serveur, vous pouvez
+utiliser :
+
+RewriteCond %{REMOTE_ADDR} ^10\.2\.

+RewriteRule (.*) http://intranet.exemple.com$1
+
+
+Si vous spécifiez plus d'une directive RewriteCond, ces directives
+doivent toutes être satisfaites pour que la règle RewriteRule suivante s'applique. Par exemple,
+pour interdire les requêtes qui contiennent le mot "hack" dans la chaîne
+de requête, sauf si elles contiennent aussi un cookie contenant le mot
+"go", vous pouvez utiliser :
+
+RewriteCond %{QUERY_STRING} hack

+RewriteCond %{HTTP_COOKIE} !go

+RewriteRule .* - [F]
+
+Notez que le point d'exclamation indique une correspondance négative
+; ainsi, la règle n'est appliquée que si le cookie ne contient pas "go"
+
+Les correspondances dans les expressions rationnelles contenues dans
+les directives RewriteCond
+peuvent constituer des parties de la chaîne de Substitution
+de la règle RewriteRule via
+les variables %1, %2, etc... Par
+exemple, ce qui suit va diriger la requête vers un répertoire différent
+en fonction du nom d'hôte utilisé pour accéder au site :
+
+RewriteCond %{HTTP_HOST} (.*)

+RewriteRule ^/(.*) /sites/%1/$1
+
+Si la requête concernait http://example.com/foo/bar,
+alors %1 contiendrait example.com et
+$1 contiendrait foo/bar.
+
+
+
+
+
+Tables de réécriture
+Voir la directive
+RewriteMap.
+
+
+Fichiers .htaccess
+
+La réécriture est en général définie au niveau de la configuration du
+serveur principal (en dehors de toute section Directory) ou dans une section  VirtualHost. Il s'agit là de la
+manière la plus simple de mettre en oeuvre la réécriture et nous la
+recommandons. Il est possible, cependant, de mettre en oeuvre la
+réécriture au sein d'une section Directory ou d'un fichier .htaccess ; ce type de
+configuration est cependant plus complexe. Cette technique est appelée
+réécriture par répertoire.
+
+La principale différence avec les réécritures au niveau du serveur réside
+dans le fait que le préfixe du chemin du répertoire contenant le fichier
+.htaccess est supprimé avant la mise en correspondance dans
+la règle RewriteRule. De
+plus, on doit utiliser la directive RewriteBase pour s'assurer que la
+requête est correctement mise en correspondance.
+
+
+
+
+
diff --git a/docs/manual/rewrite/rewrite_intro.xml.meta b/docs/manual/rewrite/rewrite_intro.xml.meta
index c1e90d6f9f..4d31be6f51 100644
--- a/docs/manual/rewrite/rewrite_intro.xml.meta
+++ b/docs/manual/rewrite/rewrite_intro.xml.meta
@@ -8,5 +8,6 @@
 
   
     en
+    fr
   
 
-- 
2.40.0

Motif	Signification	Exemple
`.`	Correspond à tout caractère unique +	`c.t` correspondra à `cat`, +`cot`, `cut`, etc.
`+`	Répète le caractère de correspondance +précédent une ou plusieurs fois	`a+` correspond à `a`, `aa`, +`aaa`, etc.
`*`	Répète le caractère de correspondance +précédent zéro ou plusieurs fois	`a*` correspond à tout ce à quoi correspond +`a+`, mais correspond aussi à la chaîne vide.
`?`	Rend la correspondance optionnelle.	+`colou?r` correspondra à `color` et `colour`.
`^`	Appelé ancrage, correspond au début de la +chaîne	`^a` correspond à une chaîne qui commence par +`a`
`$`	L'autre ancrage, correspond à la fin de +la chaîne.	`a$` correspond à une chaîne qui se termine par +`a`.
`( )`	Regroupe plusieurs caractères en une +seule entité, et conserve une correspondance à des fins d'utilisation +dans une référence arrière.	`(ab)+` +correspond à `ababab` - à savoir, le `+` +s'applique au groupe. +Pour plus de détails sur les références arrières, voir ci-dessous.
`[ ]`	Une classe de caractères - correspond à +un des caractères de la classe	`c[uoa]t` correspond à `cut`, +`cot` ou `cat`.
`[^ ]`	Négation de la classe de caractères - +correspond à tout caractère ne faisant pas partie de la classe	`c[^/]t` correspond à `cat` ou +`c=t` mais pas à `c/t`

Motif	Signification	Exemple
`.`	Correspond à tout caractère unique +	`c.t` correspondra à `cat`, +`cot`, `cut`, etc.
`+`	Répète le caractère de correspondance +précédent une ou plusieurs fois	`a+` correspond à `a`, `aa`, +`aaa`, etc.
`*`	Répète le caractère de correspondance +précédent zéro ou plusieurs fois	`a*` correspond à tout ce à quoi correspond +`a+`, mais correspond aussi à la chaîne vide.
`?`	Rend la correspondance optionnelle.	+`colou?r` correspondra à `color` et `colour`.
`^`	Appelé ancrage, correspond au début de la +chaîne	`^a` correspond à une chaîne qui commence par +`a`
`$`	L'autre ancrage, correspond à la fin de +la chaîne.	`a$` correspond à une chaîne qui se termine par +`a`.
`( )`	Regroupe plusieurs caractères en une +seule entité, et conserve une correspondance à des fins d'utilisation +dans une référence arrière.	`(ab)+` +correspond à `ababab` - à savoir, le `+` +s'applique au groupe. +Pour plus de détails sur les références arrières, voir ci-dessous.
`[ ]`	Une classe de caractères - correspond à +un des caractères de la classe	`c[uoa]t` correspond à `cut`, +`cot` ou `cat`.
`[^ ]`	Négation de la classe de caractères - +correspond à tout caractère ne faisant pas partie de la classe	`c[^/]t` correspond à `cat` ou +`c=t` mais pas à `c/t`