Serveur Apache HTTP Version 2.4
Ce document est un complément à la Documentation de référence de
mod_rewrite
. Il décrit peut-être un des concepts les
plus importants à propos de mod_rewrite
- à savoir, quand doit-on éviter
de l'utiliser.
mod_rewrite
doit être considéré comme un dernier recours,
lorsqu'aucune alternative n'est possible. Utiliser mod_rewrite lorsqu'il
existe des alternatives plus simples conduit à des configurations
confuses, fragiles, et difficiles à maintenir. La compréhension des
autres alternatives disponibles est une étape très importante sur le
chemin de la maîtrise de mod_rewrite
.
Vous devez vous attacher à comprendre le fonctionnement des exemples, car la plupart d'entre eux ne fonctionneront pas sur votre système si vous vous contentez de les copier/coller dans vos fichiers de configuration.
Le cas le plus courant dans lequel mod_rewrite
est
l'outil approprié est la situation où la seule solution envisageable
nécessite l'accès aux fichiers de configuration du serveur, alors que
cet accès ne vous est pas accordé. Certaines directives de configuration
ne sont disponibles que dans le fichier de configuration du serveur. Si
vous ne pouvez agir que sur les fichiers .htaccess, vous devrez donc
vous tourner vers mod_rewrite
.
mod_alias
fournit les directives Redirect
et RedirectMatch
qui permettent de
rediriger une URL vers une autre. Plutôt que d'utiliser la directive
RewriteRule
pour ce genre de
redirection simple d'une URL ou d'une classe d'URLs vers une autre, on
préfèrera l'utilisation de ces directives. En outre, avec
RedirectMatch
, vous pouvez inclure une expression
rationnelle dans votre critère de redirection, ce qui vous permet de
bénéficier de nombreux avantages de la directive
RewriteRule
.
Une utilisation courante de la directive RewriteRule
est
la redirection de toute une classe d'URLs. Par exemple, toutes les URLs
faisant référence au répertoire /un
doivent être
redirigées vers https://un.example.com/
, ou toutes les
requêtes http
doivent être redirigées vers
https
.
Pour ce faire, il est préférable d'utiliser la directive
Redirect
. Souvenez-vous que la directive
Redirect
conserve les informations relatives au chemin. En
d'autres termes, la redirection d'une URL /un
va aussi
rediriger toutes les URLs de niveaux inférieurs comme
/un/deux.html
et /un/trois/quatre.html
.
Pour rediriger les URLs sous /un
vers
https://un.example.com/
, utilisez cette définition :
Redirect /one/ https://one.example.com/
Pour rediriger un nom d'hôte vers un autre nom d'hôte, par exemple
example.com
vers www.example.com
, voir la
méthode Noms d'hôtes canoniques.
Pour rediriger les URLs http
vers https
,
utilisez cette définition :
<VirtualHost *:80> ServerName www.example.com Redirect "/" "https://www.example.com/" </VirtualHost> <VirtualHost *:443> ServerName www.example.com # ... insérer ici la configuration SSL </VirtualHost>
L'utilisation de la directive RewriteRule
pour accomplir
cette tâche peut se justifier s'il existe d'autres directives
RewriteRule
dans la même portée. En effet, lorsque des
directives Redirect
et RewriteRule
se trouvent
dans la même portée, les directives RewriteRule
sont
exécutées en premier, sans tenir compte de leur ordre d'apparition dans
le fichier de configuration.
Dans le cas de la redirection http-vers-https, l'utilisation
de règles RewriteRule
se justifie si vous n'avez pas accès
au fichier de configuration principal, et devez donc accomplir cette
tâche au sein d'un fichier .htaccess
.
La directive Alias
permet
de mettre en correspondance un URI avec un répertoire, ce dernier étant
en général situé en dehors de l'arborescence définie par la directive
DocumentRoot
. Bien qu'il soit
possible d'effectuer cette mise en correspondance avec
mod_rewrite
, il est préférable d'utiliser la directive
Alias
pour des raisons de simplicité
et de performances.
Alias "/cats" "/var/www/virtualhosts/felines/htdocs"
Pour effectuer cette mise en correspondance, mod_rewrite
s'impose si vous n'avez pas accès aux fichiers de configuration du
serveur. En effet, la directive Alias ne peut pas être utilisée dans un
fichier .htaccess
, mais seulement dans un contexte de
serveur principal ou de serveur virtuel.
En outre, vous pouvez arriver au même résultat avec les liens
symboliques, pourvu que Options FollowSymLinks
soit activé
sur votre serveur.
Bien qu'il soit possible de gérer les serveurs
virtuels avec mod_rewrite, il s'agit rarement de la bonne méthode.
Il est pratiquement toujours préférable de créer des blocs
<VirtualHost>
individuels.
Dans l'éventualité où vous devez gérer
un grand nombre de serveurs virtuels, vous devez vous tourner vers
mod_vhost_alias
pour créer ces serveurs
automatiquement.
Il est aussi possible d'utiliser des modules comme mod_macro
pour
créer un grand nombre de serveurs virtuels dynamiquement.
L'utilisation de mod_rewrite
pour la création de
serveurs virtuels peut se révéler appropriée si votre service
d'hébergement ne vous permet pas d'accéder aux fichiers de configuration
du serveur, et que vous soyez par conséquent obligé de passer par les
fichiers .htaccess
.
Voir le document création de serveurs virtuels avec mod_rewrite pour plus de détails sur la manière d'y parvenir si cela semble être tout de même la meilleure approche.
La directive RewriteRule
fournit
le drapeau [P] qui permet de faire passer les URIs
réécrits par mod_proxy
.
RewriteRule "^/?images(.*)" "https://serveur-images.local/images$1" [P]
Cependant, dans les nombreux cas où aucune correspondance au modèle
n'est vraiment nécessaire, comme dans l'exemple ci-dessus, il est
préférable d'utiliser la directive ProxyPass
. L'exemple précédent pourrait
être remplacé par :
ProxyPass "/images/" "https://serveur-images.local/images/"
Que vous utilisiez RewriteRule
ou ProxyPass
, vous devrez dans tous les cas
utiliser aussi la directive ProxyPassReverse
pour intercepter les
redirections en provenance du serveur d'arrière-plan :
ProxyPassReverse "/images/" "https://serveur-images.local/images/"
Vous devrez cependant tout de même utiliser RewriteRule
lorsque d'autres RewriteRule
s se trouvent dans la même portée,
car elles agissent en général avant les directives
ProxyPass
, et peuvent ainsi les court-circuiter.
mod_rewrite
est souvent utilisé pour effectuer une
action en fonction de la présence ou de l'absence d'une variable
d'environnement particulière ou d'un en-tête de requête, ce qui peut
être accompli de manière plus efficace via la directive <If>
.
Considérons par exemple le scénario courant où la directive
RewriteRule
est utilisée pour forcer un nom
d'hôte canonique, tel que www.example.com
au lieu de
example.com
. Il est possible d'utiliser à la place la
directive <If>
comme
suit :
<If "req('Host') != 'www.example.com'"> Redirect "/" "https://www.example.com" </If>
On peut utiliser cette technique dans de nombreux scénarios courant
pour remplacer mod_rewrite
pour effectuer des actions
en fonction d'en-têtes de requêtes ou de réponses, ou de variables
d'environnement.
Voir en particulier la documentation sur
l'évaluation des expressions pour une vue d'ensemble des types
d'expressions que vous pouvez utiliser dans les sections <If>
,
ainsi que dans certaines directives.