From: Lucien Gentis
Date: Fri, 15 May 2026 16:08:22 +0000 (+0000)
Subject: fr doc XML file update.
X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=402bb00a8d1bf57eff45260b93b5024a8ec265eb;p=thirdparty%2Fapache%2Fhttpd.git
fr doc XML file update.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934227 13f79535-47bb-0310-9956-ffa450edef68
---
diff --git a/docs/manual/mod/mod_rewrite.xml.fr b/docs/manual/mod/mod_rewrite.xml.fr
index 40d022c4f2..b43f53b970 100644
--- a/docs/manual/mod/mod_rewrite.xml.fr
+++ b/docs/manual/mod/mod_rewrite.xml.fr
@@ -1,7 +1,7 @@
-
+
@@ -13,7 +13,7 @@
(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,
@@ -42,28 +42,25 @@ règles permettant de réécrire les URLs des requêtes
avec le système de fichiers. Cependant, on peut aussi l'utiliser
pour rediriger une URL vers une autre URL, ou pour invoquer une
requête interne à destination du mandataire.
- mod_rewrite fournit une méthode souple et
- puissante pour manipuler les URLs en utilisant un nombre illimité
- de règles. Chaque règle peut être associée à un nombre illimité de
- conditions, afin de vous permettre de réécrire les URLs en
- fonction de variables du serveur, de variables d'environnement,
- d'en-têtes HTTP, ou de repères temporels.
- mod_rewrite agit sur la totalité de l'URL, y
- compris la partie chemin. Une règle de réécriture peut être
- invoquée dans httpd.conf ou dans un fichier
- .htaccess. Le chemin généré par une règle de
- réécriture peut inclure une chaîne de paramètres, ou peut renvoyer
- vers un traitement secondaire interne, une redirection vers une
+
+
mod_rewrite fournit une méthode souple et puissante
+ pour manipuler les URLs en utilisant un nombre illimité de règles. Chaque
+ règle peut être associée à un nombre illimité de conditions, afin de vous
+ permettre de réécrire les URLs en fonction de variables du serveur, de
+ variables d'environnement, de cookies, d'en-têtes HTTP, ou de repères
+ temporels.
+ mod_rewrite agit sur la totalité de l'URL, ou de toute
+ partie de cette dernière, y compris PATH_INFO ou QUERY_STRING.
+
+ Une règle de réécriture peut être invoquée dans les fichiers de
+ configuration globale du serveur ou dans un contexte de répertoire. Le chemin généré par
+ une règle de réécriture peut inclure une chaîne de paramètres, ou peut
+ renvoyer vers un traitement secondaire interne, une redirection vers une
requête externe ou vers le mandataire interne.
- Une expression rationnelle ne nécessite des guillemets que si elle
- contient des espaces non échappées et dans ce cas, les guillemets simples
- ou doubles sont équivalents.
-
- Vous trouverez plus de détails, discussions et exemples
- dans la
- documentation détaillée
- sur mod_rewrite.
+ Vous trouverez plus de détails, discussions et exemples dans le Guide détaillé sur mod_rewrite.
Journalisation
@@ -83,27 +80,29 @@ règles permettant de réécrire les URLs des requêtes
supérieur à trace2 qu'à des fins de débogage !
- Exemple
-
+ Exemple
+
LogLevel alert rewrite:trace3
-
-
+
+
RewriteLog
Ceux qui sont familiers avec les versions précédentes de
mod_rewrite vont probablement rechercher en vain les
- directives RewriteLog et
- RewriteLogLevel. Elles ont été en effet remplacées
- par une configuration de la journalisation par module, comme
- mentionné plus haut.
-
+ directives RewriteLog et RewriteLogLevel. Depuis
+ la sortie de httpd 2.4, ces directives ont en effet été remplacées par une
+ configuration de la journalisation par module à lâaide de la directive
+ LogLevel.
Pour extraire les traces spécifiques Ã
mod_rewrite, affichez le fichier journal en
redirigeant la sortie vers grep :
-
- tail -f error_log|fgrep '[rewrite:'
-
+
+
+
+tail -f error_log|fgrep '[rewrite:'
+
+
@@ -463,15 +462,15 @@ répertoire
FileInfo
- La directive RewriteBase permet de
- spécifier le préfixe d'URL à utiliser dans un contexte de
- répertoire (htaccess) pour les directives
- RewriteRule qui réécrivent vers un chemin
+
La directive RewriteBase permet de spécifier le
+ préfixe d'URL à utiliser dans un contexte de
+ répertoire (htaccess) pour les directives RewriteRule qui réécrivent vers un chemin
relatif.
- Cette directive est obligatoire si vous utilisez un
- chemin relatif dans une substitution, et dans un contexte de
- répertoire (htaccess), sauf si au moins une de ces conditions est
- vérifiée :
+ Cette directive est obligatoire si vous utilisez un chemin
+ relatif dans une substitution, et dans un contexte de répertoire (htaccess), sauf si
+ au moins une de ces conditions est vérifiée :
- La requête initiale, ainsi que la substitution, se
situent par raport à la valeur de la directive
@@ -479,10 +478,10 @@ répertoire
dire que pour y accéder, il n'est pas nécessaire d'utiliser
une directive telle qu'Alias).
- - Le chemin du système de fichiers vers le répertoire
- contenant la RewriteRule, suffixé par
- la substitution relative est aussi valide en tant qu'URL sur
- le serveur (ce qui est rare).
+ - Le chemin de répertoire auquel la RewriteRule sâapplique, suffixé par
+ la substitution relative est aussi valable en tant que chemin d'URL
+ sur le serveur (ce qui est rare).
- A partir de la version 2.4.16 du serveur HTTP Apache,
cette directive peut être omise lorsque la requête est mise en
correspondance avec le système de fichiers via la directive
@@ -490,23 +489,6 @@ répertoire
mod_userdir.
-Dans l'exemple ci-dessous, la directive
-RewriteBase est nécessaire afin d'éviter une
-réécriture en http://example.com/opt/myapp-1.2.3/welcome.html car la
-ressource n'était pas relative à la racine des documents. Cette erreur
-de configuration aurait conduit le serveur à rechercher un répertoire
-"opt" Ã la racine des documents.
-
-
-DocumentRoot "/var/www/example.com"
-AliasMatch "^/myapp" "/opt/myapp-1.2.3"
-<Directory "/opt/myapp-1.2.3">
- RewriteEngine On
- RewriteBase "/myapp/"
- RewriteRule "^index\.html$" "welcome.html"
-</Directory>
-
-
@@ -654,9 +636,8 @@ la réécriture soit effectuée
sont documentées dans la documentation des expressions, dans
la documentation des variables
- dâenvironnement ou dans la spécification de
- CGI.
+ dâenvironnement ou dans la spécification de
+ CGI (3875).
SERVER_NAME et SERVER_PORT dépendent respectivement
des valeurs des directives REQUEST_URI a déjà été %-décodée ; pour la
recoder, passez-la à la fonction de
mappage "escape".
+ Notez que cette variable de serveur est distincte de la
+ variable dâenvironnement CGI de même nom : dans un contexte
+ CGI, REQUEST_URI contient lâURI original complet
+ de la requête, y compris la chaîne de paramètres. Voir la
+ directive CGIVar pour les
+ détails.
THE_REQUEST
@@ -842,11 +829,12 @@ la réécriture soit effectuée
par la phase d'autorisation qui intervient après la
phase de traduction d'URL (pendant laquelle mod_rewrite
opère).
- Par contre, comme mod_rewrite implémente son contexte de
- répertoire (fichier .htaccess) via la phase Fixup
- de l'API, et comme la phase d'autorisation intervient
- avant cette dernière, vous pouvez vous contenter
- d'utiliser %{REMOTE_USER} dans ce contexte.
+ Par contre, comme mod_rewrite implémente son
+ contexte de répertoire (fichier
+ .htaccess) via la phase Fixup de l'API, et comme la phase
+ d'autorisation intervient avant cette dernière, vous pouvez
+ vous contenter d'utiliser %{REMOTE_USER} dans ce
+ contexte.
%{LA-F:variable} peut être utilisée pour effectuer
@@ -863,7 +851,7 @@ la réécriture soit effectuée
l'expression_de_comparaison.
expression_de_comparaison est en général une
- expression rationnelle compatible perl, mais vous
+ expression rationnelle, mais vous
disposez des syntaxes supplémentaires suivantes pour effectuer
d'autres tests utiles sur chaîne_de_test :
@@ -1194,10 +1182,11 @@ RewriteRule "^/$" "/homepage.std.html" [L]
les règles seront appliquées au cours du processus de
réécriture.
- Modèle est une
- expression rationnelle
- compatible perl. Ce avec quoi ce modèle est comparé dépend de l'endroit où
- la directive RewriteRule est définie.
+ Modèle est une expression
+ rationnelle. Ce avec quoi ce modèle est comparé dépend de
+ l'endroit où la directive RewriteRule est
+ définie.
Qu'est-ce qui est comparé ?
@@ -1209,18 +1198,20 @@ RewriteRule "^/$" "/homepage.std.html" [L]
exemple "/app1/index.html"). Il s'agit du URL-path décodé de sa valeur "%xx".
- Dans un contexte de répertoire (sections Dans un contexte de
+ répertoire (sections Directory et fichiers .htaccess), le
Modèle est comparé avec une partie de chemin ; par exemple une
requête pour "/app1/index.html" entraînera une comparaison avec
- "app1/index.html" ou "index.html" selon l'endroit où la directive
- RewriteRule est définie.
+ "app1/index.html" ou "index.html" selon le chemin de répertoire où la
+ directive RewriteRule est définie.
- Le chemin où la règle est défini est supprimé du chemin correspondant
- du système de fichiers avant comparaison (jusqu'au slash final compris).
- En conséquence de cette suppression, les règles définies dans
- ce contexte n'effectuent des comparaisons qu'avec la portion du chemin
- du système de fichiers "en dessous" de l'endroit où la règle est définie.
+ Le chemin de répertoire auquel la règle sâapplique est supprimé du
+ chemin correspondant du système de fichiers avant comparaison (jusqu'au
+ slash final compris). En conséquence de cette suppression, les règles
+ définies dans ce contexte n'effectuent des comparaisons qu'avec la portion
+ du chemin du système de fichiers "en dessous" du chemin de répertoire
+ auquel la règle sâapplique.
Le chemin correspondant actuel du système de fichiers est déterminé par
des directives telles que DocumentRoot et
@@ -1239,7 +1230,7 @@ RewriteRule "^/$" "/homepage.std.html" [L]
-Réécritures dans un contexte de répertoire
+Réécritures dans un contexte de répertoire
- L'utilisation du moteur de réécriture dans les
fichiers .htaccess et les sections
@@ -1247,28 +1238,30 @@ fichiers .htaccess et les sections
type="section" module="core">Directory est un peu plus
complexe.
-- Pour activer le moteur de réécriture dans ces contextes, vous devez
-définir "
RewriteEngine On" et
-"Options FollowSymLinks". Si l'administrateur a désactivé
-la possibilité de modifier l'option FollowSymLinks au
-niveau du répertoire d'un utilisateur, vous ne pouvez pas utiliser le
-moteur de réécriture. Cette restriction a été instaurée à des fins de
-sécurité.
+- Pour activer le moteur de réécriture dans ces contextes, vous devez définir
+
RewriteEngine On et au moins une des Options FollowSymLinks ou
+SymLinksIfOwnerMatch doit être activée. Notez que ces options ne
+peuvent être définies dans un fichier de configuration distribué
+(.htaccess) que si une directive AllowOverride le permet dans la configuration du
+serveur.
- Voir la directive
RewriteBase pour plus de détails Ã
propos de l'ajout du préfixe après les substitutions relatives.
- Si vous souhaitez effectuer une comparaison en prenant en compte
-l'intégralité du
-chemin de l'URL dans un contexte de répertoire (htaccess), vous devez
-utiliser la variable
%{REQUEST_URI} dans la directive
-RewriteCond.
+l'intégralité du chemin de l'URL dans un contexte
+de répertoire (htaccess), vous devez utiliser la variable
+%{REQUEST_URI} dans la directive RewriteCond.
-Le prefixe supprimé se termine toujours par un slash, ce qui
-signifie que la comparaison s'effectue avec une chaîne qui ne comporte
-jamais de slash de début. Ainsi, un modèle contenant
-^/ ne correspondra jamais dans un contexte de répertoire.
+Le prefixe supprimé se termine toujours par un slash, ce qui signifie que la
+comparaison s'effectue avec une chaîne qui ne comporte jamais de slash
+de début. Ainsi, un modèle contenant ^/ ne correspondra
+jamais dans un contexte de
+répertoire.
Bien que les règles de réécriture soient permises du point de vue de
la syntaxe dans les sections un chemin du système de fichiers
- Il indique alors la localisation dans le système de
- fichiers de la ressource qui doit être envoyée au
- client. Les substitutions ne sont traitées en tant que chemins du
- système de fichiers que si la règle est configurée dans un
- contexte de serveur (serveur virtuel), et si le premier
- composant du chemin dans la substitution existe dans le système
- de fichiers.
+ Il indique alors la localisation dans le système de fichiers de la
+ ressource qui doit être envoyée au client. Une substitution commençant
+ par / nâest traitée comme un chemin du système de fichiers
+ que dans un contexte de serveur virtuel ou de serveur global, et
+ seulement si le premier composant du chemin existe dans le système de
+ fichiers. Dans un contexte de
+ répertoire, la question ne se pose pas.
chemin d'URL
Un chemin relatif à la valeur de DocumentRoot vers la ressource qui
- doit être servie. Notez que mod_rewrite
- essaie de deviner si vous avez spécifié un chemin du système
- de fichiers ou un chemin d'URL en vérifiant si la première
- partie du chemin existe à la racine du système de fichiers.
- Par exemple, si vous avez spécifié comme chaîne de
- Substitution /www/file.html, cette
- dernière sera traitée comme un chemin d'URL à moins
- qu'un répertoire nommé www n'existe à la racine
- de votre système de fichiers (ou dans le cas d'une
- réécriture au sein d'un fichier .htaccess,
- relativement à la racine des documents), auquel cas la chaîne de
- substitution sera traitée comme un chemin du système de
- fichiers. Si vous désirez que d'autres directives de
+ doit être servie. Dans un contexte de serveur virtuel ou de serveur
+ global, si le premier composant du chemin existe à la racine du système
+ de fichiers, la substitution est traitée comme un chemin du système de
+ fichiers. Par exemple, /www/file.html est un chemin dâURL,
+ sauf si un répertoire nommé www existe à la racine du
+ système de fichiers. Si vous désirez que d'autres directives de
correspondance d'URL (comme la directive Alias) soient appliquées au
chemin d'URL résultant, utilisez le drapeau [PT]
@@ -1401,6 +1387,32 @@ substitution !
+ Comment sont interprétées les substitutions de chemin
+ En fonction du contexte et si elle commence ou non par un slash, une
+ substitution sera traitée comme un chemin du système de fichiers ou comme
+ un chemin dâURLÂ :
+
+ - Commence par un
/, contexte de serveur virtuel
+ ou de serveur global :
+ Traitée comme un chemin du système de fichiers si le premier composant du
+ chemin existe sur disque ; sinon, traitée comme un chemin dâURL.
+ - Commence par un
/, contexte de répertoire :
+ Toujours traitée comme un chemin dâURL. Pas de vérification sur le
+ système de fichiers.
+ - Ne commence pas par un
/ (chemin relatif), contexte de serveur virtuel
+ ou de serveur global : Traitée comme un chemin dâURL relatif Ã
+ lâURI de la requête actuelle.
+ - Ne commence pas par un
/ (chemin relatif),
+ contexte de
+ répertoire : Traitée comme un chemin dâURL relatif
+ au chemin de répertoire auquel la directive Directory ou le fichier .htaccess
+ sâappliquent. Voir RewriteBase pour le contrôle
+ du préfixe ajouté aux substitutions relatives.
+
+
+
En plus du texte, la chaîne Substitution peut
comporter :
@@ -1420,15 +1432,22 @@ substitution !
Les références arrières sont des identificateurs de la forme
- $N (N=0..9), qui
- seront remplacés par le contenu du Nème groupe
- du Modèle qui correspondait. Les variables du serveur
- sont les mêmes que dans la Chaîne_de_test d'une
- directive RewriteCond. Les
- fonctions de comparaison sont issues de la directive RewriteMap dans la
- section de laquelle elles sont décrites. Ces trois types de
- variables sont évaluées dans l'ordre ci-dessus.
+ $N (N=0..9).
+ $0 correspond à la chaîne entière correspondant au
+ motif, alors que $1..$9 correspondent
+ aux groupes correspondants capturés depuis le motif
+ correspondant. De même, les références arrières
+ %0..%9 correspondent aux motifs de condition
+ de RewriteCond
+ correspondants les plus récents : %0 représente une
+ correspondance complète et %1..%9 les groupes
+ capturés. Les variables du serveur sont les mêmes que dans la
+ Chaîne_de_test d'une directive RewriteCond. Les fonctions de comparaison
+ sont issues de la directive RewriteMap dans la section de laquelle
+ elles sont décrites. Ces trois types de variables sont évaluées dans
+ l'ordre ci-dessus.
Chaque règle de réécriture s'applique au résultat de la règle
précédente, selon l'ordre dans lequel elles ont été définies dans
@@ -1526,11 +1545,11 @@ substitution !
| END |
- Stoppe le processus de réécriture immédiatement et
- n'applique plus aucune règle. Empêche aussi l'application
- ultérieure de règles de réécriture dans les contextes de
- répertoire et de fichier .htaccess (disponible à partir de la
- version 2.3.9 du serveur HTTP Apache). Stoppe le processus de réécriture immédiatement et n'applique plus
+ aucune règle. Empêche aussi l'application ultérieure de règles de
+ réécriture dans les contextes de répertoire et de fichier .htaccess
+ (disponible à partir de la version 2.3.9 du serveur HTTP Apache). détails ... |
@@ -1558,11 +1577,11 @@ substitution !
| last|L |
- Arrête le processus de réécriture immédiatement et n'applique
- plus aucune règle. Prêtez une attention particulière aux mises
- en garde concernant les contextes de niveau répertoire et
- .htaccess (voir aussi le drapeau END). détails ... |
+ Arrête le processus de réécriture immédiatement et n'applique plus
+ aucune règle. Prêtez une attention particulière aux mises en garde
+ concernant les contextes de niveau répertoire (voir aussi le drapeau END).
+ détails ... |
| next|N |
@@ -1686,11 +1705,9 @@ utilisé dans la directive RewriteRuleVoici toutes les combinaisons de substitution et leurs
significations :
- Dans la configuration au niveau du serveur principal
- (httpd.conf)
- pour la requête ``GET
- /chemin/infochemin'':
-
+ En dehors de la configuration au niveau du répertoire pour la requête ``GET
+ /chemin/infochemin'':
@@ -1760,13 +1777,11 @@ redondant)
- Dans une configuration de niveau répertoire pour
- /chemin
- (/chemin/physique/vers/chemin/.htacccess, avec
- RewriteBase "/chemin")
- pour la requête ``GET
- /chemin/chemin-local/infochemin'':
-
+ Dans une configuration de niveau répertoire pour /chemin
+ (par exemple, .htaccess ou <Directory>,
+ avec RewriteBase "/chemin")
pour la requête ``GET
+ /chemin/chemin-local/infochemin'':