1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
|
<?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">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>worker - Serveur Apache HTTP 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" type="text/javascript">
</script>
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
<body>
<div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP 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="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 worker</h1>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/worker.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module multi-processus impl�mentant un serveur web hybride
multi-processus multi-thread</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>mpm_worker_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>worker.c</td></tr></table>
<h3>Sommaire</h3>
<p>Ce module multi-processus (MPM) impl�mente un serveur hybride
multi-processus multi-thread. En utilisant les threads pour servir
les requ�tes, il peut en traiter un grand nombre tout en consommant
moins de ressources qu'un serveur � base de processus. Cependant, il
conserve une grande partie de la stabilit� d'un serveur � base de
processus en maintenant plusieurs processus disponibles, chacun de
ces derniers poss�dant de nombreux threads.</p>
<p>Les directives les plus importantes qui permettent de contr�ler
ce MPM sont <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, qui d�finit le
nombre de threads lanc�s par chaque processus enfant et <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>, qui d�finit le nombre
global maximum de threads qui peuvent �tre lanc�s.</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment �a marche</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<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="mod_unixd.html#group">Group</a></li>
<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</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#maxmemfree">MaxMemFree</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#pidfile">PidFile</a></li>
<li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</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>
<li><img alt="" src="../images/right.gif" /> <a href="mod_unixd.html#user">User</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&list_id=144532&product=Apache%20httpd-2&query_format=specific&order=changeddate%20DESC%2Cpriority%2Cbug_severity&component=mpm_worker">Probl�mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&component=mpm_worker">Signaler un bug</a></li></ul><h3>Voir aussi</h3>
<ul class="seealso">
<li><a href="../bind.html">D�finition des adresses et ports
qu'utilise le serveur HTTP Apache</a></li>
<li><a href="#comments_section">Commentaires</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="section">
<h2><a name="how-it-works" id="how-it-works">Comment �a marche</a><a title="Lien permanent" href="#how-it-works" class="permalink">¶</a></h2>
<p>Un processus de contr�le unique (le parent) a pour t�che de
lancer les processus enfants. Chaque processus enfant cr�e un nombre
fixe de threads serveurs selon la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, ainsi
qu'un thread charg� d'attendre les connexions et de les passer � un
thread serveur pour traitement au fur et � mesure de leur arriv�e.</p>
<p>Le serveur HTTP Apache essaie toujours de maintenir un jeu de
threads serveurs
inactifs ou <dfn>en r�serve</dfn>, qui se tiennent pr�ts � traiter
les requ�tes entrantes. De cette fa�on, les clients n'ont pas besoin
d'attendre la cr�ation d'un nouveau thread ou d'un nouveau processus
pour que leurs requ�tes puissent �tre trait�es. Le nombre de
processus lanc�s initialement est d�fini par la directive <code class="directive"><a href="../mod/mpm_common.html#startservers">StartServers</a></code>. En cours de
fonctionnement, le serveur �value le nombre total de threads inactifs
dans tous les processus, et en cr�e ou en arr�te de fa�on �
maintenir ce nombre � l'int�rieur des limites d�finies par les
directives <code class="directive"><a href="../mod/mpm_common.html#minsparethreads">MinSpareThreads</a></code> et <code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">MaxSpareThreads</a></code>. Comme ce module
s'auto-contr�le de mani�re efficace, on peut en g�n�ral conserver
les valeurs par d�faut. Le nombre maximum de clients pouvant �tre
servis simultan�ment (c'est � dire le nombre global maximum de
threads pour tous les processus) est d�fini par la directive
<code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>. Le nombre
maximum de processus enfants actifs est d�fini par la valeur de la
directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
divis�e par la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">
ThreadsPerChild</a></code>.</p>
<p>Deux directives permettent de fixer des limites absolues pour le
nombre de processus enfants actifs et le nombre de threads serveurs
par processus enfant, et ne peuvent �tre modifi�es qu'en
arr�tant compl�tement le serveur et en le d�marrant � nouveau.
La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#serverlimit">ServerLimit</a></code> constitue une limite
absolue pour le nombre de processus enfants actifs, et doit �tre
sup�rieure ou �gale � la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> divis�e par la valeur de
la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">
ThreadsPerChild</a></code>. La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadlimit">ThreadLimit</a></code> constitue une limite
absolue pour le nombre de threads par processus enfant, et doit �tre
sup�rieure ou �gale � la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>.</p>
<p>En plus du jeu de processus enfants actifs, il peut exister
quelques processus enfants en cours d'arr�t, mais dont au moins un
thread serveur est encore en train de traiter une connexion client
existante. Il peut subsister en th�orie jusqu'� <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> processus en cours
d'arr�t, bien qu'en r�alit�, ce nombre sera en g�n�ral beaucoup plus
petit. Ce comportement peut �tre �vit� en d�sactivant l'arr�t de
processus enfants individuels de la mani�re suivante :</p>
<ul>
<li>d�finir la valeur de <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">
MaxConnectionsPerChild</a></code> � z�ro</li>
<li>D�finir la valeur de <code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">
MaxSpareThreads</a></code> � la m�me valeur que <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code></li>
</ul>
<p>Voici un exemple typique de configuration du contr�le
processus-thread pour le MPM <code class="module"><a href="../mod/worker.html">worker</a></code> :</p>
<pre class="prettyprint lang-config">ServerLimit 16
StartServers 2
MaxRequestWorkers 150
MinSpareThreads 25
MaxSpareThreads 75
ThreadsPerChild 25</pre>
<p>Alors que le processus parent est en g�n�ral d�marr� en tant que
<code>root</code> sous Unix afin de se mettre en �coute du port 80,
les processus enfants et les threads sont lanc�s par le serveur sous un
utilisateur avec privil�ges restreints. On peut utiliser les
directives <code class="directive"><a href="../mod/mod_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mod_unixd.html#group">Group</a></code> pour d�finir les privil�ges
des processus enfants. Les processus enfants doivent pouvoir �tre en
mesure de lire tous les contenus destin�s � �tre servis, mais
doivent avoir des privil�ges aussi bas que possible. De plus, ces
directives d�finissent �galement les privil�ges dont vont h�riter les
scripts CGI (sauf si on utilise <code class="program"><a href="../programs/suexec.html">suexec</a></code>).</p>
<p>La directive <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> permet de
d�finir la fr�quence � laquelle le serveur recycle ses processus en
arr�tant les plus anciens et en en lan�ant de nouveaux.</p>
<p>Ce module MPM utilise le mutex <code>mpm-accept</code> pour
s�rialiser l'acc�s aux connexions entrantes lorsqu'un probl�me
d'afflux de requ�tes peut survenir (en g�n�ral, lorsqu'il y a
plusieurs sockets en �coute). Les diff�rents aspects de
l'impl�mentation de ce mutex peuvent �tre configur�s via la
directive <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code>. Vous
trouverez des informations plus d�taill�es � propos de ce mutex dans
la documentation sur les <a href="../misc/perf-tuning.html">conseils en mati�re de
performances</a>.</p>
</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
<a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English"> en </a> |
<a href="../fr/mod/worker.html" title="Fran�ais"> fr </a> |
<a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
<a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </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&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/trunk/mod/worker.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 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>
<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[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>
|
