1 <?xml version="1.0" encoding="UTF-8"?>
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=UTF-8" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>worker - Serveur HTTP Apache 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">
17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
19 <div id="page-header">
20 <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>
21 <p class="apache">Serveur HTTP Apache Version 2.5</p>
22 <img alt="" src="../images/feather.png" /></div>
23 <div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
25 <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>
26 <div id="page-content">
27 <div id="preamble"><h1>Apache MPM worker</h1>
29 <p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
30 <a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English"> en </a> |
31 <a href="../fr/mod/worker.html" title="Français"> fr </a> |
32 <a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
33 <a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
35 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module multi-processus implémentant un serveur web hybride
36 multi-processus multi-thread</td></tr>
37 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
38 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_worker_module</td></tr>
39 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>worker.c</td></tr></table>
42 <p>Ce module multi-processus (MPM) implémente un serveur hybride
43 multi-processus multi-thread. En utilisant les threads pour servir
44 les requêtes, il peut en traiter un grand nombre tout en consommant
45 moins de ressources qu'un serveur à base de processus. Cependant, il
46 conserve une grande partie de la stabilité d'un serveur à base de
47 processus en maintenant plusieurs processus disponibles, chacun de
48 ces derniers possédant de nombreux threads.</p>
50 <p>Les directives les plus importantes qui permettent de contrôler
51 ce MPM sont <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, qui définit le
52 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
53 global maximum de threads qui peuvent être lancés.</p>
55 <div id="quickview"><h3>Sujets</h3>
57 <li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment ça marche</a></li>
58 </ul><h3 class="directives">Directives</h3>
60 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
61 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li>
62 <li><img alt="" src="../images/right.gif" /> <a href="mod_unixd.html#group">Group</a></li>
63 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li>
64 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
65 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></li>
66 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxmemfree">MaxMemFree</a></li>
67 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></li>
68 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
69 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
70 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li>
71 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</a></li>
72 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
73 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
74 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#serverlimit">ServerLimit</a></li>
75 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li>
76 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
77 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
78 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li>
79 <li><img alt="" src="../images/right.gif" /> <a href="mod_unixd.html#user">User</a></li>
81 <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>
83 <li><a href="../bind.html">Définition des adresses et ports
84 qu'utilise le serveur HTTP Apache</a></li>
85 <li><a href="#comments_section">Commentaires</a></li></ul></div>
86 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
88 <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>
89 <p>Un processus de contrôle unique (le parent) a pour tâche de
90 lancer les processus enfants. Chaque processus enfant crée un nombre
91 fixe de threads serveurs selon la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, ainsi
92 qu'un thread chargé d'attendre les connexions et de les passer à un
93 thread serveur pour traitement au fur et à mesure de leur arrivée.</p>
95 <p>Le serveur HTTP Apache essaie toujours de maintenir un jeu de
97 inactifs ou <dfn>en réserve</dfn>, qui se tiennent prêts à traiter
98 les requêtes entrantes. De cette façon, les clients n'ont pas besoin
99 d'attendre la création d'un nouveau thread ou d'un nouveau processus
100 pour que leurs requêtes puissent être traitées. Le nombre de
101 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
102 fonctionnement, le serveur évalue le nombre total de threads inactifs
103 dans tous les processus, et en crée ou en arrête de façon à
104 maintenir ce nombre à l'intérieur des limites définies par les
105 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
106 s'auto-contrôle de manière efficace, on peut en général conserver
107 les valeurs par défaut. Le nombre maximum de clients pouvant être
108 servis simultanément (c'est à dire le nombre global maximum de
109 threads pour tous les processus) est défini par la directive
110 <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>. Le nombre
111 maximum de processus enfants actifs est défini par la valeur de la
112 directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
113 divisée par la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">
114 ThreadsPerChild</a></code>.</p>
116 <p>Deux directives permettent de fixer des limites absolues pour le
117 nombre de processus enfants actifs et le nombre de threads serveurs
118 par processus enfant, et ne peuvent être modifiées qu'en
119 arrêtant complètement le serveur et en le démarrant à nouveau.
120 La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#serverlimit">ServerLimit</a></code> constitue une limite
121 absolue pour le nombre de processus enfants actifs, et doit être
122 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
123 la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">
124 ThreadsPerChild</a></code>. La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadlimit">ThreadLimit</a></code> constitue une limite
125 absolue pour le nombre de threads par processus enfant, et doit être
126 supérieure ou égale à la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>.</p>
128 <p>En plus du jeu de processus enfants actifs, il peut exister
129 quelques processus enfants en cours d'arrêt, mais dont au moins un
130 thread serveur est encore en train de traiter une connexion client
131 existante. Il peut subsister en théorie jusqu'à <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> processus en cours
132 d'arrêt, bien qu'en réalité, ce nombre sera en général beaucoup plus
133 petit. Ce comportement peut être évité en désactivant l'arrêt de
134 processus enfants individuels de la manière suivante :</p>
137 <li>définir la valeur de <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">
138 MaxConnectionsPerChild</a></code> à zéro</li>
140 <li>Définir la valeur de <code class="directive"><a href="../mod/mpm_common.html#maxsparethreads">
141 MaxSpareThreads</a></code> à la même valeur que <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code></li>
144 <p>Voici un exemple typique de configuration du contrôle
145 processus-thread pour le MPM <code class="module"><a href="../mod/worker.html">worker</a></code> :</p>
147 <pre class="prettyprint lang-config">ServerLimit 16
149 MaxRequestWorkers 150
152 ThreadsPerChild 25</pre>
155 <p>Alors que le processus parent est en général démarré en tant que
156 <code>root</code> sous Unix afin de se mettre en écoute du port 80,
157 les processus enfants et les threads sont lancés par le serveur sous un
158 utilisateur avec privilèges restreints. On peut utiliser les
159 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
160 des processus enfants. Les processus enfants doivent pouvoir être en
161 mesure de lire tous les contenus destinés à être servis, mais
162 doivent avoir des privilèges aussi bas que possible. De plus, ces
163 directives définissent également les privilèges dont vont hériter les
164 scripts CGI (sauf si on utilise <code class="program"><a href="../programs/suexec.html">suexec</a></code>).</p>
166 <p>La directive <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code> permet de
167 définir la fréquence à laquelle le serveur recycle ses processus en
168 arrêtant les plus anciens et en en lançant de nouveaux.</p>
170 <p>Ce module MPM utilise le mutex <code>mpm-accept</code> pour
171 sérialiser l'accès aux connexions entrantes lorsqu'un problème
172 d'afflux de requêtes peut survenir (en général, lorsqu'il y a
173 plusieurs sockets en écoute). Les différents aspects de
174 l'implémentation de ce mutex peuvent être configurés via la
175 directive <code class="directive"><a href="../mod/core.html#mutex">Mutex</a></code>. Vous
176 trouverez des informations plus détaillées à propos de ce mutex dans
177 la documentation sur les <a href="../misc/perf-tuning.html">conseils en matière de
178 performances</a>.</p>
182 <div class="bottomlang">
183 <p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> |
184 <a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English"> en </a> |
185 <a href="../fr/mod/worker.html" title="Français"> fr </a> |
186 <a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
187 <a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
188 </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>
189 <script type="text/javascript"><!--//--><![CDATA[//><!--
190 var comments_shortname = 'httpd';
191 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/worker.html';
193 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
194 d.write('<div id="comments_thread"><\/div>');
195 var s = d.createElement('script');
196 s.type = 'text/javascript';
198 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
199 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
202 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
204 })(window, document);
205 //--><!]]></script></div><div id="footer">
206 <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>
207 <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[//><!--
208 if (typeof(prettyPrint) !== 'undefined') {