Serveur Apache HTTP Version 2.4

Apache > Serveur HTTP > Documentation > Version 2.4 > Rewrite

# Hébergement virtuel de masse avec mod_rewrite

Ce document est un complément à la documentation de référence du module `mod_rewrite`. Il décrit comment créer des serveurs virtuels dynamiquement configurés en utilisant `mod_rewrite`.

L'utilisation de mod_rewrite n'est pas la meilleure méthode pour configurer des serveurs virtuels. Vous devez dans un premier temps tenter de résoudre votre problème via ces d'autres méthodes avant d'avoir recours à mod_rewrite. Voir aussi le document Comment éviter l'utilisation de mod_rewrite.

### Voir aussi

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

## Serveurs virtuels pour des noms d'hôtes arbitraires

Description :

  Nous voulons créer automatiquement un serveur virtuel pour tout nom d'hôte qui peut être résolu dans notre domaine, sans avoir à créer de nouvelle section VirtualHost.

  Dans cet exemple, nous supposons que nous utilisons le nom d'hôte `www.SITE.example.com` pour chaque utilisateur, et que nous servons leur contenu depuis `/home/SITE/www`.

Solution :

      RewriteEngine on

      RewriteMap    lowercase int:tolower

      RewriteCond   "${lowercase:%{HTTP_HOST}}" "^www\.([^.]+)\.example\.com$"
      RewriteRule   "^(.*)" "/home/%1/www$1"

Discussion
  Vous devez vérifier le bon fonctionnement de la résolution DNS - Apache ne gère pas la résolution de nom. Vous devrez créer soit des enregistrements CNAME pour chaque nom d'hôte, soit un enregistrement DNS avec caractères génériques. La création des enregistrements DNS est en dehors du sujet de ce document.

  La directive RewriteMap interne `tolower` permet de s'assurer que les noms d'hôtes utilisés seront tous en minuscules, de façon à éviter toute ambiguité dans la structure des répertoires qui doit être créée.

  Les contenus des parenthèses utilisées dans une directive `RewriteCond` sont enregistrés dans les références arrières `%1`, `%2`, etc..., alors que les contenus des parenthèses utilisées dans une directive `RewriteRule` le sont dans les références arrières `$1`, `$2`, etc...

  Comme c'est le cas pour de nombreuses techniques discutées dans ce document, mod_rewrite n'est vraiment pas la meilleure méthode pour accomplir cette tâche. Vous devez plutôt vous tourner vers `mod_vhost_alias`, car ce dernier sera bien plus à même de gérer tout ce qui est au delà du domaine des fichiers statiques, comme les contenus dynamiques et la résolution des alias.

## Configuration dynamique de serveurs virtuels via `mod_rewrite`

Cet extrait du fichier `httpd.conf` permet d'obtenir le même résultat que le premier exemple. La première moitié est très similaire à la partie correspondante ci-dessus, excepté quelques modifications requises à des fins de compatibilité ascendante et pour faire en sorte que la partie `mod_rewrite` fonctionne correctement ; la seconde moitié configure `mod_rewrite` pour effectuer le travail proprement dit.

Comme `mod_rewrite` s'exécute avant tout autre module de traduction d'URI (comme `mod_alias`), il faut lui ordonner explicitement d'ignorer toute URL susceptible d'être traitée par ces autres modules. Et comme ces règles auraient sinon court-circuité toute directive `ScriptAlias`, nous devons faire en sorte que `mod_rewrite` déclare explicitement ces correspondances.

    # extrait le nom de serveur de l'en-tête Host:
    UseCanonicalName Off

    # journaux dissociables
    LogFormat "%{Host}i %h %l %u %t \"%r\" %s %b" vcommon
    CustomLog "logs/access_log" vcommon

    <Directory "/www/hosts">
        # ExecCGI est nécessaire ici car on ne peut pas forcer l'exécution
        # des CGI à la manière de ScriptAlias
        Options FollowSymLinks ExecCGI
    </Directory>

    RewriteEngine On

    # un nom de serveur extrait d'un en-tête Host: peut être dans n'importe
    # quelle casse
    RewriteMap  lowercase  int:tolower

    ## on s'occupe tout d'abord des documents normaux :

    # permet à Alias "/icons/" de fonctionner - répéter pour les autres
    RewriteCond  "%{REQUEST_URI}"  "!^/icons/"
    # permet aux CGIs de fonctionner
    RewriteCond  "%{REQUEST_URI}"  "!^/cgi-bin/"
    # le coeur du traitement
    RewriteRule  "^/(.*)$"  "/www/hosts/${lowercase:%{SERVER_NAME}}/docs/$1"

    ## on s'occupe maintenant des CGIs - on doit forcer l'utilisation d'un
    # gestionnaire
    RewriteCond  "%{REQUEST_URI}"  "^/cgi-bin/"
    RewriteRule  "^/(.*)$" "/www/hosts/${lowercase:%{SERVER_NAME}}/cgi-bin/$1"  [H=cgi-script]

## Utilisation d'un fichier de configuration du serveur virtuel séparé

Cette construction utilise des fonctionnalités plus avancées de `mod_rewrite` pour effectuer la traduction depuis le serveur virtuel vers la racine des documents, à partir d'un fichier de configuration séparé. Elle est plus souple mais nécessite une configuration plus compliquée.

Le fichier `vhost.map` devrait ressembler à ceci :

`www.client-1.example.com /www/clients/1
www.client-2.example.com /www/clients/2
# ...
www.client-N.example.com /www/clients/N
`

On doit ajouter à `httpd.conf` :

    RewriteEngine on

    RewriteMap   lowercase  int:tolower

    # définit le fichier de correspondances
    RewriteMap   vhost      "txt:/www/conf/vhost.map"

    # on s'occupe des alias comme ci-dessus
    RewriteCond  "%{REQUEST_URI}"               "!^/icons/"
    RewriteCond  "%{REQUEST_URI}"               "!^/cgi-bin/"
    RewriteCond  "${lowercase:%{SERVER_NAME}}"  "^(.+)$"
    # on effectue ici la remise en correspondance à base de fichier
    RewriteCond  "${vhost:%1}"                  "^(/.*)$"
    RewriteRule  "^/(.*)$"                      "%1/docs/$1"

    RewriteCond  "%{REQUEST_URI}"               "^/cgi-bin/"
    RewriteCond  "${lowercase:%{SERVER_NAME}}"  "^(.+)$"
    RewriteCond  "${vhost:%1}"                  "^(/.*)$"
    RewriteRule  "^/cgi-bin/(.*)$"              "%1/cgi-bin/$1" [H=cgi-script]