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 : 420990 -->
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 d'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 Apache 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 d'Apache 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 directives dans les fichiers de configuration ne sont pas
80 sensibles à la casse, mais leurs arguments le sont souvent. Les lignes
81 qui débutent par le caractère "#" sont interprétées comme des
82 commentaires, et sont ignorées. Les commentaires ne doivent
83 <strong>pas</strong> être inclus dans une ligne après une directive
84 de configuration. Les lignes vides et les espaces précédant une directive
85 sont ignorés; vous pouvez par conséquent indenter les directives
86 afin d'améliorer la lisibilité.</p>
88 <p>Vous pouvez vérifier l'absence d'erreurs de syntaxe dans vos fichiers
89 de configuration sans démarrer le serveur à l'aide de la commande
90 <code>apachectl configtest</code> ou de l'option de ligne de commande
94 <section id="modules">
95 <title>Modules</title>
99 <module>mod_so</module>
102 <directive module="core" type="section">IfModule</directive>
103 <directive module="mod_so">LoadModule</directive>
107 <p>Apache est un serveur modulaire. Ceci implique que seules les
108 fonctionnalités les plus courantes sont incluses dans le serveur de base.
109 Les fonctionnalités étendues sont fournies à l'aide de <a
110 href="mod/">modules</a> qui peuvent être chargés dans Apache.
111 Par défaut, un jeu de <a
112 href="mod/module-dict.html#Status">modules de base</a> est inclus dans le
113 serveur à la compilation. Si le serveur est compilé de façon à utiliser
114 les <a href="dso.html">modules chargés dynamiquement</a>,
115 alors les modules peuvent être compilés séparément et chargés à
116 n'importe quel moment à l'aide de la directive
117 <directive module="mod_so">LoadModule</directive>.
118 Dans le cas contraire, Apache doit être recompilé pour ajouter ou
119 supprimer des modules.
120 Les directives de configuration peuvent être incluses de manière
121 conditionnelle selon la présence ou l'absence d'un module particulier
122 en les plaçant dans un bloc <directive
123 module="core" type="section">IfModule</directive>.</p>
125 <p>Pour voir quels modules ont été compilés avec le serveur,
126 vous pouvez utiliser l'option de ligne de commande <code>-l</code>.</p>
130 <title>Portée des directives</title>
134 <directive module="core" type="section">Directory</directive>
135 <directive module="core" type="section">DirectoryMatch</directive>
136 <directive module="core" type="section">Files</directive>
137 <directive module="core" type="section">FilesMatch</directive>
138 <directive module="core" type="section">Location</directive>
139 <directive module="core" type="section">LocationMatch</directive>
140 <directive module="core" type="section">VirtualHost</directive>
144 <p>Les directives placées dans les fichiers de configuration principaux
145 s'appliquent au serveur dans son ensemble. Si vous souhaitez modifier la
146 configuration d'une partie du serveur seulement, vous pouvez limiter la
147 portée de vos directives en les plaçant dans une section
148 <directive module="core"
149 type="section">Directory</directive>, <directive module="core"
150 type="section">DirectoryMatch</directive>, <directive module="core"
151 type="section">Files</directive>, <directive module="core"
152 type="section">FilesMatch</directive>, <directive module="core"
153 type="section">Location</directive>, ou <directive module="core"
154 type="section">LocationMatch</directive>.
155 Ces sections limitent le champ d'application des directives qu'elles
156 contiennent à des URls ou des portions du système de fichiers particulières.
157 Elles peuvent aussi être imbriquées, ce qui permet
158 une configuration très fine.</p>
160 <p>Apache peut servir simultanément de nombreux sites web au travers des
161 <a href="vhosts/">Hôtes Virtuels</a>. La portée des directives peut ainsi
162 être limitée en les plaçant dans des sections
163 <directive module="core" type="section">VirtualHost</directive>,
164 afin qu'elles ne s'appliquent qu'aux requêtes
165 pour un site web particulier.</p>
167 <p>Bien que la plupart des directives puissent être placées dans
168 chacune de ces sections, certaines d'entre elles n'ont aucun sens
169 dans certains contextes.
170 Par exemple, les directives qui contrôlent la création des processus
171 n'ont de sens que dans le contexte du serveur principal. Pour déterminer
172 quelles directives peuvent être placées dans quelles sections, consultez
173 le <a href="mod/directive-dict.html#Context">Contexte</a> de la
174 directive. Pour plus d'informations, nous fournissons des détails dans
175 <a href="sections.html">Comment fonctionnent les sections Directory,
176 Location et Files</a>.</p>
179 <section id="htaccess">
180 <title>Fichiers .htaccess</title>
184 <directive module="core">AccessFileName</directive>
185 <directive module="core">AllowOverride</directive>
189 <p>Apache permet la gestion décentralisée de la configuration
190 via des fichiers spéciaux placés dans l'arborescence du site web.
191 Ces fichiers spéciaux se nomment en général <code>.htaccess</code>,
192 mais tout autre nom peut être spécifié à l'aide de la directive
193 <directive module="core">AccessFileName</directive>.
194 Les directives placées dans les fichiers <code>.htaccess</code>
195 s'appliquent au répertoire dans lequel vous avez placé le fichier,
196 ainsi qu'à tous ses sous-répertoires.
197 La syntaxe des fichiers <code>.htaccess</code> est la même que celle
198 des fichiers de configuration principaux. Comme les fichiers
199 <code>.htaccess</code> sont lus à chaque requête, les modifications de
200 ces fichiers prennent effet immédiatement.</p>
202 <p>Pour déterminer quelles directives peuvent être placées
203 dans les fichiers <code>.htaccess</code>, consultez le
204 <a href="mod/directive-dict.html#Context">Contexte</a> de la
205 directive. L'administrateur du serveur peut contrôler quelles
206 directives peuvent être placées dans les fichiers
207 <code>.htaccess</code> en définissant la directive
208 <directive module="core">AllowOverride</directive>
209 dans les fichiers de configuration principaux.</p>
211 <p>Pour plus d'informations sur les fichiers <code>.htaccess</code>,
212 se référer au <a href="howto/htaccess.html">tutoriel .htaccess</a>.</p>