blob: 155a4273e60c3d113dfff6478c0fa576e6ef19c9 [file]
<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Ecoute s&eacute;lective - Serveur HTTP Apache Version 2.5</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 rel="stylesheet" type="text/css" href="./style/css/prettify.css">
<script src="./style/scripts/prettify.min.js">
</script>
<link href="./images/favicon.png" rel="shortcut icon"></head>
<body id="manual-page"><div id="page-header">
<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.5</p>
<img alt="" src="./images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Ecoute s&eacute;lective</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="./es/bind.html" hreflang="es" rel="alternate" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="./fr/bind.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="./pt-br/bind.html" hreflang="pt-br" rel="alternate" title="Portugu&ecirc;s (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a></p>
</div>
<p>Configuration du serveur HTTP Apache pour l'&eacute;coute
sur un port et une adresse IP sp&eacute;cifiques.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif"> <a href="#overview">Vue d'ensemble</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#reload">Changer la configuration de l'&eacute;coute au red&eacute;marrage</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#ipv6">Remarques sp&eacute;cifiques &agrave; IPv6</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#protocol">Sp&eacute;cification du protocole avec Listen</a></li>
<li><img alt="" src="./images/down.gif"> <a href="#virtualhost">Qu'en est-il avec les serveurs virtuels</a></li>
</ul><h3>Voir aussi</h3><ul class="seealso"><li><a href="vhosts/">Serveurs virtuels</a></li><li><a href="dns-caveats.html">Probl&egrave;mes li&eacute;s au DNS</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="overview">Vue d'ensemble <a title="Lien permanent" href="#overview" class="permalink">&para;</a></h2>
<table class="related"><tr><th>Modules Apparent&eacute;s</th><th>Directives Apparent&eacute;es</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mpm_common.html">mpm_common</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li><li><code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code></li></ul></td></tr></table>
<p>Au d&eacute;marrage de httpd, un port et une adresse lui sont associ&eacute;s sur
l'h&ocirc;te local et le serveur se met en attente de l'arriv&eacute;e d'une requ&ecirc;te.
Par d&eacute;faut, le serveur &eacute;coute toutes les adresses de l'h&ocirc;te local.
Cependant, il est possible de lui pr&eacute;ciser des ports et des adresses
sp&eacute;cifiques &agrave; &eacute;couter, ou une combinaison des deux. Tout ceci est souvent
associ&eacute; avec la fonctionnalit&eacute; des <a href="vhosts/">serveurs virtuels</a>
qui d&eacute;termine la mani&egrave;re dont <code>httpd</code> r&eacute;pond aux diff&eacute;rents
ports, noms d'h&ocirc;tes et adresses IP.</p>
<p>La directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> permet
d'indiquer au serveur qu'il ne doit accepter des requ&ecirc;tes que sur le(s)
port(s) sp&eacute;cifi&eacute;s ou une combinaison adresse/port. Si seul un num&eacute;ro de port
est sp&eacute;cifi&eacute; dans la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, le serveur se met &agrave; l'&eacute;coute sur ce
port et sur toutes les interfaces r&eacute;seau. Si une adresse IP est sp&eacute;cifi&eacute;e
en plus du port, le serveur va &eacute;couter sur ce port et uniquement sur
l'interface r&eacute;seau correspondante. On peut utiliser plusieurs directives
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> pour sp&eacute;cifier plusieurs
adresses et ports &agrave; &eacute;couter. Le serveur r&eacute;pondra alors aux requ&ecirc;tes sur tous
les ports et adresses sp&eacute;cifi&eacute;s.</p>
<p>Par exemple, pour faire en sorte que le serveur accepte des connexions
sur les ports 80 et 8000 et sur toutes les interfaces, utilisez :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80
Listen 8000</pre>
</div>
<p>Pour faire en sorte que le serveur accepte des connexions sur le port 80
pour une interface, et sur le port 8000 pour une
autre interface, utilisez :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.0.2.1:80
Listen 192.0.2.5:8000</pre>
</div>
<p>Les adresses IPv6 doivent &ecirc;tre mises entre crochets, comme dans
l'exemple suivant :</p>
<div class="example"><pre class="prettyprint lang-config">Listen [2001:db8::a00:20ff:fea7:ccea]:80</pre>
</div>
<div class="warning"><p>Des directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>
imbriqu&eacute;es provoqueront une erreur fatale qui
emp&ecirc;chera le serveur de d&eacute;marrer.</p>
<div class="example"><p><code>
(48)Address already in use: make_sock: could not bind to address [::]:80
</code></p></div>
<p>Voir <a href="https://cwiki.apache.org/confluence/display/httpd/CouldNotBindToAddress">cette
discussion dans le wiki</a> pour plus de d&eacute;tails &agrave; propos de la r&eacute;solution
de ce probl&egrave;me.</p>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="reload">Changer la configuration de l'&eacute;coute au red&eacute;marrage <a title="Lien permanent" href="#reload" class="permalink">&para;</a></h2>
<p>Lorsque httpd est red&eacute;marr&eacute;, certaines remarques sont &agrave; prendre en compte
quant aux modifications apport&eacute;es aux directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>. Au cours du red&eacute;marrage, httpd
conserve la liaison avec les ports de la configuration pr&eacute;c&eacute;dente afin
d'&eacute;viter l'obtention d'un message d'erreur "Connection refused" lors d'une
tentative ult&eacute;rieure de connexion au serveur. Si les modifications apport&eacute;es au jeu de
directives <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> utilis&eacute; entrent
en conflit avec ce dernier, le serveur refusera de red&eacute;marrer.</p>
<p>Par exemple, modifier la configuration suivante :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 127.0.0.1:80</pre>
</div>
<p>pour utiliser la suivante pourra &eacute;chouer car &eacute;couter le port 80 sur
toutes les adresses IP entre en conflit avec une &eacute;coute s&eacute;lective du port 80
sur la seule adresse IP 127.0.0.1.</p>
<div class="example"><pre class="prettyprint lang-config">Listen 80</pre>
</div>
<p>Pour qu'une telle modification de configuration soit prise en compte avec
succ&egrave;s, il est n&eacute;cessaire d'arr&ecirc;ter, puis de d&eacute;marrer le serveur.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="ipv6">Remarques sp&eacute;cifiques &agrave; IPv6 <a title="Lien permanent" href="#ipv6" class="permalink">&para;</a></h2>
<p>Un nombre croissant de plateformes impl&eacute;mentent IPv6, et
<a class="glossarylink" href="./glossary.html#apr" title="voir glossaire">APR</a> supporte IPv6 sur la plupart d'entre elles,
ce qui permet &agrave; httpd d'allouer des points de connexion (sockets) IPv6
et de traiter des requ&ecirc;tes envoy&eacute;es sur IPv6.</p>
<p>Les administrateurs de httpd doivent se pr&eacute;occuper de la possibilit&eacute;
pour un point de connexion IPv6 de traiter &agrave; la fois des connexions IPv4
et des connexions IPv6.
Le traitement de connexions IPv4 avec un point de connexion IPv6 utilise
des adresses IPv6 traduites en IPv4 qui sont autoris&eacute;es par d&eacute;faut sur la
plupart des plateformes, mais sont interdites par d&eacute;faut sous FreeBSD, NetBSD,
et OpenBSD, afin de respecter la politique de s&eacute;curit&eacute; du syst&egrave;me sur ces plateformes.
Sur les syst&egrave;mes o&ugrave; ces adresses sont interdites par d&eacute;faut, un
param&egrave;tre sp&eacute;cial du script <code class="program"><a href="./programs/configure.html">configure</a></code> permet de modifier
ce comportement pour httpd.</p>
<p>En revanche, sur certaines plateformes comme Linux et Tru64, la
<strong>seule</strong> mani&egrave;re de g&eacute;rer &agrave; la fois IPv6 et IPv4 passe
par l'utilisation d'adresses traduites. Si vous voulez que <code>httpd</code> g&egrave;re
des connexions IPv4 et IPv6 avec un minimum de points de connexion,
ce qui n&eacute;cessite l'utilisation d'adresses IPv6 traduites en IPv4,
utilisez l'option <code>--enable-v4-mapped</code> du script <code class="program"><a href="./programs/configure.html">configure</a></code>.</p>
<p>L'option <code>--enable-v4-mapped</code> est utilis&eacute;e par d&eacute;faut sur
toutes les plateformes sauf FreeBSD, NetBSD, et OpenBSD&nbsp;;
votre httpd a donc probablement &eacute;t&eacute; construit avec cette option.</p>
<p>Si vous souhaitez que httpd ne g&egrave;re que des connexions IPv4, sans se
soucier de ce que votre plateforme et APR supportent, sp&eacute;cifiez une adresse
IPv4 dans toutes les directives
<code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code>, comme dans l'exemple
suivant :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 0.0.0.0:80
Listen 192.0.2.1:80</pre>
</div>
<p>Si votre plateforme le supporte et si vous souhaitez que httpd g&egrave;re
des connexions IPv4 et IPv6 sur des points de connexion s&eacute;par&eacute;s
(c'est &agrave; dire d&eacute;sactiver la traduction des adresses IPv6 au format IPv4),
utilisez l'option <code>--disable-v4-mapped</code> du script
<code class="program"><a href="./programs/configure.html">configure</a></code>. <code>--disable-v4-mapped</code> est
utilis&eacute;e par d&eacute;faut sur FreeBSD, NetBSD, et OpenBSD.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="protocol">Sp&eacute;cification du protocole avec Listen <a title="Lien permanent" href="#protocol" class="permalink">&para;</a></h2>
<p>Dans la plupart des configurations, le second param&egrave;tre optionnel
<var>protocol</var> de la directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> n'est pas obligatoire. S'il
n'est pas sp&eacute;cifi&eacute;, les protocoles par d&eacute;faut
sont <code>https</code> pour le port 443, et <code>http</code> pour
tous les autres ports. Le protocole sert &agrave; d&eacute;terminer quel module
doit traiter une requ&ecirc;te, et &agrave; appliquer les optimisations
sp&eacute;cifiques au protocole &agrave; l'aide de la directive <code class="directive"><a href="./mod/core.html#acceptfilter">AcceptFilter</a></code>.</p>
<p>Vous ne devez d&eacute;finir le protocole que si vous travaillez avec
des ports non standards. Par exemple, pour travailler en
<code>https</code> sur le port 8443 :</p>
<div class="example"><pre class="prettyprint lang-config">Listen 192.170.2.1:8443 https</pre>
</div>
</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"></a></div>
<div class="section">
<h2 id="virtualhost">Qu'en est-il avec les serveurs virtuels <a title="Lien permanent" href="#virtualhost" class="permalink">&para;</a></h2>
<p> La directive <code class="directive"><a href="./mod/mpm_common.html#listen">Listen</a></code> n'impl&eacute;mente pas les serveurs virtuels.
Elle indique simplement au serveur principal sur quels adresses et ports
il doit &eacute;couter. Si aucune directive
<code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
n'est pr&eacute;sente, le serveur se comportera de la m&ecirc;me fa&ccedil;on pour toutes
les requ&ecirc;tes accept&eacute;es. En revanche, la directive
<code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
peut &ecirc;tre utilis&eacute;e pour provoquer une r&eacute;action diff&eacute;rente du serveur
pour un ou plusieurs adresses ou ports. Pour impl&eacute;menter un serveur virtuel,
on doit d'abord indiquer au serveur sur quels adresses et ports il doit &eacute;couter.
Ensuite, une section
<code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
doit &ecirc;tre cr&eacute;&eacute;e pour le couple adresse+port sp&eacute;cifi&eacute; afin de d&eacute;finir le
comportement de cet h&ocirc;te virtuel. Notez que si la directive
<code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
est d&eacute;finie pour une adresse et un port sur lesquels le serveur n'est pas cens&eacute;
&eacute;couter, cet h&ocirc;te virtuel ne sera pas accessible.</p>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="./de/bind.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
<a href="./en/bind.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="./es/bind.html" hreflang="es" rel="alternate" title="Espa&ntilde;ol">&nbsp;es&nbsp;</a> |
<a href="./fr/bind.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a> |
<a href="./ja/bind.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="./ko/bind.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="./pt-br/bind.html" hreflang="pt-br" rel="alternate" title="Portugu&ecirc;s (Brasil)">&nbsp;pt-br&nbsp;</a> |
<a href="./tr/bind.html" hreflang="tr" rel="alternate" title="T&uuml;rk&ccedil;e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; sous <a href="https://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/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
document.body.appendChild(qv);
var qvBtn = document.createElement('button');
qvBtn.className = 'qv-toggle';
qvBtn.setAttribute('aria-label', 'Toggle page navigation');
qvBtn.innerHTML = '&#9776;';
document.body.appendChild(qvBtn);
qvBtn.addEventListener('click', function() {
var isOpen = qv.classList.toggle('open');
if (isOpen) {
qv.style.top = window.scrollY + 10 + 'px';
}
});
window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>