From 2bd6d37aafdeca7f391098529b1f083cd4465faf Mon Sep 17 00:00:00 2001 From: Rich Bowen Date: Fri, 15 May 2026 18:17:30 +0000 Subject: [PATCH] Rebuild the most recent work on the rewrite guide git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934235 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/rewrite/avoid.html.en.utf8 | 13 +- docs/manual/rewrite/avoid.xml.de | 2 +- docs/manual/rewrite/avoid.xml.es | 2 +- docs/manual/rewrite/avoid.xml.fr | 2 +- docs/manual/rewrite/avoid.xml.ja | 2 +- docs/manual/rewrite/avoid.xml.ko | 2 +- docs/manual/rewrite/avoid.xml.tr | 2 +- docs/manual/rewrite/avoid.xml.zh-cn | 2 +- docs/manual/rewrite/flags.html.en.utf8 | 138 +++++++++++++++----- docs/manual/rewrite/flags.xml.de | 2 +- docs/manual/rewrite/flags.xml.es | 2 +- docs/manual/rewrite/flags.xml.fr | 2 +- docs/manual/rewrite/flags.xml.ja | 2 +- docs/manual/rewrite/flags.xml.ko | 2 +- docs/manual/rewrite/flags.xml.tr | 2 +- docs/manual/rewrite/flags.xml.zh-cn | 2 +- docs/manual/rewrite/htaccess.html.en.utf8 | 36 +++++ docs/manual/rewrite/htaccess.xml.de | 2 +- docs/manual/rewrite/htaccess.xml.es | 2 +- docs/manual/rewrite/htaccess.xml.fr | 2 +- docs/manual/rewrite/htaccess.xml.ja | 2 +- docs/manual/rewrite/htaccess.xml.ko | 2 +- docs/manual/rewrite/htaccess.xml.tr | 2 +- docs/manual/rewrite/htaccess.xml.zh-cn | 2 +- docs/manual/rewrite/index.html.fr.utf8 | 105 ++++++++------- docs/manual/rewrite/index.xml.meta | 2 +- docs/manual/rewrite/intro.html.en.utf8 | 39 ++++-- docs/manual/rewrite/intro.xml.de | 2 +- docs/manual/rewrite/intro.xml.es | 2 +- docs/manual/rewrite/intro.xml.fr | 2 +- docs/manual/rewrite/intro.xml.ja | 2 +- docs/manual/rewrite/intro.xml.ko | 2 +- docs/manual/rewrite/intro.xml.tr | 2 +- docs/manual/rewrite/intro.xml.zh-cn | 2 +- docs/manual/rewrite/remapping.html.en.utf8 | 29 ++++ docs/manual/rewrite/remapping.xml.de | 2 +- docs/manual/rewrite/remapping.xml.es | 2 +- docs/manual/rewrite/remapping.xml.fr | 2 +- docs/manual/rewrite/remapping.xml.ja | 2 +- docs/manual/rewrite/remapping.xml.ko | 2 +- docs/manual/rewrite/remapping.xml.tr | 2 +- docs/manual/rewrite/remapping.xml.zh-cn | 2 +- docs/manual/rewrite/rewritemap.html.en.utf8 | 4 +- docs/manual/rewrite/rewritemap.xml.de | 2 +- docs/manual/rewrite/rewritemap.xml.es | 2 +- docs/manual/rewrite/rewritemap.xml.fr | 2 +- docs/manual/rewrite/rewritemap.xml.ja | 2 +- docs/manual/rewrite/rewritemap.xml.ko | 2 +- docs/manual/rewrite/rewritemap.xml.tr | 2 +- docs/manual/rewrite/rewritemap.xml.zh-cn | 2 +- docs/manual/rewrite/tech.html.en.utf8 | 113 ++++++++++++++++ docs/manual/rewrite/tech.html.fr.utf8 | 68 +--------- docs/manual/rewrite/tech.xml.de | 2 +- docs/manual/rewrite/tech.xml.es | 2 +- docs/manual/rewrite/tech.xml.fr | 2 +- docs/manual/rewrite/tech.xml.ja | 2 +- docs/manual/rewrite/tech.xml.ko | 2 +- docs/manual/rewrite/tech.xml.tr | 2 +- docs/manual/rewrite/tech.xml.zh-cn | 2 +- 59 files changed, 436 insertions(+), 209 deletions(-) diff --git a/docs/manual/rewrite/avoid.html.en.utf8 b/docs/manual/rewrite/avoid.html.en.utf8 index ee0d528f4f..7befac3e05 100644 --- a/docs/manual/rewrite/avoid.html.en.utf8 +++ b/docs/manual/rewrite/avoid.html.en.utf8 @@ -114,11 +114,22 @@ the recommended configuration and the mod_rewrite alternative for .htaccess use.

+

Processing order

+

If you do mix Redirect + and RewriteRule in the + same context, be aware that their execution order depends on where + they appear. In server/virtual-host context, + mod_rewrite runs first; in per-directory context + (.htaccess), mod_alias runs first. See + Module Processing Order for + details.

+
+
top

URL Aliasing

The Alias directive -provides mapping from a URI to a directory - usually a directory outside +provides mapping from a URL-path to a directory - usually a directory outside of your DocumentRoot. Although it is possible to perform this mapping with mod_rewrite, Alias is the preferred method, for diff --git a/docs/manual/rewrite/avoid.xml.de b/docs/manual/rewrite/avoid.xml.de index c9acc8cccf..b2b261cf08 100644 --- a/docs/manual/rewrite/avoid.xml.de +++ b/docs/manual/rewrite/avoid.xml.de @@ -1,7 +1,7 @@ - + + + diff --git a/docs/manual/rewrite/avoid.xml.ja b/docs/manual/rewrite/avoid.xml.ja index c651a7e804..0cf8d2d857 100644 --- a/docs/manual/rewrite/avoid.xml.ja +++ b/docs/manual/rewrite/avoid.xml.ja @@ -1,7 +1,7 @@ - + + + + + + + diff --git a/docs/manual/rewrite/flags.xml.ja b/docs/manual/rewrite/flags.xml.ja index 8c4def944e..27977edeb5 100644 --- a/docs/manual/rewrite/flags.xml.ja +++ b/docs/manual/rewrite/flags.xml.ja @@ -1,7 +1,7 @@ - + + + + + + + diff --git a/docs/manual/rewrite/htaccess.xml.ja b/docs/manual/rewrite/htaccess.xml.ja index 7a32ef5482..406cee111f 100644 --- a/docs/manual/rewrite/htaccess.xml.ja +++ b/docs/manual/rewrite/htaccess.xml.ja @@ -1,7 +1,7 @@ - + + + + -Le module Apache mod_rewrite - Serveur HTTP Apache Version 2.5 +Guide pour le module Apache mod_rewrite - Serveur HTTP Apache Version 2.5 @@ -21,7 +21,7 @@

<-
-Apache > Serveur HTTP > Documentation > Version 2.5

Le module Apache mod_rewrite

+Apache > Serveur HTTP > Documentation > Version 2.5

Guide pour le module Apache mod_rewrite

Langues Disponibles:  de  |  en  | @@ -32,68 +32,65 @@  tr  |  zh-cn 

-
Cette traduction peut être périmée. Vérifiez la version - anglaise pour les changements récents.
+

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. +-- Brian Behlendorf

+ +

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.

mod_rewrite permet de modifier les requêtes entrantes dynamiquement, en fonction de règles manipulant des expressions rationnelles. Vous pouvez ainsi relier des URLs arbitraires à votre propre structure d'URLs interne comme vous le souhaitez.

-

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.

+

Ce guide est un complément du manuel de +référence avec des exemples commentés, des explications conceptuelles et des +conseils pratiques. Il est organisé comme suit :

+ +
+
Introduction
+
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.
+ +
Réécritures en fonction du répertoire
+
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 répertoire, y compris la +suppression du chemin, RewriteBase et la gestion du bouclage par le drapeau [L].
+ +
Drapeaux des règles de réécriture
+
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.
+ +
Utiliser RewriteMap
+
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.
+ +
Redirection et remappage
+
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.
-

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 - (httpd.conf), mais aussi dans le contexte des - serveurs virtuels (sections <VirtualHost>), ou dans le - contexte des - répertoires (fichiers .htaccess et blocs - <Directory>). 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 drapeaux que vous attachez aux - règles

+
Serveurs virtuels dynamiques
+
Utilisation de mod_rewrite pour associer dynamiquement les noms d’hôte aux +racines de document sans devoir créer des blocs VirtualHost individuels.
-

mod_rewrite étant très puissant, il peut par - conséquent être très complexe. Ce document - complète la documentation de - référence du module mod_rewrite, 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 mod_rewrite. Mais nous voulons aussi vous - montrer des situations où vous ne devrez pas utiliser - mod_rewrite, et lui préférer d'autres - fonctionnalités standard d'Apache, évitant ainsi - d'entrer dans une complexité inutile.

+
Quand ne pas utiliser mod_rewrite
+
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.
- +
Détails techniques
+
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.
+

Voir aussi