Serveur Apache HTTP Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > 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`.

### Voir aussi

- 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.