path: root/docs/manual/vhosts/examples.xml.fr

<?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: 395228 -->
<!-- French translation by Vincent Deffontaines, Alain B., review by  -->

<!--
 Copyright 2005 The Apache Software Foundation or its licensors, as
 applicable.

 Licensed 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&nbsp;:</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 />
    &lt;VirtualHost *:80&gt;<br />
    <indent>
      DocumentRoot /www/example1<br />
      ServerName www.example1.com<br />
      <br />
      # Autres directives ici<br />
      <br />
    </indent>
    &lt;/VirtualHost&gt;<br />
    <br />
    &lt;VirtualHost *:80&gt;<br />
    <indent>
      DocumentRoot /www/example2<br />
      ServerName www.example2.org<br />
      <br />
      # Autres directives ici<br />
      <br />
    </indent>
    &lt;/VirtualHost&gt;
    </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>&nbsp;; 
    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&nbsp;:</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>&nbsp;:</p>

            <example>
            NameVirtualHost 172.20.30.40<br />
						<br />
            &lt;VirtualHost 172.20.30.40&gt;<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&nbsp;:</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 />
    &lt;VirtualHost 172.20.30.50&gt;<br />
    <indent>
        DocumentRoot /www/example1<br />
        ServerName www.example1.com<br />
   	        <br />
        # D'autres directives ici ...<br />
                   <br />
    </indent>
    &lt;/VirtualHost&gt;<br />
        <br />
    &lt;VirtualHost 172.20.30.50&gt;<br />
    <indent>
        DocumentRoot /www/example2<br />
        ServerName www.example2.org<br />
                <br />
        # D'autres directives ici ...<br />
                <br />
    </indent>
    &lt;/VirtualHost&gt;
    </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 />
    &lt;VirtualHost 192.168.1.1 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/server1<br />
        ServerName server.example.com<br />
        ServerAlias server<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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&nbsp;:</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 &lt;VirtualHost 
    name:port&gt; 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 />
    &lt;VirtualHost 172.20.30.40:80&gt;<br />
    <indent>
        ServerName www.example1.com<br />
        DocumentRoot /www/domain-80<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
    <indent>
        ServerName www.example1.com<br />
        DocumentRoot /www/domain-8080<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40:80&gt;<br />
    <indent>
        ServerName www.example2.org<br />
        DocumentRoot /www/otherdomain-80<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
    <indent>
        ServerName www.example2.org<br />
        DocumentRoot /www/otherdomain-8080<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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 />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/example1<br />
        ServerName www.example1.com<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.50&gt;<br />
    <indent>
        DocumentRoot /www/example2<br />
        ServerName www.example2.org<br />
    </indent>
    &lt;/VirtualHost&gt;
    </example>

    <p>Les requ�tes provenant d'adresses non sp�cifi�es dans l'une des 
    directives <code>&lt;VirtualHost&gt;</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 />
    &lt;VirtualHost 172.20.30.40:80&gt;<br />
    <indent>
        DocumentRoot /www/example1-80<br />
        ServerName www.example1.com<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
    <indent>
        DocumentRoot /www/example1-8080<br />
        ServerName www.example1.com<br />
		</indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.50:80&gt;<br />
    <indent>
        DocumentRoot /www/example2-80<br />
        ServerName www.example1.org<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.50:8080&gt;<br />
    <indent>
        DocumentRoot /www/example2-8080<br />
        ServerName www.example2.org<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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 />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/example1<br />
        ServerName www.example1.com<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/example2<br />
        ServerName www.example2.org<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/example3<br />
        ServerName www.example3.net<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    # "par-IP"<br />
    &lt;VirtualHost 172.20.30.50&gt;<br />
    <indent>
        DocumentRoot /www/example4<br />
        ServerName www.example4.edu<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.60&gt;<br />
    <indent>
        DocumentRoot /www/example5<br />
        ServerName www.example5.gov<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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>
    &lt;VirtualHost *:*&gt;<br />
        ProxyPreserveHost On<br />
        ProxyPass / http://192.168.111.2<br />
        ProxyPassReverse / http://192.168.111.2/<br />
        ServerName hostname.example.com<br />
    &lt;/VirtualHost&gt;
    </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>

    &lt;VirtualHost _default_:*&gt;<br />
    <indent>
        DocumentRoot /www/default<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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>

    &lt;VirtualHost _default_:80&gt;<br />
    <indent>
        DocumentRoot /www/default80<br />
        # ...<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost _default_:*&gt;<br />
    <indent>
        DocumentRoot /www/default<br />
        # ...<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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>

    &lt;VirtualHost _default_:80&gt;<br />
    DocumentRoot /www/default<br />
    ...<br />
    &lt;/VirtualHost&gt;
    </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 />
    &lt;VirtualHost 172.20.30.40 172.20.30.50&gt;<br />
    <indent>
        DocumentRoot /www/example2<br />
        ServerName www.example2.org<br />
        # ...<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        DocumentRoot /www/example3<br />
        ServerName www.example3.net<br />
        ServerAlias *.example3.net<br />
        # ...<br />
    </indent>
    &lt;/VirtualHost&gt;
    </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 />
    &lt;VirtualHost 172.20.30.40&gt;<br />
    <indent>
        # Serveur virtuel primaire<br />
        DocumentRoot /www/subdomain<br />
        RewriteEngine On<br />
        RewriteRule ^/.* /www/subdomain/index.html<br />
        # ...<br />
    </indent>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40&gt;<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>
    &lt;/VirtualHost&gt;<br />
		<br />
    &lt;VirtualHost 172.20.30.40&gt;<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>
    &lt;/VirtualHost&gt;
    </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�&nbsp;: 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>