Updates.

<?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: 151408:833879 (outdated) -->

<!-- English Revision: 833879 -->

<!-- French translation by Vincent Deffontaines, review by alain B -->

<!-- Updated by Lucien Gentis -->

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

    sections <directive type="section" module="core">VirtualHost</directive>.</p>

    <p>Les directives

    <directive module="mpm_common">Listen</directive>,

    <directive module="core">ServerName</directive>,

    <directive module="core">ServerPath</directive>,

    et <directive module="core">ServerAlias</directive>

    <directive module="core">ServerName</directive> et

    <directive module="core">ServerPath</directive>

    peuvent être placées n'importe où dans le cadre de définition d'un

    serveur. Cependant, chaque fois que l'une d'elles est lue, elle écrase

    ses instances précédentes (dans le contexte du même serveur).</p>

    <p>La valeur par défaut du champ <code>Listen</code> pour le serveur 

    principal est de 80. Le serveur principal n'a pas de valeur par 

    <p>Le serveur principal n'a pas de valeur par

    défaut pour <code>ServerPath</code> ni pour <code>ServerAlias</code>.

    La valeur par défaut de <code>ServerName</code> est déduite à partir

    de l'adresses IP du serveur.</p>

    <p>La directive Listen associée au serveur principal a deux utilités. 

    La première détermine le port réseau sur lequel Apache va écouter. 

    La deuxième spécifie le port qui sera utilisé dans les URIs absolus 

    lors des redirections.</p>

    <p>À la différence du serveur principal, les ports des serveurs 

    virtuels <em>n</em>'affectent <em>pas</em> les ports sur lesquels 

    Apache se met à l'écoute.</p>

	<p>Les numéros de port spécifiés par la directive

	<code>VirtualHost</code> n'ont rien à voir avec les ports sur

	lesquels Apache va se mettre en écoute. Ils permettent seulement

	de déterminer quel <code>VirtualHost</code> devra être

	sélectionné pour traiter la requête.</p>

    <p>Chaque adresse incluse dans une directive <code>VirtualHost</code>

    peut disposer d'un port optionnel. Si le port n'est pas précisé, il

    prend par défaut la dernière valeur de <code>Listen</code> lue dans 

    la configuration du serveur principal. Le port particulier 

    pourra prendre n'importe quelle valeur. Le port particulier

    <code>*</code> représente un joker qui correspond à tous les ports.

    L'ensemble des adresses (y compris les résultats multiples

    <code>A</code> issus des requêtes DNS) est appelé <em>jeu

    <p>À moins qu'une directive

    <directive module="core">NameVirtualHost</directive> ne soit utilisée

    pour une adresse IP spécifique, le premier serveur virtuel avec 

    cette adresse est considéré comme un <em>serveur virtuel par-IP</em>. 

    L'adresse IP peut également prendre la valeur joker <code>*</code>.</p>

    pour la paire adresse IP exacte/port dans la directive

    <code>VirtualHost</code>, Apache sélectionne le serveur virtuel qui

    correspond le mieux en se basant sur l'adresse IP (ou une adresse

    quelconque) et le numéro de port. Si plusieurs serveurs virtuels

    correspondent sans pouvoir être départagés, c'est le premier qui

    apparaît dans le fichier de configuration qui sera sélectionné.</p>

    <p>Si vous souhaitez qu'Apache <em>affine</em> ses critères de

    sélection en faisant entrer en jeu l'en-tête HTTP <code>Host</code>

    fourni par le client, la directive <code>NameVirtualHost</code> <em>doit</em>

    apparaître avec la paire adresse IP exacte (ou adresse

    quelconque)/port utilisée dans le jeu de directives

    <code>VirtualHost</code> correspondant.</p>

    <p>La sélection du serveur virtuel en fonction du nom n'intervient

    qu'après la sélection d'un serveur virtuel à base d'adresse IP

    unique, et ne prend en compte que l'ensemble des serveurs virtuels

    qui possèdent la même paire adresse IP/port.</p>

    <p>On peut utiliser des nom d'hôtes à la place d'adresses IP dans la

    définition des serveurs virtuels, mais ils seront résolus en

    adresses IP au démarrage du serveur et ceci n'est pas recommandé.</p>

    <p>Dans les cas où l'on souhaite utiliser un <em>serveur virtuel 

    par nom</em>, la directive <code>NameVirtualHost</code> <em>doit</em> 

    apparaître avec l'adresse IP choisie. En d'autres termes, vous devez 

    spécifier dans votre fichier de configuration l'adresse IP des noms 

    de domaine (CNAME) de vos serveurs virtuels par nom au moyen de 

    la directive <code>NameVirtualHost</code>.</p>

    <p>On peut utiliser plusieurs directives <code>NameVirtualHost</code>

    pour un groupe de directives <code>VirtualHost</code>, mais seule

    <p>(Il est conseillé d'adopter le choix de gauche pour faciliter

    la lisibilité des fichiers de configuration.)</p>

    <p>Après la lecture de la directive <code>VirtualHost</code>, le 

    serveur virtuel se voit attribuer une valeur <code>Listen</code> 

    par défaut qui est la valeur du port associé au premier nom spécifié 

    dans sa directive <code>VirtualHost</code>.</p>

    <p>La liste complète des noms d'une directive <code>VirtualHost</code> 

    est gérée exactement comme des <code>ServerAlias</code> (mais ne 

    sont pas écrasés par d'autres <code>ServerAlias</code>) si tous 

    les noms sont résolus dans ce jeu d'adresse. À noter que les états 

    <code>Listen</code> de ce serveur virtuel sont sans incidence sur 

    les ports attibués au jeu d'adresses.</p>

    <p>Pendant la phase d'initialisation, une liste de chaque adresse

    IP est générée et introduite dans une table de 'hash'. Si une

    adresse IP est utilisée dans une directive <code>NameVirtualHost</code>,

    <ol>

      <li>Dans le cas où un serveur virtuel ne contient pas de directives

      <directive module="core">ServerAdmin</directive>,

      <directive module="core">ResourceConfig</directive>,

      <directive module="core">AccessConfig</directive>,

      <directive module="core">Timeout</directive>,

      <directive module="core">KeepAliveTimeout</directive>,

      <directive module="core">KeepAlive</directive>,

      <directive module="core">MaxKeepAliveRequests</directive>,

      <directive module="core">ReceiveBufferSize</directive>,

      ou <directive module="core">SendBufferSize</directive>,

      alors la valeur de chacun de ces paramètres est héritée de celle du

      serveur principal. (C'est à dire, héritée de la valeur finale après

    <p>Dans le cas où le serveur principal n'a pas de <code>ServerName</code>

    à ce stade, le nom de la machine sur laquelle tourne le programme

    <program>httpd</program> est utilisé à sa place. Nous appellerons

    <em>jeu d'adresses du serveur principal</em>, les adresses IP 

    <em>jeu d'adresses du serveur principal</em> les adresses IP

    renvoyées par une résolution DNS sur le <code>ServerName</code>

    du serveur principal.</p>

    <p>Si l'adresse IP n'est pas trouvée dans la table de hash, la

    recherche du numéro de port peut aussi se terminer par une

    correspondance à un <code>NameVirtualHost *</code> qui est géré

    ensuite comme les autres serveur virtuels par noms.</p>

    ensuite comme les autres serveurs virtuels par noms.</p>

    <p>Si une liste est bien trouvée dans la table pour l'adresse

    IP recherchée, l'étape suivante est de déterminer s'il s'agit

    dans le fichier de configuration.</p>

    <p>Le premier serveur virtuel de cette liste (donc, le premier

    serveur virtuel attribué à une adresse IP donnée dans le fichier 

    de configuration) se voit attribuer la plus grande priorité, ce 

    serveur virtuel du fichier de configuration

    attribué à l'adresse IP spécifiée)

    se voit attribuer la plus grande priorité, ce

    qui signifie que c'est lui qui traite les requêtes présentant un

    nom de serveur invalide ou ne présentant pas de champ

    <code>Host:</code> dans l'en-tête.</p>

    port sur lequel il a effectivement reçu la requête.</p>

    <p>Dans le cas où le client a envoyé une requête en HTTP/1.0 sans

    un champ d'en-tête <code>Host:</code>, il est impossible de 

    champ d'en-tête <code>Host:</code>, il est impossible de

    déterminer le serveur auquel le client veut se connecter ; l'URI

    de la requête est recherché dans tous les <code>ServerPath</code>

    existants. Le premier chemin trouvé est utilisé et la requête est

    <ul>

      <li>Les serveurs virtuels par nom et par IP n'interfèrent

      jamais entre eux. Les serveurs virtuels par IP ne sont joignables

      qu'au travers de leur(s) adresse(s) IP propre(s), en aucun 

      cas par aucune autre adresse. Les serveurs virtuels par nom 

      qu'au travers de leur(s) adresse(s) IP propre(s), et en aucun

      cas par une autre adresse. Les serveurs virtuels par nom

      ne sont accessibles que par leur(s) adresse(s) IP qui ne peuvent

      être définies qu'au moyen de la directive

      <code>NameVirtualHost</code>.</li>

      voit attribué la priorité la plus haute pour les requêtes

      arrivant sur son jeu d'adresses IP.</li>

      <li>Pour des raisons de sécurité, le numéro de port présenté 

      <li>Le numéro de port présenté

      dans le champ d'en-tête <code>Host:</code> n'est jamais utilisé

      pour les tests de correspondances. Apache ne prend en compte

      que le numéro de port sur lequel le client a envoyé la requête.</li>

      être spécifié (<em>comme dans</em> <code>_default_:*</code>)

      pour récupérer les requêtes sur tous les ports ouverts. Ceci

      est également applicable aux serveurs virtuels

      <code>NameVirtualHost *</code>.</li>

      <code>NameVirtualHost *</code>. Notez que ceci n'est qu'une

      extension du principe de "meilleure correspondance", au même titre

      qu'une correspondance spécifique et exacte est préférée à une

      valeur quelconque.</li>

      <li>Le serveur principal ne sert à servir les requêtes que 

      <li>Le serveur principal ne sert les requêtes que

      lorsque l'adresse IP et le port demandés par le client ne

      correspondent à aucun serveur virtuel (y compris un serveur

      virtuel <code>_default_</code>). En d'autres termes, le serveur

      <li>Ni les serveurs virtuels <code>_default_</code>, ni le

      serveur principal ne sont utilisés pour traiter une requête

      avec un champ d'en-tête <code>Host:</code> manquant ou vide 

      avec un champ d'en-tête <code>Host:</code> inconnu ou manquant

      lorsque l'adresse (et le port) de connexion correspondent à

      des serveurs virtuels par nom, par exemple, dans une directive

      <code>NameVirtualHost</code>.</li>

      -- la manière dont la configuration est interprétée après la

      lecture des fichiers ne met pas en évidence le fait que les

      définitions positionnées avant et surtout après les serveurs

      virtuels peuvent impacter le fonctionnement des serveurs virtuels.)</li>

      virtuels peuvent impacter le fonctionnement de tous les

      serveurs virtuels.)</li>

      <li>Toujours regrouper les définitions <code>NameVirtualHost</code>

      et <code>VirtualHost</code> dans la configuration pour une 

      meilleure lisibilité.</li>

      et <code>VirtualHost</code> correspondantes

      dans la configuration pour une meilleure lisibilité.</li>

      <li>Éviter les <code>ServerPaths</code> qui sont préfixes

      d'autres <code>ServerPaths</code>. Si cela ne peut être évité,

<?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: 421100:989156 (outdated) -->

<!-- English Revision: 989156 -->

<!-- French translation by Vincent Deffontaines, Alain B., review by  -->

<!-- updated by Lucien Gentis -->

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

<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 plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>. 

    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> 

    <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>

    Pour l'exemple, <code>www.example.com</code> et 

    <code>www.example.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 

    <br />

    &lt;VirtualHost *:80&gt;<br />

    <indent>

      DocumentRoot /www/example1<br />

      DocumentRoot /www/example.com<br />

      ServerName www.example1.com<br />

      <br />

      # Autres directives ici<br />

    <br />

    &lt;VirtualHost *:80&gt;<br />

    <indent>

      DocumentRoot /www/example2<br />

      DocumentRoot /www/example.org<br />

      ServerName www.example2.org<br />

      <br />

      # Autres directives ici<br />

    <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 

    <code>www.example.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 

    ce qui signifie que toute requête reçue ne correspondant à aucune 

    des directives <code>ServerName</code> sera servie par ce premier 

    <code>VirtualHost</code>.</p>

        <br />

    &lt;VirtualHost 172.20.30.50&gt;<br />

    <indent>

        DocumentRoot /www/example1<br />

        ServerName www.example1.com<br />

        DocumentRoot /www/example.com<br />

        ServerName www.example.com<br />

   	        <br />

        # D'autres directives ici ...<br />

                   <br />

        <br />

    &lt;VirtualHost 172.20.30.50&gt;<br />

    <indent>

        DocumentRoot /www/example2<br />

        ServerName www.example2.org<br />

        DocumentRoot /www/example.org<br />

        ServerName www.example.org<br />

                <br />

        # D'autres directives ici ...<br />

                <br />

    <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>

    <code>www.example.com</code>.</p>

    </section>

		<br />

    &lt;VirtualHost 172.20.30.40:80&gt;<br />

    <indent>

        ServerName www.example1.com<br />

        ServerName www.example.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 />

        ServerName www.example.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 />

        ServerName www.example.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 />

        ServerName www.example.org<br />

        DocumentRoot /www/otherdomain-8080<br />

    </indent>

    </VirtualHost>

    <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>

    <code>www.example.com</code> et <code>www.example.org</code>.</p>

    <example>

    <title>Configuration du serveur</title>

		<br />

    &lt;VirtualHost 172.20.30.40&gt;<br />

    <indent>

        DocumentRoot /www/example1<br />

        DocumentRoot /www/example.com<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 />

        DocumentRoot /www/example.org<br />

        ServerName www.example2.org<br />

    </indent>

    </VirtualHost>

    <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>. 

    <code>www.example.com</code> et <code>www.example.org</code>. 

    Pour chacun d'eux, nous voulons un hébergement sur les ports 80 

    et 8080.</p>

		<br />

    &lt;VirtualHost 172.20.30.40:80&gt;<br />

    <indent>

        DocumentRoot /www/example1-80<br />

        ServerName www.example1.com<br />

        DocumentRoot /www/example.com-80<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.com-8080<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.org-80<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.org-8080<br />

        ServerName www.example.org<br />

    </indent>

    </VirtualHost>

    </example>

		<br />

    &lt;VirtualHost 172.20.30.40&gt;<br />

    <indent>

        DocumentRoot /www/example1<br />

        ServerName www.example1.com<br />

        DocumentRoot /www/example.com<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.org<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.net<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.edu<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.gov<br />

        ServerName www.example.gov<br />

    </indent>

    </VirtualHost>

    </example>

	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 

    <code>www.example.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 

    <title>Configuration du serveur</title>

    Listen 80<br />

    ServerName www.example1.com<br />

    DocumentRoot /www/example1<br />

    ServerName www.example.com<br />

    DocumentRoot /www/example.com<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 />

        DocumentRoot /www/example.org<br />

        ServerName www.example.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 />

        DocumentRoot /www/example.net<br />

        ServerName www.example.net<br />

        ServerAlias *.example.net<br />

        # ...<br />

    </indent>

    </VirtualHost>

    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 

    n'est transmis, le serveur primaire sera utilisé.</p>

    <p>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> 

    <code>Host:</code>.</p>

    <p>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>