event.html.fr revision b71e5eae594d54e9e56dc20208c6a7fb52610e29
<?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">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>event - 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" />
<body>
<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.5</p>
<div id="path">
<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.5</a> > <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Apache MPM event</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Une variante du MPM <code class="module"><a href="/mod/worker.html">worker</a></code> con�ue pour ne
mobiliser des threads que pour les connexions en cours de traitement</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>mpm_event_module</td></tr>
<h3>Sommaire</h3>
<p>Le module multi-processus (MPM) <code class="module"><a href="/mod/event.html">event</a></code> est con�u
pour permettre le traitement d'un nombre accru de requ�tes
simultan�es en d�l�guant certaines t�ches � des threads de support,
lib�rant par l�-m�me le thread principal et lui permettant de
traiter les nouvelles requ�tes. Il s'inspire du MPM
multi-processus/multi-threads. Les directives de configuration �
l'ex�cution sont identiques � celles du MPM
<code>--with-mpm=event</code> aux arguments du script
<code class="program"><a href="/programs/configure.html">configure</a></code> lorsque vous compilez le programme
</div>
<div id="quickview"><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="/images/down.gif" /> <a href="#asyncrequestworkerfactor">AsyncRequestWorkerFactor</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#serverlimit">ServerLimit</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
<li><img alt="" src="/images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li>
</ul>
<h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="/images/down.gif" /> <a href="#how-it-works">Comment tout cela fonctionne</a></li>
</ul><h3>Voir aussi</h3>
<ul class="seealso">
</ul></div>
<div class="section">
<h2><a name="how-it-works" id="how-it-works">Comment tout cela fonctionne</a></h2>
<p>Ce MPM essaie de r�soudre le 'probl�me keep alive' de HTTP.
Lorsqu'un client a soumis une premi�re requ�te, il peut garder la
connexion ouverte, et envoyer les requ�tes suivantes en utilisant le
m�me socket. Ceci permet de r�duire de mani�re significative la
surcharge due � la cr�ation de connexions TCP.
Cependant, le serveur HTTP Apache
attente des donn�es du client, ce qui am�ne son propre lot
d'inconv�nients. Pour r�soudre ce probl�me, <code class="module"><a href="/mod/event.html">event</a></code>
utilise un thread d�di� qui g�re les sockets en
�coute, tous les sockets en �tat Keep Alive, et les
sockets o� les filtres gestionnaires et de protocole ont
fait leur travail et pour lesquels la seule chose restant � faire
consiste � envoyer les donn�es au client. La page d'�tat de
<code class="module"><a href="/mod/mod_status.html">mod_status</a></code> montre les connexions qui se trouvent
dans les situations mentionn�es.</p>
<p>Le gestionnaire de connexion am�lior� ne fonctionne pas encore
pour certains filtres de connexion, et en particulier SSL. Pour les
connexions SSL, ce MPM r�adopte le comportement du MPM
<code class="module"><a href="/mod/worker.html">worker</a></code> et r�serve un thread par connexion.</p>
<p>Le MPM pr�suppose que l'impl�mentation <code>apr_pollset</code>
sous-jacente est raisonnablement s�re du point de vue des threads.
Ceci permet au MPM d'�viter un verrouillage de haut niveau excessif,
ou de devoir activer le thread en �coute afin de lui envoyer un
socket keep alive. Tout ceci n'est actuellement compatible qu'avec
KQueue et EPoll.</p>
<div class="section">
<h2><a name="requirements" id="requirements">Pr�requis</a></h2>
<p>Ce MPM d�pend des op�rations atomiques compare-and-swap
d'<a class="glossarylink" href="/glossary.html#apr" title="voir glossaire">APR</a> pour la synchronisation des threads. Si
vous compilez pour une plate-forme x86 et n'avez pas besoin du
support 386, ou si vous compilez pour une plate-forme SPARC et
n'avez pas besoin du support pre-UltraSPARC, ajoutez
<code>--enable-nonportable-atomics=yes</code> aux arguments du
script <code class="program"><a href="/programs/configure.html">configure</a></code>. Ceci permettra � APR
d'impl�menter les op�rations atomiques en utilisant des instructions
performantes indisponibles avec les processeurs plus
anciens.</p>
<p>Ce MPM ne fonctionne pas de mani�re optimale sur les
plates-formes plus anciennes qui ne g�rent pas correctement les
threads, mais ce probl�me est sans objet du fait du pr�requis
concernant EPoll ou KQueue.</p>
<ul>
<li>Pour utiliser ce MPM sous FreeBSD, la version 5.3 ou
sup�rieure de ce syst�me est recommand�e. Il est cependant
possible d'ex�cuter ce MPM sous FreeBSD 5.2.1 si vous utilisez
<li>Pour NetBSD, il est recommander d'utiliser la version 2.0 ou
sup�rieure.</li>
<li>Pour Linux, un noyau 2.6 est recommand�. Il faut aussi
s'assurer que votre version de <code>glibc</code> a �t� compil�e
avec le support pour EPoll.</li>
</ul>
</div>
<div class="directive-section"><h2><a name="AsyncRequestWorkerFactor" id="AsyncRequestWorkerFactor">AsyncRequestWorkerFactor</a> <a name="asyncrequestworkerfactor" id="asyncrequestworkerfactor">Directive</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Limite le nombre de connexions simultan�es par thread</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AsyncRequestWorkerFactor <var>facteur</var></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#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.3.13</td></tr>
</table>
<p>Le MPM event g�re certaines connexions de mani�re asynchrone ;
dans ce cas, les threads traitant la requ�te sont allou�s selon les
besoins et pour de courtes p�riodes. Dans les autres cas (la plupart
du temps pour les connexions SSL), un thread est r�serv� par
connexion. Ceci peut conduire � des situations o� tous les threads
sont satur�s et o� aucun thread n'est capable d'effectuer de
nouvelles t�ches pour les connexions asynchrones �tablies.</p>
<p>Pour minimiser les effets de ce probl�me, le MPM event utilise
deux m�thodes : tout d'abord, il limite le nombre de connexions
simultan�es par thread en fonction du nombre de processus
inactifs. Ensuite, si tous les processus sont occup�s, il ferme des
connexions permanentes, m�me si la limite de dur�e de la connexion
n'a pas �t� atteinte. Ceci autorise les clients concern�s � se
reconnecter � un autre processus poss�dant encore des threads
disponibles.</p>
<p>Cette directive permet de personnaliser finement la limite du
nombre de connexions par thread. Un processus n'acceptera de
nouvelles connexions que si le nombre actuel de connexions est
inf�rieur � :</p>
<p class="indent"><strong>
(<code class="directive">AsyncRequestWorkerFactor</code> *
<var>nombre de threads inactifs</var>)
</strong></p>
<p>En d'autres termes, le nombre maximum de connexions simultan�es
sera :</p>
<p class="indent"><strong>
(<code class="directive">AsyncRequestWorkerFactor</code> + 1) *
<code class="directive"><a href="/mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
</strong></p>
<p>La directive <code class="directive"><a href="/mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> se nommait
<code class="directive">MaxClients</code> avant la version 2.3.13. La valeur
ci-dessus montre que cet ancien nom ne correspondait pas � sa
signification exacte pour le MPM event.</p>
<p>La directive <code class="directive">AsyncRequestWorkerFactor</code>
accepte des valeurs d'argument de type non entier, comme "1.5".</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/mod/event.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div><div id="footer">
<p class="apache">Copyright 2012 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="/faq/">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div>
</body></html>