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
|
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!-- English Revision: 1673947 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<manualpage metafile="configuring.xml.meta">
<title>Fichiers de configuration</title>
<summary>
<p>Ce document décrit les fichiers utilisés pour configurer
le Serveur HTTP Apache.</p>
</summary>
<section id="main">
<title>Fichiers de configuration principaux</title>
<related>
<modulelist>
<module>mod_mime</module>
</modulelist>
<directivelist>
<directive module="core" type="section">IfDefine</directive>
<directive module="core">Include</directive>
<directive module="mod_mime">TypesConfig</directive>
</directivelist>
</related>
<p>La configuration du serveur HTTP Apache est effectuée en plaçant des <a
href="mod/directives.html">directives</a> dans des fichiers de
configuration au format texte. Le fichier de configuration principal se nomme
en général
<code>httpd.conf</code>. La localisation de ce fichier est définie
à la compilation, mais peut être redéfinie à l'aide de l'option
de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
configuration peuvent être ajoutés à l'aide de la directive
<directive module="core">Include</directive>, et des caractères de
remplacement
peuvent être utilisés pour inclure de nombreux fichiers de configuration.
Des directives de tous types peuvent être placées dans chacun de ces fichiers
de configuration. Les modifications dans les fichiers de configuration
principaux ne sont prises en compte par httpd que lorsque le serveur
est démarré ou redémarré.</p>
<p>Le serveur lit aussi un fichier contenant les types de document mime;
ce fichier est défini par la directive <directive
module="mod_mime">TypesConfig</directive>,
et se nomme <code>mime.types</code> par défaut.</p>
</section>
<section id="syntax">
<title>Syntaxe des fichiers de configuration</title>
<p>Les fichiers de configuration de httpd contiennent une directive
par ligne.
On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
pour indiquer que la directive continue à la ligne suivante.
Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
la fin de la ligne.</p>
<p>Les arguments des directives sont séparés les uns des autres par
des espaces. Si un argument contient des espaces, il doit être
entouré de guillemets.</p>
<p>Les directives dans les fichiers de configuration ne sont pas
sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
qui débutent par le caractère "#" sont interprétées comme des
commentaires, et sont ignorées. Les commentaires ne doivent
<strong>pas</strong> apparaître sur la même ligne qu'une directive
de configuration. Les espaces précédant une directive
sont ignorés; vous pouvez par conséquent indenter les directives
afin d'améliorer la lisibilité. Les lignes vides sont
aussi ignorées.</p>
<p>Les valeurs des variables d'environnement ou des variables
définies via la directive <directive
module="core">Define</directive> peuvent être utilisées dans le
fichier de configuration en utilisant la syntaxe
<code>${VAR}</code>. Si "VAR" est le nom d'une variable valide, la
valeur de la variable est alors substituée à la chaîne
<code>${VAR}</code>, et le processus de lecture du fichier de
configuration continue comme si la chaîne correspondant à la valeur
de la variable s'y était trouvée littéralement. Les variables définies
via la directive <directive module="core">Define</directive>
l'emportent sur les autres variables d'environnement du shell. Si la
variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code>
n'est pas modifiée, et un avertissement est enregistré dans le
journal. Le caractère ":" est interdit dans les noms de variables
afin d'éviter tout conflit avec la syntaxe de la directive <directive
module="mod_rewrite">RewriteMap</directive>.</p>
<p>Seules les variables d'environnement du shell définies avant le démarrage
du serveur peuvent être utilisées dans les extensions.
Les variables d'environnement
définies dans le fichier de configuration lui-même, par exemple avec <directive
module="mod_env">SetEnv</directive>, prennent effet trop tard pour
pouvoir être utilisées dans les extensions au sein du fichier de
configuration.</p>
<p>La longueur maximale d'une ligne dans un fichier de configuration
normal, après substitution des variables et fusion des lignes
interrompues, est approximativement de 16 Mo. Dans les <a
href="configuring.html#htaccess">fichiers .htaccess</a>, la longueur
maximale est de 8190 caractères.</p>
<p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
de configuration sans démarrer le serveur à l'aide de la commande
<code>apachectl configtest</code> ou de l'option de ligne de commande
<code>-t</code>.</p>
<p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
<module>mod_info</module> pour afficher la configuration avec tous
les fichiers inclus et les variables d'environnement évaluées, tous
les commentaires et les sections <directive module="core"
type="section">IfDefine</directive> et <directive module="core"
type="section">IfModule</directive> non actives ayant
été supprimés. Cependant, la sortie ne reflète
pas les fusions ou écrasements pouvant intervenir en cas de
définitions multiples de directives.</p>
</section>
<section id="modules">
<title>Modules</title>
<related>
<modulelist>
<module>mod_so</module>
</modulelist>
<directivelist>
<directive module="core" type="section">IfModule</directive>
<directive module="mod_so">LoadModule</directive>
</directivelist>
</related>
<p>httpd est un serveur modulaire. Ceci implique que seules les
fonctionnalités les plus courantes sont incluses dans le serveur de base.
Les fonctionnalités étendues sont fournies à l'aide de <a
href="mod/">modules</a> qui peuvent être chargés dans httpd.
Par défaut, un jeu de <a
href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
serveur à la compilation. Si le serveur est compilé de façon à utiliser
les <a href="dso.html">modules chargés dynamiquement</a>,
alors les modules peuvent être compilés séparément et chargés à
n'importe quel moment à l'aide de la directive
<directive module="mod_so">LoadModule</directive>.
Dans le cas contraire, httpd doit être recompilé pour ajouter ou
supprimer des modules.
Les directives de configuration peuvent être incluses de manière
conditionnelle selon la présence ou l'absence d'un module particulier
en les plaçant dans un bloc <directive
module="core" type="section">IfModule</directive>.</p>
<p>Pour voir quels modules ont été compilés avec le serveur,
vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
</section>
<section id="scope">
<title>Portée des directives</title>
<related>
<directivelist>
<directive module="core" type="section">Directory</directive>
<directive module="core" type="section">DirectoryMatch</directive>
<directive module="core" type="section">Files</directive>
<directive module="core" type="section">FilesMatch</directive>
<directive module="core" type="section">Location</directive>
<directive module="core" type="section">LocationMatch</directive>
<directive module="core" type="section">VirtualHost</directive>
</directivelist>
</related>
<p>Les directives placées dans les fichiers de configuration principaux
s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
configuration d'une partie du serveur seulement, vous pouvez limiter la
portée de vos directives en les plaçant dans une section
<directive module="core"
type="section">Directory</directive>, <directive module="core"
type="section">DirectoryMatch</directive>, <directive module="core"
type="section">Files</directive>, <directive module="core"
type="section">FilesMatch</directive>, <directive module="core"
type="section">Location</directive>, ou <directive module="core"
type="section">LocationMatch</directive>.
Ces sections limitent le champ d'application des directives qu'elles
contiennent à des URls ou des portions du système de fichiers particulières.
Elles peuvent aussi être imbriquées, ce qui permet
une configuration très fine.</p>
<p>httpd peut servir simultanément de nombreux sites web au travers des
<a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
être limitée en les plaçant dans des sections
<directive module="core" type="section">VirtualHost</directive>,
afin qu'elles ne s'appliquent qu'aux requêtes
pour un site web particulier.</p>
<p>Bien que la plupart des directives puissent être placées dans
chacune de ces sections, certaines d'entre elles n'ont aucun sens
dans certains contextes.
Par exemple, les directives qui contrôlent la création des processus
n'ont de sens que dans le contexte du serveur principal. Pour déterminer
quelles directives peuvent être placées dans quelles sections, consultez
le <a href="mod/directive-dict.html#Context">Contexte</a> de la
directive. Pour plus d'informations, nous fournissons des détails dans
<a href="sections.html">Comment fonctionnent les sections Directory,
Location et Files</a>.</p>
</section>
<section id="htaccess">
<title>Fichiers .htaccess</title>
<related>
<directivelist>
<directive module="core">AccessFileName</directive>
<directive module="core">AllowOverride</directive>
</directivelist>
</related>
<p>httpd permet la gestion décentralisée de la configuration
via des fichiers spéciaux placés dans l'arborescence du site web.
Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
mais tout autre nom peut être spécifié à l'aide de la directive
<directive module="core">AccessFileName</directive>.
Les directives placées dans les fichiers <code>.htaccess</code>
s'appliquent au répertoire dans lequel vous avez placé le fichier,
ainsi qu'à tous ses sous-répertoires.
La syntaxe des fichiers <code>.htaccess</code> est la même que celle
des fichiers de configuration principaux. Comme les fichiers
<code>.htaccess</code> sont lus à chaque requête, les modifications de
ces fichiers prennent effet immédiatement.</p>
<p>Pour déterminer quelles directives peuvent être placées
dans les fichiers <code>.htaccess</code>, consultez le
<a href="mod/directive-dict.html#Context">Contexte</a> de la
directive. L'administrateur du serveur peut contrôler quelles
directives peuvent être placées dans les fichiers
<code>.htaccess</code> en définissant la directive
<directive module="core">AllowOverride</directive>
dans les fichiers de configuration principaux.</p>
<p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>
</section>
</manualpage>
|
