Le module Apache mod_rewrite

permet de modifier les requêtes entrantes dynamiquement, en fonction de règles manipulant des mod_rewriteexpressions 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.

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 (apache2.conf

), mais aussi dans le contexte des serveurs virtuels (sections

), ou dans le contexte des répertoires (fichiers .htaccess

. 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

modrewrite é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 modrewrite, 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 modrewrite. Mais nous voulons aussi vous montrer des situations où vous ne devrez pas utiliser modrewrite, et lui préférer d'autres fonctionnalités standard d'Apache, évitant ainsi d'entrer dans une complexité inutile.

Modules | Directives | FAQ | Glossaire | Plan du site

Serveur Apache HTTP Version 2.4