1 <?xml version="1.0" encoding="ISO-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head>
4 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7 This file is generated from xml source: DO NOT EDIT
8 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
10 <title>Sections de configuration - Serveur Apache HTTP Version 2.5</title>
11 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
12 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
13 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
14 <script src="./style/scripts/prettify.min.js" type="text/javascript">
17 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
18 <body id="manual-page"><div id="page-header">
19 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
20 <p class="apache">Serveur Apache HTTP Version 2.5</p>
21 <img alt="" src="./images/feather.png" /></div>
22 <div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
24 <a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="./">Version 2.5</a></div><div id="page-content"><div id="preamble"><h1>Sections de configuration</h1>
26 <p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
27 <a href="./fr/sections.html" title="Français"> fr </a> |
28 <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
29 <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
30 <a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
32 <p>Les directives des <a href="configuring.html">fichiers de configuration</a> peuvent s'appliquer
33 au serveur dans son ensemble, ou seulement à des répertoires, fichiers, hôtes,
34 ou URLs particuliers. Ce document décrit comment utiliser les conteneurs de
35 sections de configuration ou les fichiers <code>.htaccess</code> pour
36 modifier la portée des directives de configuration.</p>
38 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types de conteneurs de sections de
39 configuration</a></li>
40 <li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Système de fichiers,
41 arborescence du site web et expressions booléennes</a></li>
42 <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Hôtes virtuels</a></li>
43 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Mandataire</a></li>
44 <li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">Quelles sont les directives autorisées ?</a></li>
45 <li><img alt="" src="./images/down.gif" /> <a href="#merging">Comment les sections sont combinées entre elles</a></li>
46 </ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div>
47 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
49 <h2><a name="types" id="types">Types de conteneurs de sections de
50 configuration</a></h2>
52 <table class="related"><tr><th>Modules Apparentés</th><th>Directives Apparentées</th></tr><tr><td><ul><li><code class="module"><a href="./mod/core.html">core</a></code></li><li><code class="module"><a href="./mod/mod_version.html">mod_version</a></code></li><li><code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code></li></ul></td><td><ul><li><code class="directive"><a href="./mod/core.html#directory"><Directory></a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#files"><Files></a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#if"><If></a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code></li><li><code class="directive"><a href="./mod/core.html#location"><Location></a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code></li></ul></td></tr></table>
54 <p>Il existe deux grands types de conteneurs. La plupart des conteneurs sont
55 évalués pour chaque requête. Les directives qu'ils contiennent s'appliquent
56 seulement aux requêtes qui sont concernées par le conteneur. En revanche,
58 <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>, <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>, et
59 <code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code> sont
60 évalués seulement au démarrage et au redémarrage du serveur.
61 Si leurs conditions sont vérifiées au démarrage, les directives qu'ils contiennent
62 s'appliqueront à toutes les requêtes. Si leurs conditions ne sont pas vérifiées, les
63 directives qu'ils contiennent seront ignorées.</p>
65 <p>Le conteneur <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>
66 contient des directives qui ne seront appliquées que si un paramètre
67 approprié a été défini dans la ligne de commande de <code class="program"><a href="./programs/httpd.html">httpd</a></code>.
69 avec la configuration suivante, toutes les requêtes seront redirigées vers
70 un autre site si le serveur est démarré en utilisant la ligne de commande :
71 <code>httpd -DClosedForNow</code>:</p>
73 <pre class="prettyprint lang-config"><IfDefine ClosedForNow>
74 Redirect "/" "http://otherserver.example.com/"
75 </IfDefine></pre>
78 <p>Le conteneur <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>
79 est similaire; les directives qu'il contient ne s'appliqueront que si
80 un module particulier est disponible au niveau du serveur.
81 Le module doit être soit compilé statiquement dans le serveur, soit
82 dynamiquement et dans ce cas, la ligne <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante doit apparaître
83 plus haut dans le fichier de configuration. Ce conteneur ne doit être
84 utilisé que dans le cas où votre fichier de configuration doit fonctionner
85 indépendamment de la présence ou de l'absence de certains modules.
86 Il ne doit pas contenir de directives que vous souhaitez voir s'appliquer
87 systématiquement, car vous pouvez perdre ainsi de précieux messages d'erreur
88 à propos de modules manquants.</p>
90 <p>Dans l'exemple suivant, la directive <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfile">MimeMagicFile</a></code> ne s'appliquera que si le
91 module <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> est disponible.</p>
93 <pre class="prettyprint lang-config"><IfModule mod_mime_magic.c>
94 MimeMagicFile conf/magic
95 </IfModule></pre>
99 <code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
100 est similaire aux conteneurs <code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code> et <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>; les directives qu'il contient ne
101 s'appliqueront que si une version particulière du serveur s'exécute. Ce
102 conteneur a été conçu pour une utilisation dans les suites de tests
103 et les grands réseaux qui doivent prendre en compte différentes versions
104 et configurations de httpd.</p>
106 <pre class="prettyprint lang-config"><IfVersion >= 2.4>
107 # les directives situées ici ne s'appliquent que si la version <br />
108 # est supérieure ou égale à 2.4.0.
109 </IfVersion></pre>
112 <p><code class="directive"><a href="./mod/core.html#ifdefine"><IfDefine></a></code>,
113 <code class="directive"><a href="./mod/core.html#ifmodule"><IfModule></a></code>, et
114 <code class="directive"><a href="./mod/mod_version.html#ifversion"><IfVersion></a></code>
115 peuvent inverser leur test conditionnel en le faisant précéder d'un "!".
116 De plus, ces sections peuvent être imbriquées afin de définir des restrictions
118 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
119 <div class="section">
120 <h2><a name="file-and-web" id="file-and-web">Système de fichiers,
121 arborescence du site web et expressions booléennes</a></h2>
123 <p>Les conteneurs de sections de configuration les plus couramment utilisés
124 sont ceux qui modifient la configuration de points particuliers du système de
125 fichiers ou de l'arborescence du site web. Tout d'abord, il est important de
126 comprendre la différence entre les deux. Le système de fichiers est une vue
127 de vos disques tels qu'ils sont perçus par votre système d'exploitation.
128 Par exemple, avec une installation par défaut,
129 Apache httpd est situé dans <code>/usr/local/apache2</code> pour le système de
130 fichiers UNIX, ou <code>"c:/Program Files/Apache Group/Apache2"</code> pour
131 le système de fichiers Windows. (Notez que des slashes directs doivent
132 toujours être utilisés comme séparateur de chemin
133 dans les fichiers de configuration d'Apache httpd, même sous
135 l'arborescence du site web, il s'agit d'une vue de votre site
136 tel que présenté par le
137 serveur web et perçue par le client. Ainsi le chemin <code>/dir/</code> dans
138 l'arborescence du site web correspond au chemin
139 <code>/usr/local/apache2/htdocs/dir/</code> dans le système de fichiers pour
140 une installation d'Apache httpd par défaut sous UNIX.
141 En outre, l'arborescence du site web n'a pas besoin de correspondre en permanence au
142 système de fichiers, car les pages web peuvent être générées dynamiquement
143 à partir de bases de données ou d'autres emplacements.</p>
145 <h3><a name="filesystem" id="filesystem">Conteneurs de système de fichiers</a></h3>
147 <p>Les conteneurs <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
148 et <code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
149 ainsi que leurs équivalents acceptant les
150 <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a>,
151 appliquent des directives à certaines parties du système de fichiers.
152 Les directives contenues dans une section <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> s'appliquent au répertoire
153 précisé, ainsi qu'à tous ses sous-répertoires et aux fichiers que ces
154 derniers contiennent.
155 Le même effet peut être obtenu en utilisant les <a href="howto/htaccess.html">fichiers .htaccess</a>. Par exemple, avec la
156 configuration suivante, l'indexation sera activée pour le répertoire
157 <code>/var/web/dir1</code> et tous ses sous-répertoires.</p>
159 <pre class="prettyprint lang-config"><Directory "/var/web/dir1">
161 </Directory></pre>
164 <p>Les directives contenues dans une section <code class="directive"><a href="./mod/core.html#files"><Files></a></code> s'appliquent à tout fichier
165 avec le nom spécifié, quel que soit le répertoire dans lequel il se trouve.
166 Ainsi par exemple, les directives de configuration suivantes, si elles sont
167 placées dans la section principale du fichier de configuration, vont interdire
168 l'accès à tout fichier nommé <code>private.html</code> quel que soit
169 l'endroit où il se trouve.</p>
171 <pre class="prettyprint lang-config"><Files "private.html">
176 <p>Pour faire référence à des fichiers qui se trouvent en des points
177 particuliers du système de fichiers, les sections
178 <code class="directive"><a href="./mod/core.html#files"><Files></a></code> et
179 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
180 peuvent être combinées. Par exemple, la configuration suivante va interdire
181 l'accès à <code>/var/web/dir1/private.html</code>,
182 <code>/var/web/dir1/subdir2/private.html</code>,
183 <code>/var/web/dir1/subdir3/private.html</code>, ainsi que toute instance de
184 <code>private.html</code> qui se trouve dans l'arborescence
185 <code>/var/web/dir1/</code>.</p>
187 <pre class="prettyprint lang-config"><Directory "/var/web/dir1">
188 <Files "private.html">
191 </Directory></pre>
195 <h3><a name="webspace" id="webspace">Conteneurs de l'arborescence du site web</a></h3>
197 <p>le conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
198 et son équivalent acceptant les
199 <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, modifient quant à eux la
200 configuration de parties de l'arborescence du site web. Par exemple, la
201 configuration suivante interdit l'accès à toute URL dont la partie chemin
202 commence par /private.
203 En particulier, l'interdiction s'appliquera aux requêtes pour :
204 <code>http://yoursite.example.com/private</code>,
205 <code>http://yoursite.example.com/private123</code>, et
206 <code>http://yoursite.example.com/private/dir/file.html</code> ainsi qu'à
207 toute requête commençant par la chaîne de caractères <code>/private</code>.</p>
209 <pre class="prettyprint lang-config"><LocationMatch "^/private">
211 </LocationMatch></pre>
214 <p>Le conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
215 n'a pas besoin de faire référence à un élément du système de fichiers.
216 Par exemple, l'exemple suivant montre comment faire référence à une URL
217 particulière vers un gestionnaire interne du serveur HTTP Apache fourni par le module
218 <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>.
219 Il n'est pas nécessaire de trouver un fichier nommé <code>server-status</code>
220 dans le système de fichiers.</p>
222 <pre class="prettyprint lang-config"><Location "/server-status">
223 SetHandler server-status
224 </Location></pre>
228 <h3><a name="overlapping-webspace" id="overlapping-webspace">Espace web imbriqué</a></h3>
229 <p>Pour contrôler deux URLs imbriquées, on doit tenir compte de l'ordre
230 dans lequel certaines sections ou directives sont évaluées. Pour
231 <code class="directive"><a href="./mod/core.html#location"><Location></a></code>, on doit
233 <pre class="prettyprint lang-config"><Location "/foo">
235 <Location "/foo/bar">
236 </Location></pre>
238 <p>Les directives <code class="directive"><a href="./mod/mod_alias.html#alias"><Alias></a></code>, quant à elles, sont évaluées vice-versa :</p>
239 <pre class="prettyprint lang-config">Alias "/foo/bar" "/srv/www/uncommon/bar"
240 Alias "/foo" "/srv/www/common/foo"</pre>
242 <p>Ceci est aussi vrai pour les directives <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> :</p>
243 <pre class="prettyprint lang-config">ProxyPass "/special-area" "http://special.example.com" smax=5 max=10
244 ProxyPass "/" "balancer://mycluster/" stickysession=JSESSIONID|jsessionid nofailover=On</pre>
249 <h3><a name="wildcards" id="wildcards">Caractères de remplacement
250 et expressions rationnelles</a></h3>
253 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>,
254 <code class="directive"><a href="./mod/core.html#files"><Files></a></code>, et
255 <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
256 peuvent utiliser des caractères de remplacement de style shell comme dans
257 la fonction <code>fnmatch</code> de la bibliothèque C standard.
259 correspond à toute séquence de caractères, "?" à un caractère seul,
260 et "[<em>seq</em>]" à tout caractère contenu dans <em>seq</em>.
262 ne peut pas faire l'objet d'un remplacement;
263 il doit être spécifié explicitement.</p>
265 <p>Si une définition des critères de correspondance
266 encore plus souple est nécessaire, chaque conteneur
267 possède son équivalent acceptant les expressions rationnelles : <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>, <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>, et <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> acceptent les
268 <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a> compatibles Perl
269 pour définir les critères de correspondance. Mais voyez plus loin la section
270 à propos de la combinaison des sections de configuration
271 pour comprendre comment l'utilisation de
272 conteneurs avec des expressions rationnelles va modifier la manière
273 dont les directives sont appliquées.</p>
275 <p>Un conteneur qui modifie la configuration de tous les
276 répertoires utilisateurs à l'aide de caractères de remplacement
278 les expressions rationnelles pourrait ressembler à ceci :</p>
280 <pre class="prettyprint lang-config"><Directory "/home/*/public_html">
282 </Directory></pre>
285 <p>Avec les conteneurs utilisant les expressions rationnelles,
286 on peut interdire l'accès à de nombreux types de fichiers d'images
288 <pre class="prettyprint lang-config">+<FilesMatch "\.(?i:gif|jpe?g|png)$">
290 </FilesMatch></pre>
293 <p>Les expressions rationnelles contenant des <strong>groupes nommés et
294 des références arrières</strong> sont ajoutées à l'environnement avec
295 leur nom en majuscules. Ceci permet de référencer des éléments de
296 chemins de fichiers et d'URLs depuis une <a href="expr.html">expression</a> et au sein de modules comme
297 <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code>.</p>
299 <pre class="prettyprint lang-config"><DirectoryMatch "^/var/www/combined/(?<SITENAME>[^/]+)">
300 require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
301 </DirectoryMatch></pre>
306 <h3><a name="expressions" id="expressions">Expressions booléennes</a></h3>
307 <p>La directive <code class="directive"><a href="./mod/core.html#if"><If></a></code>
308 permet de modifier la configuration en fonction d'une condition qui peut
309 être définie sous la forme d'une expression booléenne. Dans l'exemple
310 suivant, l'accès est interdit si l'en-tête HTTP Referer ne commence pas
311 par "http://www.example.com/".</p>
312 <pre class="prettyprint lang-config"><If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')">
319 <h3><a name="whichwhen" id="whichwhen">Que faut-il utiliser et quand ?</a></h3>
321 <p>Choisir entre des conteneurs de système de fichiers et des conteneurs
322 d'arborescence du site web est vraiment très simple.
323 Pour appliquer des directives à des objets qui résident dans le système de
324 fichiers, utilisez toujours un conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ou <code class="directive"><a href="./mod/core.html#files"><Files></a></code>. Pour appliquer des directives à des objets
325 qui ne résident pas dans le système de fichiers (comme une page web générée
326 par une base de données), utilisez un conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code>.</p>
328 <p>Il ne faut jamais utiliser un conteneur <code class="directive"><a href="./mod/core.html#location"><Location></a></code> pour restreindre l'accès à des
329 objets du système de fichiers, car plusieurs localisations de
330 l'arborescence du site web (URLs) peuvent correspondre à la même localisation
331 du système de fichier, ce qui peut permettre de contourner vos restrictions.
332 Par exemple, imaginez la configuration suivante :</p>
334 <pre class="prettyprint lang-config"><Location "/dir/">
336 </Location></pre>
339 <p>Elle fonctionne correctement si la requête appelle
340 <code>http://yoursite.example.com/dir/</code>. Mais que va-t-il se passer si
341 votre système de fichiers est insensible à la casse ?
342 Votre restriction va pouvoir être tout simplement contournée en envoyant une
344 <code>http://yoursite.example.com/DIR/</code>. Le conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, quant à lui, s'appliquera
345 à tout contenu servi à partir de cette localisation,
346 sans tenir compte de la manière dont il est appelé.
347 (Les liens du système de fichiers constituent une exception.
348 Le même répertoire peut être placé dans plusieurs parties du système de
349 fichiers en utilisant des liens symboliques. Le conteneur
350 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> va suivre le
351 lien symbolique sans modifier le nom du chemin. Par conséquent, pour plus de
352 sécurité, les liens symboliques doivent être désactivés à l'aide de la
354 <code class="directive"><a href="./mod/core.html#options">Options</a></code> appropriée.)</p>
356 <p>Si vous pensez que vous n'êtes pas concerné par ce problème
357 parceque vous utilisez un système de fichiers sensible à la casse,
358 gardez à l'esprit qu'il y a de nombreuses autres manières pour faire
359 correspondre plusieurs localisations de l'arborescence du site web à la même
360 localisation du système de fichiers. C'est pourquoi vous devez autant que
361 possible toujours utiliser les conteneurs de système de fichiers.
362 Il y a cependant une exception à cette règle. Placer des restrictions de
363 configuration dans un conteneur <code><Location
364 "/"></code> est tout à fait sans rique car ce conteneur va s'appliquer à
365 toutes les requêtes sans tenir compte de l'URL spécifique.</p>
368 <h3><a name="nesting" id="nesting">Imbrication des sections</a></h3>
370 <p>Certains types de sections peuvent être imbriqués : d'une part, on
371 peut utiliser les sections <code class="directive"><a href="./mod/core.html#files"><Files></a></code> à l'intérieur des sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, d'autre part, on
373 directives <code class="directive"><a href="./mod/core.html#if"><If></a></code> à
374 l'intérieur des sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, <code class="directive"><a href="./mod/core.html#location"><Location></a></code> et <code class="directive"><a href="./mod/core.html#files"><Files></a></code>. Les valeurs des expressions
375 rationnelles correspondant aux sections nommées se comportent de manière
378 <p>Les sections imbriquées sont fusionnées après les sections
379 non-imbriquées de même type.</p>
383 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
384 <div class="section">
385 <h2><a name="virtualhost" id="virtualhost">Hôtes virtuels</a></h2>
387 <p>Le conteneur <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
388 contient des directives qui s'appliquent à des hôtes spécifiques.
389 Ceci s'avère utile pour servir des hôtes multiples à partir de la même machine,
390 chacun d'entre eux possédant une configuration différente. Pour de plus amples
392 voir la <a href="vhosts/">Documentation sur les hôtes virtuels</a>.</p>
393 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
394 <div class="section">
395 <h2><a name="proxy" id="proxy">Mandataire</a></h2>
398 <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
399 et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>
400 appliquent les directives de configuration qu'ils contiennent uniquement aux
401 sites qui correspondent à l'URL spécifiée et auxquels on a
402 accédé via le serveur mandataire du module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
403 Par exemple, la configuration suivante n'autorisera qu'un sous-ensemble de
404 clients à accéder au site <code>www.example.com</code> en passant par le serveur
407 <pre class="prettyprint lang-config"><Proxy http://www.example.com/*>
408 Require host yournetwork.example.com
411 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
412 <div class="section">
413 <h2><a name="whatwhere" id="whatwhere">Quelles sont les directives autorisées ?</a></h2>
415 <p>Pour déterminer quelles sont les directives autorisées pour tel type de
416 section de configuration, vérifiez le <a href="mod/directive-dict.html#Context">Contexte</a> de la directive.
417 Tout ce qui est autorisé dans les sections
418 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>
419 l'est aussi d'un point de vue syntaxique dans les sections
420 <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>,
421 <code class="directive"><a href="./mod/core.html#files"><Files></a></code>,
422 <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>,
423 <code class="directive"><a href="./mod/core.html#location"><Location></a></code>,
424 <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code>,
425 <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>,
426 et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>.
427 Il y a cependant quelques exceptions :</p>
430 <li>La directive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
431 ne fonctionne que dans les sections
432 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>.</li>
434 <li>Les <code class="directive"><a href="./mod/core.html#options">Options</a></code> <code>FollowSymLinks</code> et
435 <code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les sections
436 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> ou les fichiers
437 <code>.htaccess</code>.</li>
439 <li>La directive <code class="directive"><a href="./mod/core.html#options">Options</a></code> ne peut pas être
440 utilisée dans les sections
441 <code class="directive"><a href="./mod/core.html#files"><Files></a></code>
442 et <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code>.</li>
444 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
445 <div class="section">
446 <h2><a name="merging" id="merging">Comment les sections sont combinées entre elles</a></h2>
448 <p>Les sections de configuration sont appliquées dans un ordre très particulier.
449 Il est important de savoir comment cet ordre est défini car il peut avoir
450 des effets importants sur la manière dont les directives de configuration
451 sont interprétées.</p>
453 <p>L'ordre dans lequel les sections sont combinées est :</p>
456 <li> Les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (à l'exception des
457 expressions rationnelles)
458 et les fichiers <code>.htaccess</code> sont appliqués simultanément (avec
459 la possibilité pour <code>.htaccess</code>, s'il y est autorisé, de
461 <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>)</li>
464 <code class="directive"><a href="./mod/core.html#directorymatch"><DirectoryMatch></a></code>
465 (et <code><Directory ~></code>)</li>
467 <li>Les sections <code class="directive"><a href="./mod/core.html#files"><Files></a></code> et <code class="directive"><a href="./mod/core.html#filesmatch"><FilesMatch></a></code> sont appliquées
471 <code class="directive"><a href="./mod/core.html#location"><Location></a></code>
472 et <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> sont appliquées
475 <li>Les directives <code class="directive"><a href="./mod/core.html#if"><If></a></code>
479 <p>Mises à part les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, chaque groupe est traité selon
480 l'ordre dans lequel il apparaît dans les fichiers de configuration.
481 Les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> (groupe 1 ci-dessus)
482 sont traitées dans l'ordre du répertoire le plus court vers le plus long.
483 Par exemple, <code><Directory "/var/web/dir"></code> sera
484 traité avant <code><Directory
485 "/var/web/dir/subdir"></code>. Si plusieurs sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> s'appliquent au même
486 répertoire, elles sont traitées selon l'ordre dans lequel elles
487 apparaissent dans le fichier de configuration.
488 Les sections de configuration incluses via la directive <code class="directive"><a href="./mod/core.html#include">Include</a></code> sont traitées comme si elles se
489 trouvaient réellement dans le fichier qui les inclut à la position de la
491 <code class="directive"><a href="./mod/core.html#include">Include</a></code>.</p>
493 <p>Les sections situées à l'intérieur de sections <code class="directive"><a href="./mod/core.html#virtualhost"><VirtualHost></a></code>
494 sont appliquées <em>après</em> les sections correspondantes situées en
495 dehors de la définition de l'hôte virtuel, ce qui permet à l'hôte virtuel
496 de prévaloir sur la configuration du serveur principal.</p>
498 <p>Quand la requête est servie par le module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>,
499 le conteneur <code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
500 prend la place du conteneur <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> dans l'ordre de traitement.</p>
502 <div class="note"><h3>Note technique</h3>
503 Une séquence <code><Location></code>/<code><LocationMatch></code>
504 est réellement traitée juste avant la phase de traduction du nom
505 (où <code>Aliases</code> et <code>DocumentRoots</code>
506 sont utilisés pour faire correspondre les URLs aux noms de fichiers).
507 Les effets de cette séquence disparaissent totalement lorsque
508 la traduction est terminée.
511 <h3><a name="relationship-module-configuration" id="relationship-module-configuration">Interactions entre
512 modules et sections de configuration</a></h3>
513 <p>Une question se pose souvent après avoir lu comment les sections de
514 configuration sont fusionnées : comment et quand les directives de modules
515 particuliers comme <code class="module"><a href="./mod/mod_rewrite.html">mod_rewrite</a></code> sont-elles interprétées ? La
516 réponse n'est pas triviale et nécessite un approfondissement. Chaque module
517 httpd gère sa propre configuration, et chacune de ses directives dans
518 httpd.conf définit un élément de configuration dans un contexte particulier.
519 httpd n'exécute pas un commande au moment où elle est lue.</p>
520 <p>A l'exécution, le noyau de httpd parcours les sections de configuration
521 dans l'ordre décrit ci-dessus afin de déterminer lesquelles s'appliquent à
522 la requête courante. Lorsqu'une première section s'applique, elle est
523 considérée comme la configuration courante pour cette requête. Si une
524 section suivante s'applique aussi, chaque module qui possède des directives
525 dans chacune de ces sections a la possibilité de fusionner sa configuration
526 entre ces deux sections. Il en résulte une troisième configuration et le
527 processus de fusion se poursuit jusqu'à ce que toutes les sections de
528 configuration aient été évaluées.</p>
529 <p>Après l'étape précédente, le traitement proprement dit de la requête HTTP
530 peut commencer : chaque module peut effectuer toute tâche qui lui incombe,
531 et pour déterminer de quelle manière dont il doit agir, il peut s'appuyer
532 sur le noyau de httpd pour retrouver sa configuration globale issue de la
533 fusion précédente.</p>
534 <p>Un exemple permet de mieux visualiser l'ensemble du processus. la
535 configuration suivante utilise la directive <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> du module
536 <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> pour définir un en-tête HTTP spécifique. Quelle
537 valeur httpd va-t-il affecter à l'en-tête <code>CustomHeaderName</code> pour
538 une requête vers <code>/example/index.html</code> ?
540 <pre class="prettyprint lang-config"><Directory "/">
541 Header set CustomHeaderName one
542 <FilesMatch ".*">
543 Header set CustomHeaderName three
547 <Directory "/example">
548 Header set CustomHeaderName two
549 </Directory></pre>
552 <li><code class="directive">Directory</code> "/" s'applique, et une configuration
553 initiale est créée qui définit l'en-tête <code>CustomHeaderName</code>
554 avec la valeur <code>one</code>.</li>
555 <li><code class="directive">Directory</code> "/example" s'applique, et comme
556 <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> spécifie dans son code que
557 la valeur d'un en-tête doit être écrasée si ce dernier est défini à
558 nouveau, une nouvelle configuration est créée qui définit l'en-tête
559 <code>CustomHeaderName</code> avec la valeur <code>two</code>.</li>
560 <li><code class="directive">FilesMatch</code> ".*" s'applique, une nouvelle
561 opportunité de fusion surgit, et l'en-tête <code>CustomHeaderName</code>
562 est défini à la valeur <code>three</code>.</li>
563 <li>Finalement, au cours des étapes suivantes du traitement de la
564 requête HTTP, <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> sera sollicité, et il se
565 basera sur la configuration qui a défini l'en-tête
566 <code>CustomHeaderName</code> à la valeur <code>three</code>.
567 <code class="module"><a href="./mod/mod_headers.html">mod_headers</a></code> utilise normalement cette configuration pour
568 accomplir sa tâche, à savoir définir des en-têtes HTTP. Cela ne veut
569 cependant pas dire qu'un module ne peut pas effectuer des actions plus
570 complexes comme désactiver des directives car elle ne sont pas
571 nécessaires ou obsolètes, etc...</li>
574 <p>Ceci est aussi vrai pour les fichiers .htaccess car ils possèdent la même
575 priorité que les sections <code class="directive">Directory</code> dans l'ordre de
576 fusion. Il faut bien comprendre que les sections de configuration comme
577 <code class="directive">Directory</code> et <code class="directive">FilesMatch</code> ne
578 sont pas comparables avec les directives spécifiques de modules comme
579 <code class="directive"><a href="./mod/mod_headers.html#header">Header</a></code> ou <code class="directive"><a href="./mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> car elles agissent à des
584 <h3><a name="merge-examples" id="merge-examples">Quelques exemples utiles</a></h3>
586 <p>Voici un exemple imaginaire qui montre l'ordre de combinaison des sections.
587 En supposant qu'elles s'appliquent toutes à la requête, les directives de
588 cet exemple seront appliquées dans l'ordre suivant : A > B > C > D >
591 <pre class="prettyprint lang-config"><Location "/">
595 <Files "f.html">
599 <VirtualHost *>
600 <Directory "/a/emphasis role="bold"">
605 <DirectoryMatch "^.*b$">
607 </DirectoryMatch>
609 <Directory "/a/b">
611 </Directory></pre>
614 <p>Pour un exemple plus concret, considérez ce qui suit. Sans tenir compte
615 de toute restriction d'accès placée dans les sections <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code>, la section <code class="directive"><a href="./mod/core.html#location"><Location></a></code> sera
616 évaluée en dernier et permettra un accès au serveur sans aucune restriction.
617 En d'autres termes, l'ordre de la combinaison des sections est important,
618 soyez donc prudent !</p>
620 <pre class="prettyprint lang-config"><Location "/">
624 # Arrghs! Cette section <Directory> n'aura aucun effet
625 <Directory "/">
628 Require not host badguy.example.com
630 </Directory></pre>
636 <div class="bottomlang">
637 <p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> |
638 <a href="./fr/sections.html" title="Français"> fr </a> |
639 <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
640 <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
641 <a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
642 </div><div class="top"><a href="#page-header"><img src="./images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
643 <script type="text/javascript"><!--//--><![CDATA[//><!--
644 var comments_shortname = 'httpd';
645 var comments_identifier = 'http://httpd.apache.org/docs/trunk/sections.html';
647 if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
648 d.write('<div id="comments_thread"><\/div>');
649 var s = d.createElement('script');
650 s.type = 'text/javascript';
652 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
653 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
656 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
658 })(window, document);
659 //--><!]]></script></div><div id="footer">
660 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
661 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
662 if (typeof(prettyPrint) !== 'undefined') {