granicus.if.org Git - apache/blob - docs/manual/vhosts/examples.xml.fr

   1 <?xml version='1.0' encoding='ISO-8859-1' ?>
   2 <!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1053231 -->
   5 <!-- French translation by Vincent Deffontaines, Alain B., review by  -->
   6 <!-- updated by Lucien Gentis -->
   7
   8 <!--
   9  Licensed to the Apache Software Foundation (ASF) under one or more
  10  contributor license agreements.  See the NOTICE file distributed with
  11  this work for additional information regarding copyright ownership.
  12  The ASF licenses this file to You under the Apache License, Version 2.0
  13  (the "License"); you may not use this file except in compliance with
  14  the License.  You may obtain a copy of the License at
  15
  16      http://www.apache.org/licenses/LICENSE-2.0
  17
  18  Unless required by applicable law or agreed to in writing, software
  19  distributed under the License is distributed on an "AS IS" BASIS,
  20  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21  See the License for the specific language governing permissions and
  22  limitations under the License.
  23 -->
  24
  25 <manualpage metafile="examples.xml.meta">
  26 <parentdocument href="./">Serveurs virtuels</parentdocument>
  27     <title>Exemples d'utilisations de VirtualHost</title>
  28
  29 <summary>
  30
  31     <p>Le but de ce document est d'essayer de répondre aux questions
  32     les plus répandues sur la configuration des <a href="index.html">serveurs virtuels</a>.
  33     Les scénarios présentés ici se rencontrent quand plusieurs
  34     serveurs Webs doivent tourner sur une seule et même machine au
  35     moyen de serveurs virtuels <a href="name-based.html">par nom</a>
  36     ou <a href="ip-based.html">par IP</a>.</p>
  37
  38 </summary>
  39
  40   <section id="purename"><title>Fonctionnement de plusieurs serveurs
  41   virtuels par nom sur une seule adresse IP.</title>
  42
  43     <p>Votre serveur ne dispose que d'une seule adresse IP, et de
  44     nombreux alias (CNAMES) pointent vers cette adresse dans le DNS.
  45     Pour l'exemple, <code>www.example.com</code> et
  46     <code>www.example.org</code> doivent tourner sur cette machine.</p>
  47
  48     <note><title>Note&nbsp;:</title><p>La configuration de serveurs virtuels
  49     sous Apache ne provoque pas leur apparition magique dans la
  50     configuration du DNS. Il <em>faut</em> que leurs noms soient
  51     définis dans le DNS, et qu'ils y soient résolus sur l'adresse IP
  52     du serveur, faute de quoi personne ne pourra visiter votre site Web.
  53     Il est possible d'ajouter des entrées dans le fichier
  54     <code>hosts</code> pour tests locaux, mais qui ne fonctionneront
  55     que sur la machine possédant ces entrées.</p>
  56     </note>
  57
  58     <example>
  59     <title>Configuration du serveur</title>
  60
  61     # Apache doit écouter sur le port 80<br />
  62     Listen 80<br />
  63     <br />
  64     <br />
  65     &lt;VirtualHost *:80&gt;<br />
  66     <indent>
  67       DocumentRoot /www/example.com<br />
  68       ServerName www.example1.com<br />
  69       <br />
  70       # Autres directives ici<br />
  71       <br />
  72     </indent>
  73     &lt;/VirtualHost&gt;<br />
  74     <br />
  75     &lt;VirtualHost *:80&gt;<br />
  76     <indent>
  77       DocumentRoot /www/example.org<br />
  78       ServerName www.example2.org<br />
  79       <br />
  80       # Autres directives ici<br />
  81       <br />
  82     </indent>
  83     &lt;/VirtualHost&gt;
  84     </example>
  85
  86     <p>Les astérisques correspondent à toutes les adresses, si bien que
  87     le serveur principal ne répondra jamais à aucune requête. Comme le
  88     serveur virtuel
  89     <code>ServerName www.example.com</code> se trouve en premier dans le fichier
  90     de configuration, il a la plus grande priorité et peut être vu
  91     comme serveur <cite>par défaut</cite> ou <cite>primaire</cite>&nbsp;;
  92     ce qui signifie que toute requête reçue ne correspondant à aucune
  93     des directives <code>ServerName</code> sera servie par ce premier
  94     <code>VirtualHost</code>.</p>
  95
  96     <note>
  97             <title>Note&nbsp;:</title>
  98
  99             <p>Vous pouvez remplacer <code>*</code>
 100             par l'adresse IP du système si vous ne souhaitez pas faire
 101             opérer la sélection du serveur virtuel en fonction de la
 102             paire adresse IP/port.</p>
 103
 104            <p>En général, il est commode d'utiliser <code>*</code> sur
 105            les systèmes dont l'adresse IP n'est pas constante - par
 106            exemple, pour des serveurs dont l'adresse IP est attribuée
 107            dynamiquement par le FAI, et où le DNS est géré au moyen
 108            d'un DNS dynamique quelconque. Comme <code>*</code> signifie
 109            <cite>n'importe quelle adresse</cite>, cette configuration
 110            fonctionne sans devoir être modifiée quand l'adresse IP du
 111            système est modifiée.</p>
 112     </note>
 113
 114     <p>La configuration ci-dessus est en pratique utilisée dans la
 115     plupart des cas pour les serveurs virtuels par nom. En fait, le
 116     seul cas où cette configuration ne fonctionne pas est lorsque
 117     différents contenus doivent être servis en fonction de l'adresse IP
 118     et du port contactés par le client.</p>
 119
 120     </section>
 121
 122     <section id="twoips"><title>Serveurs virtuels par nom sur plus
 123     d'une seule adresse IP.</title>
 124
 125         <note>
 126           <title>Note&nbsp;:</title><p>Toutes les techniques présentées ici
 127           peuvent être étendues à un plus grand nombre d'adresses IP.</p>
 128     </note>
 129
 130     <p>Le serveur a deux adresses IP. Sur l'une
 131     (<code>172.20.30.40</code>), le serveur "principal"
 132     <code>server.example.com</code> doit répondre, et sur l'autre
 133     (<code>172.20.30.50</code>), deux serveurs virtuels (ou plus)
 134     répondront.</p>
 135
 136     <example>
 137     <title>Configuration du serveur</title>
 138
 139     Listen 80<br />
 140         <br />
 141     # Serveur "principal" sur 172.20.30.40<br />
 142     ServerName server.example.com<br />
 143     DocumentRoot /www/mainserver<br />
 144         <br />
 145     &lt;VirtualHost 172.20.30.50&gt;<br />
 146     <indent>
 147         DocumentRoot /www/example.com<br />
 148         ServerName www.example.com<br />
 149                 <br />
 150         # D'autres directives ici ...<br />
 151                    <br />
 152     </indent>
 153     &lt;/VirtualHost&gt;<br />
 154         <br />
 155     &lt;VirtualHost 172.20.30.50&gt;<br />
 156     <indent>
 157         DocumentRoot /www/example.org<br />
 158         ServerName www.example.org<br />
 159                 <br />
 160         # D'autres directives ici ...<br />
 161                 <br />
 162     </indent>
 163     &lt;/VirtualHost&gt;
 164     </example>
 165
 166     <p>Toute requête arrivant sur une autre adresse que
 167     <code>172.20.30.50</code> sera servie par le serveur principal.
 168     Les requêtes vers <code>172.20.30.50</code> avec un nom de serveur
 169     inconnu, ou sans en-tête <code>Host:</code>, seront servies par
 170     <code>www.example.com</code>.</p>
 171
 172     </section>
 173
 174     <section id="intraextra"><title>Servir le même contenu sur des
 175     adresses IP différentes (telle qu'une adresse interne et une
 176     externe).</title>
 177
 178     <p>La machine serveur dispose de deux adresses IP
 179     (<code>192.168.1.1</code> et <code>172.20.30.40</code>). Cette
 180     machine est placée à la fois sur le réseau interne (l'Intranet)
 181     et le réseau externe (Internet). Sur Internet, le nom
 182     <code>server.example.com</code> pointe vers l'adresse externe
 183     (<code>172.20.30.40</code>), mais sur le réseau interne, ce même
 184     nom pointe vers l'adresse interne (<code>192.168.1.1</code>).</p>
 185
 186     <p>Le serveur peut être configuré pour répondre de la même manière
 187     aux requêtes internes et externes, au moyen d'une seule section
 188     <code>VirtualHost</code>.</p>
 189
 190     <example>
 191     <title>Configuration du serveur</title>
 192
 193     <br />
 194     &lt;VirtualHost 192.168.1.1 172.20.30.40&gt;<br />
 195     <indent>
 196         DocumentRoot /www/server1<br />
 197         ServerName server.example.com<br />
 198         ServerAlias server<br />
 199     </indent>
 200     &lt;/VirtualHost&gt;
 201     </example>
 202
 203     <p>Ainsi, les requêtes en provenance de chacun des deux réseaux
 204     seront servies par le même <code>VirtualHost</code>.</p>
 205
 206     <note>
 207           <title>Note&nbsp;:</title><p>Sur le réseau interne, il est possible
 208           d'utiliser le nom raccourci <code>server</code> au lieu du nom
 209           complet <code>server.example.com</code>.</p>
 210
 211           <p>Notez également que dans l'exemple précédent, vous pouvez
 212           remplacer la liste des adresses IP par des <code>*</code> afin
 213           que le serveur réponde de la même manière sur toutes ses
 214           adresses.</p>
 215     </note>
 216
 217     </section>
 218
 219     <section id="port"><title>Servir différents sites sur différents
 220     ports.</title>
 221
 222     <p>Vous disposez de plusieurs domaines pointant sur la même adresse
 223     IP et vous voulez également servir de multiples ports. L'exemple
 224     suivant montre que la sélection en fonction du nom intervient après
 225     la sélection de la meilleure correspondance du point de vue adresse
 226     IP/port.</p>
 227
 228     <example>
 229     <title>Configuration du serveur</title>
 230
 231     Listen 80<br />
 232     Listen 8080<br />
 233                 <br />
 234     &lt;VirtualHost 172.20.30.40:80&gt;<br />
 235     <indent>
 236         ServerName www.example.com<br />
 237         DocumentRoot /www/domain-80<br />
 238     </indent>
 239     &lt;/VirtualHost&gt;<br />
 240                 <br />
 241     &lt;VirtualHost 172.20.30.40:8080&gt;<br />
 242     <indent>
 243         ServerName www.example.com<br />
 244         DocumentRoot /www/domain-8080<br />
 245     </indent>
 246     &lt;/VirtualHost&gt;<br />
 247                 <br />
 248     &lt;VirtualHost 172.20.30.40:80&gt;<br />
 249     <indent>
 250         ServerName www.example.org<br />
 251         DocumentRoot /www/otherdomain-80<br />
 252     </indent>
 253     &lt;/VirtualHost&gt;<br />
 254                 <br />
 255     &lt;VirtualHost 172.20.30.40:8080&gt;<br />
 256     <indent>
 257         ServerName www.example.org<br />
 258         DocumentRoot /www/otherdomain-8080<br />
 259     </indent>
 260     &lt;/VirtualHost&gt;
 261     </example>
 262
 263         </section>
 264
 265     <section id="ip"><title>Hébergement virtuel basé sur IP</title>
 266
 267     <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
 268     et <code>172.20.30.50</code>) correspondant respectivement aux noms
 269     <code>www.example.com</code> et <code>www.example.org</code>.</p>
 270
 271     <example>
 272     <title>Configuration du serveur</title>
 273
 274     Listen 80<br />
 275                 <br />
 276     &lt;VirtualHost 172.20.30.40&gt;<br />
 277     <indent>
 278         DocumentRoot /www/example.com<br />
 279         ServerName www.example1.com<br />
 280     </indent>
 281     &lt;/VirtualHost&gt;<br />
 282                 <br />
 283     &lt;VirtualHost 172.20.30.50&gt;<br />
 284     <indent>
 285         DocumentRoot /www/example.org<br />
 286         ServerName www.example2.org<br />
 287     </indent>
 288     &lt;/VirtualHost&gt;
 289     </example>
 290
 291     <p>Les requêtes provenant d'adresses non spécifiées dans l'une des
 292     directives <code>&lt;VirtualHost&gt;</code> (comme pour
 293     <code>localhost</code> par exemple) seront dirigées vers le serveur
 294     principal, s'il en existe un.</p>
 295
 296         </section>
 297
 298     <section id="ipport"><title>Hébergements virtuels mixtes basés sur
 299     les ports et sur les IP</title>
 300
 301     <p>Le serveur dispose de deux adresses IP (<code>172.20.30.40</code>
 302     et <code>172.20.30.50</code>) correspondant respectivement aux noms
 303     <code>www.example.com</code> et <code>www.example.org</code>.
 304     Pour chacun d'eux, nous voulons un hébergement sur les ports 80
 305     et 8080.</p>
 306
 307     <example>
 308     <title>Configuration du serveur</title>
 309
 310     Listen 172.20.30.40:80<br />
 311     Listen 172.20.30.40:8080<br />
 312     Listen 172.20.30.50:80<br />
 313     Listen 172.20.30.50:8080<br />
 314                 <br />
 315     &lt;VirtualHost 172.20.30.40:80&gt;<br />
 316     <indent>
 317         DocumentRoot /www/example.com-80<br />
 318         ServerName www.example.com<br />
 319     </indent>
 320     &lt;/VirtualHost&gt;<br />
 321                 <br />
 322     &lt;VirtualHost 172.20.30.40:8080&gt;<br />
 323     <indent>
 324         DocumentRoot /www/example.com-8080<br />
 325         ServerName www.example.com<br />
 326                 </indent>
 327     &lt;/VirtualHost&gt;<br />
 328                 <br />
 329     &lt;VirtualHost 172.20.30.50:80&gt;<br />
 330     <indent>
 331         DocumentRoot /www/example.org-80<br />
 332         ServerName www.example.org<br />
 333     </indent>
 334     &lt;/VirtualHost&gt;<br />
 335                 <br />
 336     &lt;VirtualHost 172.20.30.50:8080&gt;<br />
 337     <indent>
 338         DocumentRoot /www/example.org-8080<br />
 339         ServerName www.example.org<br />
 340     </indent>
 341     &lt;/VirtualHost&gt;
 342     </example>
 343
 344         </section>
 345
 346     <section id="mixed"><title>Hébergements virtuels mixtes basé sur
 347     les noms et sur IP</title>
 348
 349     <p>Toute adresse indiquée comme argument d'une section VirtualHost
 350     et n'apparaissant dans aucun autre serveur virtuel, fait de cette
 351     section un serveur virtuel sélectionnable uniquement en fonction de
 352     son adresse IP.</p>
 353
 354     <example>
 355     <title>Configuration du serveur</title>
 356
 357     Listen 80<br />
 358     &lt;VirtualHost 172.20.30.40&gt;<br />
 359     <indent>
 360         DocumentRoot /www/example1<br />
 361         ServerName www.example.com<br />
 362     </indent>
 363     &lt;/VirtualHost&gt;<br />
 364                 <br />
 365     &lt;VirtualHost 172.20.30.40&gt;<br />
 366     <indent>
 367         DocumentRoot /www/example2<br />
 368         ServerName www.example.org<br />
 369     </indent>
 370     &lt;/VirtualHost&gt;<br />
 371                 <br />
 372     &lt;VirtualHost 172.20.30.40&gt;<br />
 373     <indent>
 374         DocumentRoot /www/example3<br />
 375         ServerName www.example.net<br />
 376     </indent>
 377     &lt;/VirtualHost&gt;<br />
 378                 <br />
 379     # "par-IP"<br />
 380     &lt;VirtualHost 172.20.30.50&gt;<br />
 381     <indent>
 382         DocumentRoot /www/example4<br />
 383         ServerName www.example.edu<br />
 384     </indent>
 385     &lt;/VirtualHost&gt;<br />
 386                 <br />
 387     &lt;VirtualHost 172.20.30.60&gt;<br />
 388     <indent>
 389         DocumentRoot /www/example5<br />
 390         ServerName www.example.gov<br />
 391     </indent>
 392     &lt;/VirtualHost&gt;
 393     </example>
 394
 395         </section>
 396
 397     <section id="proxy"><title>Utilisation simultanée de
 398     <code>Virtual_host</code> et de mod_proxy</title>
 399
 400     <p>L'exemple suivant montre comment une machine peut mandater
 401     un serveur virtuel fonctionnant sur le serveur d'une autre machine.
 402     Dans cet exemple, un serveur virtuel de même nom est configuré sur
 403     une machine à l'adresse <code>192.168.111.2</code>. La directive
 404     <directive module="mod_proxy">ProxyPreserveHost On</directive> est
 405     employée pour permette au nom de domaine d'être préservé lors du
 406     transfert, au cas où plusieurs noms de domaines cohabitent sur
 407     une même machine.</p>
 408
 409     <example>
 410     &lt;VirtualHost *:*&gt;<br />
 411         ProxyPreserveHost On<br />
 412         ProxyPass / http://192.168.111.2<br />
 413         ProxyPassReverse / http://192.168.111.2/<br />
 414         ServerName hostname.example.com<br />
 415     &lt;/VirtualHost&gt;
 416     </example>
 417
 418     </section>
 419
 420     <section id="default"><title>Utilisation de serveurs virtuels
 421     <code>_default_</code></title>
 422
 423     <section id="defaultallports"><title>Serveurs virtuels
 424     <code>_default_</code> pour tous les ports</title>
 425
 426     <p>Exemple de capture de <em>toutes</em> les requêtes émanant
 427     d'adresses IP ou de ports non connus, <em>c'est-à-dire</em>, d'un
 428     couple adresse/port non traité par aucun autre serveur virtuel.</p>
 429
 430     <example>
 431     <title>Configuration du serveur</title>
 432
 433     &lt;VirtualHost _default_:*&gt;<br />
 434     <indent>
 435         DocumentRoot /www/default<br />
 436     </indent>
 437     &lt;/VirtualHost&gt;
 438     </example>
 439
 440     <p>L'utilisation d'un tel serveur virtuel avec un joker pour le
 441     port empêche de manière efficace qu'une requête n'atteigne le
 442     serveur principal.</p>
 443
 444     <p>Un serveur virtuel par défaut ne servira jamais une requête
 445     qui est envoyée vers un couple adresse/port utilisée par un
 446     serveur virtuel par nom. Si la requête contient un en-tête
 447     <code>Host:</code> inconnu, ou si celui-ci est absent, elle
 448     sera toujours servie par le serveur virtuel primaire par nom
 449     (celui correspondant à ce couple adresse/port trouvé en premier
 450     dans le fichier de configuration).</p>
 451
 452     <p>Vous pouvez utiliser une directive
 453     <directive module="mod_alias">AliasMatch</directive> ou
 454     <directive module="mod_rewrite">RewriteRule</directive> afin de
 455     réécrire une requête pour une unique page d'information (ou pour
 456     un script).</p>
 457     </section>
 458
 459     <section id="defaultdifferentports"><title>Serveurs virtuels
 460     <code>_default_</code> pour des ports différents</title>
 461
 462     <p>La configuration est similaire à l'exemple précédent, mais
 463     le serveur écoute sur plusieurs ports et un second serveur virtuel
 464     <code>_default_</code> pour le port 80 est ajouté.</p>
 465
 466     <example>
 467     <title>Configuration du serveur</title>
 468
 469     &lt;VirtualHost _default_:80&gt;<br />
 470     <indent>
 471         DocumentRoot /www/default80<br />
 472         # ...<br />
 473     </indent>
 474     &lt;/VirtualHost&gt;<br />
 475                 <br />
 476     &lt;VirtualHost _default_:*&gt;<br />
 477     <indent>
 478         DocumentRoot /www/default<br />
 479         # ...<br />
 480     </indent>
 481     &lt;/VirtualHost&gt;
 482     </example>
 483
 484     <p>Le serveur virtuel par défaut défini pour le port 80 (il doit
 485     impérativement être placé avant un autre serveur virtuel par
 486     défaut traitant tous les ports grâce au joker *) capture toutes
 487     les requêtes envoyées sur une adresse IP non spécifiée. Le
 488     serveur principal n'est jamais utilisé pour servir une requête.</p>
 489     </section>
 490
 491     <section id="defaultoneport"><title>Serveurs virtuels
 492     <code>_default_</code> pour un seul port</title>
 493
 494     <p>Nous voulons créer un serveur virtuel par défaut seulement
 495     pour le port 80.</p>
 496
 497     <example>
 498     <title>Configuration du serveur</title>
 499
 500     &lt;VirtualHost _default_:80&gt;<br />
 501     DocumentRoot /www/default<br />
 502     ...<br />
 503     &lt;/VirtualHost&gt;
 504     </example>
 505
 506     <p>Une requête vers une adresse non spécifiée sur le port 80
 507     sera servie par le serveur virtuel par défaut, et toute autre
 508     requête vers une adresse et un port non spécifiés sera servie
 509     par le serveur principal.</p>
 510
 511     <p>L'utilisation du caractère générique <code>*</code> dans la
 512     déclaration d'un serveur virtuel l'emporte sur
 513     <code>_default_</code>.</p>
 514     </section>
 515
 516         </section>
 517
 518         <section id="migrate"><title>Migration d'un serveur virtuel
 519         par nom en un serveur virtuel par IP</title>
 520
 521     <p>Le serveur virtuel par nom avec le nom de domaine
 522     <code>www.example.org</code> (de notre <a href="#name">exemple
 523     par nom</a>) devrait obtenir sa propre adresse IP. Pendant la
 524     phase de migration, il est possible d'éviter les problèmes avec
 525     les noms de serveurs et autres serveurs mandataires qui mémorisent
 526     les vielles adresses IP pour les serveurs virtuels par nom.<br />
 527     La solution est simple, car il suffit d'ajouter la nouvelle
 528     adresse IP (<code>172.20.30.50</code>) dans la directive
 529     <code>VirtualHost</code>.</p>
 530
 531     <example>
 532     <title>Configuration du serveur</title>
 533
 534     Listen 80<br />
 535     ServerName www.example.com<br />
 536     DocumentRoot /www/example.com<br />
 537                 <br />
 538     &lt;VirtualHost 172.20.30.40 172.20.30.50&gt;<br />
 539     <indent>
 540         DocumentRoot /www/example.org<br />
 541         ServerName www.example.org<br />
 542         # ...<br />
 543     </indent>
 544     &lt;/VirtualHost&gt;<br />
 545                 <br />
 546     &lt;VirtualHost 172.20.30.40&gt;<br />
 547     <indent>
 548         DocumentRoot /www/example.net<br />
 549         ServerName www.example.net<br />
 550         ServerAlias *.example.net<br />
 551         # ...<br />
 552     </indent>
 553     &lt;/VirtualHost&gt;
 554     </example>
 555
 556     <p>Le serveur virtuel peut maintenant être joint par la nouvelle
 557     adresse (comme un serveur virtuel par IP) et par l'ancienne
 558     adresse (comme un serveur virtuel par nom).</p>
 559
 560         </section>
 561
 562     <section id="serverpath"><title>Utilisation de la directive
 563     <code>ServerPath</code></title>
 564
 565     <p>Dans le cas où vous disposez de deux serveurs virtuels par nom,
 566     le client doit transmettre un en-tête <code>Host:</code> correct
 567     pour déterminer le serveur concerné. Les vieux clients HTTP/1.0
 568     n'envoient pas un tel en-tête et Apache n'a aucun indice pour
 569     connaître le serveur virtuel devant être joint (il sert la
 570     requête à partir d'un serveur virtuel primaire). Dans un soucis
 571     de préserver la compatibilité descendante, il suffit de créer
 572     un serveur virtuel primaire chargé de retourner une page contenant
 573     des liens dont les URLs auront un préfixe identifiant les serveurs
 574     virtuels par nom.</p>
 575
 576     <example>
 577     <title>Configuration du serveur</title>
 578
 579     &lt;VirtualHost 172.20.30.40&gt;<br />
 580     <indent>
 581         # Serveur virtuel primaire<br />
 582         DocumentRoot /www/subdomain<br />
 583         RewriteEngine On<br />
 584         RewriteRule ^/.* /www/subdomain/index.html<br />
 585         # ...<br />
 586     </indent>
 587     &lt;/VirtualHost&gt;<br />
 588                 <br />
 589     &lt;VirtualHost 172.20.30.40&gt;<br />
 590     DocumentRoot /www/subdomain/sub1<br />
 591     <indent>
 592         ServerName www.sub1.domain.tld<br />
 593         ServerPath /sub1/<br />
 594         RewriteEngine On<br />
 595         RewriteRule ^(/sub1/.*) /www/subdomain$1<br />
 596         # ...<br />
 597     </indent>
 598     &lt;/VirtualHost&gt;<br />
 599                 <br />
 600     &lt;VirtualHost 172.20.30.40&gt;<br />
 601     <indent>
 602         DocumentRoot /www/subdomain/sub2<br />
 603         ServerName www.sub2.domain.tld<br />
 604         ServerPath /sub2/<br />
 605         RewriteEngine On<br />
 606         RewriteRule ^(/sub2/.*) /www/subdomain$1<br />
 607         # ...<br />
 608     </indent>
 609     &lt;/VirtualHost&gt;
 610     </example>
 611
 612     <p>À cause de la directive
 613     <directive module="core">ServerPath</directive>, une requête sur
 614     une URL <code>http://www.sub1.domain.tld/sub1/</code> est
 615     <em>toujours</em> servie par le serveur sub1-vhost.<br />
 616     Une requête sur une URL <code>http://www.sub1.domain.tld/</code> n'est
 617     servie par le serveur sub1-vhost que si le client envoie un en-tête
 618     <code>Host:</code> correct. Si aucun en-tête <code>Host:</code>
 619     n'est transmis, le serveur primaire sera utilisé.</p>
 620     <p>Notez qu'il y a une singularité&nbsp;: une requête sur
 621     <code>http://www.sub2.domain.tld/sub1/</code> est également servie
 622     par le serveur sub1-vhost si le client n'envoie pas d'en-tête
 623     <code>Host:</code>.</p>
 624     <p>Les directives <directive module="mod_rewrite">RewriteRule</directive>
 625     sont employées pour s'assurer que le client qui envoie un en-tête
 626     <code>Host:</code> correct puisse utiliser d'autres variantes d'URLs,
 627     <em>c'est-à-dire</em> avec ou sans préfixe d'URL.</p>
 628
 629         </section>
 630
 631 </manualpage>