mirror of
https://github.com/apache/httpd.git
synced 2025-05-30 01:07:09 +03:00
ef27013c2f
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@421136 13f79535-47bb-0310-9956-ffa450edef68
651 lines
22 KiB
Plaintext
651 lines
22 KiB
Plaintext
<?xml version='1.0' encoding='ISO-8859-1' ?>
|
|
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision: 420990 -->
|
|
<!-- French translation by Vincent Deffontaines, Alain B., review by -->
|
|
|
|
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
-->
|
|
|
|
<manualpage metafile="examples.xml.meta">
|
|
<parentdocument href="./">Serveurs virtuels</parentdocument>
|
|
<title>Exemples d'utilisations de VirtualHost</title>
|
|
|
|
<summary>
|
|
|
|
<p>Le but de ce document est d'essayer de répondre aux questions
|
|
les plus répandues sur la configuration des serveurs virtuels.
|
|
Les scénarios présentés ici se rencontrent quand plusieurs
|
|
serveurs Webs doivent tourner sur une seule et même machine au
|
|
moyen de serveurs virtuels <a href="name-based.html">par nom</a>
|
|
ou <a href="ip-based.html">par IP</a>.</p>
|
|
|
|
</summary>
|
|
|
|
<section id="purename"><title>Fonctionnement de plusieurs serveurs
|
|
virtuels par nom sur une seule adresse IP.</title>
|
|
|
|
<p>Votre serveur ne dispose que d'une seule adresse IP, et de
|
|
nombreux alias (CNAMES) pointent vers cette adresse dans le DNS.
|
|
Pour l'exemple, <code>www.example1.com</code> et
|
|
<code>www.example2.org</code> doivent tourner sur cette machine.</p>
|
|
|
|
<note><title>Note :</title><p>La configuration de serveurs virtuels
|
|
sous Apache ne provoque pas leur apparition magique dans la
|
|
configuration du DNS. Il <em>faut</em> que leurs noms soient
|
|
définis dans le DNS, et qu'ils y soient résolus sur l'adresse IP
|
|
du serveur, faute de quoi personne ne pourra visiter votre site Web.
|
|
Il est possible d'ajouter des entrées dans le fichier
|
|
<code>hosts</code> pour tests locaux, mais qui ne fonctionneront
|
|
que sur la machine possédant ces entrées.</p>
|
|
</note>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
# Apache doit écouter sur le port 80<br />
|
|
Listen 80<br />
|
|
<br />
|
|
# Toutes les adresses IP doivent répondre aux requêtes sur les
|
|
# serveurs virtuels
|
|
NameVirtualHost *:80<br />
|
|
<br />
|
|
<VirtualHost *:80><br />
|
|
<indent>
|
|
DocumentRoot /www/example1<br />
|
|
ServerName www.example1.com<br />
|
|
<br />
|
|
# Autres directives ici<br />
|
|
<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost *:80><br />
|
|
<indent>
|
|
DocumentRoot /www/example2<br />
|
|
ServerName www.example2.org<br />
|
|
<br />
|
|
# Autres directives ici<br />
|
|
<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Les astérisques correspondent à toutes les adresses, si bien que
|
|
le serveur principal ne répondra jamais à aucune requête. Comme
|
|
<code>www.example1.com</code> se trouve en premier dans le fichier
|
|
de configuration, il a la plus grande priorité et peut être vu
|
|
comme serveur <cite>par défaut</cite> ou <cite>primaire</cite> ;
|
|
ce qui signifie que toute requête reçue ne correspondant pas à une
|
|
des directives <code>ServerName</code> sera servie par ce premier
|
|
<code>VirtualHost</code>.</p>
|
|
|
|
<note>
|
|
<title>Note :</title>
|
|
|
|
<p>Si vous le souhaitez, vous pouvez remplacer <code>*</code>
|
|
par l'adresse IP du système. Dans ce cas, l'argument de
|
|
<code>VirtualHost</code> <em>doit</em> correspondre à
|
|
l'argument de <code>NameVirtualHost</code> :</p>
|
|
|
|
<example>
|
|
NameVirtualHost 172.20.30.40<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
# etc ...
|
|
</example>
|
|
|
|
<p>En général, il est commode d'utiliser <code>*</code> sur
|
|
les systèmes dont l'adresse IP n'est pas constante - par
|
|
exemple, pour des serveurs dont l'adresse IP est attribuée
|
|
dynamiquement par le FAI, et où le DNS est géré au moyen
|
|
d'un DNS dynamique quelconque. Comme <code>*</code> signifie
|
|
<cite>n'importe quelle adresse</cite>, cette configuration
|
|
fonctionne sans devoir être modifiée quand l'adresse IP du
|
|
système est modifiée.</p>
|
|
</note>
|
|
|
|
<p>La configuration ci-dessus est en pratique utilisée dans la
|
|
plupart des cas pour les serveurs virtuels par nom. En fait, le
|
|
seul cas où cette configuration ne fonctionne pas est lorsque
|
|
différents contenus doivent être servis en fonction de l'adresse IP
|
|
et du port contactés par le client.</p>
|
|
|
|
</section>
|
|
|
|
<section id="twoips"><title>Serveurs virtuels par nom sur plus
|
|
d'une seule adresse IP.</title>
|
|
|
|
<note>
|
|
<title>Note :</title><p>Toutes les techniques présentées ici
|
|
peuvent être étendues à un plus grand nombre d'adresses IP.</p>
|
|
</note>
|
|
|
|
<p>Le serveur a deux adresses IP. Sur l'une
|
|
(<code>172.20.30.40</code>), le serveur "principal"
|
|
<code>server.domain.com</code> doit répondre, et sur l'autre
|
|
(<code>172.20.30.50</code>), deux serveurs virtuels (ou plus)
|
|
répondront.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 80<br />
|
|
<br />
|
|
# Serveur "principal" sur 172.20.30.40<br />
|
|
ServerName server.domain.com<br />
|
|
DocumentRoot /www/mainserver<br />
|
|
<br />
|
|
# l'autre adresse <br />
|
|
NameVirtualHost 172.20.30.50<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.50><br />
|
|
<indent>
|
|
DocumentRoot /www/example1<br />
|
|
ServerName www.example1.com<br />
|
|
<br />
|
|
# D'autres directives ici ...<br />
|
|
<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.50><br />
|
|
<indent>
|
|
DocumentRoot /www/example2<br />
|
|
ServerName www.example2.org<br />
|
|
<br />
|
|
# D'autres directives ici ...<br />
|
|
<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Toute requête arrivant sur une autre adresse que
|
|
<code>172.20.30.50</code> sera servie par le serveur principal.
|
|
Les requêtes vers <code>172.20.30.50</code> avec un nom de serveur
|
|
inconnu, ou sans en-tête <code>Host:</code>, seront servies par
|
|
<code>www.example1.com</code>.</p>
|
|
|
|
</section>
|
|
|
|
<section id="intraextra"><title>Servir le même contenu sur des
|
|
adresses IP différentes (telle qu'une adresse interne et une
|
|
externe).</title>
|
|
|
|
<p>La machine serveur dispose de deux adresses IP
|
|
(<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette
|
|
machine est placée à la fois sur le réseau interne (l'Intranet)
|
|
et le réseau externe (Internet). Sur Internet, le nom
|
|
<code>server.example.com</code> pointe vers l'adresse externe
|
|
(<code>172.20.30.40</code>), mais sur le réseau interne, ce même
|
|
nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
|
|
|
|
<p>Le serveur peut être configuré pour répondre de la même manière
|
|
aux requêtes internes et externes, au moyen d'une seule section
|
|
<code>VirtualHost</code>.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
NameVirtualHost 192.168.1.1<br />
|
|
NameVirtualHost 172.20.30.40<br />
|
|
<br />
|
|
<VirtualHost 192.168.1.1 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/server1<br />
|
|
ServerName server.example.com<br />
|
|
ServerAlias server<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Ainsi, les requêtes en provenance de chacun des deux réseaux
|
|
seront servies par le même <code>VirtualHost</code>.</p>
|
|
|
|
<note>
|
|
<title>Note :</title><p>Sur le réseau interne, il est possible
|
|
d'utiliser le nom raccourci <code>server</code> au lieu du nom
|
|
complet <code>server.example.com</code>.</p>
|
|
|
|
<p>Notez également que dans l'exemple précédent, vous pouvez
|
|
remplacer la liste des adresses IP par des <code>*</code> afin
|
|
que le serveur réponde de la même manière sur toutes ses
|
|
adresses.</p>
|
|
</note>
|
|
|
|
</section>
|
|
|
|
<section id="port"><title>Servir différents sites sur différents
|
|
ports.</title>
|
|
|
|
<p>Vous disposez de plusieurs domaines pointant sur la même adresse
|
|
IP et vous voulez également servir de multiples ports. Vous y
|
|
parviendrez en définissant les ports dans la directive
|
|
"NameVirtualHost". Si vous tentez d'utiliser <VirtualHost
|
|
name:port> sans directive NameVirtualHost name:port, ou tentez
|
|
d'utiliser la directive Listen, votre configuration ne fonctionnera
|
|
pas.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 80<br />
|
|
Listen 8080<br />
|
|
<br />
|
|
NameVirtualHost 172.20.30.40:80<br />
|
|
NameVirtualHost 172.20.30.40:8080<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:80><br />
|
|
<indent>
|
|
ServerName www.example1.com<br />
|
|
DocumentRoot /www/domain-80<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:8080><br />
|
|
<indent>
|
|
ServerName www.example1.com<br />
|
|
DocumentRoot /www/domain-8080<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:80><br />
|
|
<indent>
|
|
ServerName www.example2.org<br />
|
|
DocumentRoot /www/otherdomain-80<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:8080><br />
|
|
<indent>
|
|
ServerName www.example2.org<br />
|
|
DocumentRoot /www/otherdomain-8080<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
</section>
|
|
|
|
<section id="ip"><title>Hébergement virtuel basé sur IP</title>
|
|
|
|
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
|
|
et <code>172.20.30.50</code>) correspondant respectivement aux noms
|
|
<code>www.example1.com</code> et <code>www.example2.org</code>.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 80<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/example1<br />
|
|
ServerName www.example1.com<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.50><br />
|
|
<indent>
|
|
DocumentRoot /www/example2<br />
|
|
ServerName www.example2.org<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Les requêtes provenant d'adresses non spécifiées dans l'une des
|
|
directives <code><VirtualHost></code> (comme pour
|
|
<code>localhost</code> par exemple) seront dirigées vers le serveur
|
|
principal, s'il en existe un.</p>
|
|
|
|
</section>
|
|
|
|
<section id="ipport"><title>Hébergements virtuels mixtes basés sur
|
|
les ports et sur les IP</title>
|
|
|
|
<p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
|
|
et <code>172.20.30.50</code>) correspondant respectivement aux noms
|
|
<code>www.example1.com</code> et <code>www.example2.org</code>.
|
|
Pour chacun d'eux, nous voulons un hébergement sur les ports 80
|
|
et 8080.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 172.20.30.40:80<br />
|
|
Listen 172.20.30.40:8080<br />
|
|
Listen 172.20.30.50:80<br />
|
|
Listen 172.20.30.50:8080<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:80><br />
|
|
<indent>
|
|
DocumentRoot /www/example1-80<br />
|
|
ServerName www.example1.com<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40:8080><br />
|
|
<indent>
|
|
DocumentRoot /www/example1-8080<br />
|
|
ServerName www.example1.com<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.50:80><br />
|
|
<indent>
|
|
DocumentRoot /www/example2-80<br />
|
|
ServerName www.example1.org<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.50:8080><br />
|
|
<indent>
|
|
DocumentRoot /www/example2-8080<br />
|
|
ServerName www.example2.org<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
</section>
|
|
|
|
<section id="mixed"><title>Hébergements virtuels mixtes basé sur
|
|
les noms et sur IP</title>
|
|
|
|
<p>Pour certaines adresses, des serveurs virtuels seront définis
|
|
par nom, et pour d'autres, ils seront définis par IP.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 80<br />
|
|
<br />
|
|
NameVirtualHost 172.20.30.40<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/example1<br />
|
|
ServerName www.example1.com<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/example2<br />
|
|
ServerName www.example2.org<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/example3<br />
|
|
ServerName www.example3.net<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
# "par-IP"<br />
|
|
<VirtualHost 172.20.30.50><br />
|
|
<indent>
|
|
DocumentRoot /www/example4<br />
|
|
ServerName www.example4.edu<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.60><br />
|
|
<indent>
|
|
DocumentRoot /www/example5<br />
|
|
ServerName www.example5.gov<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
</section>
|
|
|
|
<section id="proxy"><title>Utilisation simultanée de
|
|
<code>Virtual_host</code> et de mod_proxy</title>
|
|
|
|
<p>L'exemple suivant montre comment une machine peut mandater
|
|
un serveur virtuel fonctionnant sur le serveur d'une autre machine.
|
|
Dans cet exemple, un serveur virtuel de même nom est configuré sur
|
|
une machine à l'adresse <code>192.168.111.2</code>. La directive
|
|
<directive module="mod_proxy">ProxyPreserveHost On</directive> est
|
|
employée pour permette au nom de domaine d'être préservé lors du
|
|
transfert, au cas où plusieurs noms de domaines cohabitent sur
|
|
une même machine.</p>
|
|
|
|
<example>
|
|
<VirtualHost *:*><br />
|
|
ProxyPreserveHost On<br />
|
|
ProxyPass / http://192.168.111.2<br />
|
|
ProxyPassReverse / http://192.168.111.2/<br />
|
|
ServerName hostname.example.com<br />
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
</section>
|
|
|
|
<section id="default"><title>Utilisation de serveurs virtuels
|
|
<code>_default_</code></title>
|
|
|
|
<section id="defaultallports"><title>Serveurs virtuels
|
|
<code>_default_</code> pour tous les ports</title>
|
|
|
|
<p>Exemple de capture de <em>toutes</em> les requêtes émanant
|
|
d'adresses IP ou de ports non connus, <em>c'est-à-dire</em>, d'un
|
|
couple adresse/port non traité par aucun autre serveur virtuel.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
<VirtualHost _default_:*><br />
|
|
<indent>
|
|
DocumentRoot /www/default<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>L'utilisation d'un tel serveur virtuel avec un joker pour le
|
|
port empêche de manière efficace qu'une requête n'atteigne le
|
|
serveur principal.</p>
|
|
|
|
<p>Un serveur virtuel par défaut ne servira jamais une requête
|
|
qui est envoyée vers un couple adresse/port utilisée par un
|
|
serveur virtuel par nom. Si la requête contient un en-tête
|
|
<code>Host:</code> inconnu, ou si celui-ci est absent, elle
|
|
sera toujours servie par le serveur virtuel primaire par nom
|
|
(celui correspondant à ce couple adresse/port trouvé en premier
|
|
dans le fichier de configuration).</p>
|
|
|
|
<p>Vous pouvez utiliser une directive
|
|
<directive module="mod_alias">AliasMatch</directive> ou
|
|
<directive module="mod_rewrite">RewriteRule</directive> afin de
|
|
réécrire une requête pour une unique page d'information (ou pour
|
|
un script).</p>
|
|
</section>
|
|
|
|
<section id="defaultdifferentports"><title>Serveurs virtuels
|
|
<code>_default_</code> pour des ports différents</title>
|
|
|
|
<p>La configuration est similaire à l'exemple précédent, mais
|
|
le serveur écoute sur plusieurs ports et un second serveur virtuel
|
|
<code>_default_</code> pour le port 80 est ajouté.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
<VirtualHost _default_:80><br />
|
|
<indent>
|
|
DocumentRoot /www/default80<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost _default_:*><br />
|
|
<indent>
|
|
DocumentRoot /www/default<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Le serveur virtuel par défaut défini pour le port 80 (il doit
|
|
impérativement être placé avant un autre serveur virtuel par
|
|
défaut traitant tous les ports grâce au joker *) capture toutes
|
|
les requêtes envoyées sur une adresse IP non spécifiée. Le
|
|
serveur principal n'est jamais utilisé pour servir une requête.</p>
|
|
</section>
|
|
|
|
<section id="defaultoneport"><title>Serveurs virtuels
|
|
<code>_default_</code> pour un seul port</title>
|
|
|
|
<p>Nous voulons créer un serveur virtuel par défaut seulement
|
|
pour le port 80.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
<VirtualHost _default_:80><br />
|
|
DocumentRoot /www/default<br />
|
|
...<br />
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Une requête vers une adresse non spécifiée sur le port 80
|
|
sera servie par le serveur virtuel par défaut, et toute autre
|
|
requête vers une adresse et un port non spécifiés sera servie
|
|
par le serveur principal.</p>
|
|
</section>
|
|
|
|
</section>
|
|
|
|
<section id="migrate"><title>Migration d'un serveur virtuel
|
|
par nom en un serveur virtuel par IP</title>
|
|
|
|
<p>Le serveur virtuel par nom avec le nom de domaine
|
|
<code>www.example2.org</code> (de notre <a href="#name">exemple
|
|
par nom</a>) devrait obtenir sa propre adresse IP. Pendant la
|
|
phase de migration, il est possible d'éviter les problèmes avec
|
|
les noms de serveurs et autres serveurs mandataires qui mémorisent
|
|
les vielles adresses IP pour les serveurs virtuels par nom.<br />
|
|
La solution est simple, car il suffit d'ajouter la nouvelle
|
|
adresse IP (<code>172.20.30.50</code>) dans la directive
|
|
<code>VirtualHost</code>.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
Listen 80<br />
|
|
ServerName www.example1.com<br />
|
|
DocumentRoot /www/example1<br />
|
|
<br />
|
|
NameVirtualHost 172.20.30.40<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40 172.20.30.50><br />
|
|
<indent>
|
|
DocumentRoot /www/example2<br />
|
|
ServerName www.example2.org<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/example3<br />
|
|
ServerName www.example3.net<br />
|
|
ServerAlias *.example3.net<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>Le serveur virtuel peut maintenant être joint par la nouvelle
|
|
adresse (comme un serveur virtuel par IP) et par l'ancienne
|
|
adresse (comme un serveur virtuel par nom).</p>
|
|
|
|
</section>
|
|
|
|
<section id="serverpath"><title>Utilisation de la directive
|
|
<code>ServerPath</code></title>
|
|
|
|
<p>Dans le cas où vous disposez de deux serveurs virtuels par nom,
|
|
le client doit transmettre un en-tête <code>Host:</code> correct
|
|
pour déterminer le serveur concerné. Les vieux clients HTTP/1.0
|
|
n'envoient pas un tel en-tête et Apache n'a aucun indice pour
|
|
connaître le serveur virtuel devant être joint (il sert la
|
|
requête à partir d'un serveur virtuel primaire). Dans un soucis
|
|
de préserver la compatibilité descendante, il suffit de créer
|
|
un serveur virtuel primaire chargé de retourner une page contenant
|
|
des liens dont les URLs auront un préfixe identifiant les serveurs
|
|
virtuels par nom.</p>
|
|
|
|
<example>
|
|
<title>Configuration du serveur</title>
|
|
|
|
NameVirtualHost 172.20.30.40<br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
# Serveur virtuel primaire<br />
|
|
DocumentRoot /www/subdomain<br />
|
|
RewriteEngine On<br />
|
|
RewriteRule ^/.* /www/subdomain/index.html<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
DocumentRoot /www/subdomain/sub1<br />
|
|
<indent>
|
|
ServerName www.sub1.domain.tld<br />
|
|
ServerPath /sub1/<br />
|
|
RewriteEngine On<br />
|
|
RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost><br />
|
|
<br />
|
|
<VirtualHost 172.20.30.40><br />
|
|
<indent>
|
|
DocumentRoot /www/subdomain/sub2<br />
|
|
ServerName www.sub2.domain.tld<br />
|
|
ServerPath /sub2/<br />
|
|
RewriteEngine On<br />
|
|
RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
|
|
# ...<br />
|
|
</indent>
|
|
</VirtualHost>
|
|
</example>
|
|
|
|
<p>À cause de la directive
|
|
<directive module="core">ServerPath</directive>, une requête sur
|
|
une URL <code>http://www.sub1.domain.tld/sub1/</code> est
|
|
<em>toujours</em> servie par le serveur sub1-vhost.<br />
|
|
Une requête sur une URL <code>http://www.sub1.domain.tld/</code> n'est
|
|
servie par le serveur sub1-vhost que si le client envoie un en-tête
|
|
<code>Host:</code> correct. Si aucun en-tête <code>Host:</code>
|
|
n'est transmis, le serveur primaire sera utilisé.<br />
|
|
Notez qu'il y a une singularité : une requête sur
|
|
<code>http://www.sub2.domain.tld/sub1/</code> est également servie
|
|
par le serveur sub1-vhost si le client n'envoie pas d'en-tête
|
|
<code>Host:</code>.<br />
|
|
Les directives <directive module="mod_rewrite">RewriteRule</directive>
|
|
sont employées pour s'assurer que le client qui envoie un en-tête
|
|
<code>Host:</code> correct puisse utiliser d'autres variantes d'URLs,
|
|
<em>c'est-à-dire</em> avec ou sans préfixe d'URL.</p>
|
|
|
|
</section>
|
|
|
|
</manualpage>
|