granicus.if.org Git - apache/blob - docs/manual/mod/worker.html.fr

   1 <?xml version="1.0" encoding="ISO-8859-1"?>
   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         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   5               This file is generated from xml source: DO NOT EDIT
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7       -->
   8 <title>worker - Serveur Apache HTTP</title>
   9 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  10 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  11 <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" />
  12 <script src="../style/scripts/prettify.js" type="text/javascript">
  13 </script>
  14
  15 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  16 <body>
  17 <div id="page-header">
  18 <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>
  19 <p class="apache">Serveur Apache HTTP Version 2.4</p>
  20 <img alt="" src="../images/feather.gif" /></div>
  21 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  22 <div id="path">
  23 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Modules</a></div>
  24 <div id="page-content">
  25 <div id="preamble"><h1>Apache MPM worker</h1>
  26 <div class="toplang">
  27 <p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  28 <a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  29 <a href="../fr/mod/worker.html" title="Français">&nbsp;fr&nbsp;</a> |
  30 <a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  31 <a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
  32 </div>
  33 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Module multi-processus implémentant un serveur web hybride
  34 multi-processus multi-thread</td></tr>
  35 <tr><th><a href="module-dict.html#Status">Statut:</a></th><td>MPM</td></tr>
  36 <tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>mpm_worker_module</td></tr>
  37 <tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>worker.c</td></tr></table>
  38 <h3>Sommaire</h3>
  39
  40     <p>Ce module multi-processus (MPM) implémente un serveur hybride
  41     multi-processus multi-thread. En utilisant les threads pour servir
  42     les requêtes, il peut en traiter un grand nombre tout en consommant
  43     moins de ressources qu'un serveur à base de processus. Cependant, il
  44     conserve une grande partie de la stabilité d'un serveur à base de
  45     processus en maintenant plusieurs processus disponibles, chacun de
  46     ces derniers possédant de nombreux threads.</p>
  47
  48     <p>Les directives les plus importantes qui permettent de contrôler
  49     ce MPM sont <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, qui définit le
  50     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
  51     global maximum de threads qui peuvent être lancés.</p>
  52 </div>
  53 <div id="quickview"><h3 class="directives">Directives</h3>
  54 <ul id="toc">
  55 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
  56 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#enableexceptionhook">EnableExceptionHook</a></li>
  57 <li><img alt="" src="../images/right.gif" /> <a href="mod_unixd.html#group">Group</a></li>
  58 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li>
  59 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
  60 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></li>
  61 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxmemfree">MaxMemFree</a></li>
  62 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></li>
  63 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
  64 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
  65 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li>
  66 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</a></li>
  67 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
  68 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
  69 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#serverlimit">ServerLimit</a></li>
  70 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#startservers">StartServers</a></li>
  71 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
  72 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
  73 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li>
  74 <li><img alt="" src="../images/right.gif" /> <a href="mod_unixd.html#user">User</a></li>
  75 </ul>
  76 <h3>Sujets</h3>
  77 <ul id="topics">
  78 <li><img alt="" src="../images/down.gif" /> <a href="#how-it-works">Comment ça marche</a></li>
  79 </ul><h3>Voir aussi</h3>
  80 <ul class="seealso">
  81 <li><a href="../bind.html">Définition des adresses et ports
  82 qu'utilise le serveur HTTP Apache</a></li>
  83 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
  84 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
  85 <div class="section">
  86 <h2><a name="how-it-works" id="how-it-works">Comment ça marche</a></h2>
  87     <p>Un processus de contrôle unique (le parent) a pour tâche de
  88     lancer les processus enfants. Chaque processus enfant crée un nombre
  89     fixe de threads serveurs selon la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>, ainsi
  90     qu'un thread chargé d'attendre les connexions et de les passer à un
  91     thread serveur pour traitement au fur et à mesure de leur arrivée.</p>
  92
  93     <p>Le serveur HTTP Apache essaie toujours de maintenir un jeu de
  94     threads serveurs
  95     inactifs ou <dfn>en réserve</dfn>, qui se tiennent prêts à traiter
  96     les requêtes entrantes. De cette façon, les clients n'ont pas besoin
  97     d'attendre la création d'un nouveau thread ou d'un nouveau processus
  98     pour que leurs requêtes puissent être traitées. Le nombre de
  99     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
 100     fonctionnement, le serveur évalue le nombre total de threads inactifs
 101     dans tous les processus, et en crée ou en arrête de façon à
 102     maintenir ce nombre à l'intérieur des limites définies par les
 103     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
 104     s'auto-contrôle de manière efficace, on peut en général conserver
 105     les valeurs par défaut. Le nombre maximum de clients pouvant être
 106     servis simultanément (c'est à dire le nombre global maximum de
 107     threads pour tous les processus) est défini par la directive
 108     <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>. Le nombre
 109     maximum de processus enfants actifs est défini par la valeur de la
 110     directive <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code>
 111     divisée par la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#&#10;    threadsperchild">
 112     ThreadsPerChild</a></code>.</p>
 113
 114     <p>Deux directives permettent de fixer des limites absolues pour le
 115     nombre de processus enfants actifs et le nombre de threads serveurs
 116     par processus enfant, et ne peuvent être modifiées qu'en
 117     arrêtant complètement le serveur et en le démarrant à nouveau.
 118     La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#serverlimit">ServerLimit</a></code> constitue une limite
 119     absolue pour le nombre de processus enfants actifs, et doit être
 120     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
 121     la directive <code class="directive"><a href="../mod/mpm_common.html#&#10;    threadsperchild">
 122     ThreadsPerChild</a></code>. La valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadlimit">ThreadLimit</a></code> constitue une limite
 123     absolue pour le nombre de threads par processus enfant, et doit être
 124     supérieure ou égale à la valeur de la directive <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code>.</p>
 125
 126     <p>En plus du jeu de processus enfants actifs, il peut exister
 127     quelques processus enfants en cours d'arrêt, mais dont au moins un
 128     thread serveur est encore en train de traiter une connexion client
 129     existante. Il peut subsister en théorie jusqu'à <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code> processus en cours
 130     d'arrêt, bien qu'en réalité, ce nombre sera en général beaucoup plus
 131     petit. Ce comportement peut être évité en désactivant l'arrêt de
 132     processus enfants individuels de la manière suivante :</p>
 133
 134     <ul>
 135       <li>définir la valeur de <code class="directive"><a href="../mod/mpm_common.html#&#10;      maxconnectionsperchild">
 136       MaxConnectionsPerChild</a></code> à zéro</li>
 137
 138       <li>Définir la valeur de <code class="directive"><a href="../mod/mpm_common.html#&#10;      maxsparethreads">
 139       MaxSpareThreads</a></code> à la même valeur que <code class="directive"><a href="../mod/mpm_common.html#maxrequestworkers">MaxRequestWorkers</a></code></li>
 140     </ul>
 141
 142     <p>Voici un exemple typique de configuration du contrôle
 143     processus-thread pour le MPM <code class="module"><a href="../mod/worker.html">worker</a></code> :</p>
 144
 145     <pre class="prettyprint lang-config">
 146 ServerLimit         16
 147 StartServers         2
 148 MaxRequestWorkers  150
 149 MinSpareThreads     25
 150 MaxSpareThreads     75
 151 ThreadsPerChild     25
 152     </pre>
 153
 154
 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/mpm_unixd.html#user">User</a></code> et <code class="directive"><a href="../mod/mpm_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>
 165
 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>
 169
 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>
 179
 180 </div>
 181 </div>
 182 <div class="bottomlang">
 183 <p><span>Langues Disponibles: </span><a href="../de/mod/worker.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 184 <a href="../en/mod/worker.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 185 <a href="../fr/mod/worker.html" title="Français">&nbsp;fr&nbsp;</a> |
 186 <a href="../ja/mod/worker.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 187 <a href="../tr/mod/worker.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</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&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>
 189 <script type="text/javascript"><!--//--><![CDATA[//><!--
 190 var comments_shortname = 'httpd';
 191 var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/worker.html';
 192 (function(w, d) {
 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';
 197         s.async = true;
 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);
 200     }
 201     else {
 202         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
 203     }
 204 })(window, document);
 205 //--><!]]></script></div><div id="footer">
 206 <p class="apache">Copyright 2014 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/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[//><!--
 208 if (typeof(prettyPrint) !== 'undefined') {
 209     prettyPrint();
 210 }
 211 //--><!]]></script>
 212 </body></html>