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
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<!-- Traduction anglais 1.17 -->
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<meta http-equiv="Content-Type"
content="text/html; charset=iso-8859-1" />
<title>Fichiers de configuration</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">Fichiers de configuration</h1>
<ul>
<li><a href="#main">Principaux fichiers de
configuration</a></li>
<li><a href="#syntax">Syntaxe des fichiers de
configuration</a></li>
<li><a href="#modules">Modules</a></li>
<li><a href="#scope">Portée des directives</a></li>
<li><a href="#htaccess">Fichiers .htaccess</a></li>
<li><a href="#logs">Fichiers de trace</a></li>
</ul>
<hr />
<h2><a id="main" name="main">Principaux fichiers de
configuration</a></h2>
<table border="1">
<tr>
<td valign="top"><strong>Modules liés</strong><br />
<br />
<a href="mod/mod_mime.html">mod_mime</a><br />
</td>
<td valign="top"><strong>Directives
liées</strong><br />
<br />
<a
href="mod/core.html#accessconfig">AccessConfig</a><br />
<a
href="mod/core.html#ifdefine"><IfDefine></a><br />
<a href="mod/core.html#include">Include</a><br />
<a
href="mod/core.html#resourceconfig">ResourceConfig</a><br />
<a
href="mod/mod_mime.html#typesconfig">TypesConfig</a><br />
</td>
</tr>
</table>
<p>Apache se configure en plaçant des <a
href="mod/directives.html">directives</a> dans des fichiers
textes de configuration. Le fichier de configuration principal
est généralement appelé
<code>httpd.conf</code>. L'emplacement de ce fichier est
fixé à la compilation, mais peut être
redéfini en utilisant l'option de ligne de commande
<code>-f</code>. Certains sites possèdent
également des fichiers <code>srm.conf</code> et
<code>access.conf</code> pour des <a
href="http://httpd.apache.org/info/three-config-files.html">raisons
historiques</a>. De plus, d'autres fichiers de configuration
peuvent être ajoutés en utilisant la directive
<code><a href="mod/core.html#include">Include</a></code>. Les
directives peuvent être placées dans n'importe
quel fichier. Les modifications dans le fichier de
configuration principal ne sont prises en compte qu'au
démarrage ou au redémarrage d'Apache.</p>
<p>Une nouveauté de la version 1.3.13 d'Apache est la
possibilité qu'un fichier de configuration soit en fait
un répertoire. Dans ce cas, Apache lira tous les
fichiers et sous répertoires et les traitera comme
fichiers de configuration. Une utilisation possible de cette
fonctionnalité est de pouvoir ajouter des hôtes
virtuels en créant des fichiers de configuration pour
chaque hôte, et de les placer dans le répertoire
de configuration. Ainsi, vous pouvez ajouter ou retirer des
hôtes virtuels sans avoir à éditer de
fichiers, mais simplement en ajoutant ou supprimant un fichier.
Celà permet d'automatiser plus facilement ce genre de
traitement.</p>
<p>Le serveur lit également un fichier décrivant
les types de contenu MIME; le nom de ce fichier est
défini par la directive <a
href="mod/mod_mime.html#typesconfig">TypesConfig</a> et est par
défaut <code>mime.types</code>.</p>
<hr />
<h2><a id="syntax" name="syntax">Syntaxe des fichiers de
configuration</a></h2>
<p>Les fichiers de configurations contiennent au plus une
directive par ligne. Le caractère "\" peut être
utilisé à la fin d'une ligne pour indiquer que la
directive se poursuit sur la ligne suivante. Il ne doit pas y
avoir d'autres caractère ou d'espace entre le
caractère "\" et la fin de la ligne.</p>
<p>Dans les fichiers de configuration, l'écriture des
noms des directives n'est pas sensible à la casse, mais
les arguments des directives le sont
généralement. Les lignes blanches et les espaces
précédant une directive sont ignorés. Les
commentaires <strong>ne doivent pas</strong> être inclus
sur la même ligne qu'une directive. Les lignes
commençant par le caractère dièse "#" sont
traitées comme des commentaires et sont ignorés;
vous pouvez les utiliser pour indenter les directives et rendre
leur lecture plus facile.</p>
<p>Vous pouvez vérifier la syntaxe de vos fichiers de
configuration en utilisant soit <code>apachectl
configtest</code> soit l'option de ligne de commande
<code>-t</code>.</p>
<hr />
<h2><a id="modules" name="modules">Modules</a></h2>
<table border="1">
<tr>
<td valign="top"><strong>Modules liés</strong><br />
<br />
<a href="mod/mod_so.html">mod_so</a><br />
</td>
<td valign="top"><strong>Directives
liées</strong><br />
<br />
<a href="mod/core.html#addmodule">AddModule</a><br />
<a
href="mod/core.html#clearmodulelist">ClearModuleList</a><br />
<a
href="mod/core.html#ifmodule"><IfModule></a><br />
<a href="mod/mod_so.html#loadmodule">LoadModule</a><br />
</td>
</tr>
</table>
<p>Apache est un serveur modulaire. Celà implique que
seules les fonctions de base sont incluses dans le noyau du
serveur. Les fonctionnalités plus avancées sont
disponibles grâce aux <a
href="mod/index-bytype.html">modules</a> qui peuvent être
chargés dans Apache. Par défaut, un ensemble de
modules de <a href="mod/module-dict.html#Status">base</a> sont
inclus à la compilation. Si le serveur est
compilé pour utiliser les modules <a
href="dso.html">dynamiquement chargés</a>, alors les
modules peuvent être compilés
séparément et ajouté à n'importe
quel moment en utilisant la directive <a
href="mod/mod_so.html#loadmodule">LoadModule</a>. Sinon, Apache
doit être recompilé pour ajouter ou supprimer des
modules. Des directives de configuration peuvent être
incluses de manière conditionnelle en fonction de la
présence d'un module particulier en les entourant par un
bloc <a href="mod/core.html#ifmodule"><IfModule></a>.</p>
<p>Pour savoir quels modules ont été
compilés dans le serveur, vous pouvez utiliser l'option
de ligne de commande <code>-l</code>.</p>
<hr />
<h2><a id="scope" name="scope">Portée des
directives</a></h2>
<table border="1">
<tr>
<td valign="top"><strong>Directives
liées</strong><br />
<br />
<a
href="mod/core.html#directory"><Directory></a><br />
<a
href="mod/core.html#directorymatch"><DirectoryMatch></a><br />
<a href="mod/core.html#files"><Files></a><br />
<a
href="mod/core.html#filesmatch"><FilesMatch></a><br />
<a
href="mod/core.html#location"><Location></a><br />
<a
href="mod/core.html#locationmatch"><LocationMatch></a><br />
<a
href="mod/core.html#virtualhost"><VirtualHost></a><br />
</td>
</tr>
</table>
<p>Les directives placées dans les principaux fichiers
de configuration s'appliquent à l'ensemble du serveur.
Si vous souhaitez modifier la configuration pour une partie
seulement du serveur, vous pouvez mettre en contexte vos
directives en les plaçant dans des sections <code><a
href="mod/core.html#directory"><Directory></a>, <a
href="mod/core.html#directorymatch"><DirectoryMatch></a>,
<a href="mod/core.html#files"><Files></a>, <a
href="mod/core.html#filesmatch"><FilesMatch></a>, <a
href="mod/core.html#location"><Location></a>,</code> et
<code><a
href="mod/core.html#locationmatch"><LocationMatch></a></code>
. Ces sections limitent la portée d'application des
directives qu'elles contiennent à un emplacement des
fichiers ou à certaines URL. Elles peuvent être
imbriquées, permettant ainsi une configuration
très fine.</p>
<p>Apache a la possibilité de servir plusieurs sites web
simultanément. Cette possibilité est
appelée <a href="vhosts/">hébergement
virtuel</a>. Des directives peuvent également être
limitées en utilisant des sections <code><a
href="mod/core.html#virtualhost"><VirtualHost></a></code>
afin qu'elles ne s'appliquent qu'à certains sites
web.</p>
<p>Bien que la plupart des directives peuvent être
placées à l'intérieur de n'importe quelle
section, certaines directives n'ont pas de sens dans certains
contextes. Par exemple, les directives contrôlant la
création des processus ne peuvent être
placées que dans le contexte pricipal du serveur. Pour
savoir quelles directives peuvent être placées
dans quelles sections, vérifiez le <a
href="mod/directive-dict.html#Context">contexte</a> de la
directive. Pour plus d'informations, voir <a
href="sections.html">comment les sections Directory, Location
et Files fonctionnent</a>.</p>
<hr />
<h2><a id="htaccess" name="htaccess">Fichiers
.htaccess</a></h2>
<table border="1">
<tr>
<td valign="top"><strong>Directives
liées</strong><br />
<br />
<a
href="mod/core.html#accessfilename">AccessFileName</a><br />
<a
href="mod/core.html#allowoverride">AllowOverride</a><br />
</td>
</tr>
</table>
<p>Apache permet une gestion décentralisée de la
configuration par l'utilisation de fichiers spéciaux
à l'intérieur de l'arborescence web. Ces fichiers
spéciaux sont généralement appelés
<code>.htaccess</code>, mais n'importe quel nom peut être
défini par la directive <a
href="mod/core.html#accessfilename"><code>AccessFileName</code></a>.
Les directives placées dans les fichiers
<code>.htaccess</code> s'appliquent au répertoire
où se trouve le fichier ainsi qu'aux sous
répertoires. Les fichiers <code>.htaccess</code>
respectent la même syntaxe que les fichiers principaux de
configuration. Comme les fichiers <code>.htaccess</code> sont
lus à chaque requête, Les modifications
effectuées dans ces fichiers prennent effet
immédiatement.</p>
<p>Pour savoir si une directive peut être placée
dans les fichiers <code>.htaccess</code>, vérifiez le <a
href="mod/directive-dict.html#Context">contexte</a> de la
directive. L'administrateur peut contôler quelles
directives peuvent être placées dans les fichiers
<code>.htaccess</code> en modifiant la directive <a
href="mod/core.html#allowoverride"><code>AllowOverride</code></a>
du fichier principal de configuration.</p>
<hr />
<h2><a id="logs" name="logs">Fichiers de trace</a></h2>
<h3>Avertissement sur la sécurité</h3>
Toute personne pouvant écrire dans le répertoire
où Apache écrit un fichier de trace peut avoir
accès à l'uid sous lequel le serveur est
lancé, généralement root. <em>Ne donnez
pas</em> accès en écriture au répertoire
où les fichiers de trace sont stockés sans
être clairement conscient des conséquences; voir
le document <a href="misc/security_tips.html">trucs sur la
sécurité</a> pour plus de détails.
<h3>Fichier pid</h3>
<p>Au lancement, Apache écrit le numéro de
processus du processus père httpd dans le fichier
<code>logs/httpd.pid</code>. Le nom du fichier peut être
changé en modifiant la directive <a
href="mod/core.html#pidfile">PidFile</a>. Le numéro de
processus est utilisé par l'administrateur pour relancer
et arrêter le démon. Sur Unix, un signal HUP ou
USR1 a pour effet de faire relire par le démon les
fichiers de configuration, et un signal TERM le fait terminer
de manière douce. Sur Windows, il faut employer l'option
-k. Pour plus d'information voir la page <a
href="stopping.html">Arrêt et redémarrage</a>.</p>
<p>Si le processus meurt (ou est tué) de manière
anormale, il peut alors être nécessaire de tuer
les processus fils.</p>
<h3>Trace des erreurs</h3>
<p>Le serveur trace les messages d'erreurs dans un fichier, par
défaut <code>logs/error_log</code> sur Unix ou
<code>logs/error.log</code> sur Windows and OS/2. Le nom du
fichier peut être défini en utilisant la directive
<a href="mod/core.html#errorlog">ErrorLog</a> D'autres traces
peuvent être définies pour différents <a
href="mod/core.html#virtualhost">hôtes virtuels</a>.</p>
<h3>Trace des requêtes</h3>
<p>Le serveur trace généralement chaque
requête dans un fichier de transfert, par défaut
<code>logs/access_log</code> sur Unix ou
<code>logs/access.log</code> sur Windows and OS/2. Le nom du
fichier peut être défini en utilisant la directive
<a href="mod/mod_log_config.html#customlog">CustomLog</a>.
D'autres traces peuvent être définies pour
différents <a
href="mod/core.html#virtualhost">hôtes virtuels</a>.
<!--#include virtual="footer.html" -->
</p>
</body>
</html>
|
