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 SITE.example.com pour chaque utilisateur, et que nous servons leur contenu depuis /home/SITE/www. Nous souhaitons cependant que www.example.com n'apparaisse pas dans cette mise en correspondance.

Solution :

RewriteEngine on RewriteMap lowercase int:tolower RewriteCond %{HTTP_HOST} !^www\. RewriteCond ${lowercase:%{HTTP_HOST}} ^([^.]+)\.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...

La première directive RewriteCond vérifie si le nom d'hôte commence par www. et si c'est le cas, la réécriture est annulée.

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.

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.

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 :

On doit ajouter à httpd.conf :