Directive VirtualHost (module mod_alias)

See also

Introduction

Les balises <VirtualHost> et </VirtualHost> permettent de rassembler un groupe de directives qui ne s’appliquent qu’à un serveur virtuel particulier.

Toute directive autorisée dans un contexte de serveur virtuel peut être utilisée. 

Lorsque le serveur reçoit une requête pour un document hébergé par un serveur
virtuel particulier, il applique les directives de configuration rassemblées
dans la section <VirtualHost>. adresse IP peut être une des entités suivantes,
éventuellement suivies d'un caractère ':' et d'un numéro de port (ou *) :

L'adresse IP du serveur virtuel ;
Un nom de domaine entièrement qualifié correspondant à l'adresse IP du serveur virtuel (non recommandé) ;
Le caractère *, qui agit comme un caractère générique, et correspond à toute adresse IP.
La chaîne _default_, dont la signification est identique à celle du caractère *

1 <VirtualHost 10.1.2.3:80>
2   ServerAdmin webmaster@host.example.com
3   DocumentRoot "/www/docs/host.example.com"
4   ServerName host.example.com
5   ErrorLog "logs/host.example.com-error_log"
6   TransferLog "logs/host.example.com-access_log"
7 </VirtualHost>

Les adresses IPv6 doivent être entourées de crochets car dans le cas contraire, un éventuel port optionnel ne pourrait pas être déterminé.

Voici un exemple de serveur virtuel avec adresse IPv6 : 

1 <VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80>
2   ServerAdmin webmaster@host.example.com
3   DocumentRoot "/www/docs/host.example.com"
4   ServerName host.example.com
5   ErrorLog "logs/host.example.com-error_log"
6   TransferLog "logs/host.example.com-access_log"
7 </VirtualHost>

Chaque serveur virtuel doit correspondre à une adresse IP, un port ou un nom d’hôte spécifique ; dans le premier cas, le serveur doit être configuré pour recevoir les paquets IP de plusieurs adresses (si le serveur n’a qu’une interface réseau, on peut utiliser à cet effet la commande ifconfig alias – si votre système d’exploitation le permet).

Note

L’utilisation de la directive <VirtualHost> n’affecte en rien les adresses IP sur lesquelles Apache httpd est en écoute.

Vous devez vous assurer que les adresses des serveurs virtuels sont bien incluses dans la liste des adresses précisées par la directive Listen.

Tout bloc <VirtualHost> doit comporter une directive ServerName.

Dans le cas contraire, le serveur virtuel héritera de la valeur de la directive ServerName issue de la configuration du serveur principal.

A l’arrivée d’une requête, le serveur tente de la faire prendre en compte par la section <VirtualHost> qui correspond le mieux en ne se basant que sur la paire adresse IP/port.

Les chaînes sans caractères génériques l’emportent sur celles qui en contiennent.

Si aucune correspondance du point de vue de l’adresse IP/port n’est trouvée, c’est la configuration du serveur “principal” qui sera utilisée.

Si plusieurs serveurs virtuels correspondent du point de vue de l’adresse IP/port, le serveur sélectionne celui qui correspond le mieux du point de vue du nom d’hôte de la requête. Si aucune correspondance du point de vue du nom d’hôte n’est trouvée, c’est le premier serveur virtuel dont l’adresse IP/port correspond qui sera utilisé. Par voie de conséquence, le premier serveur virtuel comportant une certaine paire adresse IP/port est le serveur virtuel par défaut pour cette paire adresse IP/port.