summaryrefslogtreecommitdiff
path: root/usr.sbin/httpd/htdocs/manual/server-wide.html.fr
blob: 84a9293fb213f94e42ca7c247b52f50a62f1f934 (plain)
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
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--English revision 1.7 -->
<HTML>
<HEAD>
<TITLE>Configuration globale du serveur</TITLE>
</HEAD>

<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<BODY
 BGCOLOR="#FFFFFF"
 TEXT="#000000"
 LINK="#0000FF"
 VLINK="#000080"
 ALINK="#FF0000"
>
<!--#include virtual="header.html" -->
<h1 align="center">Configuration globale du serveur</h1>

<p>Ce document d&eacute;crit certaines directives trait&eacute;es par le
<a href="mod/core.html">noyau</A> du serveur qui sont utilis&eacute;es pour
configurer les op&eacute;rations de base du serveur.</p>

<ul>
<li><a href="#identification">Identification du serveur</a></li>
<li><a href="#locations">Emplacement des fichiers</a></li>
<li><a href="#process">Cr&eacute;ation des processus</a></li>
<li><a href="#network">Configuration r&eacute;seau</a></li>
<li><a href="#resource">Limitation de l'utilisation des ressources</a></li>
</ul>

<hr>

<h2><a name="identification">Identification du serveur</a></h2>

<table border="1">
<tr><td valign="top">
<strong>Directives associ&eacute;es</strong><br><br>

<A HREF="mod/core.html#servername">ServerName</A><br>
<A HREF="mod/core.html#serveradmin">ServerAdmin</A><br>
<A HREF="mod/core.html#serversignature">ServerSignature</A><br>
<A HREF="mod/core.html#servertokens">ServerTokens</A><br>
<A HREF="mod/core.html#usecanonicalname">UseCanonicalName</A><br>
</td></tr></table>

<p>Les directives <code>ServerAdmin</code> and <code>ServerTokens</code>
contr&ocirc;lent quelles informations du serveur seront pr&eacute;sent&eacute;es
dans les pages g&eacute;n&eacute;r&eacute;es par le serveur telles que les messages
d'erreur. La directive <code>ServerTokens</code> assigne la valeur du champ serveur 
dans les en-t&ecirc;tes de r&eacute;ponse HTTP.</p>

<p>Les directives <code>ServerName</code> and <code>UseCanonicalName</code>
sont utilis&eacute;es pour d&eacute;terminer comment former les URLs s'auto
r&eacute;f&eacute;ren&ccedil;ant. Par exemple, quand un client requiert un
r&eacute;pertoire, mais n'inclut pas de barre oblique finale dans le nom du 
r&eacute;pertoire, Apache doit rediriger le client vers le nom complet, incluant
la barre oblique finale permettant ainsi au client de r&eacute;soudre correctement
les r&eacute;f&eacute;rences relatives contenues dans le document.</p>

<hr>

<h2><a name="locations">Emplacement des fichiers</a></h2>

<table border="1">
<tr><td valign="top">
<strong>Directives associ&eacute;es</strong><br><br>

<a href="mod/core.html#coredumpdirectory">CoreDumpDirectory</a><br>
<a href="mod/core.html#documentroot">DocumentRoot</a><br>
<a href="mod/core.html#errorlog">ErrorLog</a><br>
<a href="mod/core.html#lockfile">Lockfile</a><br>
<a href="mod/core.html#pidfile">PidFile</a><br>
<a href="mod/core.html#scoreboardfile">ScoreBoardFile</a><br>
<a href="mod/core.html#serverroot">ServerRoot</a><br>
</td></tr></table>

<p>Ces directives contr&ocirc;lent les emplacements des diff&eacute;rents 
fichiers qu'Apache a besoin pour ses propres besoins. Quand le chemin employ&eacute;
ne commence pas par une barre oblique, les fichiers sont localis&eacute;s 
relativement &agrave; <code>ServerRoot</code>. Soyez attentifs &agrave; placer
ces fichiers dans des chemins qui sont autoris&eacute;s en &eacute;criture aux
utilisateurs autres que root. Voir les 
<a href="misc/security_tips.html">trucs sur la s&eacute;curit&eacute;</a> pour 
plus de d&eacute;tails.</p>

<hr>

<h2><a name="process">Cr&eacute;ation des processus</a></h2>

<table border="1">
<tr><td valign="top">
<strong>Directives associ&eacute;es</strong><br><br>

<a href="mod/core.html#bs2000account">BS2000Account</a><br>
<a href="mod/core.html#group">Group</a><br>
<a href="mod/core.html#maxclients">MaxClients</a><br>
<a href="mod/core.html#maxrequestsperchild">MaxRequestsPerChild</a><br>
<a href="mod/core.html#maxspareservers">MaxSpareServers</a><br>
<a href="mod/core.html#minspareservers">MinSpareServers</a><br>
<a href="mod/core.html#servertype">ServerType</a><br>
<a href="mod/core.html#startservers">StartServers</a><br>
<a href="mod/core.html#threadsperchild">ThreadsPerChild</a><br>
<a href="mod/core.html#user">User</a><br>
</td></tr></table>

<p>Si la directive <code>ServerType</code> est d&eacute;finie avec la 
valeur recommand&eacute;e de <code>Standalone</code>, 
Apache 1.3 sur Unix est bas&eacute; sur mod&egrave;le de pr&eacute;lancement
des processus. Un unique processus de contr&ocirc;le est responsable de lancer
des processus fils qui &eacute;coutent les connexions et les traitent &agrave; 
leur arriv&eacute;e. Apache essaye de maintenir un certain nombre processus
en r&eacute;serve ou inactifs, qui restent toujours pr&ecirc;ts &agrave; traiter
les requ&ecirc;tes arrivantes. De cette mani&egrave;re, les clients n'ont pas 
&agrave; attendre que de nouveaux processus fils soient lanc&eacute;s avant que 
leurs requ&ecirc;tes soient trait&eacute;es.</p>

<p>Les directives <code>StartServers</code>, <code>MinSpareServers</code>,
<code>MaxSpareServers</code>, and <code>MaxServers</code> r&eacute;gissent
comment le processus p&egrave;re cr&eacute;e les processus fils pour traiter les
requ&ecirc;tes. En g&eacute;n&eacute;ral Apache se r&eacute;git seul correctement,
et la plupart des sites n'ont pas besoin d'ajuster la valeur de ces directives.
Les sites qui veulent servir plus de 256 requ&ecirc;tes simultan&eacute;es 
doivent augmenter la valeur de <code>MaxClients</code>, tandis que les sites
tournant sur des machines limit&eacute;es en m&eacute;moire doivent r&eacute;duire
la valeur de  <code>MaxClients</code> afin d'&eacute;viter d'utiliser le fichier
d'&eacute;change. Plus d'informations sur le param&eacute;trage de la 
cr&eacute;ation des processus se trouvent dans la documentation 
<a href="misc/perf-tuning.html">Aide sur les performances générales</a>.</p>

<p>Tandis que le processus p&egrave;re est g&eacute;n&eacute;ralement lanc&eacute;
en tant que root sous Unix pour se connecter sur le port 80, les processus fils
sont lanc&eacute;s sous un utilisateur moins privil&eacute;gi&eacute;.
Les directives <code>User</code> et <code>Group</code> servent &agrave; d&eacute;finir
les privil&egrave;ges des processus fils. Les processus fils doivent &ecirc;tre
capable de lire le contenu devant &ecirc;tre servi, mais doivent avoir le minimum
de privil&egrave;ges possibles. De plus, &agrave; moins que 
<a href="suexec.html">suexec</a> soit utilis&eacute;, ces directives d&eacute;finissent 
&eacute;galement les droits qui seront h&eacute;rit&eacute;s par les scripts CGI.</p>

<p><code>MaxRequestsPerChild</code> contr&ocirc;le la fr&eacute;quence de 
r&eacute;novation des processus, en supprimant les anciens et en lan&ccedil;ant de 
nouveaux.</p>

<p>Sous Windows, Apache lance un processus p&egrave;re et un processus fils.
Le processus fils cr&eacute;e un ensemble de threads pour traiter les requ&ecirc;tes.
Le nombre de threads est contr&ocirc;l&eacute; par la directive
<code>ThreadsPerChild</code>.</p>

<hr>

<h2><a name="network">Configuration r&eacute;seau</a></h2>

<table border="1">
<tr><td valign="top">
<strong>Directives associ&eacute;es</strong><br><br>

<a href="mod/core.html#bindaddress">BindAddress</a><br>
<a href="mod/core.html#keepalive">KeepAlive</a><br>
<a href="mod/core.html#keepalivetimeout">KeepAliveTimeout</a><br>
<a href="mod/core.html#listen">Listen</a><br>
<a href="mod/core.html#listenbacklog">ListenBackLog</a><br>
<a href="mod/core.html#maxkeepaliverequests">MaxKeepAliveRequests</a><br>
<a href="mod/core.html#port">Port</a><br>
<a href="mod/core.html#sendbuffersize">SendBufferSize</a><br>
<a href="mod/core.html#timeout">TimeOut</a><br>
</td></tr></table>

<p>Au d&eacute;marrage d'Apache, celui ci se connecte &agrave; un port et une 
adresse donn&eacute;s sur la machine locale et attend l'arriv&eacute;e de 
requ&ecirc;tes. Par d&eacute;faut, il &eacute;coute sur toutes les adresses,
et sur le port d&eacute;fini par la directive <code>Port</code>. Toutefois,
on peut lui indiquer d'&eacute;couter sur plus d'un port, de n'&eacute;couter
qu'&agrave; partir d'une seule adresse, ou une combinaison des deux. Ceci est
g&eacute;n&eacute;ralement combin&eacute; avec la fonction d'
<a href="vhosts/">h&ocirc;te virtuel</a> qui d&eacute;termine comment 
Apache r&eacute;pond de diff&eacute;rentes adresses IP, de noms d'h&ocirc;tes et
de ports.</p>

<p>Il y a deux directives qui permettent de restreindre ou de sp&eacute;cifier
quelles adresses et quels ports Apache doit &eacute;couter.
La directive <code>BindAddress</code> restreint le serveur &agrave; 
n'&eacute;couter qu'une seule adresse IP. La directive <code>Listen</code> peut
&ecirc;tre utilis&eacute;e pour sp&eacute;cifier un ensemble d'adresses et de 
ports qu'Apache doit &eacute;couter.</p>

<p>Les directives <code>ListenBackLog</code>, <code>SendBufferSize</code>, and
<code>TimeOut</code> permettent d'adjuster comment Apache interagit avec
le r&eacute;seau.</p>

<p>Les directives <code>KeepAlive</code>, <code>KeepAliveTimeout</code>, 
and <code>MaxKeepAliveRequests</code> d&eacute;finissent comment
Apache g&egrave;re les connexions persistantes.</p>

<hr>
<h2><a name="resource">Limitation de l'utilisation des Ressources</a></h2>
<table border="1">
<tr><td valign="top">
<strong>Directives associ&eacute;es</strong><br><br>

<a href="mod/core.html#limitrequestbody">LimitRequestBody</a><br>
<a href="mod/core.html#limitrequestfields">LimitRequestFields</a><br>
<a href="mod/core.html#limitrequestfieldsize">LimitRequestFieldsize</a><br>
<a href="mod/core.html#limitrequestline">LimitRequestLine</a><br>
<a href="mod/core.html#rlimitcpu">RLimitCPU</a><br>
<a href="mod/core.html#rlimitmem">RLimitMEM</a><br>
<a href="mod/core.html#rlimitnproc">RLimitNPROC</a><br>
<a href="mod/core.html#threadstacksize">ThreadStackSize</a><br>
</td></tr></table>

<p>Les directives commen&ccedil;ant par <code>LimitRequest</code>
sont employ&eacute;es pour fixer des limites sur la quantit&eacute; de 
ressources qui seront utilis&eacute;es pendant la lecture des requ&ecirc;tes clientes. En 
limitant ces valeurs, certains types de d&eacute;ni de service peuvent 
&ecirc;tre att&eacute;nu&eacute;s.</p>

<p>Les directives commen&ccedil;ant par <code>RLimit</code> sont employ&eacute;es
pour fixer des limites sur la quantit&eacute; de ressources qu'utiliseront les processus
lanc&eacute;s par les processus enfants Apache.
En particulier, elles contr&ocirc;le les ressources utilis&eacute;es par les 
scripts CGI et les commandes exec SSI.</p>

<p>La directive <code>ThreadStackSize</code> est utilis&eacute;e seulement sur
Netware pour contr&ocirc;ler la taille de la pile.</p>

<!--#include virtual="footer.html" -->
</BODY>
</HTML>