core.html.fr 294 KB
Newer Older
powelld's avatar
powelld committed
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalName On|Off|DNS</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>UseCanonicalName Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Dans de nombreuses situations, Apache httpd doit construire une URL
    <em>auto-identifiante</em> -- c'est  dire une URL qui fait
    rfrence au serveur lui-mme. Avec <code>UseCanonicalName
    On</code>, Apache httpd va utiliser le nom d'hte et le port spcifis par
    la directive <code class="directive"><a href="#servername">ServerName</a></code> pour
    construire le nom canonique du serveur. Ce nom est utilis dans
    toutes les URLs auto-identifiantes, et affect aux variables
    <code>SERVER_NAME</code> et <code>SERVER_PORT</code> dans les
    programmes CGI.</p>

    <p>Avec <code>UseCanonicalName Off</code>, Apache httpd va construire ses
    URLs auto-identifiantes  l'aide du nom d'hte et du port fournis
    par le client, si ce dernier en a fourni un (dans la ngative,
    Apache utilisera le nom canonique, de la mme manire que
    ci-dessus). Ces valeurs sont les mmes que celles qui sont utilises
    pour implmenter les <a href="../vhosts/name-based.html">serveurs virtuels  base de
    nom</a>, et sont disponibles avec les mmes clients. De mme, les
    variables CGI <code>SERVER_NAME</code> et <code>SERVER_PORT</code>
    seront affectes des valeurs fournies par le client.</p>

    <p>Cette directive peut s'avrer utile, par exemple, sur un serveur
    intranet auquel les utilisateurs se connectent en utilisant des noms
    courts tels que <code>www</code>. Si les utilisateurs tapent un nom
    court suivi d'une URL qui fait rfrence  un rpertoire, comme
    <code>http://www/splat</code>, <em>sans le slash terminal</em>, vous
    remarquerez qu'Apache httpd va les rediriger vers
    <code>http://www.example.com/splat/</code>. Si vous avez activ
    l'authentification, ceci va obliger l'utilisateur  s'authentifier
    deux fois (une premire fois pour <code>www</code> et une seconde
    fois pour <code>www.example.com</code> -- voir <a href="http://wiki.apache.org/httpd/FAQ#Why_does_Apache_ask_for_my_password_twice_before_serving_a_file.3F">la
    foire aux questions sur ce sujet pour plus d'informations</a>).
    Par contre, si <code class="directive">UseCanonicalName</code> est dfinie 
    <code>Off</code>, Apache httpd redirigera l'utilisateur vers
    <code>http://www/splat/</code>.</p>

    <p>Pour l'hbergement virtuel en masse  base d'adresse IP, on
    utilise une troisime option, <code>UseCanonicalName
    DNS</code>, pour supporter les clients anciens qui ne
    fournissent pas d'en-tte <code>Host:</code>. Apache httpd effectue alors
    une recherche DNS inverse sur l'adresse IP du serveur auquel le
    client s'est connect afin de construire ses URLs
    auto-identifiantes.</p>

    <div class="warning"><h3>Avertissement</h3>
    <p>Les programmes CGI risquent d'tre perturbs par cette option
    s'ils tiennent compte de la variable <code>SERVER_NAME</code>. Le
    client est pratiquement libre de fournir la valeur qu'il veut comme
    nom d'hte. Mais si le programme CGI n'utilise
    <code>SERVER_NAME</code> que pour construire des URLs
    auto-identifiantes, il ne devrait pas y avoir de problme.</p>
    </div>

<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalphysicalport">UseCanonicalPhysicalPort</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="usecanonicalphysicalport" id="usecanonicalphysicalport">Directive</a> <a name="UseCanonicalPhysicalPort" id="UseCanonicalPhysicalPort">UseCanonicalPhysicalPort</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dfinit la manire dont le serveur
dtermine son propre port</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>UseCanonicalPhysicalPort On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>UseCanonicalPhysicalPort Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Dans de nombreuses situations, Apache httpd doit construire une URL
    <em>auto-identifiante</em> -- c'est  dire une URL qui fait
    rfrence au serveur lui-mme. Avec <code>UseCanonicalPhysicalPort
    On</code>, Apache httpd va fournir le numro de port physique rel utilis
    par la requte en tant que port potentiel, pour construire le port
    canonique afin que le serveur puisse alimenter la directive
    <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>. Avec
    <code>UseCanonicalPhysicalPort Off</code>, Apache httpd n'utilisera pas le
    numro de port physique rel, mais au contraire se rfrera aux
    informations de configuration pour construire un numro de port
    valide.</p>

    <div class="note"><h3>Note</h3>
    <p>L'ordre dans lequel s'effectue la recherche quand on utilise le
    port physique est le suivant :</p>
     <dl>
     <dt><code>UseCanonicalName On</code></dt>
     <dd>
     <ol>
      <li>Port indiqu dans <code class="directive"><a href="#servername">Servername</a></code></li>
      <li>Port physique</li>
      <li>Port par dfaut</li>
     </ol>
     </dd>
     <dt><code>UseCanonicalName Off | DNS</code></dt>
     <dd>
     <ol>
      <li>Port spcifi dans l'en-tte <code>Host:</code></li>
      <li>Port physique</li>
      <li>Port spcifi par <code class="directive"><a href="#servername">Servername</a></code></li>
      <li>Port par dfaut</li>
     </ol>
     </dd>
     </dl>

    <p>Avec <code>UseCanonicalPhysicalPort Off</code>, on reprend
    l'ordre ci-dessus en supprimant "Port physique".</p>
    </div>


<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code></li>
<li><code class="directive"><a href="#servername">ServerName</a></code></li>
<li><code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="virtualhost" id="virtualhost">Directive</a> <a name="VirtualHost" id="VirtualHost">&lt;VirtualHost&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent qu' un nom
d'hte spcifique ou  une adresse IP</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;VirtualHost
    <var>adresse IP</var>[:<var>port</var>] [<var>adresse
    IP</var>[:<var>port</var>]] ...&gt; ...
    &lt;/VirtualHost&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Les balises <code class="directive">&lt;VirtualHost&gt;</code> et
    <code>&lt;/VirtualHost&gt;</code> permettent de rassembler un groupe
    de directives qui ne s'appliquent qu' un serveur virtuel
    particulier. Toute directive autorise dans un contexte de serveur
    virtuel peut tre utilise. Lorsque le serveur reoit un requte
    pour un document hberg par un serveur virtuel particulier, il
    applique les directives de configuration rassembles dans la section
    <code class="directive">&lt;VirtualHost&gt;</code>. <var>adresse
    IP</var> peut tre une des entits suivantes, ventuellement suivies
    d'un caractre ':' et d'un numro de port (ou *) :</p>

    <ul>
      <li>L'adresse IP du serveur virtuel ;</li>

      <li>Un nom de domaine entirement qualifi correspondant 
      l'adresse IP du serveur virtuel (non recommand) ;</li>

      <li>Le caractre <code>*</code>, qui agit comme un
      caractre gnrique, et correspond  toute adresse IP.</li>

      <li>La chane <code>_default_</code>, dont la signification est
      identique  celle du caractre <code>*</code></li>

    </ul>

    <pre class="prettyprint lang-config">&lt;VirtualHost 10.1.2.3:80&gt;
  ServerAdmin webmaster@host.example.com
  DocumentRoot "/www/docs/host.example.com"
  ServerName host.example.com
  ErrorLog "logs/host.example.com-error_log"
  TransferLog "logs/host.example.com-access_log"
&lt;/VirtualHost&gt;</pre>



    <p>Les adresses IPv6 doivent tre entoures de crochets car dans le
    cas contraire, un ventuel port optionnel ne pourrait pas tre
    dtermin. Voici un exemple de serveur virtuel avec adresse IPv6
    :</p>

    <pre class="prettyprint lang-config">&lt;VirtualHost [2001:db8::a00:20ff:fea7:ccea]:80&gt;
  ServerAdmin webmaster@host.example.com
  DocumentRoot "/www/docs/host.example.com"
  ServerName host.example.com
  ErrorLog "logs/host.example.com-error_log"
  TransferLog "logs/host.example.com-access_log"
&lt;/VirtualHost&gt;</pre>


    <p>Chaque serveur virtuel doit correspondre  une adresse IP, un
    port ou un nom d'hte spcifique ; dans le premier cas, le serveur
    doit tre configur pour recevoir les paquets IP de plusieurs
    adresses (si le serveur n'a qu'une interface rseau, on peut
    utiliser  cet effet la commande <code>ifconfig alias</code> -- si
    votre systme d'exploitation le permet).</p>

    <div class="note"><h3>Note</h3>
    <p>L'utilisation de la directive <code class="directive">&lt;VirtualHost&gt;</code> n'affecte en rien les
    adresses IP sur lesquelles Apache httpd est en coute. Vous devez vous
    assurer que les adresses des serveurs virtuels sont bien incluses
    dans la liste des adresses prcises par la directive <code class="directive"><a href="../mod/mpm_common.html#listen">Listen</a></code>.</p>
    </div>
    
    <p>Tout bloc <code class="directive">&lt;VirtualHost&gt;</code> doit comporter une directive
    <code class="directive"><a href="#servername">ServerName</a></code>. Dans le cas
    contraire, le serveur virtuel hritera de la valeur de la directive
    <code class="directive"><a href="#servername">ServerName</a></code> issue de la
    configuration du serveur principal.</p>

    <p>A l'arrive d'une requte, le serveur tente de la
    faire prendre en compte par la section <code class="directive">&lt;VirtualHost&gt;</code> qui correspond le mieux en ne
    se basant que sur la paire adresse IP/port. Les chanes sans
    caractres gnriques l'emportent sur celles qui en contiennent. Si
    aucune correspondance du point de vue de l'adresse IP/port n'est
    trouve, c'est la configuration du serveur "principal" qui sera
    utilise.</p>
    
    <p>Si plusieurs serveurs virtuels correspondent du point de vue de
    l'adresse IP/port, le serveur slectionne celui qui correspond le
    mieux du point de vue du nom d'hte de la requte. Si aucune
    correspondance du point de vue du nom d'hte n'est trouve, c'est le
    premier serveur virtuel dont l'adresse IP/port correspond qui sera
    utilis. Par voie de consquence, le premier serveur virtuel
    comportant une certaine paire adresse IP/port est le serveur virtuel
    par dfaut pour cette paire adresse IP/port.</p>

    <div class="warning"><h3>Scurit</h3>
    <p>Voir le document sur les <a href="../misc/security_tips.html">conseils  propos de scurit</a>
    pour une description dtaille des raisons pour lesquelles la
    scurit de votre serveur pourrait tre compromise, si le rpertoire
    contenant les fichiers journaux est inscriptible par tout autre
    utilisateur que celui qui dmarre le serveur.</p>
    </div>

<h3>Voir aussi</h3>
<ul>
<li><a href="../vhosts/">Documentation des serveurs virtuels
du serveur HTTP Apache</a></li>
<li><a href="../dns-caveats.html">Problmes concernant le DNS et
le serveur HTTP Apache</a></li>
<li><a href="../bind.html">Dfinition des adresses et ports
qu'utilise le serveur HTTP Apache</a></li>
<li><a href="../sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la manire dont ces diffrentes sections se combinent
entre elles  la rception d'une requte</li>
</ul>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../de/mod/core.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="../en/mod/core.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../es/mod/core.html" hreflang="es" rel="alternate" title="Espaol">&nbsp;es&nbsp;</a> |
<a href="../fr/mod/core.html" title="Franais">&nbsp;fr&nbsp;</a> |
<a href="../ja/mod/core.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="../tr/mod/core.html" hreflang="tr" rel="alternate" title="Trke">&nbsp;tr&nbsp;</a></p>
</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>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/core.html';
(function(w, d) {
    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
        d.write('<div id="comments_thread"><\/div>');
        var s = d.createElement('script');
        s.type = 'text/javascript';
        s.async = true;
        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
    }
    else { 
        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
    }
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2017 The Apache Software Foundation.<br />Autoris 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="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[//><!--
if (typeof(prettyPrint) !== 'undefined') {
    prettyPrint();
}
//--><!]]></script>
</body></html>