]> granicus.if.org Git - apache/commitdiff
Submitted and reviewed by Vincent Deffontaines, alain B and Jean-François El Fouly.
authorJean-Frederic Clere <jfclere@apache.org>
Wed, 29 Jun 2005 08:54:09 +0000 (08:54 +0000)
committerJean-Frederic Clere <jfclere@apache.org>
Wed, 29 Jun 2005 08:54:09 +0000 (08:54 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@202339 13f79535-47bb-0310-9956-ffa450edef68

12 files changed:
docs/manual/vhosts/details.html.fr [new file with mode: 0644]
docs/manual/vhosts/details.xml.fr [new file with mode: 0644]
docs/manual/vhosts/examples.html.fr [new file with mode: 0644]
docs/manual/vhosts/examples.xml.fr [new file with mode: 0644]
docs/manual/vhosts/fd-limits.html.fr [new file with mode: 0644]
docs/manual/vhosts/fd-limits.xml.fr [new file with mode: 0644]
docs/manual/vhosts/index.html.fr [new file with mode: 0644]
docs/manual/vhosts/index.xml.fr [new file with mode: 0644]
docs/manual/vhosts/ip-based.html.fr [new file with mode: 0644]
docs/manual/vhosts/ip-based.xml.fr [new file with mode: 0644]
docs/manual/vhosts/name-based.html.fr [new file with mode: 0644]
docs/manual/vhosts/name-based.xml.fr [new file with mode: 0644]

diff --git a/docs/manual/vhosts/details.html.fr b/docs/manual/vhosts/details.html.fr
new file mode 100644 (file)
index 0000000..c794ac3
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/details.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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>&lt;VirtualHost&gt;</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">&lt;VirtualHost&gt;</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)&nbsp;:</p>
+
+<table><tr>
+<td><div class="example"><p><code>
+  NameVirtualHost 111.22.33.44<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur A<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur B<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  <br />
+  NameVirtualHost 111.22.33.55<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur C<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur D<br />
+  ...<br />
+  &lt;/VirtualHost&gt;
+</code></p></div></td>
+<td><div class="example"><p><code>
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur A<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur C<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur B<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur D<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<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&nbsp;:</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&nbsp;:</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&nbsp;; 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&nbsp;; 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&nbsp;:</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">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/details.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ko/vhosts/details.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/details.xml.fr b/docs/manual/vhosts/details.xml.fr
new file mode 100644 (file)
index 0000000..21b1990
--- /dev/null
@@ -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>&lt;VirtualHost&gt;</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)&nbsp;:</p>
+
+<table><tr>
+<td><example>
+  NameVirtualHost 111.22.33.44<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur A<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur B<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  <br />
+  NameVirtualHost 111.22.33.55<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur C<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur D<br />
+  ...<br />
+  &lt;/VirtualHost&gt;
+</example></td>
+<td><example>
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur A<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur C<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.44&gt;<br />
+  # serveur B<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<br />
+  &lt;VirtualHost 111.22.33.55&gt;<br />
+  # serveur D<br />
+  ...<br />
+  &lt;/VirtualHost&gt;<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&nbsp;:</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&nbsp;:</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&nbsp;; 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&nbsp;; 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&nbsp;:</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>
+
diff --git a/docs/manual/vhosts/examples.html.fr b/docs/manual/vhosts/examples.html.fr
new file mode 100644 (file)
index 0000000..daf518a
--- /dev/null
@@ -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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/examples.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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&nbsp;:</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 />
+    &lt;VirtualHost *:80&gt;<br />
+    <span class="indent">
+      DocumentRoot /www/example1<br />
+      ServerName www.example1.com<br />
+      <br />
+      # Autres directives ici<br />
+      <br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+    <br />
+    &lt;VirtualHost *:80&gt;<br />
+    <span class="indent">
+      DocumentRoot /www/example2<br />
+      ServerName www.example2.org<br />
+      <br />
+      # Autres directives ici<br />
+      <br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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>&nbsp;; 
+    ce qui signifie que toute requête reçue ne correspondant pas à une 
+    des directives <code>ServerName</code> sera servie par ce premier 
+    <code>VirtualHost</code>.</p>
+
+    <div class="note">
+            <h3>Note&nbsp;:</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>&nbsp;:</p>
+
+            <div class="example"><p><code>
+            NameVirtualHost 172.20.30.40<br />
+                                               <br />
+            &lt;VirtualHost 172.20.30.40&gt;<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&nbsp;:</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 />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+               <br />
+        # D'autres directives ici ...<br />
+                   <br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+        <br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+                <br />
+        # D'autres directives ici ...<br />
+                <br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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 />
+    &lt;VirtualHost 192.168.1.1 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/server1<br />
+        ServerName server.example.com<br />
+        ServerAlias server<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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&nbsp;:</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 &lt;VirtualHost 
+    name:port&gt; 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 />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <span class="indent">
+        ServerName www.example1.com<br />
+        DocumentRoot /www/domain-80<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <span class="indent">
+        ServerName www.example1.com<br />
+        DocumentRoot /www/domain-8080<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <span class="indent">
+        ServerName www.example2.org<br />
+        DocumentRoot /www/otherdomain-80<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <span class="indent">
+        ServerName www.example2.org<br />
+        DocumentRoot /www/otherdomain-8080<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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 />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </code></p></div>
+
+    <p>Les requêtes provenant d'adresses non spécifiées dans l'une des 
+    directives <code>&lt;VirtualHost&gt;</code> (comme pour 
+    <code>localhost</code> par exemple) seront dirigées vers le serveur 
+    principal, s'il en existe un.</p>
+
+       </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 />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example1-80<br />
+        ServerName www.example1.com<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example1-8080<br />
+        ServerName www.example1.com<br />
+               </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50:80&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2-80<br />
+        ServerName www.example1.org<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50:8080&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2-8080<br />
+        ServerName www.example2.org<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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 />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example3<br />
+        ServerName www.example3.net<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    # "par-IP"<br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example4<br />
+        ServerName www.example4.edu<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.60&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example5<br />
+        ServerName www.example5.gov<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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>
+    &lt;VirtualHost *:*&gt;<br />
+        ProxyPreserveHost On<br />
+        ProxyPass / http://192.168.111.2<br />
+        ProxyPassReverse / http://192.168.111.2/<br />
+        ServerName hostname.example.com<br />
+    &lt;/VirtualHost&gt;
+    </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>
+    
+
+    &lt;VirtualHost _default_:*&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/default<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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>
+    
+
+    &lt;VirtualHost _default_:80&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/default80<br />
+        # ...<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost _default_:*&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/default<br />
+        # ...<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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>
+    
+
+    &lt;VirtualHost _default_:80&gt;<br />
+    DocumentRoot /www/default<br />
+    ...<br />
+    &lt;/VirtualHost&gt;
+    </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 />
+    &lt;VirtualHost 172.20.30.40 172.20.30.50&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+        # ...<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        DocumentRoot /www/example3<br />
+        ServerName www.example3.net<br />
+        ServerAlias *.example3.net<br />
+        # ...<br />
+    </span>
+    &lt;/VirtualHost&gt;
+    </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 />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <span class="indent">
+        # Serveur virtuel primaire<br />
+        DocumentRoot /www/subdomain<br />
+        RewriteEngine On<br />
+        RewriteRule ^/.* /www/subdomain/index.html<br />
+        # ...<br />
+    </span>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<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>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<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>
+    &lt;/VirtualHost&gt;
+    </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é&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 <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">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/examples.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/examples.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/examples.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/examples.xml.fr b/docs/manual/vhosts/examples.xml.fr
new file mode 100644 (file)
index 0000000..09d4600
--- /dev/null
@@ -0,0 +1,650 @@
+<?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, Alain B., review by  -->
+
+<!--
+ Copyright 2005 The Apache Software Foundation or its licensors, as
+ applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="examples.xml.meta">
+<parentdocument href="./">Serveurs virtuels</parentdocument>
+    <title>Exemples d'utilisations de VirtualHost</title>
+
+<summary>
+
+    <p>Le but de ce document est d'essayer de répondre aux questions 
+    les plus répandues sur la configuration des serveurs virtuels. 
+    Les scénarios présentés ici se rencontrent quand plusieurs 
+    serveurs Webs doivent tourner sur une seule et même machine au 
+    moyen de serveurs virtuels <a href="name-based.html">par nom</a> 
+    ou <a href="ip-based.html">par IP</a>.</p>
+
+</summary>
+
+  <section id="purename"><title>Fonctionnement de plusieurs serveurs 
+  virtuels par nom sur une seule adresse IP.</title>
+
+    <p>Votre serveur ne dispose que d'une seule adresse IP, et de 
+    nombreux alias (CNAMES) pointent vers cette adresse dans le DNS. 
+    Pour l'exemple, <code>www.example1.com</code> et 
+    <code>www.example2.org</code> doivent tourner sur cette machine.</p>
+
+    <note><title>Note&nbsp;:</title><p>La configuration de serveurs virtuels 
+    sous Apache ne provoque pas leur apparition magique dans la 
+    configuration du DNS. Il <em>faut</em> que leurs noms soient 
+    définis dans le DNS, et qu'ils y soient résolus sur l'adresse IP 
+    du serveur, faute de quoi personne ne pourra visiter votre site Web. 
+    Il est possible d'ajouter des entrées dans le fichier 
+    <code>hosts</code> pour tests locaux, mais qui ne fonctionneront 
+    que sur la machine possédant ces entrées.</p>
+    </note>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    # Apache doit écouter sur le port 80<br />
+    Listen 80<br />
+    <br />
+    # Toutes les adresses IP doivent répondre aux requêtes sur les 
+    # serveurs virtuels
+    NameVirtualHost *:80<br />
+    <br />
+    &lt;VirtualHost *:80&gt;<br />
+    <indent>
+      DocumentRoot /www/example1<br />
+      ServerName www.example1.com<br />
+      <br />
+      # Autres directives ici<br />
+      <br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+    <br />
+    &lt;VirtualHost *:80&gt;<br />
+    <indent>
+      DocumentRoot /www/example2<br />
+      ServerName www.example2.org<br />
+      <br />
+      # Autres directives ici<br />
+      <br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Les astérisques correspondent à toutes les adresses, si bien que 
+    le serveur principal ne répondra jamais à aucune requête. Comme 
+    <code>www.example1.com</code> se trouve en premier dans le fichier 
+    de configuration, il a la plus grande priorité et peut être vu 
+    comme serveur <cite>par défaut</cite> ou <cite>primaire</cite>&nbsp;; 
+    ce qui signifie que toute requête reçue ne correspondant pas à une 
+    des directives <code>ServerName</code> sera servie par ce premier 
+    <code>VirtualHost</code>.</p>
+
+    <note>
+            <title>Note&nbsp;:</title>
+
+            <p>Si vous le souhaitez, vous pouvez remplacer <code>*</code> 
+            par l'adresse IP du système. Dans ce cas, l'argument de 
+            <code>VirtualHost</code> <em>doit</em> correspondre à 
+            l'argument de <code>NameVirtualHost</code>&nbsp;:</p>
+
+            <example>
+            NameVirtualHost 172.20.30.40<br />
+                                               <br />
+            &lt;VirtualHost 172.20.30.40&gt;<br />
+                       # etc ...
+            </example>
+
+           <p>En général, il est commode d'utiliser <code>*</code> sur 
+           les systèmes dont l'adresse IP n'est pas constante - par 
+           exemple, pour des serveurs dont l'adresse IP est attribuée 
+           dynamiquement par le FAI, et où le DNS est géré au moyen 
+           d'un DNS dynamique quelconque. Comme <code>*</code> signifie 
+           <cite>n'importe quelle adresse</cite>, cette configuration 
+           fonctionne sans devoir être modifiée quand l'adresse IP du 
+           système est modifiée.</p>
+    </note>
+
+    <p>La configuration ci-dessus est en pratique utilisée dans la 
+    plupart des cas pour les serveurs virtuels par nom. En fait, le 
+    seul cas où cette configuration ne fonctionne pas est lorsque 
+    différents contenus doivent être servis en fonction de l'adresse IP 
+    et du port contactés par le client.</p>
+
+    </section>
+
+    <section id="twoips"><title>Serveurs virtuels par nom sur plus 
+    d'une seule adresse IP.</title>
+
+       <note>
+          <title>Note&nbsp;:</title><p>Toutes les techniques présentées ici 
+          peuvent être étendues à un plus grand nombre d'adresses IP.</p>
+    </note>
+
+    <p>Le serveur a deux adresses IP. Sur l'une 
+    (<code>172.20.30.40</code>), le serveur "principal" 
+    <code>server.domain.com</code> doit répondre, et sur l'autre 
+    (<code>172.20.30.50</code>), deux serveurs virtuels (ou plus) 
+    répondront.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 80<br />
+        <br />
+    # Serveur "principal" sur 172.20.30.40<br />
+    ServerName server.domain.com<br />
+    DocumentRoot /www/mainserver<br />
+        <br />
+    # l'autre adresse <br />
+    NameVirtualHost 172.20.30.50<br />
+        <br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <indent>
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+               <br />
+        # D'autres directives ici ...<br />
+                   <br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+        <br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <indent>
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+                <br />
+        # D'autres directives ici ...<br />
+                <br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Toute requête arrivant sur une autre adresse que 
+    <code>172.20.30.50</code> sera servie par le serveur principal. 
+    Les requêtes vers <code>172.20.30.50</code> avec un nom de serveur 
+    inconnu, ou sans en-tête <code>Host:</code>, seront servies par 
+    <code>www.example1.com</code>.</p>
+
+    </section>
+
+    <section id="intraextra"><title>Servir le même contenu sur des 
+    adresses IP différentes (telle qu'une adresse interne et une 
+    externe).</title>
+
+    <p>La machine serveur dispose de deux adresses IP 
+    (<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette 
+    machine est placée à la fois sur le réseau interne (l'Intranet) 
+    et le réseau externe (Internet). Sur Internet, le nom 
+    <code>server.example.com</code> pointe vers l'adresse externe 
+    (<code>172.20.30.40</code>), mais sur le réseau interne, ce même 
+    nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
+
+    <p>Le serveur peut être configuré pour répondre de la même manière 
+    aux requêtes internes et externes, au moyen d'une seule section 
+    <code>VirtualHost</code>.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    NameVirtualHost 192.168.1.1<br />
+    NameVirtualHost 172.20.30.40<br />
+        <br />
+    &lt;VirtualHost 192.168.1.1 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/server1<br />
+        ServerName server.example.com<br />
+        ServerAlias server<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Ainsi, les requêtes en provenance de chacun des deux réseaux 
+    seront servies par le même <code>VirtualHost</code>.</p>
+
+    <note>
+          <title>Note&nbsp;:</title><p>Sur le réseau interne, il est possible 
+          d'utiliser le nom raccourci <code>server</code> au lieu du nom 
+          complet <code>server.example.com</code>.</p>
+
+          <p>Notez également que dans l'exemple précédent, vous pouvez 
+          remplacer la liste des adresses IP par des <code>*</code> afin 
+          que le serveur réponde de la même manière sur toutes ses 
+          adresses.</p>
+    </note>
+
+    </section>
+
+    <section id="port"><title>Servir différents sites sur différents 
+    ports.</title>
+
+    <p>Vous disposez de plusieurs domaines pointant sur la même adresse 
+    IP et vous voulez également servir de multiples ports. Vous y 
+    parviendrez en définissant les ports dans la directive 
+    "NameVirtualHost". Si vous tentez d'utiliser &lt;VirtualHost 
+    name:port&gt; sans directive NameVirtualHost name:port, ou tentez 
+    d'utiliser la directive Listen, votre configuration ne fonctionnera 
+    pas.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 80<br />
+    Listen 8080<br />
+               <br />
+    NameVirtualHost 172.20.30.40:80<br />
+    NameVirtualHost 172.20.30.40:8080<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <indent>
+        ServerName www.example1.com<br />
+        DocumentRoot /www/domain-80<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <indent>
+        ServerName www.example1.com<br />
+        DocumentRoot /www/domain-8080<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <indent>
+        ServerName www.example2.org<br />
+        DocumentRoot /www/otherdomain-80<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <indent>
+        ServerName www.example2.org<br />
+        DocumentRoot /www/otherdomain-8080<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+       </section>
+
+    <section id="ip"><title>Hébergement virtuel basé sur IP</title>
+
+    <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code> 
+    et <code>172.20.30.50</code>) correspondant respectivement aux noms 
+    <code>www.example1.com</code> et <code>www.example2.org</code>.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 80<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <indent>
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Les requêtes provenant d'adresses non spécifiées dans l'une des 
+    directives <code>&lt;VirtualHost&gt;</code> (comme pour 
+    <code>localhost</code> par exemple) seront dirigées vers le serveur 
+    principal, s'il en existe un.</p>
+
+       </section>
+
+    <section id="ipport"><title>Hébergements virtuels mixtes basés sur 
+    les ports et sur les IP</title>
+
+    <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code> 
+    et <code>172.20.30.50</code>) correspondant respectivement aux noms 
+    <code>www.example1.com</code> et <code>www.example2.org</code>. 
+    Pour chacun d'eux, nous voulons un hébergement sur les ports 80 
+    et 8080.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 172.20.30.40:80<br />
+    Listen 172.20.30.40:8080<br />
+    Listen 172.20.30.50:80<br />
+    Listen 172.20.30.50:8080<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:80&gt;<br />
+    <indent>
+        DocumentRoot /www/example1-80<br />
+        ServerName www.example1.com<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40:8080&gt;<br />
+    <indent>
+        DocumentRoot /www/example1-8080<br />
+        ServerName www.example1.com<br />
+               </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50:80&gt;<br />
+    <indent>
+        DocumentRoot /www/example2-80<br />
+        ServerName www.example1.org<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.50:8080&gt;<br />
+    <indent>
+        DocumentRoot /www/example2-8080<br />
+        ServerName www.example2.org<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+       </section>
+
+    <section id="mixed"><title>Hébergements virtuels mixtes basé sur 
+    les noms et sur IP</title>
+
+    <p>Pour certaines adresses, des serveurs virtuels seront définis 
+    par nom, et pour d'autres, ils seront définis par IP.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 80<br />
+               <br />
+    NameVirtualHost 172.20.30.40<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/example1<br />
+        ServerName www.example1.com<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/example3<br />
+        ServerName www.example3.net<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    # "par-IP"<br />
+    &lt;VirtualHost 172.20.30.50&gt;<br />
+    <indent>
+        DocumentRoot /www/example4<br />
+        ServerName www.example4.edu<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.60&gt;<br />
+    <indent>
+        DocumentRoot /www/example5<br />
+        ServerName www.example5.gov<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+       </section>
+
+    <section id="proxy"><title>Utilisation simultanée de 
+    <code>Virtual_host</code> et de mod_proxy</title>
+
+    <p>L'exemple suivant montre comment une machine peut mandater 
+    un serveur virtuel fonctionnant sur le serveur d'une autre machine. 
+    Dans cet exemple, un serveur virtuel de même nom est configuré sur 
+    une machine à l'adresse <code>192.168.111.2</code>. La directive 
+    <directive module="mod_proxy">ProxyPreserveHost On</directive> est 
+    employée pour permette au nom de domaine d'être préservé lors du 
+    transfert, au cas où plusieurs noms de domaines cohabitent sur 
+    une même machine.</p>
+
+    <example>
+    &lt;VirtualHost *:*&gt;<br />
+        ProxyPreserveHost On<br />
+        ProxyPass / http://192.168.111.2<br />
+        ProxyPassReverse / http://192.168.111.2/<br />
+        ServerName hostname.example.com<br />
+    &lt;/VirtualHost&gt;
+    </example>
+
+    </section>
+
+    <section id="default"><title>Utilisation de serveurs virtuels 
+    <code>_default_</code></title>
+
+    <section id="defaultallports"><title>Serveurs virtuels 
+    <code>_default_</code> pour tous les ports</title>
+
+    <p>Exemple de capture de <em>toutes</em> les requêtes émanant 
+    d'adresses IP ou de ports non connus, <em>c'est-à-dire</em>, d'un 
+    couple adresse/port non traité par aucun autre serveur virtuel.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    &lt;VirtualHost _default_:*&gt;<br />
+    <indent>
+        DocumentRoot /www/default<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>L'utilisation d'un tel serveur virtuel avec un joker pour le 
+    port empêche de manière efficace qu'une requête n'atteigne le 
+    serveur principal.</p>
+
+    <p>Un serveur virtuel par défaut ne servira jamais une requête 
+    qui est envoyée vers un couple adresse/port utilisée par un 
+    serveur virtuel par nom. Si la requête contient un en-tête 
+    <code>Host:</code> inconnu, ou si celui-ci est absent, elle 
+    sera toujours servie par le serveur virtuel primaire par nom 
+    (celui correspondant à ce couple adresse/port trouvé en premier 
+    dans le fichier de configuration).</p>
+
+    <p>Vous pouvez utiliser une directive 
+    <directive module="mod_alias">AliasMatch</directive> ou 
+    <directive module="mod_rewrite">RewriteRule</directive> afin de 
+    réécrire une requête pour une unique page d'information (ou pour 
+    un script).</p>
+    </section>
+
+    <section id="defaultdifferentports"><title>Serveurs virtuels 
+    <code>_default_</code> pour des ports différents</title>
+
+    <p>La configuration est similaire à l'exemple précédent, mais 
+    le serveur écoute sur plusieurs ports et un second serveur virtuel 
+    <code>_default_</code> pour le port 80 est ajouté.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    &lt;VirtualHost _default_:80&gt;<br />
+    <indent>
+        DocumentRoot /www/default80<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost _default_:*&gt;<br />
+    <indent>
+        DocumentRoot /www/default<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Le serveur virtuel par défaut défini pour le port 80 (il doit 
+    impérativement être placé avant un autre serveur virtuel par 
+    défaut traitant tous les ports grâce au joker *) capture toutes 
+    les requêtes envoyées sur une adresse IP non spécifiée. Le 
+    serveur principal n'est jamais utilisé pour servir une requête.</p>
+    </section>
+
+    <section id="defaultoneport"><title>Serveurs virtuels 
+    <code>_default_</code> pour un seul port</title>
+
+    <p>Nous voulons créer un serveur virtuel par défaut seulement 
+    pour le port 80.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    &lt;VirtualHost _default_:80&gt;<br />
+    DocumentRoot /www/default<br />
+    ...<br />
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Une requête vers une adresse non spécifiée sur le port 80 
+    sera servie par le serveur virtuel par défaut, et toute autre 
+    requête vers une adresse et un port non spécifiés sera servie 
+    par le serveur principal.</p>
+    </section>
+
+       </section>
+
+       <section id="migrate"><title>Migration d'un serveur virtuel 
+       par nom en un serveur virtuel par IP</title>
+
+    <p>Le serveur virtuel par nom avec le nom de domaine 
+    <code>www.example2.org</code> (de notre <a href="#name">exemple 
+    par nom</a>) devrait obtenir sa propre adresse IP. Pendant la 
+    phase de migration, il est possible d'éviter les problèmes avec 
+    les noms de serveurs et autres serveurs mandataires qui mémorisent 
+    les vielles adresses IP pour les serveurs virtuels par nom.<br />
+    La solution est simple, car il suffit d'ajouter la nouvelle 
+    adresse IP (<code>172.20.30.50</code>) dans la directive 
+    <code>VirtualHost</code>.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    Listen 80<br />
+    ServerName www.example1.com<br />
+    DocumentRoot /www/example1<br />
+               <br />
+    NameVirtualHost 172.20.30.40<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40 172.20.30.50&gt;<br />
+    <indent>
+        DocumentRoot /www/example2<br />
+        ServerName www.example2.org<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/example3<br />
+        ServerName www.example3.net<br />
+        ServerAlias *.example3.net<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>Le serveur virtuel peut maintenant être joint par la nouvelle 
+    adresse (comme un serveur virtuel par IP) et par l'ancienne 
+    adresse (comme un serveur virtuel par nom).</p>
+
+       </section>
+
+    <section id="serverpath"><title>Utilisation de la directive 
+    <code>ServerPath</code></title>
+
+    <p>Dans le cas où vous disposez de deux serveurs virtuels par nom, 
+    le client doit transmettre un en-tête <code>Host:</code> correct 
+    pour déterminer le serveur concerné. Les vieux clients HTTP/1.0 
+    n'envoient pas un tel en-tête et Apache n'a aucun indice pour 
+    connaître le serveur virtuel devant être joint (il sert la 
+    requête à partir d'un serveur virtuel primaire). Dans un soucis 
+    de préserver la compatibilité descendante, il suffit de créer 
+    un serveur virtuel primaire chargé de retourner une page contenant 
+    des liens dont les URLs auront un préfixe identifiant les serveurs 
+    virtuels par nom.</p>
+
+    <example>
+    <title>Configuration du serveur</title>
+
+    NameVirtualHost 172.20.30.40<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        # Serveur virtuel primaire<br />
+        DocumentRoot /www/subdomain<br />
+        RewriteEngine On<br />
+        RewriteRule ^/.* /www/subdomain/index.html<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    DocumentRoot /www/subdomain/sub1<br />
+    <indent>
+        ServerName www.sub1.domain.tld<br />
+        ServerPath /sub1/<br />
+        RewriteEngine On<br />
+        RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost 172.20.30.40&gt;<br />
+    <indent>
+        DocumentRoot /www/subdomain/sub2<br />
+        ServerName www.sub2.domain.tld<br />
+        ServerPath /sub2/<br />
+        RewriteEngine On<br />
+        RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
+        # ...<br />
+    </indent>
+    &lt;/VirtualHost&gt;
+    </example>
+
+    <p>À cause de la directive 
+    <directive module="core">ServerPath</directive>, une requête sur 
+    une URL <code>http://www.sub1.domain.tld/sub1/</code> est 
+    <em>toujours</em> servie par le serveur sub1-vhost.<br />
+    Une requête sur une URL <code>http://www.sub1.domain.tld/</code> n'est 
+    servie par le serveur sub1-vhost que si le client envoie un en-tête 
+    <code>Host:</code> correct. Si aucun en-tête <code>Host:</code> 
+    n'est transmis, le serveur primaire sera utilisé.<br />
+    Notez qu'il y a une singularité&nbsp;: une requête sur 
+    <code>http://www.sub2.domain.tld/sub1/</code> est également servie 
+    par le serveur sub1-vhost si le client n'envoie pas d'en-tête 
+    <code>Host:</code>.<br />
+    Les directives <directive module="mod_rewrite">RewriteRule</directive> 
+    sont employées pour s'assurer que le client qui envoie un en-tête 
+    <code>Host:</code> correct puisse utiliser d'autres variantes d'URLs, 
+    <em>c'est-à-dire</em> avec ou sans préfixe d'URL.</p>
+
+       </section>
+
+</manualpage>
diff --git a/docs/manual/vhosts/fd-limits.html.fr b/docs/manual/vhosts/fd-limits.html.fr
new file mode 100644 (file)
index 0000000..792508f
--- /dev/null
@@ -0,0 +1,143 @@
+<?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>Limites des descripteurs de fichiers - 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" class="no-sidebar"><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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Serveurs Virtuels</a></div><div id="page-content"><div id="preamble"><h1>Limites des descripteurs de fichiers</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/fd-limits.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+<div class="outofdate">Cette traduction peut être périmée. Verifiez la version
+            Anglaise pour les changements récents.</div>
+
+
+    <p>Quand de nombreux serveurs virtuels sont créés, Apache peut 
+    dépasser les limites en descripteurs de fichiers ('file descriptors', 
+    également appelés <cite>gestionnaires de fichiers</cite>) si chacun 
+    des serveurs virtuels utilise ses propres fichiers journaux. Le 
+    nombre total de descripteurs de fichiers utilisés par Apache est 
+    d'un par fichier journal, un pour chacune des autres directives 
+    de fichiers journaux, plus un nombre constant compris entre 10 et 20 
+    pour son fonctionnement interne. Les systèmes d'exploitation Unix 
+    limitent le nombre de descripteurs de fichiers utilisables par 
+    processus&nbsp;; une valeur courante pour cette limite est de 64, et 
+    cette valeur peut le plus souvent être augmentée.</p>
+
+    <p>Apache tente d'accroître cette valeur limite si nécessaire, mais 
+    sans y parvenir dans les cas suivants&nbsp;:</p>
+
+    <ol>
+      <li>Le système d'exploitation ne permet pas l'utilisation d'appels 
+      systèmes <code>setrlimit()</code>.</li>
+
+      <li>L'appel <code>setrlimit(RLIMIT_NOFILE)</code> ne fonctionne pas 
+      sur votre système d'exploitation (c'est le cas sous Solaris 2.3).</li>
+
+      <li>Le nombre de descripteurs de fichiers nécessaires à Apache 
+      dépasse la limite physique du matériel.</li>
+      
+      <li>Le système impose d'autres limites sur l'utilisation des 
+      descripteurs de fichiers, comme par exemple une limite sur les 
+      flux stdio, utilisables uniquement sur les descripteurs de 
+      fichiers inférieurs à 256. (sous Solaris 2).</li>
+    </ol>
+
+       <p>En cas de problème, Vous pouvez&nbsp;:</p>
+
+    <ul>
+      <li>Réduire le nombre de fichiers journaux, en ne spécifiant 
+      aucun fichier journal dans les sections 
+      <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>, 
+      en donc en envoyant les informations aux fichiers journaux du 
+      serveur principal (Voir <a href="#splitlogs">Éclatement des 
+      fichiers journaux</a> ci-dessous pour plus d'informations sur 
+      cette possibilité).</li>
+
+      <li>
+        Dans les cas 1 ou 2 (évoqués ci-dessus), augmentez la limite sur 
+        les descripteurs de fichiers avant le démarrage d'Apache, au 
+        moyen d'un script comme
+
+        <div class="example"><p><code>
+          <code>#!/bin/sh<br />
+           ulimit -S -n 100<br />
+           exec httpd</code>
+        </code></p></div>
+      </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="splitlogs" id="splitlogs">Éclatement des fichiers journaux</a></h2>
+
+<p>Lorsque vous choisissez d'enregistrer les informations émanant de 
+plusieurs serveurs virtuels dans un même fichier journal, vous voudrez 
+ensuite pouvoir scinder ces informations à des fins de statistiques, par 
+exemple, sur les différents serveurs virtuels. Il est possible de procéder 
+de la manière suivante&nbsp;:</p>
+
+<p>Tout d'abord, vous devez ajouter le nom du serveur virtuel à chaque 
+entrée du journal. Ceci se paramètre au moyen de la directive 
+<code class="directive"><a href="../mod/mod_log_config.html# logformat"> LogFormat</a></code> et de la 
+variable <code>%v</code>. Ajoutez cette variable au début de la chaîne 
+de définition du format de journalisations&nbsp;:</p>
+
+<div class="example"><p><code>
+LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost<br />
+CustomLog logs/multiple_vhost_log vhost
+</code></p></div>
+
+<p>Cette configuration va provoquer la création d'un fichier de 
+journalisation au format standard (CLF&nbsp;: 'Common Log Format'), mais dont 
+chaque ligne débutera par le nom canonique du serveur virtuel (spécifié 
+par la directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>). 
+(Voir <code class="directive"><a href="../mod/mod_log_config.html#formats de journalisation &#10;personnalisés">Formats de journalisation 
+personnalisés</a></code> pour d'autres informations sur la 
+personnalisation des fichiers journaux.)</p>
+
+<p>Au moment de séparer les informations du fichier journal en un fichier 
+par serveur virtuel, le programme <code>
+<a href="../programs/other.html">split-logfile</a></code> peut être 
+utilisé. Ce programme peut être trouvé dans le répertoire 
+<code>support</code> de la distribution d'Apache.</p>
+
+<p>Exécutez ce programme au moyen de la commande&nbsp;:</p>
+
+<div class="example"><p><code>
+split-logfile &lt; /logs/multiple_vhost_log
+</code></p></div>
+
+<p>Une fois exécuté avec le nom du fichier contenant tous les journaux, 
+ce programme va générer un fichier pour chacun des serveurs virtuels 
+qui apparaît dans le fichier d'entrée. Chaque fichier en sortie est 
+nommé <code>nomduserveur.log</code>.</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/fd-limits.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/fd-limits.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/fd-limits.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/fd-limits.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/fd-limits.xml.fr b/docs/manual/vhosts/fd-limits.xml.fr
new file mode 100644 (file)
index 0000000..bdb3ce7
--- /dev/null
@@ -0,0 +1,141 @@
+<?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="fd-limits.xml.meta">
+<parentdocument href="./">Serveurs Virtuels</parentdocument>
+  <title>Limites des descripteurs de fichiers</title>
+
+<summary>
+
+    <p>Quand de nombreux serveurs virtuels sont créés, Apache peut 
+    dépasser les limites en descripteurs de fichiers ('file descriptors', 
+    également appelés <cite>gestionnaires de fichiers</cite>) si chacun 
+    des serveurs virtuels utilise ses propres fichiers journaux. Le 
+    nombre total de descripteurs de fichiers utilisés par Apache est 
+    d'un par fichier journal, un pour chacune des autres directives 
+    de fichiers journaux, plus un nombre constant compris entre 10 et 20 
+    pour son fonctionnement interne. Les systèmes d'exploitation Unix 
+    limitent le nombre de descripteurs de fichiers utilisables par 
+    processus&nbsp;; une valeur courante pour cette limite est de 64, et 
+    cette valeur peut le plus souvent être augmentée.</p>
+
+    <p>Apache tente d'accroître cette valeur limite si nécessaire, mais 
+    sans y parvenir dans les cas suivants&nbsp;:</p>
+
+    <ol>
+      <li>Le système d'exploitation ne permet pas l'utilisation d'appels 
+      systèmes <code>setrlimit()</code>.</li>
+
+      <li>L'appel <code>setrlimit(RLIMIT_NOFILE)</code> ne fonctionne pas 
+      sur votre système d'exploitation (c'est le cas sous Solaris 2.3).</li>
+
+      <li>Le nombre de descripteurs de fichiers nécessaires à Apache 
+      dépasse la limite physique du matériel.</li>
+      
+      <li>Le système impose d'autres limites sur l'utilisation des 
+      descripteurs de fichiers, comme par exemple une limite sur les 
+      flux stdio, utilisables uniquement sur les descripteurs de 
+      fichiers inférieurs à 256. (sous Solaris 2).</li>
+    </ol>
+
+       <p>En cas de problème, Vous pouvez&nbsp;:</p>
+
+    <ul>
+      <li>Réduire le nombre de fichiers journaux, en ne spécifiant 
+      aucun fichier journal dans les sections 
+      <directive type="section" module="core">VirtualHost</directive>, 
+      en donc en envoyant les informations aux fichiers journaux du 
+      serveur principal (Voir <a href="#splitlogs">Éclatement des 
+      fichiers journaux</a> ci-dessous pour plus d'informations sur 
+      cette possibilité).</li>
+
+      <li>
+        Dans les cas 1 ou 2 (évoqués ci-dessus), augmentez la limite sur 
+        les descripteurs de fichiers avant le démarrage d'Apache, au 
+        moyen d'un script comme
+
+        <example>
+          <code>#!/bin/sh<br />
+           ulimit -S -n 100<br />
+           exec httpd</code>
+        </example>
+      </li>
+    </ul>
+    
+<!-- the document misc/descriptors.xml does not exist yet in 2.1
+    <p>Veuillez noter que le document 
+    <a href="../misc/descriptors.html">Descripteurs et Apache</a> 
+    contient plus de détails concernant les problèmes de descripteurs 
+    de fichiers et comment les résoudre en fonction de votre système 
+    d'exploitation.</p>
+-->
+
+</summary>
+
+<section id="splitlogs"><title>Éclatement des fichiers journaux</title>
+
+<p>Lorsque vous choisissez d'enregistrer les informations émanant de 
+plusieurs serveurs virtuels dans un même fichier journal, vous voudrez 
+ensuite pouvoir scinder ces informations à des fins de statistiques, par 
+exemple, sur les différents serveurs virtuels. Il est possible de procéder 
+de la manière suivante&nbsp;:</p>
+
+<p>Tout d'abord, vous devez ajouter le nom du serveur virtuel à chaque 
+entrée du journal. Ceci se paramètre au moyen de la directive 
+<directive module="mod_log_config"> LogFormat</directive> et de la 
+variable <code>%v</code>. Ajoutez cette variable au début de la chaîne 
+de définition du format de journalisations&nbsp;:</p>
+
+<example>
+LogFormat "%v %h %l %u %t \"%r\" %&gt;s %b" vhost<br />
+CustomLog logs/multiple_vhost_log vhost
+</example>
+
+<p>Cette configuration va provoquer la création d'un fichier de 
+journalisation au format standard (CLF&nbsp;: 'Common Log Format'), mais dont 
+chaque ligne débutera par le nom canonique du serveur virtuel (spécifié 
+par la directive <directive module="core">ServerName</directive>). 
+(Voir <directive module="mod_log_config">Formats de journalisation 
+personnalisés</directive> pour d'autres informations sur la 
+personnalisation des fichiers journaux.)</p>
+
+<p>Au moment de séparer les informations du fichier journal en un fichier 
+par serveur virtuel, le programme <code>
+<a href="../programs/other.html">split-logfile</a></code> peut être 
+utilisé. Ce programme peut être trouvé dans le répertoire 
+<code>support</code> de la distribution d'Apache.</p>
+
+<p>Exécutez ce programme au moyen de la commande&nbsp;:</p>
+
+<example>
+split-logfile &lt; /logs/multiple_vhost_log
+</example>
+
+<p>Une fois exécuté avec le nom du fichier contenant tous les journaux, 
+ce programme va générer un fichier pour chacun des serveurs virtuels 
+qui apparaît dans le fichier d'entrée. Chaque fichier en sortie est 
+nommé <code>nomduserveur.log</code>.</p>
+
+</section>
+</manualpage>
+
diff --git a/docs/manual/vhosts/index.html.fr b/docs/manual/vhosts/index.html.fr
new file mode 100644 (file)
index 0000000..1cb324f
--- /dev/null
@@ -0,0 +1,111 @@
+<?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>Documentation sur les serveurs virtuels Apache - 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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a></div><div id="page-content"><div id="preamble"><h1>Documentation sur les serveurs virtuels Apache</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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 principe des <cite>Serveurs Virtuels</cite> consiste à 
+    faire fonctionner un ou plusieurs serveurs Web (comme 
+    <code>www.company1.com</code> et <code>www.company2.com</code>) 
+    sur une même machine. Les serveurs virtuels peuvent être soit 
+    "<a href="ip-based.html">par-IP</a>" où une adresse IP est 
+    attribuée pour chaque serveur Web, soit "<a href="name-based.html">par-nom</a>" où plusieurs noms de domaine se côtoient sur 
+    des mêmes adresses IP. L'utilisateur final ne perçoit pas 
+    qu'en fait il s'agit d'un même serveur physique.</p>
+
+    <p>Apache a été le précurseur des serveurs proposant cette 
+    méthode de serveurs virtuels basés sur les adresses IP. Ses 
+    versions 1.1 et suivantes ont toujours proposées ces deux 
+    méthodes de serveurs virtuels par-IP et par-nom. Cette 
+    deuxième méthode est parfois également appelée <em>host-based</em> 
+    ou <em>serveur virtuel non-IP</em>.</p>
+
+    <p>Vous trouverez ci-dessous une liste documentaire qui vous 
+    expliquera en détails le fonctionnement des serveurs virtuels 
+    sous Apache 1.3 et ses versions suivantes.</p>
+
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#support">Support des serveurs virtuels</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#directives">Directives de configuration</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code></li><li><a href="name-based.html">Serveurs virtuels par-nom</a></li><li><a href="ip-based.html">Serveurs virtuels par-IP</a></li><li><a href="examples.html">Exemples de serveurs virtuels</a></li><li><a href="fd-limits.html">Limites des descripteurs de fichiers</a></li><li><a href="mass.html">Hébergement virtuel en masse</a></li><li><a href="details.html">Détails sur les critères de choix du serveur</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="support" id="support">Support des serveurs virtuels</a></h2>
+
+    <ul>
+      <li><a href="name-based.html">Serveurs Virtuels par-Nom</a> 
+      (Un ou plusieurs sites Web par adresse IP)</li>
+      <li><a href="ip-based.html">Serveurs Virtuels par-IP</a> 
+      (Une adresse IP pour chaque site Web)</li>
+      <li><a href="examples.html">Exemples de configurations classiques 
+      de Serveurs Virtuels </a></li>
+      <li><a href="fd-limits.html">Limites des descripteurs de fichiers</a> 
+      (ou, <em>trop de fichiers journaux</em>)</li>
+      <li><a href="mass.html">Configuration dynamique en masse de 
+      Serveurs Virtuels</a></li>
+      <li><a href="details.html">Explication approfondie des critères 
+      de sélection d'un Serveur Virtuel</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="directives" id="directives">Directives de configuration</a></h2>
+
+    <ul>
+      <li><code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li>
+      <li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li>
+      <li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li>
+      <li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li>
+      <li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li>
+    </ul>
+
+    <p>Pour vérifier et analyser la configuration de vos serveurs 
+    virtuels, vous pouvez utiliser l'argument <code>-S</code> sur 
+    la ligne de commande lançant le programme Apache comme ceci&nbsp;:</p>
+
+    <div class="example"><p><code>
+    /usr/local/apache2/bin/httpd -S
+    </code></p></div>
+
+    <p>Cette commande affichera dans le détail comment Apache a 
+    traité son fichier de configuration. Les erreurs de configuration 
+    peuvent être corrigées par l'examen attentif des adresses IP et 
+    des noms de serveurs. (Consultez la documentation du programme 
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour les autres arguments de la ligne de 
+    commande)</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../de/vhosts/" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="../en/vhosts/" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/index.xml.fr b/docs/manual/vhosts/index.xml.fr
new file mode 100644 (file)
index 0000000..0243b5d
--- /dev/null
@@ -0,0 +1,108 @@
+<?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 alain B, review by Vincent Deffontaines -->
+
+<!--
+ 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="index.xml.meta">
+<parentdocument href="../"/>
+
+   <title>Documentation sur les serveurs virtuels Apache</title>
+
+<summary>
+
+    <p>Le principe des <cite>Serveurs Virtuels</cite> consiste à 
+    faire fonctionner un ou plusieurs serveurs Web (comme 
+    <code>www.company1.com</code> et <code>www.company2.com</code>) 
+    sur une même machine. Les serveurs virtuels peuvent être soit 
+    "<a href="ip-based.html">par-IP</a>" où une adresse IP est 
+    attribuée pour chaque serveur Web, soit "<a href="name-based.html"
+    >par-nom</a>" où plusieurs noms de domaine se côtoient sur 
+    des mêmes adresses IP. L'utilisateur final ne perçoit pas 
+    qu'en fait il s'agit d'un même serveur physique.</p>
+
+    <p>Apache a été le précurseur des serveurs proposant cette 
+    méthode de serveurs virtuels basés sur les adresses IP. Ses 
+    versions 1.1 et suivantes ont toujours proposées ces deux 
+    méthodes de serveurs virtuels par-IP et par-nom. Cette 
+    deuxième méthode est parfois également appelée <em>host-based</em> 
+    ou <em>serveur virtuel non-IP</em>.</p>
+
+    <p>Vous trouverez ci-dessous une liste documentaire qui vous 
+    expliquera en détails le fonctionnement des serveurs virtuels 
+    sous Apache 1.3 et ses versions suivantes.</p>
+
+</summary>
+
+<seealso><module>mod_vhost_alias</module></seealso>
+<seealso><a href="name-based.html">Serveurs virtuels par-nom</a></seealso>
+<seealso><a href="ip-based.html">Serveurs virtuels par-IP</a></seealso>
+<seealso><a href="examples.html">Exemples de serveurs virtuels</a></seealso>
+<seealso><a href="fd-limits.html">Limites des descripteurs de fichiers</a></seealso>
+<seealso><a href="mass.html">Hébergement virtuel en masse</a></seealso>
+<seealso><a href="details.html">Détails sur les critères de choix du serveur</a></seealso>
+
+<section id="support"><title>Support des serveurs virtuels</title>
+
+    <ul>
+      <li><a href="name-based.html">Serveurs Virtuels par-Nom</a> 
+      (Un ou plusieurs sites Web par adresse IP)</li>
+      <li><a href="ip-based.html">Serveurs Virtuels par-IP</a> 
+      (Une adresse IP pour chaque site Web)</li>
+      <li><a href="examples.html">Exemples de configurations classiques 
+      de Serveurs Virtuels </a></li>
+      <li><a href="fd-limits.html">Limites des descripteurs de fichiers</a> 
+      (ou, <em>trop de fichiers journaux</em>)</li>
+      <li><a href="mass.html">Configuration dynamique en masse de 
+      Serveurs Virtuels</a></li>
+      <li><a href="details.html">Explication approfondie des critères 
+      de sélection d'un Serveur Virtuel</a></li>
+    </ul>
+
+</section>
+
+<section id="directives"><title>Directives de configuration</title>
+
+    <ul>
+      <li><directive type="section"
+           module="core">VirtualHost</directive></li>
+      <li><directive module="core">NameVirtualHost</directive></li>
+      <li><directive module="core">ServerName</directive></li>
+      <li><directive module="core">ServerAlias</directive></li>
+      <li><directive module="core">ServerPath</directive></li>
+    </ul>
+
+    <p>Pour vérifier et analyser la configuration de vos serveurs 
+    virtuels, vous pouvez utiliser l'argument <code>-S</code> sur 
+    la ligne de commande lançant le programme Apache comme ceci&nbsp;:</p>
+
+    <example>
+    /usr/local/apache2/bin/httpd -S
+    </example>
+
+    <p>Cette commande affichera dans le détail comment Apache a 
+    traité son fichier de configuration. Les erreurs de configuration 
+    peuvent être corrigées par l'examen attentif des adresses IP et 
+    des noms de serveurs. (Consultez la documentation du programme 
+    <program>httpd</program> pour les autres arguments de la ligne de 
+    commande)</p>
+
+</section>
+</manualpage>
diff --git a/docs/manual/vhosts/ip-based.html.fr b/docs/manual/vhosts/ip-based.html.fr
new file mode 100644 (file)
index 0000000..a7dd380
--- /dev/null
@@ -0,0 +1,184 @@
+<?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>Support Apache des serveurs virtuels par IP - 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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Support Apache des serveurs virtuels par IP</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/ip-based.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+<div class="outofdate">Cette traduction peut être périmée. Verifiez la version
+            Anglaise pour les changements récents.</div>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#requirements">Système requis</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#howto">Comment configurer Apache</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#multiple">Configuration de processus multiples</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#single">Configuration d'un unique processus 
+résident pour des serveurs virtuels</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li>
+<a href="name-based.html">Support Apache des serveurs virtuels par nom</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="requirements" id="requirements">Système requis</a></h2>
+
+    <p>Comme l'indique le terme <cite>par IP</cite>, le serveur 
+    <strong>doit disposer de différentes adresses IP pour chaque 
+    serveur virtuel par IP</strong>. La machine peut posséder 
+    plusieurs connexions physiques au réseau, ou utiliser des 
+    interfaces virtuelles qui sont supportées par la plupart des 
+    systèmes d'exploitation modernes (Consultez la documentation des 
+    systèmes d'exploitation pour plus de détails, notamment les "alias 
+    IP" et la commande "ifconfig" pour les activer).</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="howto" id="howto">Comment configurer Apache</a></h2>
+
+    <p>Il y a deux manières de configurer Apache pour le support de 
+    multiples serveurs virtuels. Il suffit soit de faire tourner un 
+    processus résident <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour chaque nom de 
+    domaine, soit de faire tourner un unique processus résident qui 
+    gère tous les serveurs virtuels.</p>
+
+    <p>Utilisez des processus résidents multiples lorsque&nbsp;:</p>
+
+    <ul>
+      <li>il y a des problèmes de répartition de sécurité, tels 
+      qu'une entreprise1 ne souhaite que personne d'une entreprise2 
+      ne puisse lire ses données excepté via le Web. Dans ce cas, 
+      vous aurez besoin de deux processus résidents, chacun fonctionnant 
+      avec des paramètres <code class="directive"><a href="../mod/mpm_common.html#user">User</a></code>, 
+      <code class="directive"><a href="../mod/mpm_common.html#group">Group</a></code>, 
+      <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, et 
+      <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> différents.</li>
+
+      <li>vous disposez suffisamment de mémoire et de 
+      <a href="../misc/descriptors.html">descripteurs de fichiers</a> 
+      pour l'écoute de chaque alias IP de la machine. Il est seulement 
+      possible d'appliquer la directive 
+      <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>, soit sur toutes 
+      les adresses avec le joker "*", soit uniquement sur des adresses 
+      spécifiques. Donc, si vous avez besoin d'écouter une adresse 
+      en particulier, vous devrez le faire pour l'ensemble des 
+      autres adresses (Bien qu'il soit plus simple de lancer un 
+      processus <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour écouter N-1 adresses, 
+      et un autre pour l'adresse restante).</li>
+    </ul>
+
+    <p>Utilisez un unique processus résident lorsque&nbsp;:</p>
+
+    <ul>
+      <li>le partage de la configuration httpd entre les serveurs 
+      virtuels est acceptable.</li>
+
+      <li>la machine assume déjà une grande quantité de requêtes, et 
+      que l'ajout de processus résidents supplémentaires en affecterait 
+      les performances.</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="multiple" id="multiple">Configuration de processus multiples</a></h2>
+
+    <p>Créez une installation indépendante du programme 
+    <code class="program"><a href="../programs/httpd.html">httpd</a></code> pour chaque serveur virtuel. Pour 
+    chacune d'elle, utilisez la directive 
+    <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code> dans le fichier 
+    de configuration pour définir l'adresse IP (ou serveur virtuel) 
+    que le processus résident doit gérer. Par exemple&nbsp;:</p>
+
+    <div class="example"><p><code>
+    Listen www.smallco.com:80
+    </code></p></div>
+
+    <p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom 
+    de domaine (consultez <a href="../dns-caveats.html">Problèmes DNS 
+    avec Apache</a>).</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="single" id="single">Configuration d'un unique processus 
+résident pour des serveurs virtuels</a></h2>
+
+    <p>Dans ce cas, un unique processus httpd va gérer les requêtes 
+    pour le serveur principal et tous les serveurs virtuels. Dans le 
+    fichier de configuration, la directive 
+    <code class="directive"><a href="../mod/core.html#virtualhost">VirtualHost</a></code> va servir à 
+    définir les autres directives 
+    <code class="directive"><a href="../mod/core.html#serveradmin">ServerAdmin</a></code>, 
+    <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, 
+    <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>, 
+    <code class="directive"><a href="../mod/core.html#errorlog">ErrorLog</a></code> et 
+    <code class="directive"><a href="../mod/mod_log_config.html#transferlog">TransferLog</a></code> ou 
+    <code class="directive"><a href="../mod/mod_log_config.html#customlog">CustomLog</a></code> avec des 
+    valeurs différentes pour chaque serveur virtuel. Par exemple&nbsp;:</p>
+
+    <div class="example"><p><code>
+    &lt;VirtualHost www.smallco.com&gt;<br />
+    ServerAdmin webmaster@mail.smallco.com<br />
+    DocumentRoot /groups/smallco/www<br />
+    ServerName www.smallco.com<br />
+    ErrorLog /groups/smallco/logs/error_log<br />
+    TransferLog /groups/smallco/logs/access_log<br />
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost www.baygroup.org&gt;<br />
+    ServerAdmin webmaster@mail.baygroup.org<br />
+    DocumentRoot /groups/baygroup/www<br />
+    ServerName www.baygroup.org<br />
+    ErrorLog /groups/baygroup/logs/error_log<br />
+    TransferLog /groups/baygroup/logs/access_log<br />
+    &lt;/VirtualHost&gt;
+               </code></p></div>
+
+    <p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom 
+    de domaine (consultez <a href="../dns-caveats.html">Problèmes DNS 
+    avec Apache</a>).</p>
+
+    <p>Presque <strong>toutes</strong> les directives de configuration 
+    peuvent être employées dans une directive VirtualHost, à l'exception 
+    des directives qui contrôlent la création du processus et de 
+    quelques autres. Pour connaître celles utilisables dans une 
+    directive VirtualHost, vérifiez leur 
+    <a href="../mod/directive-dict.html#Context">Contexte</a> en utilisant 
+    l'<a href="../mod/directives.html">Index des directives</a>.</p>
+
+
+    <a href="../mod/mod_suexec.html/#suexecusergroup">SuexecUserGroup</a> peut être
+    utilisées à l'intérieur d'une directive VirtualHost si l'exécution se fait sous
+    suEXEC. (Voir <a href="../suexec.html">suEXEC</a>).
+
+    <p><em>SÉCURITÉ&nbsp;:</em> lorsque vous spécifiez où écrire les 
+    fichiers journaux, soyez attentif aux risques si quelqu'un d'autre 
+    que celui qui a démarré Apache dispose des droits d'écriture 
+    sur l'emplacement de ces fichiers. Consultez les 
+    <a href="../misc/security_tips.html">Conseils sur la sécurité</a> 
+    pour plus de détails.</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/vhosts/ip-based.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/ip-based.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/ip-based.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/ip-based.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/ip-based.xml.fr b/docs/manual/vhosts/ip-based.xml.fr
new file mode 100644 (file)
index 0000000..0a74cf8
--- /dev/null
@@ -0,0 +1,176 @@
+<?xml version='1.0' encoding='ISO-8859-1' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<!-- English Revision: 151405:169327 (outdated) -->
+<!-- French translation by alain B, review by Vincent Deffontaines -->
+
+<!--
+ 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="ip-based.xml.meta">
+<parentdocument href="./">Serveurs virtuels</parentdocument>
+   <title>Support Apache des serveurs virtuels par IP</title>
+
+<seealso>
+<a href="name-based.html">Support Apache des serveurs virtuels par nom</a>
+</seealso>
+
+<section id="requirements"><title>Système requis</title>
+
+    <p>Comme l'indique le terme <cite>par IP</cite>, le serveur 
+    <strong>doit disposer de différentes adresses IP pour chaque 
+    serveur virtuel par IP</strong>. La machine peut posséder 
+    plusieurs connexions physiques au réseau, ou utiliser des 
+    interfaces virtuelles qui sont supportées par la plupart des 
+    systèmes d'exploitation modernes (Consultez la documentation des 
+    systèmes d'exploitation pour plus de détails, notamment les "alias 
+    IP" et la commande "ifconfig" pour les activer).</p>
+
+</section>
+
+<section id="howto"><title>Comment configurer Apache</title>
+
+    <p>Il y a deux manières de configurer Apache pour le support de 
+    multiples serveurs virtuels. Il suffit soit de faire tourner un 
+    processus résident <program>httpd</program> pour chaque nom de 
+    domaine, soit de faire tourner un unique processus résident qui 
+    gère tous les serveurs virtuels.</p>
+
+    <p>Utilisez des processus résidents multiples lorsque&nbsp;:</p>
+
+    <ul>
+      <li>il y a des problèmes de répartition de sécurité, tels 
+      qu'une entreprise1 ne souhaite que personne d'une entreprise2 
+      ne puisse lire ses données excepté via le Web. Dans ce cas, 
+      vous aurez besoin de deux processus résidents, chacun fonctionnant 
+      avec des paramètres <directive module="mpm_common">User</directive>, 
+      <directive module="mpm_common">Group</directive>, 
+      <directive module="mpm_common">Listen</directive>, et 
+      <directive module="core">ServerRoot</directive> différents.</li>
+
+      <li>vous disposez suffisamment de mémoire et de 
+      <a href="../misc/descriptors.html">descripteurs de fichiers</a> 
+      pour l'écoute de chaque alias IP de la machine. Il est seulement 
+      possible d'appliquer la directive 
+      <directive module="mpm_common">Listen</directive>, soit sur toutes 
+      les adresses avec le joker "*", soit uniquement sur des adresses 
+      spécifiques. Donc, si vous avez besoin d'écouter une adresse 
+      en particulier, vous devrez le faire pour l'ensemble des 
+      autres adresses (Bien qu'il soit plus simple de lancer un 
+      processus <program>httpd</program> pour écouter N-1 adresses, 
+      et un autre pour l'adresse restante).</li>
+    </ul>
+
+    <p>Utilisez un unique processus résident lorsque&nbsp;:</p>
+
+    <ul>
+      <li>le partage de la configuration httpd entre les serveurs 
+      virtuels est acceptable.</li>
+
+      <li>la machine assume déjà une grande quantité de requêtes, et 
+      que l'ajout de processus résidents supplémentaires en affecterait 
+      les performances.</li>
+    </ul>
+
+</section>
+
+<section id="multiple"><title>Configuration de processus multiples</title>
+
+    <p>Créez une installation indépendante du programme 
+    <program>httpd</program> pour chaque serveur virtuel. Pour 
+    chacune d'elle, utilisez la directive 
+    <directive module="mpm_common">Listen</directive> dans le fichier 
+    de configuration pour définir l'adresse IP (ou serveur virtuel) 
+    que le processus résident doit gérer. Par exemple&nbsp;:</p>
+
+    <example>
+    Listen www.smallco.com:80
+    </example>
+
+    <p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom 
+    de domaine (consultez <a href="../dns-caveats.html">Problèmes DNS 
+    avec Apache</a>).</p>
+
+</section>
+
+<section id="single"><title>Configuration d'un unique processus 
+résident pour des serveurs virtuels</title>
+
+    <p>Dans ce cas, un unique processus httpd va gérer les requêtes 
+    pour le serveur principal et tous les serveurs virtuels. Dans le 
+    fichier de configuration, la directive 
+    <directive module="core">VirtualHost</directive> va servir à 
+    définir les autres directives 
+    <directive module="core">ServerAdmin</directive>, 
+    <directive module="core">ServerName</directive>, 
+    <directive module="core">DocumentRoot</directive>, 
+    <directive module="core">ErrorLog</directive> et 
+    <directive module="mod_log_config">TransferLog</directive> ou 
+    <directive module="mod_log_config">CustomLog</directive> avec des 
+    valeurs différentes pour chaque serveur virtuel. Par exemple&nbsp;:</p>
+
+    <example>
+    &lt;VirtualHost www.smallco.com&gt;<br />
+    ServerAdmin webmaster@mail.smallco.com<br />
+    DocumentRoot /groups/smallco/www<br />
+    ServerName www.smallco.com<br />
+    ErrorLog /groups/smallco/logs/error_log<br />
+    TransferLog /groups/smallco/logs/access_log<br />
+    &lt;/VirtualHost&gt;<br />
+               <br />
+    &lt;VirtualHost www.baygroup.org&gt;<br />
+    ServerAdmin webmaster@mail.baygroup.org<br />
+    DocumentRoot /groups/baygroup/www<br />
+    ServerName www.baygroup.org<br />
+    ErrorLog /groups/baygroup/logs/error_log<br />
+    TransferLog /groups/baygroup/logs/access_log<br />
+    &lt;/VirtualHost&gt;
+               </example>
+
+    <p>Il est recommandé d'utiliser une adresse IP plutôt qu'un nom 
+    de domaine (consultez <a href="../dns-caveats.html">Problèmes DNS 
+    avec Apache</a>).</p>
+
+    <p>Presque <strong>toutes</strong> les directives de configuration 
+    peuvent être employées dans une directive VirtualHost, à l'exception 
+    des directives qui contrôlent la création du processus et de 
+    quelques autres. Pour connaître celles utilisables dans une 
+    directive VirtualHost, vérifiez leur 
+    <a href="../mod/directive-dict.html#Context">Contexte</a> en utilisant 
+    l'<a href="../mod/directives.html">Index des directives</a>.</p>
+
+<!-- 
+    <p>Les directives <directive module="mpm_common">User</directive> et  
+    <directive module="mpm_common">Group</directive> NE doivent PLUS être 
+    utilisées à l'intérieur d'une directive VirtualHost lors d'une 
+    <a href="../suexec.html">exécution sous suEXEC</a>. Voir la directive 
+    <a href="../mod/mod_suexec.html/#suexecusergroup">SuexecUserGroup</a> définie 
+    en remplacement depuis la version 2.0.</p>
+ -->
+    <a href="../mod/mod_suexec.html/#suexecusergroup">SuexecUserGroup</a> peut être
+    utilisées à l'intérieur d'une directive VirtualHost si l'exécution se fait sous
+    suEXEC. (Voir <a href="../suexec.html">suEXEC</a>).
+
+    <p><em>SÉCURITÉ&nbsp;:</em> lorsque vous spécifiez où écrire les 
+    fichiers journaux, soyez attentif aux risques si quelqu'un d'autre 
+    que celui qui a démarré Apache dispose des droits d'écriture 
+    sur l'emplacement de ces fichiers. Consultez les 
+    <a href="../misc/security_tips.html">Conseils sur la sécurité</a> 
+    pour plus de détails.</p>
+
+</section>
+</manualpage>
diff --git a/docs/manual/vhosts/name-based.html.fr b/docs/manual/vhosts/name-based.html.fr
new file mode 100644 (file)
index 0000000..c98033a
--- /dev/null
@@ -0,0 +1,300 @@
+<?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>Support Apache des serveurs virtuels par nom - 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="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Serveurs virtuels</a></div><div id="page-content"><div id="preamble"><h1>Support Apache des serveurs virtuels par nom</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/name-based.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+<div class="outofdate">Cette traduction peut être périmée. Verifiez la version
+            Anglaise pour les changements récents.</div>
+
+    <p>Ce document décrit quand et comment utiliser des serveurs 
+    virtuels par nom.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#namevip">Serveurs virtuels par nom vs. par IP</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#using">Utilisation de serveurs virtuels par nom</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#compat">Compatibilité avec les navigateurs anciens</a></li>
+</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="ip-based.html">Support Apache des serveurs virtuels par IP</a></li><li><a href="details.html">Détails sur le fonctionnement des serveurs virtuels</a></li><li><a href="mass.html">Configuration dynamique des hébergements virtuels de masse</a></li><li><a href="examples.html">Exemples d'utilisations de VirtualHost</a></li><li><a href="examples.html#serverpath">Utilisation de la directive ServerPath</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="namevip" id="namevip">Serveurs virtuels par nom vs. par IP</a></h2>
+
+    <p>Les hébergements virtuels par IP utilisent l'adresse IP 
+    de la connexion afin de déterminer quel serveur virtuel doit 
+    répondre. Par conséquent, vous devez disposer d'adresses IP 
+    différentes pour chaque nom de domaine complet (FQDN) que vous hébergez. 
+    Avec un hébergement 
+    virtuel par nom, le serveur s'appuit sur les informations 
+    transmises par le client dans les en-têtes HTTP de ses requêtes. 
+    La technique présentée ici vous permet de disposer de serveurs 
+    virtuels différents partagés sur une même adresse IP.</p>
+
+    <p>L'hébergement virtuel par nom est habituellement plus simple, 
+    car il vous suffit de configurer votre serveur DNS pour que 
+    chaque domaine pointe sur l'adresse IP dont vous disposez, et de 
+    configurer votre serveur Apache HTTP afin qu'il reconnaisse 
+    ces domaines. Il réduit aussi la pénurie en adresses IP. Par 
+    conséquent, vous devriez utiliser l'hébergement virtuel par 
+    nom à moins d'avoir une raison spécifique de préférer 
+    l'hébergement virtuel par IP. Certaines de ces raisons vous 
+    sont exposées ci-après&nbsp;:</p>
+
+    <ul>
+        <li>Certains anciens navigateurs ne sont pas compatibles 
+        avec les serveurs virtuels par nom, car pour fonctionner, 
+        un client doit transmettre un champ d'en-tête HTTP Host. 
+        Cet en-tête est exigé pour HTTP/1.1, et peut être implémenté 
+        sur des navigateurs modernes HTTP/1.0 grâce à une extension. 
+        Si vous devez maintenir des clients obsolètes tout en 
+        utilisant l'hébergement virtuel par nom, il existe une 
+        technique qui est traitée à la fin de ce document.</li>
+
+        <li>L'hébergement virtuel par nom ne peut pas être utilisé 
+        avec des serveurs sécurisés SSL à cause de la nature même 
+        du protocole SSL.</li>
+
+        <li>Certains systèmes d'exploitation et équipements réseaux 
+        emploient des techniques de gestion de la bande passante 
+        qui ne peuvent pas différencier des domaines autrement que 
+        par des adresses IP séparées.</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="using" id="using">Utilisation de serveurs virtuels par nom</a></h2>
+
+<table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code></li><li><code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code></li><li><code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code></li><li><code class="directive"><a href="../mod/core.html#servername">ServerName</a></code></li><li><code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code></li><li><code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table>
+
+    <p>Pour utiliser des serveurs virtuels par nom, vous devez 
+    désigner l'adresse IP (et si possible le port) sur le serveur 
+    devant accepter les requêtes pour des domaines. Cette 
+    configuration utilise la directive 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. Dans un 
+    cas normal où n'importe quelle adresse IP peut être utilisée, 
+    vous pouvez ajouter <code>*</code> comme argument de la directive 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. Si vous 
+    prévoyez d'utiliser de multiples ports (comme l'emploi de SSL), 
+    vous devriez ajouter le port à cet argument tel que 
+    <code>*:80</code>. Notez que la simple mention d'une adresse 
+    IP dans une directive 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> ne suffit 
+    pas à faire écouter le serveur sur cette IP. Consultez 
+    <a href="../bind.html">la page sur les liaisons</a> pour plus 
+    de détails. Par ailleurs, chaque adresse IP spécifiée ici doit 
+    être associée avec une interface réseau sur le serveur.</p>
+
+    <p>L'étape suivante est la création d'une section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+    pour chacun des serveurs à créer. L'argument de la directive 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+    doit être le même que celui de la directive 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> 
+    (c'est-à-dire l'adresse IP ou <code>*</code> pour toutes les 
+    adresses). Dans chaque section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>, 
+    vous devez définir au minimum une directive 
+    <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> pour désigner 
+    le serveur concerné et une directive 
+    <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> pour préciser 
+    l'emplacement sur le système de fichiers du contenu de ce serveur.</p>
+
+    <div class="note"><h3>Le serveur principal disparaît</h3>
+        <p>Si vous ajoutez des serveurs virtuels à un serveur Web 
+        existant, vous devez également créer une section 
+        <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+        redéfinissant ce serveur existant. Les directives 
+        <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> et 
+        <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> incluses 
+        dans ce serveur virtuel doivent être les mêmes que pour 
+        les directives globales 
+        <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> et 
+        <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>. Positionnez 
+        ce serveur virtuel en premier dans le fichier de configuration 
+        pour en faire le serveur par défaut.</p>
+    </div>
+
+    <p>Par exemple, supposez que vous hébergez le domaine 
+    <code>www.domain.tld</code> et que vous souhaitez ajouter le 
+    serveur virtuel <code>www.otherdomain.tld</code> qui pointe sur 
+    la même adresse IP. Il vous suffit d'ajouter la configuration 
+    suivante à <code>httpd.conf</code>&nbsp;:</p>
+
+    <div class="example"><p><code>
+        NameVirtualHost *:80<br />
+        <br />
+        &lt;VirtualHost *:80&gt;<br />
+        <span class="indent">
+            ServerName www.domain.tld<br />
+            ServerAlias domain.tld *.domain.tld<br />
+            DocumentRoot /www/domain<br />
+        </span>
+        &lt;/VirtualHost&gt;<br />
+        <br />
+        &lt;VirtualHost *:80&gt;<br />
+        <span class="indent">ServerName www.otherdomain.tld<br />
+            DocumentRoot /www/otherdomain<br />
+        </span>
+        &lt;/VirtualHost&gt;<br />
+    </code></p></div>
+
+    <p>Autrement, vous pouvez spécifiez une adresse IP explicite 
+    à la place de <code>*</code> dans les deux directives 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code> et 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>. 
+    Par exemple, cette méthode est utile si vous souhaitez faire 
+    tourner quelques serveurs virtuels par nom sur une même adresse 
+    IP, et d'autres, soit par IP, soit basés sur un autre jeu de 
+    serveurs virtuels par nom sur une autre adresse IP.</p>
+
+    <p>Plusieurs serveurs sont accessibles par plus d'un nom. Il 
+    suffit de placer la directive 
+    <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> dans une section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>. 
+    Par exemple, dans la première section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+    ci-dessus, la directive <code class="directive"><a href="../mod/core.html#serveralias">ServerAlias</a></code> 
+    indique aux utilisateurs les autres noms permis pour accéder au 
+    même site Web&nbsp;:</p>
+
+    <div class="example"><p><code>
+        ServerAlias domain.tld *.domain.tld
+    </code></p></div>
+
+    <p>ainsi, toutes les requêtes portant sur un domaine 
+    <code>domain.tld</code> seront servies par le serveur virtuel 
+    <code>www.domain.tld</code>. Les caractères joker <code>*</code> 
+    et <code>?</code> peuvent être utilisés pour les correspondances. 
+    Bien entendu, vous ne pouvez pas inventer des noms et les placer 
+    dans une directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> 
+    ou <code>ServerAlias</code>. Tout d'abord, votre serveur DNS 
+    doit être correctement configuré pour lier ces noms à une 
+    adresse IP associée avec votre serveur.</p>
+
+    <p>Finalement, vous pouvez affiner la configuration des serveurs 
+    virtuels en plaçant d'autres directives à l'intérieur des sections 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>. 
+    La plupart des directives peut être placée dans ces sections en 
+    y changeant seulement la configuration du serveur virtuel associé. 
+    Pour déterminer si une directive particulière est permise, 
+    consultez <a href="../mod/directive-dict.html#Context">la page de 
+    contexte</a>. Le jeu de directives configurées dans le contexte 
+    du <em>serveur principal</em> (en dehors de toutes sections 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>) 
+    sera utilisé seulement s'il n'y a pas de configuration contraire 
+    par un serveur virtuel.</p>
+
+    <p>Maintenant, lorsqu'une requête arrive, le serveur va d'abord 
+    tester si elle utilise une adresse IP qui correspond à 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. Si c'est 
+    le cas, il regardera chaque section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+    avec l'adresse correspondante et essaiera d'en trouver une où 
+    le nom de domaine requis correspond à 
+    <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code> ou 
+    <code>ServerAlias</code>. S'il en trouve une, il utilisera 
+    sa configuration pour le serveur. Si aucun serveur virtuel ne 
+    correspond, alors <em>le premier serveur virtuel listé</em> 
+    dont l'adresse IP correspond sera employé.</p>
+
+    <p>En conséquence, le premier serveur virtuel listé est le 
+    serveur virtuel <em>default</em>. La directive 
+    <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> du 
+    <em>serveur principal</em> <strong>ne</strong> sera 
+    <strong>jamais</strong> employée lorsqu'une adresse IP 
+    correspond dans une directive 
+    <code class="directive"><a href="../mod/core.html#namevirtualhost">NameVirtualHost</a></code>. Si vous 
+    ne voulez pas avoir de configuration spéciale pour les requêtes 
+    qui ne sont pas attachées à un serveur virtuel en particulier, 
+    mettez cette configuration dans une section 
+    <code class="directive"><a href="../mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code> 
+    que vous placerez en premier dans le fichier de configuration.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="compat" id="compat">Compatibilité avec les navigateurs anciens</a></h2>
+
+    <p>Comme mentionné plus tôt, certains clients ne transmettent 
+    pas les données nécessaires pour le bon fonctionnement des 
+    serveurs virtuels. Ces clients recevront toujours les pages 
+    du premier serveur virtuel listé pour cette adresse IP (le 
+    serveur virtuel par nom <cite>primaire</cite>).</p>
+
+    <div class="note"><h3>De combien plus anciens&nbsp;?</h3>
+    <p>Veuillez noter que quand nous disons plus anciens, nous 
+    disons vraiment plus anciens. Vous seriez malchanceux de rencontrer 
+    de tels navigateurs encore utilisés de nos jours. Toutes les 
+    versions actuelles des navigateurs transmettent leur en-tête 
+    <code>Host</code> comme exigé par les serveurs virtuels par nom.</p>
+    </div>
+
+    <p>Il existe une solution avec la directive 
+    <code class="directive"><a href="../mod/core.html#serverpath">ServerPath</a></code>, bien que 
+    légèrement complexe&nbsp;:</p>
+
+    <p>Exemple de configuration&nbsp;:</p>
+
+    <div class="example"><p><code>
+        NameVirtualHost 111.22.33.44<br />
+        <br />
+        &lt;VirtualHost 111.22.33.44&gt;<br />
+        <span class="indent">
+            ServerName www.domain.tld<br />
+            ServerPath /domain<br />
+            DocumentRoot /web/domain<br />
+        </span>
+        &lt;/VirtualHost&gt;<br />
+    </code></p></div>
+
+    <p>Qu'est-ce que cela signifie&nbsp;? Il signifie qu'une requête 
+    pour tout URI qui commence par "<code>/domain</code>" sera 
+    servie par le serveur virtuel <code>www.domain.tld</code>. 
+    Ainsi, les pages sont accessibles à 
+    <code>http://www.domain.tld/domain/</code> pour tous les 
+    clients, bien que ceux qui transmettent un en-tête 
+    <code>Host:</code> peuvent également y accéder à 
+    <code>http://www.domain.tld/</code>.</p>
+
+    <p>Pour rendre cette technique fonctionnelle, mettez un lien 
+    dans votre serveur virtuel primaire vers 
+    <code>http://www.domain.tld/domain/</code>. Ensuite, dans les 
+    pages de ce serveur virtuel, assurez vous ne n'utiliser que 
+    des liens relatifs (<em>par exemple</em>, "<code>file.html</code>" 
+    ou "<code>../icons/image.gif</code>") ou des liens contenant 
+    le préfixe <code>/domain/</code> (<em>par exemple</em>, 
+    "<code>http://www.domain.tld/domain/misc/file.html</code>" 
+    ou "<code>/domain/misc/file.html</code>").</p>
+
+    <p>Cela requiert un peu de discipline, mais si vous suivez 
+    cette ligne de conduite, vous serez assuré que vos pages 
+    s'afficheront dans tous les navigateurs, nouveaux et anciens.</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../de/vhosts/name-based.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
+<a href="../en/vhosts/name-based.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="../fr/vhosts/name-based.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="../ja/vhosts/name-based.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
+<a href="../ko/vhosts/name-based.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</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
diff --git a/docs/manual/vhosts/name-based.xml.fr b/docs/manual/vhosts/name-based.xml.fr
new file mode 100644 (file)
index 0000000..6802c7d
--- /dev/null
@@ -0,0 +1,304 @@
+<?xml version='1.0' encoding='ISO-8859-1' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<!-- English Revision: 151405:151408 (outdated) -->
+<!-- French translation by alain B, review by Vincent Deffontaines -->
+
+<!--
+ 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="name-based.xml.meta">
+<parentdocument href="./">Serveurs virtuels</parentdocument>
+<title>Support Apache des serveurs virtuels par nom</title>
+
+<summary>
+    <p>Ce document décrit quand et comment utiliser des serveurs 
+    virtuels par nom.</p>
+</summary>
+
+<seealso><a href="ip-based.html">Support Apache des serveurs virtuels par IP</a></seealso>
+<seealso><a href="details.html">Détails sur le fonctionnement des serveurs virtuels</a></seealso>
+<seealso><a href="mass.html">Configuration dynamique des hébergements virtuels de masse</a></seealso>
+<seealso><a href="examples.html">Exemples d'utilisations de VirtualHost</a></seealso>
+<seealso><a href="examples.html#serverpath">Utilisation de la directive ServerPath</a></seealso>
+
+<section id="namevip"><title>Serveurs virtuels par nom vs. par IP</title>
+
+    <p>Les hébergements virtuels par IP utilisent l'adresse IP 
+    de la connexion afin de déterminer quel serveur virtuel doit 
+    répondre. Par conséquent, vous devez disposer d'adresses IP 
+    différentes pour chaque nom de domaine complet (FQDN) que vous hébergez. 
+    Avec un hébergement 
+    virtuel par nom, le serveur s'appuit sur les informations 
+    transmises par le client dans les en-têtes HTTP de ses requêtes. 
+    La technique présentée ici vous permet de disposer de serveurs 
+    virtuels différents partagés sur une même adresse IP.</p>
+
+    <p>L'hébergement virtuel par nom est habituellement plus simple, 
+    car il vous suffit de configurer votre serveur DNS pour que 
+    chaque domaine pointe sur l'adresse IP dont vous disposez, et de 
+    configurer votre serveur Apache HTTP afin qu'il reconnaisse 
+    ces domaines. Il réduit aussi la pénurie en adresses IP. Par 
+    conséquent, vous devriez utiliser l'hébergement virtuel par 
+    nom à moins d'avoir une raison spécifique de préférer 
+    l'hébergement virtuel par IP. Certaines de ces raisons vous 
+    sont exposées ci-après&nbsp;:</p>
+
+    <ul>
+        <li>Certains anciens navigateurs ne sont pas compatibles 
+        avec les serveurs virtuels par nom, car pour fonctionner, 
+        un client doit transmettre un champ d'en-tête HTTP Host. 
+        Cet en-tête est exigé pour HTTP/1.1, et peut être implémenté 
+        sur des navigateurs modernes HTTP/1.0 grâce à une extension. 
+        Si vous devez maintenir des clients obsolètes tout en 
+        utilisant l'hébergement virtuel par nom, il existe une 
+        technique qui est traitée à la fin de ce document.</li>
+
+        <li>L'hébergement virtuel par nom ne peut pas être utilisé 
+        avec des serveurs sécurisés SSL à cause de la nature même 
+        du protocole SSL.</li>
+
+        <li>Certains systèmes d'exploitation et équipements réseaux 
+        emploient des techniques de gestion de la bande passante 
+        qui ne peuvent pas différencier des domaines autrement que 
+        par des adresses IP séparées.</li>
+    </ul>
+
+</section>
+
+<section id="using"><title>Utilisation de serveurs virtuels par nom</title>
+
+<related>
+    <modulelist>
+    <module>core</module>
+    </modulelist>
+
+    <directivelist>
+       <directive module="core">DocumentRoot</directive>
+       <directive module="core">NameVirtualHost</directive>
+       <directive module="core">ServerAlias</directive>
+       <directive module="core">ServerName</directive>
+       <directive module="core">ServerPath</directive>
+       <directive module="core" type="section">VirtualHost</directive>
+    </directivelist>
+</related>
+
+    <p>Pour utiliser des serveurs virtuels par nom, vous devez 
+    désigner l'adresse IP (et si possible le port) sur le serveur 
+    devant accepter les requêtes pour des domaines. Cette 
+    configuration utilise la directive 
+    <directive module="core">NameVirtualHost</directive>. Dans un 
+    cas normal où n'importe quelle adresse IP peut être utilisée, 
+    vous pouvez ajouter <code>*</code> comme argument de la directive 
+    <directive module="core">NameVirtualHost</directive>. Si vous 
+    prévoyez d'utiliser de multiples ports (comme l'emploi de SSL), 
+    vous devriez ajouter le port à cet argument tel que 
+    <code>*:80</code>. Notez que la simple mention d'une adresse 
+    IP dans une directive 
+    <directive module="core">NameVirtualHost</directive> ne suffit 
+    pas à faire écouter le serveur sur cette IP. Consultez 
+    <a href="../bind.html">la page sur les liaisons</a> pour plus 
+    de détails. Par ailleurs, chaque adresse IP spécifiée ici doit 
+    être associée avec une interface réseau sur le serveur.</p>
+
+    <p>L'étape suivante est la création d'une section 
+    <directive type="section" module="core">VirtualHost</directive> 
+    pour chacun des serveurs à créer. L'argument de la directive 
+    <directive type="section" module="core">VirtualHost</directive> 
+    doit être le même que celui de la directive 
+    <directive module="core">NameVirtualHost</directive> 
+    (c'est-à-dire l'adresse IP ou <code>*</code> pour toutes les 
+    adresses). Dans chaque section 
+    <directive type="section" module="core">VirtualHost</directive>, 
+    vous devez définir au minimum une directive 
+    <directive module="core">ServerName</directive> pour désigner 
+    le serveur concerné et une directive 
+    <directive module="core">DocumentRoot</directive> pour préciser 
+    l'emplacement sur le système de fichiers du contenu de ce serveur.</p>
+
+    <note><title>Le serveur principal disparaît</title>
+        <p>Si vous ajoutez des serveurs virtuels à un serveur Web 
+        existant, vous devez également créer une section 
+        <directive type="section" module="core">VirtualHost</directive> 
+        redéfinissant ce serveur existant. Les directives 
+        <directive module="core">ServerName</directive> et 
+        <directive module="core">DocumentRoot</directive> incluses 
+        dans ce serveur virtuel doivent être les mêmes que pour 
+        les directives globales 
+        <directive module="core">ServerName</directive> et 
+        <directive module="core">DocumentRoot</directive>. Positionnez 
+        ce serveur virtuel en premier dans le fichier de configuration 
+        pour en faire le serveur par défaut.</p>
+    </note>
+
+    <p>Par exemple, supposez que vous hébergez le domaine 
+    <code>www.domain.tld</code> et que vous souhaitez ajouter le 
+    serveur virtuel <code>www.otherdomain.tld</code> qui pointe sur 
+    la même adresse IP. Il vous suffit d'ajouter la configuration 
+    suivante à <code>httpd.conf</code>&nbsp;:</p>
+
+    <example>
+        NameVirtualHost *:80<br />
+        <br />
+        &lt;VirtualHost *:80&gt;<br />
+        <indent>
+            ServerName www.domain.tld<br />
+            ServerAlias domain.tld *.domain.tld<br />
+            DocumentRoot /www/domain<br />
+        </indent>
+        &lt;/VirtualHost&gt;<br />
+        <br />
+        &lt;VirtualHost *:80&gt;<br />
+        <indent>ServerName www.otherdomain.tld<br />
+            DocumentRoot /www/otherdomain<br />
+        </indent>
+        &lt;/VirtualHost&gt;<br />
+    </example>
+
+    <p>Autrement, vous pouvez spécifiez une adresse IP explicite 
+    à la place de <code>*</code> dans les deux directives 
+    <directive module="core" >NameVirtualHost</directive> et 
+    <directive type="section" module="core" >VirtualHost</directive>. 
+    Par exemple, cette méthode est utile si vous souhaitez faire 
+    tourner quelques serveurs virtuels par nom sur une même adresse 
+    IP, et d'autres, soit par IP, soit basés sur un autre jeu de 
+    serveurs virtuels par nom sur une autre adresse IP.</p>
+
+    <p>Plusieurs serveurs sont accessibles par plus d'un nom. Il 
+    suffit de placer la directive 
+    <directive module="core">ServerAlias</directive> dans une section 
+    <directive type="section" module="core">VirtualHost</directive>. 
+    Par exemple, dans la première section 
+    <directive type="section" module="core">VirtualHost</directive> 
+    ci-dessus, la directive <directive module="core">ServerAlias</directive> 
+    indique aux utilisateurs les autres noms permis pour accéder au 
+    même site Web&nbsp;:</p>
+
+    <example>
+        ServerAlias domain.tld *.domain.tld
+    </example>
+
+    <p>ainsi, toutes les requêtes portant sur un domaine 
+    <code>domain.tld</code> seront servies par le serveur virtuel 
+    <code>www.domain.tld</code>. Les caractères joker <code>*</code> 
+    et <code>?</code> peuvent être utilisés pour les correspondances. 
+    Bien entendu, vous ne pouvez pas inventer des noms et les placer 
+    dans une directive <directive module="core">ServerName</directive> 
+    ou <code>ServerAlias</code>. Tout d'abord, votre serveur DNS 
+    doit être correctement configuré pour lier ces noms à une 
+    adresse IP associée avec votre serveur.</p>
+
+    <p>Finalement, vous pouvez affiner la configuration des serveurs 
+    virtuels en plaçant d'autres directives à l'intérieur des sections 
+    <directive type="section" module="core">VirtualHost</directive>. 
+    La plupart des directives peut être placée dans ces sections en 
+    y changeant seulement la configuration du serveur virtuel associé. 
+    Pour déterminer si une directive particulière est permise, 
+    consultez <a href="../mod/directive-dict.html#Context">la page de 
+    contexte</a>. Le jeu de directives configurées dans le contexte 
+    du <em>serveur principal</em> (en dehors de toutes sections 
+    <directive type="section" module="core">VirtualHost</directive>) 
+    sera utilisé seulement s'il n'y a pas de configuration contraire 
+    par un serveur virtuel.</p>
+
+    <p>Maintenant, lorsqu'une requête arrive, le serveur va d'abord 
+    tester si elle utilise une adresse IP qui correspond à 
+    <directive module="core" >NameVirtualHost</directive>. Si c'est 
+    le cas, il regardera chaque section 
+    <directive type="section" module="core">VirtualHost</directive> 
+    avec l'adresse correspondante et essaiera d'en trouver une où 
+    le nom de domaine requis correspond à 
+    <directive module="core">ServerName</directive> ou 
+    <code>ServerAlias</code>. S'il en trouve une, il utilisera 
+    sa configuration pour le serveur. Si aucun serveur virtuel ne 
+    correspond, alors <em>le premier serveur virtuel listé</em> 
+    dont l'adresse IP correspond sera employé.</p>
+
+    <p>En conséquence, le premier serveur virtuel listé est le 
+    serveur virtuel <em>default</em>. La directive 
+    <directive module="core">DocumentRoot</directive> du 
+    <em>serveur principal</em> <strong>ne</strong> sera 
+    <strong>jamais</strong> employée lorsqu'une adresse IP 
+    correspond dans une directive 
+    <directive module="core">NameVirtualHost</directive>. Si vous 
+    ne voulez pas avoir de configuration spéciale pour les requêtes 
+    qui ne sont pas attachées à un serveur virtuel en particulier, 
+    mettez cette configuration dans une section 
+    <directive type="section" module="core">VirtualHost</directive> 
+    que vous placerez en premier dans le fichier de configuration.</p>
+
+</section>
+
+<section id="compat"><title>Compatibilité avec les navigateurs anciens</title>
+
+    <p>Comme mentionné plus tôt, certains clients ne transmettent 
+    pas les données nécessaires pour le bon fonctionnement des 
+    serveurs virtuels. Ces clients recevront toujours les pages 
+    du premier serveur virtuel listé pour cette adresse IP (le 
+    serveur virtuel par nom <cite>primaire</cite>).</p>
+
+    <note><title>De combien plus anciens&nbsp;?</title>
+    <p>Veuillez noter que quand nous disons plus anciens, nous 
+    disons vraiment plus anciens. Vous seriez malchanceux de rencontrer 
+    de tels navigateurs encore utilisés de nos jours. Toutes les 
+    versions actuelles des navigateurs transmettent leur en-tête 
+    <code>Host</code> comme exigé par les serveurs virtuels par nom.</p>
+    </note>
+
+    <p>Il existe une solution avec la directive 
+    <directive module="core">ServerPath</directive>, bien que 
+    légèrement complexe&nbsp;:</p>
+
+    <p>Exemple de configuration&nbsp;:</p>
+
+    <example>
+        NameVirtualHost 111.22.33.44<br />
+        <br />
+        &lt;VirtualHost 111.22.33.44&gt;<br />
+        <indent>
+            ServerName www.domain.tld<br />
+            ServerPath /domain<br />
+            DocumentRoot /web/domain<br />
+        </indent>
+        &lt;/VirtualHost&gt;<br />
+    </example>
+
+    <p>Qu'est-ce que cela signifie&nbsp;? Il signifie qu'une requête 
+    pour tout URI qui commence par "<code>/domain</code>" sera 
+    servie par le serveur virtuel <code>www.domain.tld</code>. 
+    Ainsi, les pages sont accessibles à 
+    <code>http://www.domain.tld/domain/</code> pour tous les 
+    clients, bien que ceux qui transmettent un en-tête 
+    <code>Host:</code> peuvent également y accéder à 
+    <code>http://www.domain.tld/</code>.</p>
+
+    <p>Pour rendre cette technique fonctionnelle, mettez un lien 
+    dans votre serveur virtuel primaire vers 
+    <code>http://www.domain.tld/domain/</code>. Ensuite, dans les 
+    pages de ce serveur virtuel, assurez vous ne n'utiliser que 
+    des liens relatifs (<em>par exemple</em>, "<code>file.html</code>" 
+    ou "<code>../icons/image.gif</code>") ou des liens contenant 
+    le préfixe <code>/domain/</code> (<em>par exemple</em>, 
+    "<code>http://www.domain.tld/domain/misc/file.html</code>" 
+    ou "<code>/domain/misc/file.html</code>").</p>
+
+    <p>Cela requiert un peu de discipline, mais si vous suivez 
+    cette ligne de conduite, vous serez assuré que vos pages 
+    s'afficheront dans tous les navigateurs, nouveaux et anciens.</p>
+
+</section>
+</manualpage>