granicus.if.org Git - apache/blob - docs/manual/vhosts/mass.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
   4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>Hébergement virtuel de masse configuré dynamiquement - Serveur Apache HTTP Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body id="manual-page"><div id="page-header">
  19 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p>
  20 <p class="apache">Serveur Apache HTTP Version 2.5</p>
  21 <img alt="" src="../images/feather.png" /></div>
  22 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  23 <div id="path">
  24 <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/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <a href="./">Hébergement virtuel</a></div><div id="page-content"><div id="preamble"><h1>Hébergement virtuel de masse configuré dynamiquement</h1>
  25 <div class="toplang">
  26 <p><span>Langues Disponibles: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  27 <a href="../fr/vhosts/mass.html" title="Français">&nbsp;fr&nbsp;</a> |
  28 <a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29 <a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  30 </div>
  31
  32
  33     <p>Ce document propose une méthode performante pour servir un nombre
  34     quelconque d'hôtes virtuels avec le serveur HTTP Apache. Un <a href="../rewrite/vhosts.html">document séparé</a> décrit comment
  35     utiliser <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> pour gérer l'hébergement
  36     virtuel de masse dynamique.
  37     </p>
  38
  39 </div>
  40 <div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#motivation">A qui ce document est-il destiné ?</a></li>
  41 <li><img alt="" src="../images/down.gif" /> <a href="#overview">Vue d'ensemble</a></li>
  42 <li><img alt="" src="../images/down.gif" /> <a href="#simple">Hébergement virtuel
  43 dynamique avec mod_vhost_alias</a></li>
  44 <li><img alt="" src="../images/down.gif" /> <a href="#homepages">Système de serveurs virtuels dynamiques
  45 simplifié</a></li>
  46 <li><img alt="" src="../images/down.gif" /> <a href="#combinations">Utiliser plusieurs systèmes
  47 d'hébergement virtuel sur le même serveur</a></li>
  48 <li><img alt="" src="../images/down.gif" /> <a href="#ipbased">Pour un hébergement virtuel par IP plus
  49 efficace</a></li>
  50 <li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Hébergement virtuel de masse avec
  51 mod_rewrite</a></li>
  52 <li><img alt="" src="../images/down.gif" /> <a href="#macro">Hébergement virtuel en masse avec mod_macro</a></li>
  53 </ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  54 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  55 <div class="section">
  56 <h2><a name="motivation" id="motivation">A qui ce document est-il destiné ?</a><a title="Lien permanent" href="#motivation" class="permalink">&para;</a></h2>
  57
  58     <p>Les techniques décrites ici vous concernent si votre
  59     <code>httpd.conf</code> contient de nombreuses sections
  60     <code>&lt;VirtualHost&gt;</code> très semblables,
  61     dans le style :</p>
  62
  63 <pre class="prettyprint lang-config">&lt;VirtualHost 111.22.33.44&gt;
  64     ServerName                 customer-1.example.com
  65     DocumentRoot        "/www/hosts/customer-1.example.com/docs"
  66     ScriptAlias  "/cgi-bin/"
  67     "/www/hosts/customer-1.example.com/cgi-bin"
  68 &lt;/VirtualHost&gt;
  69
  70 &lt;VirtualHost 111.22.33.44&gt;
  71     ServerName                 customer-2.example.com
  72     DocumentRoot        "/www/hosts/customer-2.example.com/docs"
  73     ScriptAlias  "/cgi-bin/" "/www/hosts/customer-2.example.com/cgi-bin"
  74 &lt;/VirtualHost&gt;
  75
  76 &lt;VirtualHost 111.22.33.44&gt;
  77     ServerName                 customer-N.example.com
  78     DocumentRoot        "/www/hosts/customer-N.example.com/docs"
  79     ScriptAlias  "/cgi-bin/" "/www/hosts/customer-N.example.com/cgi-bin"
  80 &lt;/VirtualHost&gt;</pre>
  81
  82
  83     <p>Nous voulons remplacer toutes les configurations
  84     <code>&lt;VirtualHost&gt;</code> par un mécanisme qui les génère
  85     dynamiquement. Ceci présente certains avantages :</p>
  86
  87     <ol>
  88       <li>Votre fichier de configuration est plus petit, ainsi Apache
  89       démarre plus rapidement et consomme moins de mémoire. Et ce qui
  90       est peut-être le plus important, le fichier de configuration plus
  91       petit est plus facile à maintenir, et le risque d'erreurs en est
  92       diminué d'autant.
  93       </li>
  94
  95       <li>Pour ajouter des serveurs virtuels, il suffit de créer les
  96       répertoires appropriés dans le système de fichiers et les entrées
  97       dans le DNS - il n'est plus nécessaire de reconfigurer ou de
  98       redémarrer Apache.</li>
  99     </ol>
 100
 101     <p>Le principal désavantage réside dans le fait que vous ne pouvez
 102     pas définir un fichier journal différent pour chaque serveur
 103     virtuel. De toute façon, ce serait une mauvaise idée si vous avez de
 104     nombreux serveurs virtuels, car cela nécessiterait un <a href="fd-limits.html">nombre important de descripteurs de
 105     fichier</a>. Il est préférable de rediriger <a href="../logs.html#piped">les journaux via un pipe ou
 106     une file fifo</a> vers un
 107     programme, et faire en sorte que ce dernier éclate les journaux
 108     en un journal par serveur virtuel. L'utilitaire <a href="../programs/split-logfile.html">split-logfile</a>
 109     constitue un exemple de ce traitement.</p>
 110
 111 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 112 <div class="section">
 113 <h2><a name="overview" id="overview">Vue d'ensemble</a><a title="Lien permanent" href="#overview" class="permalink">&para;</a></h2>
 114
 115     <p>Un serveur virtuel peut être défini par deux informations : son
 116     adresse IP, et le contenu de l'en-tête <code>Host:</code> de la
 117     requête HTTP. La technique d'hébergement virtuel dynamique de masse
 118     utilisée ici consiste à insérer automatiquement ces informations
 119     dans le chemin du fichier à utiliser pour répondre à la requête. On
 120     peut y parvenir assez facilement en utilisant
 121     <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code> avec Apache httpd, mais on peut aussi
 122     <a href="../rewrite/vhosts.html">utiliser mod_rewrite</a>. </p>
 123     <p>Par défaut, ces deux modules
 124     sont désactivés ; vous devez activer l'un d'eux lors de la
 125     compilation et de la configuration d'Apache httpd si vous voulez utiliser
 126     cette technique.</p>
 127
 128     <p>Certains paramètres doivent être extraits de la requête pour que le serveur
 129     dynamique se présente comme un serveur dynamique normal. Le plus
 130     important est le nom du serveur, que le serveur utilise pour générer des
 131     URLs d'auto-référencement, etc... Il est défini via la directive
 132     <code>ServerName</code>, et les CGIs peuvent s'y référer via la
 133     variable d'environnement <code>SERVER_NAME</code>. Sa véritable
 134     valeur utilisée à l'exécution est contrôlée par la définition de la
 135     directive
 136     <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code>. Avec
 137     <code>UseCanonicalName Off</code>, le nom du serveur correspond au
 138     contenu de l'en-tête <code>Host:</code> de la requête. Avec
 139     <code>UseCanonicalName DNS</code>, il est extrait d'une recherche
 140     DNS inverse sur l'adresse IP du serveur virtuel. La première
 141     configuration est utilisée pour l'hébergement virtuel dynamique par
 142     nom, et la deuxième pour l'hébergement virtuel dynamique par IP. Si
 143     httpd ne peut pas déterminer le nom du serveur, soit parce qu'il
 144     n'y a pas d'en-tête <code>Host:</code>, soit parce que la recherche
 145     DNS a échoué, il prend en compte la valeur définie par la directive
 146     <code>ServerName</code>.</p>
 147
 148     <p>L'autre paramètre à extraire est la racine des documents (définie
 149     via la directive <code>DocumentRoot</code> et disponible pour les
 150     scripts CGI via la variable d'environnement <code>DOCUMENT_ROOT</code>).
 151     Dans une configuration classique, il est utilisé par le module core
 152     pour faire correspondre les URIs aux noms de fichiers, mais lorsque
 153     la configuration du serveur comporte des serveurs virtuels, ce
 154     traitement doit être pris en charge par un autre module (soit
 155     <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>, soit <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>), qui
 156     utilise un méthode de correspondance différente. Aucun de ces
 157     modules ne se chargeant de définir la variable d'environnement
 158     <code>DOCUMENT_ROOT</code>, si des CGIs ou des documents SSI
 159     doivent en faire usage, ils obtiendront une valeur erronée.</p>
 160
 161 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 162 <div class="section">
 163 <h2><a name="simple" id="simple">Hébergement virtuel
 164 dynamique avec mod_vhost_alias</a><a title="Lien permanent" href="#simple" class="permalink">&para;</a></h2>
 165
 166     <p>Cet extrait de fichier <code>httpd.conf</code> implémente
 167     l'hébergement virtuel décrit dans la section <a href="#motivation">À qui ce document est-il destiné ?</a> ci-dessus
 168     en utilisant <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</p>
 169
 170 <pre class="prettyprint lang-config"># extrait le nom du serveur de l'en-tête Host:
 171 UseCanonicalName Off
 172
 173 # ce format de journal peut être éclaté en journaux par serveur virtuel
 174 # à l'aide du premier champ via l'utilitaire split-logfile
 175 LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
 176 CustomLog "logs/access_log" vcommon
 177
 178 # inclut le nom du serveur dans les noms de fichiers ressources
 179 # nécessaires aux traitements des requêtes
 180 VirtualDocumentRoot "/www/hosts/%0/docs"
 181 VirtualScriptAlias  "/www/hosts/%0/cgi-bin"</pre>
 182
 183
 184     <p>Pour changer cette configuration en solution de serveur virtuel
 185     par IP, il suffit de remplacer <code>UseCanonicalName
 186     Off</code> par <code>UseCanonicalName DNS</code>. Le nom du serveur
 187     inséré dans le nom de fichier sera alors déduit de l'adresse IP du
 188     serveur virtuel. La variable <code>%0</code> fait référence au nom
 189     de serveur de la requête, tel qu'il est indiqué dans l'en-tête
 190     <code>Host:</code>.</p>
 191
 192     <p>Voir la documentation du module <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>
 193     pour d'avantages d'exemples d'utilisation.</p>
 194
 195 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 196 <div class="section">
 197 <h2><a name="homepages" id="homepages">Système de serveurs virtuels dynamiques
 198 simplifié</a><a title="Lien permanent" href="#homepages" class="permalink">&para;</a></h2>
 199
 200     <p>Il s'agit d'une adaptation du système ci-dessus, ajusté pour un
 201     serveur d'hébergement web de FAI. Grâce à la variable
 202     <code>%2</code>, on peut extraire des sous-chaînes de caractères du
 203     nom du serveur pour les utiliser dans le nom de fichier afin, par
 204     exemple, de définir <code>/home/user/www</code> comme emplacement des
 205     documents pour <code>www.user.example.com</code>. Un seul répertoire
 206     <code>cgi-bin</code> suffit pour l'ensemble des
 207     serveurs virtuels.</p>
 208
 209 <pre class="prettyprint lang-config">UseCanonicalName Off
 210
 211 LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
 212 CustomLog "logs/access_log" vcommon
 213
 214 # insertion d'une partie du nom du serveur dans les noms de fichiers
 215 VirtualDocumentRoot "/home/%2/www"
 216
 217 # répertoire cgi-bin unique
 218 ScriptAlias  "/cgi-bin/"  "/www/std-cgi/"</pre>
 219
 220
 221     <p>Vous trouverez des exemples plus élaborés d'utilisation de la
 222     directive <code>VirtualDocumentRoot</code> dans la documentation du
 223     module <code class="module"><a href="../mod/mod_vhost_alias.html">mod_vhost_alias</a></code>.</p>
 224
 225 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 226 <div class="section">
 227 <h2><a name="combinations" id="combinations">Utiliser plusieurs systèmes
 228 d'hébergement virtuel sur le même serveur</a><a title="Lien permanent" href="#combinations" class="permalink">&para;</a></h2>
 229
 230     <p>Moyennant une configuration un peu plus compliquée, vous pouvez
 231     contrôler la portée des différentes configurations d'hébergement
 232     virtuel à l'aide des directives <code>&lt;VirtualHost&gt;</code>
 233     normales de httpd. Par exemple, on peut associer une adresse IP pour
 234     les pages d'accueil des clients en général, et une autre pour les
 235     clients commerciaux avec la configuration suivante. Cette
 236     configuration peut être combinée avec les sections
 237     <code>&lt;VirtualHost&gt;</code> conventionnelles, comme indiqué
 238     plus loin.</p>
 239
 240 <pre class="prettyprint lang-config">UseCanonicalName Off
 241
 242 LogFormat "%V %h %l %u %t \"%r\" %s %b" vcommon
 243
 244 &lt;Directory "/www/commercial"&gt;
 245     Options FollowSymLinks
 246     AllowOverride All
 247 &lt;/Directory&gt;
 248
 249 &lt;Directory "/www/homepages"&gt;
 250     Options FollowSymLinks
 251     AllowOverride None
 252 &lt;/Directory&gt;
 253
 254 &lt;VirtualHost 111.22.33.44&gt;
 255     ServerName www.commercial.example.com
 256
 257     CustomLog "logs/access_log.commercial" vcommon
 258
 259     VirtualDocumentRoot "/www/commercial/%0/docs"
 260     VirtualScriptAlias  "/www/commercial/%0/cgi-bin"
 261 &lt;/VirtualHost&gt;
 262
 263 &lt;VirtualHost 111.22.33.45&gt;
 264     ServerName www.homepages.example.com
 265
 266     CustomLog "logs/access_log.homepages" vcommon
 267
 268     VirtualDocumentRoot "/www/homepages/%0/docs"
 269     ScriptAlias         "/cgi-bin/" "/www/std-cgi/"
 270 &lt;/VirtualHost&gt;</pre>
 271
 272
 273 <div class="note">
 274         <h3>Note</h3>
 275         <p>Si le premier bloc VirtualHost ne comporte <em>pas</em> de
 276         directive <code class="directive"><a href="../mod/core.html#servername">ServerName</a></code>, c'est
 277         le nom issu d'une recherche DNS inverse à partir de l'adresse IP
 278         du serveur virtuel qui sera utilisé. Si ce nom ne correspond pas
 279         à celui que vous voulez utiliser, vous pouvez ajouter une entrée
 280         de remplacement (par exemple <code>ServerName
 281         none.example.com</code>) pour éviter ce comportement.</p>
 282 </div>
 283
 284 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 285 <div class="section">
 286 <h2><a name="ipbased" id="ipbased">Pour un hébergement virtuel par IP plus
 287 efficace</a><a title="Lien permanent" href="#ipbased" class="permalink">&para;</a></h2>
 288
 289     <p>Les changements de configuration suggérés pour transformer <a href="#simple">le premier exemple</a> en hébergement virtuel par IP
 290     conduisent à une configuration peu efficace. Chaque requête
 291     nécessite une nouvelle recherche DNS. Pour éviter cette surcharge de
 292     travail, le système de fichiers peut être organisé pour correspondre
 293     aux adresses IP, plutôt qu'aux noms de serveurs, supprimant par
 294     la-même la nécessité d'une recherche DNS. La journalisation doit
 295     aussi être adaptée pour fonctionner sur un tel système.</p>
 296
 297 <pre class="prettyprint lang-config"># obtention du nom du serveur par recherche DNS inverse
 298 # sur l'adresse IP
 299 UseCanonicalName DNS
 300
 301 # insertion de l'adresse IP dans les journaux afin de pouvoir les
 302 # éclater
 303 LogFormat "%A %h %l %u %t \"%r\" %s %b" vcommon
 304 CustomLog "logs/access_log" vcommon
 305
 306 # insertion de l'adresse IP dans les noms de fichiers
 307 VirtualDocumentRootIP "/www/hosts/%0/docs"
 308 VirtualScriptAliasIP  "/www/hosts/%0/cgi-bin"</pre>
 309
 310
 311 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 312 <div class="section">
 313 <h2><a name="rewrite" id="rewrite">Hébergement virtuel de masse avec
 314 mod_rewrite</a><a title="Lien permanent" href="#rewrite" class="permalink">&para;</a></h2>
 315
 316 <p>
 317 L'hébergement virtuel de masse peut aussi être effectué en utilisant
 318 <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>, soit à l'aide de simples directives <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, soit en utilisant des
 319 techniques plus compliquées comme le stockage externe des définitions
 320 des serveurs virtuels, ces dernières étant accessibles via des
 321 directives <code class="directive"><a href="../mod/mod_rewrite.html#rewritemap">RewriteMap</a></code>. Ces
 322 techniques sont décrites dans la <a href="../rewrite/vhosts.html">documentation sur la réécriture</a>.</p>
 323
 324 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 325 <div class="section">
 326 <h2><a name="macro" id="macro">Hébergement virtuel en masse avec mod_macro</a><a title="Lien permanent" href="#macro" class="permalink">&para;</a></h2>
 327
 328 <p>Une autre option pour générer dynamiquement des serveurs virtuels :
 329 mod_macro ; ce module permet de créer un modèle de serveur virtuel que
 330 vous pourrez invoquer pour des noms d'hôtes multiples. La section
 331 <strong>Usage</strong> de la documentation du module présente un exemple qui
 332 illustre cette méthode.
 333 </p>
 334 </div></div>
 335 <div class="bottomlang">
 336 <p><span>Langues Disponibles: </span><a href="../en/vhosts/mass.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 337 <a href="../fr/vhosts/mass.html" title="Français">&nbsp;fr&nbsp;</a> |
 338 <a href="../ko/vhosts/mass.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 339 <a href="../tr/vhosts/mass.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 340 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
 341 <script type="text/javascript"><!--//--><![CDATA[//><!--
 342 var comments_shortname = 'httpd';
 343 var comments_identifier = 'http://httpd.apache.org/docs/trunk/vhosts/mass.html';
 344 (function(w, d) {
 345     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
 346         d.write('<div id="comments_thread"><\/div>');
 347         var s = d.createElement('script');
 348         s.type = 'text/javascript';
 349         s.async = true;
 350         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
 351         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
 352     }
 353     else {
 354         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 355     }
 356 })(window, document);
 357 //--><!]]></script></div><div id="footer">
 358 <p class="apache">Copyright 2018 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 359 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 360 if (typeof(prettyPrint) !== 'undefined') {
 361     prettyPrint();
 362 }
 363 //--><!]]></script>
 364 </body></html>