Rewrite

# Quand ne pas utiliser mod_rewrite

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.

Documentation du module mod_rewrite
Introduction à mod_rewrite
Redirection et remise en correspondance
Contrôle d'accès
Serveurs virtuels
Serveurs mandataires
Utilisation de RewriteMap
Techniques avancées

# Redirection simple

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 `http://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 `http://un.example.com/`, utilisez cette définition :

Redirect /one/ http://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`.

# Alias d'URL

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.

## Utilisation de la directive Alias

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.

# Hébergement virtuel

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.

# Mandat simple

La directive RewriteRule fournit le drapeau [P] qui permet de faire passer les URIs réécrits par mod_proxy.

RewriteRule "^/?images(.*)" "http://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/" "http://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/" "http://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.

# Test de variables d'environnement

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 "/" "http://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.