1 <?xml version="1.0" encoding="ISO-8859-1" ?>
2 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
3 <?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
4 <!-- French translation : Lucien GENTIS -->
5 <!-- Reviewed by : Vincent Deffontaines -->
6 <!-- English Revision: 1470515:1522935 (outdated) -->
9 Licensed to the Apache Software Foundation (ASF) under one or more
10 contributor license agreements. See the NOTICE file distributed with
11 this work for additional information regarding copyright ownership.
12 The ASF licenses this file to You under the Apache License, Version 2.0
13 (the "License"); you may not use this file except in compliance with
14 the License. You may obtain a copy of the License at
16 http://www.apache.org/licenses/LICENSE-2.0
18 Unless required by applicable law or agreed to in writing, software
19 distributed under the License is distributed on an "AS IS" BASIS,
20 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
21 See the License for the specific language governing permissions and
22 limitations under the License.
25 <manualpage metafile="configuring.xml.meta">
27 <title>Fichiers de configuration</title>
30 <p>Ce document décrit les fichiers utilisés pour configurer
31 le Serveur HTTP Apache.</p>
35 <title>Fichiers de configuration principaux</title>
38 <module>mod_mime</module>
41 <directive module="core" type="section">IfDefine</directive>
42 <directive module="core">Include</directive>
43 <directive module="mod_mime">TypesConfig</directive>
47 <p>La configuration du serveur HTTP Apache est effectuée en plaçant des <a
48 href="mod/directives.html">directives</a> dans des fichiers de
49 configuration au format texte. Le fichier de configuration principal se nomme
50 en général
51 <code>httpd.conf</code>. La localisation de ce fichier est définie
52 à la compilation, mais peut être redéfinie à l'aide de l'option
53 de ligne de commande <code>-f</code>. En outre, d'autres fichiers de
54 configuration peuvent être ajoutés à l'aide de la directive
55 <directive module="core">Include</directive>, et des caractères de
57 peuvent être utilisés pour inclure de nombreux fichiers de configuration.
58 Des directives de tous types peuvent être placées dans chacun de ces fichiers
59 de configuration. Les modifications dans les fichiers de configuration
60 principaux ne sont prises en compte par httpd que lorsque le serveur
61 est démarré ou redémarré.</p>
63 <p>Le serveur lit aussi un fichier contenant les types de document mime;
64 ce fichier est défini par la directive <directive
65 module="mod_mime">TypesConfig</directive>,
66 et se nomme <code>mime.types</code> par défaut.</p>
70 <title>Syntaxe des fichiers de configuration</title>
72 <p>Les fichiers de configuration de httpd contiennent une directive
74 On peut utiliser l'anti-slash "\" comme dernier caractère d'une ligne
75 pour indiquer que la directive continue à la ligne suivante.
76 Il ne doit y avoir aucun caractère ni espace entre l'anti-slash et
77 la fin de la ligne.</p>
79 <p>Les arguments des directives sont séparés les uns des autres par
80 des espaces. Si un argument contient des espaces, il doit être
81 entouré de guillemets.</p>
83 <p>Les directives dans les fichiers de configuration ne sont pas
84 sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
85 qui débutent par le caractère "#" sont interprétées comme des
86 commentaires, et sont ignorées. Les commentaires ne doivent
87 <strong>pas</strong> être inclus dans une ligne après une directive
88 de configuration. Les lignes vides et les espaces précédant une directive
89 sont ignorés; vous pouvez par conséquent indenter les directives
90 afin d'améliorer la lisibilité.</p>
92 <p>Les valeurs des variables d'environnement ou des variables
93 définies via la directive <directive
94 module="core">Define</directive> peuvent être utilisées dans le
95 fichier de configuration en utilisant la syntaxe
96 <code>${VAR}</code>. Si "VAR" est le nom d'une variable valide, la
97 valeur de la variable est alors substituée à la chaîne
98 <code>${VAR}</code>, et le processus de lecture du fichier de
99 configuration continue comme si la chaîne correspondant à la valeur
100 de la variable s'y était trouvée littéralement. Les variables définies
101 via la directive <directive module="core">Define</directive>
102 l'emportent sur les autres variables d'environnement du shell. Si la
103 variable "VAR" n'est pas trouvée, la chaîne <code>${VAR}</code>
104 n'est pas modifiée, et un avertissement est enregistré dans le
105 journal. Le caractère ":" est interdit dans les noms de variables
106 afin d'éviter tout conflit avec la syntaxe de la directive <directive
107 module="mod_rewrite">RewriteMap</directive>.</p>
109 <p>Seules les variables d'environnement du shell définies avant le démarrage
110 du serveur peuvent être utilisées dans les extensions.
111 Les variables d'environnement
112 définies dans le fichier de configuration lui-même, par exemple avec <directive
113 module="mod_env">SetEnv</directive>, prennent effet trop tard pour
114 pouvoir être utilisées dans les extensions au sein du fichier de
117 <p>La longueur maximale d'une ligne dans un fichier de configuration
118 normal, après substitution des variables et fusion des lignes
119 interrompues, est approximativement de 16 Mo. Dans les <a
120 href="configuring.xml#htaccess">fichiers .htaccess</a>, la longueur
121 maximale est de 8190 caractères.</p>
123 <p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
124 de configuration sans démarrer le serveur à l'aide de la commande
125 <code>apachectl configtest</code> ou de l'option de ligne de commande
128 <p>Vous pouvez utiliser la définition <code>-DDUMP_CONFIG</code> de
129 <module>mod_info</module> pour afficher la configuration avec tous
130 les fichiers inclus et les variables d'environnement évaluées, tous
131 les commentaires et les sections <directive module="core"
132 type="section">IfDefine</directive> et <directive module="core"
133 type="section">IfModule</directive> non actives ayant
134 été supprimés. Cependant, la sortie ne reflète
135 pas les fusions ou écrasements pouvant intervenir en cas de
136 définitions multiples de directives.</p>
139 <section id="modules">
140 <title>Modules</title>
144 <module>mod_so</module>
147 <directive module="core" type="section">IfModule</directive>
148 <directive module="mod_so">LoadModule</directive>
152 <p>httpd est un serveur modulaire. Ceci implique que seules les
153 fonctionnalités les plus courantes sont incluses dans le serveur de base.
154 Les fonctionnalités étendues sont fournies à l'aide de <a
155 href="mod/">modules</a> qui peuvent être chargés dans httpd.
156 Par défaut, un jeu de <a
157 href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
158 serveur à la compilation. Si le serveur est compilé de façon à utiliser
159 les <a href="dso.html">modules chargés dynamiquement</a>,
160 alors les modules peuvent être compilés séparément et chargés à
161 n'importe quel moment à l'aide de la directive
162 <directive module="mod_so">LoadModule</directive>.
163 Dans le cas contraire, httpd doit être recompilé pour ajouter ou
164 supprimer des modules.
165 Les directives de configuration peuvent être incluses de manière
166 conditionnelle selon la présence ou l'absence d'un module particulier
167 en les plaçant dans un bloc <directive
168 module="core" type="section">IfModule</directive>.</p>
170 <p>Pour voir quels modules ont été compilés avec le serveur,
171 vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
175 <title>Portée des directives</title>
179 <directive module="core" type="section">Directory</directive>
180 <directive module="core" type="section">DirectoryMatch</directive>
181 <directive module="core" type="section">Files</directive>
182 <directive module="core" type="section">FilesMatch</directive>
183 <directive module="core" type="section">Location</directive>
184 <directive module="core" type="section">LocationMatch</directive>
185 <directive module="core" type="section">VirtualHost</directive>
189 <p>Les directives placées dans les fichiers de configuration principaux
190 s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
191 configuration d'une partie du serveur seulement, vous pouvez limiter la
192 portée de vos directives en les plaçant dans une section
193 <directive module="core"
194 type="section">Directory</directive>, <directive module="core"
195 type="section">DirectoryMatch</directive>, <directive module="core"
196 type="section">Files</directive>, <directive module="core"
197 type="section">FilesMatch</directive>, <directive module="core"
198 type="section">Location</directive>, ou <directive module="core"
199 type="section">LocationMatch</directive>.
200 Ces sections limitent le champ d'application des directives qu'elles
201 contiennent à des URls ou des portions du système de fichiers particulières.
202 Elles peuvent aussi être imbriquées, ce qui permet
203 une configuration très fine.</p>
205 <p>httpd peut servir simultanément de nombreux sites web au travers des
206 <a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
207 être limitée en les plaçant dans des sections
208 <directive module="core" type="section">VirtualHost</directive>,
209 afin qu'elles ne s'appliquent qu'aux requêtes
210 pour un site web particulier.</p>
212 <p>Bien que la plupart des directives puissent être placées dans
213 chacune de ces sections, certaines d'entre elles n'ont aucun sens
214 dans certains contextes.
215 Par exemple, les directives qui contrôlent la création des processus
216 n'ont de sens que dans le contexte du serveur principal. Pour déterminer
217 quelles directives peuvent être placées dans quelles sections, consultez
218 le <a href="mod/directive-dict.html#Context">Contexte</a> de la
219 directive. Pour plus d'informations, nous fournissons des détails dans
220 <a href="sections.html">Comment fonctionnent les sections Directory,
221 Location et Files</a>.</p>
224 <section id="htaccess">
225 <title>Fichiers .htaccess</title>
229 <directive module="core">AccessFileName</directive>
230 <directive module="core">AllowOverride</directive>
234 <p>httpd permet la gestion décentralisée de la configuration
235 via des fichiers spéciaux placés dans l'arborescence du site web.
236 Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
237 mais tout autre nom peut être spécifié à l'aide de la directive
238 <directive module="core">AccessFileName</directive>.
239 Les directives placées dans les fichiers <code>.htaccess</code>
240 s'appliquent au répertoire dans lequel vous avez placé le fichier,
241 ainsi qu'à tous ses sous-répertoires.
242 La syntaxe des fichiers <code>.htaccess</code> est la même que celle
243 des fichiers de configuration principaux. Comme les fichiers
244 <code>.htaccess</code> sont lus à chaque requête, les modifications de
245 ces fichiers prennent effet immédiatement.</p>
247 <p>Pour déterminer quelles directives peuvent être placées
248 dans les fichiers <code>.htaccess</code>, consultez le
249 <a href="mod/directive-dict.html#Context">Contexte</a> de la
250 directive. L'administrateur du serveur peut contrôler quelles
251 directives peuvent être placées dans les fichiers
252 <code>.htaccess</code> en définissant la directive
253 <directive module="core">AllowOverride</directive>
254 dans les fichiers de configuration principaux.</p>
256 <p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
257 se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>