You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by jf...@apache.org on 2005/06/29 10:54:10 UTC
svn commit: r202339 [1/3] - /httpd/httpd/trunk/docs/manual/vhosts/
Author: jfclere
Date: Wed Jun 29 01:54:09 2005
New Revision: 202339
URL: http://svn.apache.org/viewcvs?rev=202339&view=rev
Log:
Submitted and reviewed by Vincent Deffontaines, alain B and Jean-François El Fouly.
Added:
httpd/httpd/trunk/docs/manual/vhosts/details.html.fr
httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/examples.html.fr
httpd/httpd/trunk/docs/manual/vhosts/examples.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/fd-limits.html.fr
httpd/httpd/trunk/docs/manual/vhosts/fd-limits.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/index.html.fr
httpd/httpd/trunk/docs/manual/vhosts/index.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/ip-based.html.fr
httpd/httpd/trunk/docs/manual/vhosts/ip-based.xml.fr
httpd/httpd/trunk/docs/manual/vhosts/name-based.html.fr
httpd/httpd/trunk/docs/manual/vhosts/name-based.xml.fr
Added: httpd/httpd/trunk/docs/manual/vhosts/details.html.fr
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/vhosts/details.html.fr?rev=202339&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/details.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/vhosts/details.html.fr Wed Jun 29 01:54:09 2005
@@ -0,0 +1,459 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Détails sur le fonctionnement des serveurs virtuels - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Détails sur le fonctionnement des serveurs virtuels</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/vhosts/details.html" title="Français"> fr </a> |
+<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+<div class="outofdate">Cette traduction peut être périmée. Verifiez la version
+ Anglaise pour les changements récents.</div>
+
+
+ <p>Le code gérant les serveurs virtuels a été réécrit à partir de
+ zéro dans <strong>Apache 1.3</strong>. Ce document vise à expliquer
+ dans le détail comment Apache procède lors du choix de l'utilisation
+ d'un serveur virtuel en fonction d'une requête reçue. L'apparition
+ de la directive <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>
+ a rendu beaucoup plus facile et plus sûre la configuration des
+ serveurs virtuels par rapport aux versions précédant la 1.3.</p>
+
+ <p>Si vous voulez juste <cite>que ça marche</cite> sans en
+ comprendre le fonctionnement, voici <a href="examples.html">quelques
+ exemples</a>.</p>
+
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configparsing">Interprétation des fichiers
+de configuration</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#hostmatching">Choix du serveur virtuel</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#tips">Trucs et astuces</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="configparsing" id="configparsing">Interprétation des fichiers
+de configuration</a></h2>
+
+ <p>Un <em>serveur principal (main_server)</em> contient toutes
+ les définitions qui apparaissent en dehors des sections
+ <code><VirtualHost></code>. Les serveurs virtuels, aussi
+ appelés <em>vhosts</em> (pour virtual hosts), sont définis par les
+ sections <code class="directive"><a href="../mod/core.html#virtualhost"><VirtualHost></a></code>.</p>
+
+ <p>Les directives
+ <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>,
+ <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>,
+ <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>,
+ et <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code>
+ 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
+ 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>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
+ <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
+ d'adresses</em> du serveur virtuel.</p>
+
+ <p>À moins qu'une directive
+ <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> 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>
+
+ <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
+ une directive <code>NameVirtualHost</code> doit être utilisée pour
+ chaque couple IP:port donné.</p>
+
+ <p>L'ordre d'apparition des directives <code>NameVirtualHost</code>
+ et <code>VirtualHost</code> est sans importance, ce qui fait que
+ les deux exemples suivants ont des effets identiques (seul l'ordre
+ des directives <code>VirtualHost</code> pour <em>un</em> jeu
+ d'adresses est important, voir ci-dessous) :</p>
+
+<table><tr>
+<td><div class="example"><p><code>
+ NameVirtualHost 111.22.33.44<br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur A<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur B<br />
+ ...<br />
+ </VirtualHost><br />
+ <br />
+ NameVirtualHost 111.22.33.55<br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur C<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur D<br />
+ ...<br />
+ </VirtualHost>
+</code></p></div></td>
+<td><div class="example"><p><code>
+ <VirtualHost 111.22.33.44><br />
+ # serveur A<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur C<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur B<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur D<br />
+ ...<br />
+ </VirtualHost><br />
+ <br />
+ NameVirtualHost 111.22.33.44<br />
+ NameVirtualHost 111.22.33.55<br />
+ <br />
+</code></p></div></td>
+</tr></table>
+
+
+ <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>,
+ cette liste contient les noms des serveurs virtuels pour cette
+ adresse. Si aucun serveur virtuel n'est défini pour cette adresse,
+ la directive <code>NameVirtualHost</code> est ignorée et un message
+ est envoyé au journal d'erreurs. Quand un serveur virtuel par IP
+ est utilisé, la table de 'hash' reste vide.</p>
+
+ <p>La fonction de 'hash' étant rapide, le temps d'exécution d'un
+ 'hash' sur une adresse IP lors d'une requête est minimale et
+ quasiment imperceptible. De plus, la table est optimisée pour les
+ adresses IP dont le dernier octet est le seul à changer.</p>
+
+ <p>Pour chaque serveur virtuel, diverses valeurs sont initialisées
+ par défaut. En particulier :</p>
+
+ <ol>
+ <li>Dans le cas où un serveur virtuel ne contient pas de directives
+ <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>,
+ <code class="directive"><a href="../mod/core.html#resourceconfig">ResourceConfig</a></code>,
+ <code class="directive"><a href="../mod/core.html#accessconfig">AccessConfig</a></code>,
+ <code class="directive"><a href="../mod/core.html#timeout">Timeout</a></code>,
+ <code class="directive"><a href="../mod/core.html#keepalivetimeout">KeepAliveTimeout</a></code>,
+ <code class="directive"><a href="../mod/core.html#keepalive">KeepAlive</a></code>,
+ <code class="directive"><a href="../mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a></code>,
+ ou <code class="directive"><a href="../mod/core.html#sendbuffersize">SendBufferSize</a></code>,
+ 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
+ lecture de la configuration du serveur principal.)</li>
+
+ <li>Les permissions par défaut sur les répertoires de chaque
+ serveur virtuel sont assemblées avec celles du serveur principal.
+ Elles concernent également toutes les informations de configuration
+ par répertoire pour tous les modules.</li>
+
+ <li>Les configurations par serveur pour chaque module sont assemblées
+ à partir de celles du serveur principal.</li>
+ </ol>
+
+ <p>L'essentiel des valeurs de configuration des serveurs virtuels
+ provient de valeurs par défaut issues du serveur principal.
+ Mais la position dans le fichier de configuration des directives
+ du serveur principal n'a pas d'importance -- l'ensemble de la
+ configuration du serveur principal est lu avant que ces valeurs par
+ défaut soient appliquées aux serveur virtuels. Ainsi, même si la
+ définition d'une valeur apparaît après celle d'un serveur virtuel,
+ cette valeur peut affecter la definition du serveur virtuel.</p>
+
+ <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
+ <code class="program"><a href="../programs/httpd.html">httpd</a></code> est utilisé à sa place. Nous appellerons
+ <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>Pour tous les champs <code>ServerName</code> non définis, dans
+ le cas d'une configuration en serveur virtuel par nom, la valeur
+ adoptée par défaut est la première adresse donnée dans la section
+ <code>VirtualHost</code> qui définit le serveur virtuel.</p>
+
+ <p>Si un serveur virtuel contient la valeur magique
+ <code>_default_</code>, il fonctionne sur le même <code>ServerName</code>
+ que le serveur principal.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="hostmatching" id="hostmatching">Choix du serveur virtuel</a></h2>
+
+ <p>À la réception d'une requête, le serveur procède comme suit pour
+ déterminer quel serveur virtuel utiliser :</p>
+
+ <h3><a name="hashtable" id="hashtable">Vérification dans la table de hash</a></h3>
+
+ <p>Après que le client se soit connecté, l'adresse
+ IP à laquelle le client s'est connecté est recherchée dans la
+ table de hash IP interne.</p>
+
+ <p>Si la résolution de l'adresse IP n'aboutit pas (adresse IP non
+ trouvée), la requête est servie par le serveur virtuel
+ <code>_default_</code> s'il est défini pour le port correspondant
+ à la requête. Sinon, elle est servie par le 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>
+
+ <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
+ d'un serveur virtuel par nom ou par IP.</p>
+
+
+
+ <h3><a name="ipbased" id="ipbased">Serveur virtuel par IP</a></h3>
+
+ <p>Si l'entrée trouvée dispose d'une liste de noms vide, c'est
+ qu'il s'agit d'un serveur virtuel par IP, et aucun autre choix
+ n'est plus à faire ; la requête est servie par ce serveur virtuel.</p>
+
+
+
+ <h3><a name="namebased" id="namebased">Serveur virtuel par nom</a></h3>
+
+ <p>Si l'entrée trouvée correspond à un serveur virtuel par nom,
+ la liste de noms contient au moins une structure de serveurs
+ virtuels. Les serveurs virtuels se présentent dans cette liste
+ dans le même ordre que la lecture des directives <code>VirtualHost</code>
+ 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
+ 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>
+
+ <p>Si un champ <code>Host:</code> est transmis dans l'en-tête de
+ la requête, son occurrence est recherchée dans la liste et le
+ premier serveur virtuel qui présente un <code>ServerName</code>
+ ou un <code>ServerAlias</code> correspondant est choisi pour
+ servir la requête. Il est possible que le champ <code>Host:</code>
+ contienne un numéro de port, mais Apache utilise toujours le
+ 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
+ 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
+ servie par le serveur virtuel correspondant.</p>
+
+ <p>Si aucun serveur virtuel n'est trouvé, la requête est servie
+ par le premier serveur virtuel qui écoute sur le port demandé et
+ qui est sur la liste associée à l'adresse IP vers laquelle la
+ requête a été envoyée (comme déjà précisé ci-avant).</p>
+
+
+
+ <h3><a name="persistent" id="persistent">Connexions persistantes</a></h3>
+
+ <p>La recherche par adresse IP décrite ci-avant n'est faite
+ qu'<em>une fois</em> pour chaque session TCP/IP, alors que la
+ recherche par nom est réalisée pour <em>chaque</em> requête au
+ cours d'une connexion persistante (KeepAlive). En d'autres termes,
+ il est possible pour un client de faire des requêtes sur
+ différents serveurs virtuels par nom, au cours d'une unique
+ connexion persistante.</p>
+
+
+
+ <h3><a name="absoluteURI" id="absoluteURI">URI absolu</a></h3>
+
+ <p>Au cas où l'URI de la requête est absolu, et que son nom de
+ serveur et son port correspondent au serveur principal (ou l'un
+ des serveurs virtuels configurés), <em>et</em> qu'ils correspondent
+ à l'adresse et au port de la requête, alors l'URI est amputé
+ de son préfixe protocole/nom de serveur/port et traité par le
+ serveur correspondant (principal ou virtuel). Si cette correspondance
+ n'existe pas, l'URI reste inchangé et la requête est considérée
+ comme une requête d'un serveur mandataire (proxy).</p>
+
+
+<h3><a name="observations" id="observations">Observations</a></h3>
+
+ <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
+ 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>
+
+ <li>Les vérifications sur <code>ServerAlias</code> et
+ <code>ServerPath</code> ne sont jamais réalisées pour les
+ serveurs virtuels par IP.</li>
+
+ <li>L'ordre dans lequel sont agencés dans le fichier de
+ configuration le serveur virtuel <code>_default_</code>, les
+ serveurs virtuels par nom et par IP, et la directive
+ <code>NameVirtualHost</code> est sans incidence sur le
+ fonctionnement. Seul l'ordre des serveurs virtuels par nom
+ pour une adresse donnée a une importance. Le serveur virtuel
+ par nom qui est présent en premier dans la configuration se
+ 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é
+ 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>
+
+ <li>Si une directive <code>ServerPath</code> existe, et se
+ trouve être préfixe d'une autre directive <code>ServerPath</code>
+ qui apparaît plus loin dans la configuration, la première
+ sera toujours utilisée et la deuxième jamais. (Ceci ne se
+ produit que dans le cas où aucun champ <code>Host:</code>
+ n'a été présenté par le client pour distinguer les deux.)</li>
+
+ <li>Dans le cas où deux serveurs virtuels par IP ont une
+ adresse en commun, le serveur virtuel qui apparaît en premier
+ dans la configuration est toujours choisi. Ce genre de chose
+ peut arriver par inadvertance. Le serveur envoie une alerte
+ dans le journal d'erreurs si ce cas se présente.</li>
+
+ <li>Le serveur virtuel <code>_default_</code> ne sert la requête
+ que si aucun autre serveur virtuel travaillant sur l'adresse
+ IP <em>et</em> le port demandés n'est trouvé. La requête n'est
+ traitée que si le numéro de port qui a reçu la requête est
+ associé au serveur virtuel <code>_default_</code> (qui par
+ défaut, correspond à <code>Listen</code>). Un port joker peut
+ ê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>
+
+ <li>Le serveur principal ne sert à servir 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
+ principal n'est utile que pour les combinaisons adresse/port
+ non spécifiées (sauf quand un serveur virtuel <code>_default_</code>
+ correspond au port).</li>
+
+ <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
+ lorsque l'adresse (et le port) de connexion correspondent à
+ des serveurs virtuels par nom, par exemple, dans une directive
+ <code>NameVirtualHost</code>.</li>
+
+ <li>Il ne faut jamais employer de noms DNS dans des directives
+ <code>VirtualHost</code>, car cela oblige le serveur a s'appuyer
+ sur le DNS au moment du démarrage. De plus, vous vous exposez
+ à des problèmes de sécurité si vous n'avez pas la maîtrise du
+ DNS pour la totalité de vos domaines. Voir la documentation
+ <a href="../dns-caveats.html">disponible ici</a>, ainsi que
+ les deux points précisés ci-après.</li>
+
+ <li>Un nom de serveur <code>ServerName</code> devrait toujours
+ être indiqué pour chaque serveur virtuel. Sans cela, une
+ résolution DNS est nécessaire pour chaque serveur virtuel.</li>
+ </ul>
+
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="tips" id="tips">Trucs et astuces</a></h2>
+
+ <p>En plus des points évoqués sur la page des
+ <a href="../dns-caveats.html#tips">problèmes liés au DNS</a>,
+ voici quelques points intéressants :</p>
+
+ <ul>
+ <li>Toujours positionner les définitions relatives au serveur
+ principal avant toute définition <code>VirtualHost</code>.
+ (Ceci améliore grandement la lisibilité de la configuration
+ -- 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>
+
+ <li>Toujours regrouper les définitions <code>NameVirtualHost</code>
+ et <code>VirtualHost</code> 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é,
+ veillez à ce que le serveur virtuel contenant le préfixe le plus
+ long (donc le plus précis) apparaisse dans le fichier de
+ configuration avant le plus court. (<em>par exemple</em>,
+ "ServerPath /abc" est à spécifier après "ServerPath /abc/def").</li>
+ </ul>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/details.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/vhosts/details.html" title="Français"> fr </a> |
+<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr?rev=202339&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/vhosts/details.xml.fr Wed Jun 29 01:54:09 2005
@@ -0,0 +1,448 @@
+<?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: 151405:151408 (outdated) -->
+<!-- French translation by Vincent Deffontaines, review by alain B -->
+
+<!--
+ 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="details.xml.meta">
+<parentdocument href="./">Serveurs virtuels</parentdocument>
+ <title>Détails sur le fonctionnement des serveurs virtuels</title>
+
+<summary>
+
+ <p>Le code gérant les serveurs virtuels a été réécrit à partir de
+ zéro dans <strong>Apache 1.3</strong>. Ce document vise à expliquer
+ dans le détail comment Apache procède lors du choix de l'utilisation
+ d'un serveur virtuel en fonction d'une requête reçue. L'apparition
+ de la directive <directive module="core">NameVirtualHost</directive>
+ a rendu beaucoup plus facile et plus sûre la configuration des
+ serveurs virtuels par rapport aux versions précédant la 1.3.</p>
+
+ <p>Si vous voulez juste <cite>que ça marche</cite> sans en
+ comprendre le fonctionnement, voici <a href="examples.html">quelques
+ exemples</a>.</p>
+
+</summary>
+
+<section id="configparsing"><title>Interprétation des fichiers
+de configuration</title>
+
+ <p>Un <em>serveur principal (main_server)</em> contient toutes
+ les définitions qui apparaissent en dehors des sections
+ <code><VirtualHost></code>. Les serveurs virtuels, aussi
+ appelés <em>vhosts</em> (pour virtual hosts), sont définis par les
+ 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>
+ 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
+ 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>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
+ <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
+ d'adresses</em> du serveur virtuel.</p>
+
+ <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>
+
+ <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
+ une directive <code>NameVirtualHost</code> doit être utilisée pour
+ chaque couple IP:port donné.</p>
+
+ <p>L'ordre d'apparition des directives <code>NameVirtualHost</code>
+ et <code>VirtualHost</code> est sans importance, ce qui fait que
+ les deux exemples suivants ont des effets identiques (seul l'ordre
+ des directives <code>VirtualHost</code> pour <em>un</em> jeu
+ d'adresses est important, voir ci-dessous) :</p>
+
+<table><tr>
+<td><example>
+ NameVirtualHost 111.22.33.44<br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur A<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur B<br />
+ ...<br />
+ </VirtualHost><br />
+ <br />
+ NameVirtualHost 111.22.33.55<br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur C<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur D<br />
+ ...<br />
+ </VirtualHost>
+</example></td>
+<td><example>
+ <VirtualHost 111.22.33.44><br />
+ # serveur A<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur C<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.44><br />
+ # serveur B<br />
+ ...<br />
+ </VirtualHost><br />
+ <VirtualHost 111.22.33.55><br />
+ # serveur D<br />
+ ...<br />
+ </VirtualHost><br />
+ <br />
+ NameVirtualHost 111.22.33.44<br />
+ NameVirtualHost 111.22.33.55<br />
+ <br />
+</example></td>
+</tr></table>
+
+
+ <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>,
+ cette liste contient les noms des serveurs virtuels pour cette
+ adresse. Si aucun serveur virtuel n'est défini pour cette adresse,
+ la directive <code>NameVirtualHost</code> est ignorée et un message
+ est envoyé au journal d'erreurs. Quand un serveur virtuel par IP
+ est utilisé, la table de 'hash' reste vide.</p>
+
+ <p>La fonction de 'hash' étant rapide, le temps d'exécution d'un
+ 'hash' sur une adresse IP lors d'une requête est minimale et
+ quasiment imperceptible. De plus, la table est optimisée pour les
+ adresses IP dont le dernier octet est le seul à changer.</p>
+
+ <p>Pour chaque serveur virtuel, diverses valeurs sont initialisées
+ par défaut. En particulier :</p>
+
+ <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>,
+ 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
+ lecture de la configuration du serveur principal.)</li>
+
+ <li>Les permissions par défaut sur les répertoires de chaque
+ serveur virtuel sont assemblées avec celles du serveur principal.
+ Elles concernent également toutes les informations de configuration
+ par répertoire pour tous les modules.</li>
+
+ <li>Les configurations par serveur pour chaque module sont assemblées
+ à partir de celles du serveur principal.</li>
+ </ol>
+
+ <p>L'essentiel des valeurs de configuration des serveurs virtuels
+ provient de valeurs par défaut issues du serveur principal.
+ Mais la position dans le fichier de configuration des directives
+ du serveur principal n'a pas d'importance -- l'ensemble de la
+ configuration du serveur principal est lu avant que ces valeurs par
+ défaut soient appliquées aux serveur virtuels. Ainsi, même si la
+ définition d'une valeur apparaît après celle d'un serveur virtuel,
+ cette valeur peut affecter la definition du serveur virtuel.</p>
+
+ <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
+ renvoyées par une résolution DNS sur le <code>ServerName</code>
+ du serveur principal.</p>
+
+ <p>Pour tous les champs <code>ServerName</code> non définis, dans
+ le cas d'une configuration en serveur virtuel par nom, la valeur
+ adoptée par défaut est la première adresse donnée dans la section
+ <code>VirtualHost</code> qui définit le serveur virtuel.</p>
+
+ <p>Si un serveur virtuel contient la valeur magique
+ <code>_default_</code>, il fonctionne sur le même <code>ServerName</code>
+ que le serveur principal.</p>
+
+</section>
+
+<section id="hostmatching"><title>Choix du serveur virtuel</title>
+
+ <p>À la réception d'une requête, le serveur procède comme suit pour
+ déterminer quel serveur virtuel utiliser :</p>
+
+ <section id="hashtable"><title>Vérification dans la table de hash</title>
+
+ <p>Après que le client se soit connecté, l'adresse
+ IP à laquelle le client s'est connecté est recherchée dans la
+ table de hash IP interne.</p>
+
+ <p>Si la résolution de l'adresse IP n'aboutit pas (adresse IP non
+ trouvée), la requête est servie par le serveur virtuel
+ <code>_default_</code> s'il est défini pour le port correspondant
+ à la requête. Sinon, elle est servie par le 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>
+
+ <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
+ d'un serveur virtuel par nom ou par IP.</p>
+
+ </section>
+
+ <section id="ipbased"><title>Serveur virtuel par IP</title>
+
+ <p>Si l'entrée trouvée dispose d'une liste de noms vide, c'est
+ qu'il s'agit d'un serveur virtuel par IP, et aucun autre choix
+ n'est plus à faire ; la requête est servie par ce serveur virtuel.</p>
+
+ </section>
+
+ <section id="namebased"><title>Serveur virtuel par nom</title>
+
+ <p>Si l'entrée trouvée correspond à un serveur virtuel par nom,
+ la liste de noms contient au moins une structure de serveurs
+ virtuels. Les serveurs virtuels se présentent dans cette liste
+ dans le même ordre que la lecture des directives <code>VirtualHost</code>
+ 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
+ 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>
+
+ <p>Si un champ <code>Host:</code> est transmis dans l'en-tête de
+ la requête, son occurrence est recherchée dans la liste et le
+ premier serveur virtuel qui présente un <code>ServerName</code>
+ ou un <code>ServerAlias</code> correspondant est choisi pour
+ servir la requête. Il est possible que le champ <code>Host:</code>
+ contienne un numéro de port, mais Apache utilise toujours le
+ 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
+ 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
+ servie par le serveur virtuel correspondant.</p>
+
+ <p>Si aucun serveur virtuel n'est trouvé, la requête est servie
+ par le premier serveur virtuel qui écoute sur le port demandé et
+ qui est sur la liste associée à l'adresse IP vers laquelle la
+ requête a été envoyée (comme déjà précisé ci-avant).</p>
+
+ </section>
+
+ <section id="persistent"><title>Connexions persistantes</title>
+
+ <p>La recherche par adresse IP décrite ci-avant n'est faite
+ qu'<em>une fois</em> pour chaque session TCP/IP, alors que la
+ recherche par nom est réalisée pour <em>chaque</em> requête au
+ cours d'une connexion persistante (KeepAlive). En d'autres termes,
+ il est possible pour un client de faire des requêtes sur
+ différents serveurs virtuels par nom, au cours d'une unique
+ connexion persistante.</p>
+
+ </section>
+
+ <section id="absoluteURI"><title>URI absolu</title>
+
+ <p>Au cas où l'URI de la requête est absolu, et que son nom de
+ serveur et son port correspondent au serveur principal (ou l'un
+ des serveurs virtuels configurés), <em>et</em> qu'ils correspondent
+ à l'adresse et au port de la requête, alors l'URI est amputé
+ de son préfixe protocole/nom de serveur/port et traité par le
+ serveur correspondant (principal ou virtuel). Si cette correspondance
+ n'existe pas, l'URI reste inchangé et la requête est considérée
+ comme une requête d'un serveur mandataire (proxy).</p>
+</section>
+
+<section id="observations"><title>Observations</title>
+
+ <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
+ 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>
+
+ <li>Les vérifications sur <code>ServerAlias</code> et
+ <code>ServerPath</code> ne sont jamais réalisées pour les
+ serveurs virtuels par IP.</li>
+
+ <li>L'ordre dans lequel sont agencés dans le fichier de
+ configuration le serveur virtuel <code>_default_</code>, les
+ serveurs virtuels par nom et par IP, et la directive
+ <code>NameVirtualHost</code> est sans incidence sur le
+ fonctionnement. Seul l'ordre des serveurs virtuels par nom
+ pour une adresse donnée a une importance. Le serveur virtuel
+ par nom qui est présent en premier dans la configuration se
+ 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é
+ 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>
+
+ <li>Si une directive <code>ServerPath</code> existe, et se
+ trouve être préfixe d'une autre directive <code>ServerPath</code>
+ qui apparaît plus loin dans la configuration, la première
+ sera toujours utilisée et la deuxième jamais. (Ceci ne se
+ produit que dans le cas où aucun champ <code>Host:</code>
+ n'a été présenté par le client pour distinguer les deux.)</li>
+
+ <li>Dans le cas où deux serveurs virtuels par IP ont une
+ adresse en commun, le serveur virtuel qui apparaît en premier
+ dans la configuration est toujours choisi. Ce genre de chose
+ peut arriver par inadvertance. Le serveur envoie une alerte
+ dans le journal d'erreurs si ce cas se présente.</li>
+
+ <li>Le serveur virtuel <code>_default_</code> ne sert la requête
+ que si aucun autre serveur virtuel travaillant sur l'adresse
+ IP <em>et</em> le port demandés n'est trouvé. La requête n'est
+ traitée que si le numéro de port qui a reçu la requête est
+ associé au serveur virtuel <code>_default_</code> (qui par
+ défaut, correspond à <code>Listen</code>). Un port joker peut
+ ê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>
+
+ <li>Le serveur principal ne sert à servir 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
+ principal n'est utile que pour les combinaisons adresse/port
+ non spécifiées (sauf quand un serveur virtuel <code>_default_</code>
+ correspond au port).</li>
+
+ <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
+ lorsque l'adresse (et le port) de connexion correspondent à
+ des serveurs virtuels par nom, par exemple, dans une directive
+ <code>NameVirtualHost</code>.</li>
+
+ <li>Il ne faut jamais employer de noms DNS dans des directives
+ <code>VirtualHost</code>, car cela oblige le serveur a s'appuyer
+ sur le DNS au moment du démarrage. De plus, vous vous exposez
+ à des problèmes de sécurité si vous n'avez pas la maîtrise du
+ DNS pour la totalité de vos domaines. Voir la documentation
+ <a href="../dns-caveats.html">disponible ici</a>, ainsi que
+ les deux points précisés ci-après.</li>
+
+ <li>Un nom de serveur <code>ServerName</code> devrait toujours
+ être indiqué pour chaque serveur virtuel. Sans cela, une
+ résolution DNS est nécessaire pour chaque serveur virtuel.</li>
+ </ul>
+ </section>
+
+</section>
+
+<section id="tips"><title>Trucs et astuces</title>
+
+ <p>En plus des points évoqués sur la page des
+ <a href="../dns-caveats.html#tips">problèmes liés au DNS</a>,
+ voici quelques points intéressants :</p>
+
+ <ul>
+ <li>Toujours positionner les définitions relatives au serveur
+ principal avant toute définition <code>VirtualHost</code>.
+ (Ceci améliore grandement la lisibilité de la configuration
+ -- 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>
+
+ <li>Toujours regrouper les définitions <code>NameVirtualHost</code>
+ et <code>VirtualHost</code> 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é,
+ veillez à ce que le serveur virtuel contenant le préfixe le plus
+ long (donc le plus précis) apparaisse dans le fichier de
+ configuration avant le plus court. (<em>par exemple</em>,
+ "ServerPath /abc" est à spécifier après "ServerPath /abc/def").</li>
+ </ul>
+
+</section>
+</manualpage>
+
Added: httpd/httpd/trunk/docs/manual/vhosts/examples.html.fr
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/vhosts/examples.html.fr?rev=202339&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/vhosts/examples.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/vhosts/examples.html.fr Wed Jun 29 01:54:09 2005
@@ -0,0 +1,681 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Exemples d'utilisations de VirtualHost - Serveur Apache HTTP</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs-project/">Documentation</a> > <a href="../">Version 2.1</a> > <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Exemples d'utilisations de VirtualHost</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/vhosts/examples.html" title="Français"> fr </a> |
+<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div>
+<div class="outofdate">Cette traduction peut être périmée. Verifiez la version
+ Anglaise pour les changements récents.</div>
+
+
+ <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>
+
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#purename">Fonctionnement de plusieurs serveurs
+ virtuels par nom sur une seule adresse IP.</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#twoips">Serveurs virtuels par nom sur plus
+ d'une seule adresse IP.</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#intraextra">Servir le même contenu sur des
+ adresses IP différentes (telle qu'une adresse interne et une
+ externe).</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#port">Servir différents sites sur différents
+ ports.</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ip">Hébergement virtuel basé sur IP</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ipport">Hébergements virtuels mixtes basés sur
+ les ports et sur les IP</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#mixed">Hébergements virtuels mixtes basé sur
+ les noms et sur IP</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#proxy">Utilisation simultanée de
+ <code>Virtual_host</code> et de mod_proxy</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#default">Utilisation de serveurs virtuels
+ <code>_default_</code></a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#migrate">Migration d'un serveur virtuel
+ par nom en un serveur virtuel par IP</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#serverpath">Utilisation de la directive
+ <code>ServerPath</code></a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="purename" id="purename">Fonctionnement de plusieurs serveurs
+ virtuels par nom sur une seule adresse IP.</a></h2>
+
+ <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>
+
+ <div class="note"><h3>Note :</h3><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>
+ </div>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ # 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 />
+ <span class="indent">
+ DocumentRoot /www/example1<br />
+ ServerName www.example1.com<br />
+ <br />
+ # Autres directives ici<br />
+ <br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost *:80><br />
+ <span class="indent">
+ DocumentRoot /www/example2<br />
+ ServerName www.example2.org<br />
+ <br />
+ # Autres directives ici<br />
+ <br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+ <div class="note">
+ <h3>Note :</h3>
+
+ <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>
+
+ <div class="example"><p><code>
+ NameVirtualHost 172.20.30.40<br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ # etc ...
+ </code></p></div>
+
+ <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>
+ </div>
+
+ <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>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="twoips" id="twoips">Serveurs virtuels par nom sur plus
+ d'une seule adresse IP.</a></h2>
+
+ <div class="note">
+ <h3>Note :</h3><p>Toutes les techniques présentées ici
+ peuvent être étendues à un plus grand nombre d'adresses IP.</p>
+ </div>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ 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 />
+ <span class="indent">
+ DocumentRoot /www/example1<br />
+ ServerName www.example1.com<br />
+ <br />
+ # D'autres directives ici ...<br />
+ <br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.50><br />
+ <span class="indent">
+ DocumentRoot /www/example2<br />
+ ServerName www.example2.org<br />
+ <br />
+ # D'autres directives ici ...<br />
+ <br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="intraextra" id="intraextra">Servir le même contenu sur des
+ adresses IP différentes (telle qu'une adresse interne et une
+ externe).</a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ NameVirtualHost 192.168.1.1<br />
+ NameVirtualHost 172.20.30.40<br />
+ <br />
+ <VirtualHost 192.168.1.1 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/server1<br />
+ ServerName server.example.com<br />
+ ServerAlias server<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <p>Ainsi, les requêtes en provenance de chacun des deux réseaux
+ seront servies par le même <code>VirtualHost</code>.</p>
+
+ <div class="note">
+ <h3>Note :</h3><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>
+ </div>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="port" id="port">Servir différents sites sur différents
+ ports.</a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ 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 />
+ <span class="indent">
+ ServerName www.example1.com<br />
+ DocumentRoot /www/domain-80<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40:8080><br />
+ <span class="indent">
+ ServerName www.example1.com<br />
+ DocumentRoot /www/domain-8080<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40:80><br />
+ <span class="indent">
+ ServerName www.example2.org<br />
+ DocumentRoot /www/otherdomain-80<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40:8080><br />
+ <span class="indent">
+ ServerName www.example2.org<br />
+ DocumentRoot /www/otherdomain-8080<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="ip" id="ip">Hébergement virtuel basé sur IP</a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ Listen 80<br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/example1<br />
+ ServerName www.example1.com<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.50><br />
+ <span class="indent">
+ DocumentRoot /www/example2<br />
+ ServerName www.example2.org<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="ipport" id="ipport">Hébergements virtuels mixtes basés sur
+ les ports et sur les IP</a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ 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 />
+ <span class="indent">
+ DocumentRoot /www/example1-80<br />
+ ServerName www.example1.com<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40:8080><br />
+ <span class="indent">
+ DocumentRoot /www/example1-8080<br />
+ ServerName www.example1.com<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.50:80><br />
+ <span class="indent">
+ DocumentRoot /www/example2-80<br />
+ ServerName www.example1.org<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.50:8080><br />
+ <span class="indent">
+ DocumentRoot /www/example2-8080<br />
+ ServerName www.example2.org<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="mixed" id="mixed">Hébergements virtuels mixtes basé sur
+ les noms et sur IP</a></h2>
+
+ <p>Pour certaines adresses, des serveurs virtuels seront définis
+ par nom, et pour d'autres, ils seront définis par IP.</p>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ Listen 80<br />
+ <br />
+ NameVirtualHost 172.20.30.40<br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/example1<br />
+ ServerName www.example1.com<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/example2<br />
+ ServerName www.example2.org<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/example3<br />
+ ServerName www.example3.net<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ # "par-IP"<br />
+ <VirtualHost 172.20.30.50><br />
+ <span class="indent">
+ DocumentRoot /www/example4<br />
+ ServerName www.example4.edu<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.60><br />
+ <span class="indent">
+ DocumentRoot /www/example5<br />
+ ServerName www.example5.gov<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="proxy" id="proxy">Utilisation simultanée de
+ <code>Virtual_host</code> et de mod_proxy</a></h2>
+
+ <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
+ <code class="directive"><a href="../mod/mod_proxy.html#proxypreservehost on">ProxyPreserveHost On</a></code> 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>
+
+ <div class="example"><p><code>
+ <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>
+ </code></p></div>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="default" id="default">Utilisation de serveurs virtuels
+ <code>_default_</code></a></h2>
+
+ <h3><a name="defaultallports" id="defaultallports">Serveurs virtuels
+ <code>_default_</code> pour tous les ports</a></h3>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ <VirtualHost _default_:*><br />
+ <span class="indent">
+ DocumentRoot /www/default<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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
+ <code class="directive"><a href="../mod/mod_alias.html#aliasmatch">AliasMatch</a></code> ou
+ <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> afin de
+ réécrire une requête pour une unique page d'information (ou pour
+ un script).</p>
+
+
+ <h3><a name="defaultdifferentports" id="defaultdifferentports">Serveurs virtuels
+ <code>_default_</code> pour des ports différents</a></h3>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ <VirtualHost _default_:80><br />
+ <span class="indent">
+ DocumentRoot /www/default80<br />
+ # ...<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost _default_:*><br />
+ <span class="indent">
+ DocumentRoot /www/default<br />
+ # ...<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+
+ <h3><a name="defaultoneport" id="defaultoneport">Serveurs virtuels
+ <code>_default_</code> pour un seul port</a></h3>
+
+ <p>Nous voulons créer un serveur virtuel par défaut seulement
+ pour le port 80.</p>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ <VirtualHost _default_:80><br />
+ DocumentRoot /www/default<br />
+ ...<br />
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="migrate" id="migrate">Migration d'un serveur virtuel
+ par nom en un serveur virtuel par IP</a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ 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 />
+ <span class="indent">
+ DocumentRoot /www/example2<br />
+ ServerName www.example2.org<br />
+ # ...<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ DocumentRoot /www/example3<br />
+ ServerName www.example3.net<br />
+ ServerAlias *.example3.net<br />
+ # ...<br />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <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>
+
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="serverpath" id="serverpath">Utilisation de la directive
+ <code>ServerPath</code></a></h2>
+
+ <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>
+
+ <div class="example"><h3>Configuration du serveur</h3><p><code>
+
+
+ NameVirtualHost 172.20.30.40<br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="indent">
+ # Serveur virtuel primaire<br />
+ DocumentRoot /www/subdomain<br />
+ RewriteEngine On<br />
+ RewriteRule ^/.* /www/subdomain/index.html<br />
+ # ...<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ DocumentRoot /www/subdomain/sub1<br />
+ <span class="indent">
+ ServerName www.sub1.domain.tld<br />
+ ServerPath /sub1/<br />
+ RewriteEngine On<br />
+ RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
+ # ...<br />
+ </span>
+ </VirtualHost><br />
+ <br />
+ <VirtualHost 172.20.30.40><br />
+ <span class="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 />
+ </span>
+ </VirtualHost>
+ </code></p></div>
+
+ <p>À cause de la directive
+ <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>, 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 <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
+ 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>
+
+ </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/examples.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/vhosts/examples.html" title="Français"> fr </a> |
+<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 1995-2005 The Apache Software Foundation or its licensors, as applicable.<br />Authorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file