]> granicus.if.org Git - apache/blob - docs/manual/sections.html.fr
Full doc rebuild.
[apache] / docs / manual / sections.html.fr
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         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5               This file is generated from xml source: DO NOT EDIT
6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7       -->
8 <title>Sections de configuration - Serveur Apache HTTP</title>
9 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
12 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
13 <body id="manual-page"><div id="page-header">
14 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p>
15 <p class="apache">Serveur Apache HTTP Version 2.3</p>
16 <img alt="" src="./images/feather.gif" /></div>
17 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
18 <div id="path">
19 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.3</a></div><div id="page-content"><div id="preamble"><h1>Sections de configuration</h1>
20 <div class="toplang">
21 <p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
22 <a href="./fr/sections.html" title="Français">&nbsp;fr&nbsp;</a> |
23 <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
24 <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
25 <a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
26 </div>
27  <p>Les directives des <a href="configuring.html">fichiers de configuration</a> peuvent s'appliquer
28 au serveur dans son ensemble, ou seulement à des répertoires, fichiers, hôtes,
29 ou URLs particuliers.  Ce document décrit comment utiliser les conteneurs de
30 sections de configuration ou les fichiers <code>.htaccess</code> pour
31 modifier la portée des directives de configuration.</p>
32 </div>
33 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#types">Types de conteneurs de sections de
34 configuration</a></li>
35 <li><img alt="" src="./images/down.gif" /> <a href="#file-and-web">Système de fichiers et
36 arborescence du site web</a></li>
37 <li><img alt="" src="./images/down.gif" /> <a href="#virtualhost">Hôtes virtuels</a></li>
38 <li><img alt="" src="./images/down.gif" /> <a href="#proxy">Mandataire</a></li>
39 <li><img alt="" src="./images/down.gif" /> <a href="#whatwhere">Quelles sont les directives autorisées ?</a></li>
40 <li><img alt="" src="./images/down.gif" /> <a href="#mergin">Comment les sections sont combinées entre elles</a></li>
41 </ul></div>
42 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
43 <div class="section">
44 <h2><a name="types" id="types">Types de conteneurs de sections de
45 configuration</a></h2>
46
47 <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">&lt;Directory&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#if">&lt;If&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code></li><li><code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code></li><li><code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code></li></ul></td></tr></table>
48
49 <p>Il existe deux grands types de conteneurs.  La plupart des conteneurs sont
50 évalués pour chaque requête.  Les directives qu'ils contiennent s'appliquent
51 seulement aux requêtes qui sont concernées par le conteneur.  En revanche,
52 les conteneurs
53 <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>, <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, et
54 <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code> sont
55 évalués seulement au démarrage et au redémarrage du serveur.
56 Si leurs conditions sont vérifiées au démarrage, les directives qu'ils contiennent
57 s'appliqueront à toutes les requêtes.  Si leurs conditions ne sont pas vérifiées, les
58 directives qu'ils contiennent seront ignorées.</p>
59
60 <p>Le conteneur <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>
61 contient des directives qui ne seront appliquées que si un paramètre
62 approprié a été défini dans la ligne de commande de <code class="program"><a href="./programs/httpd.html">httpd</a></code>.
63 Par exemple,
64 avec la configuration suivante, toutes les requêtes seront redirigées vers
65 un autre site si le serveur est démarré en utilisant la ligne de commande :
66 <code>httpd -DClosedForNow</code>:</p>
67
68 <div class="example"><p><code>
69 &lt;IfDefine ClosedForNow&gt;<br />
70 Redirect / http://otherserver.example.com/<br />
71 &lt;/IfDefine&gt;
72 </code></p></div>
73
74 <p>Le conteneur <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>
75 est similaire; les directives qu'il contient ne s'appliqueront que si
76 un module particulier est disponible au niveau du serveur.
77 Le module doit être soit compilé statiquement dans le serveur, soit
78 dynamiquement et dans ce cas, la ligne <code class="directive"><a href="./mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante doit apparaître
79 plus haut dans le fichier de configuration.  Ce conteneur ne doit être
80 utilisé que dans le cas où votre fichier de configuration doit fonctionner
81 indépendamment de la présence ou de l'absence de certains modules.
82 Il ne doit pas contenir de directives que vous souhaitez voir s'appliquer
83 systématiquement, car vous pouvez perdre ainsi de précieux messages d'erreur
84 à propos de modules manquants.</p>
85
86 <p>Dans l'exemple suivant, la directive <code class="directive"><a href="./mod/mod_mime_magic.html#mimemagicfiles">MimeMagicFiles</a></code> ne s'appliquera que si le
87 module <code class="module"><a href="./mod/mod_mime_magic.html">mod_mime_magic</a></code> est disponible.</p>
88
89 <div class="example"><p><code>
90 &lt;IfModule mod_mime_magic.c&gt;<br />
91 MimeMagicFile conf/magic<br />
92 &lt;/IfModule&gt;
93 </code></p></div>
94
95 <p>Le conteneur
96 <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
97 est similaire aux conteneurs <code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code> et <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>; les directives qu'il contient ne
98 s'appliqueront que si une version particulière du serveur s'exécute.  Ce
99 conteneur a été conçu pour une utilisation dans les suites de tests
100 et les grands réseaux qui doivent prendre en compte différentes versions
101 et configurations de httpd.</p>
102
103 <div class="example"><p><code>
104   &lt;IfVersion &gt;= 2.1&gt;<br />
105   <span class="indent">
106     # les directives situées ici ne s'appliquent que si la version <br />
107     # est supérieure ou égale à 2.1.0.<br />
108   </span>
109   &lt;/IfVersion&gt;
110 </code></p></div>
111
112 <p><code class="directive"><a href="./mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>,
113 <code class="directive"><a href="./mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>, et
114 <code class="directive"><a href="./mod/mod_version.html#ifversion">&lt;IfVersion&gt;</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
117 plus complexes.</p>
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 et
121 arborescence du site web</a></h2>
122
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
134 Windows.)  Quant à
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>
144
145 <h3><a name="filesystem" id="filesystem">Conteneurs de système de fichiers</a></h3>
146
147 <p>Les conteneurs <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
148 et <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</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">&lt;Directory&gt;</a></code> s'appliquent au répertoire
153 précisé, ainsi qu'à tous ses sous-répertoires.
154 Le même effet peut être obtenu en utilisant les <a href="howto/htaccess.html">fichiers .htaccess</a>.  Par exemple, avec la
155 configuration suivante, l'indexation sera activée pour le répertoire
156 <code>/var/web/dir1</code> et tous ses sous-répertoires.</p>
157
158 <div class="example"><p><code>
159 &lt;Directory /var/web/dir1&gt;<br />
160 Options +Indexes<br />
161 &lt;/Directory&gt;
162 </code></p></div>
163
164 <p>Les directives contenues dans une section <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</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>
170
171 <div class="example"><p><code>
172 &lt;Files private.html&gt;<br />
173 Order allow,deny<br />
174 Deny from all<br />
175 &lt;/Files&gt;
176 </code></p></div>
177
178 <p>Pour faire référence à des fichiers qui se trouvent en des points
179 particuliers du système de fichiers, les sections
180 <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> et
181 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
182 peuvent être combinées.  Par exemple, la configuration suivante va interdire
183 l'accès à <code>/var/web/dir1/private.html</code>,
184 <code>/var/web/dir1/subdir2/private.html</code>,
185 <code>/var/web/dir1/subdir3/private.html</code>, ainsi que toute instance de
186 <code>private.html</code> qui se trouve dans l'arborescence
187 <code>/var/web/dir1/</code>.</p>
188
189 <div class="example"><p><code>
190 &lt;Directory /var/web/dir1&gt;<br />
191 &lt;Files private.html&gt;<br />
192 Order allow,deny<br />
193 Deny from all<br />
194 &lt;/Files&gt;<br />
195 &lt;/Directory&gt;
196 </code></p></div>
197
198
199 <h3><a name="webspace" id="webspace">Conteneurs de l'arborescence du site web</a></h3>
200
201 <p>le conteneur <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
202 et son équivalent acceptant les
203 <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, modifient quant à eux la
204 configuration de parties de l'arborescence du site web.  Par exemple, la
205 configuration suivante interdit l'accès à toute URL dont la partie chemin
206 commence par /private.
207 En particulier, l'interdiction s'appliquera aux requêtes pour :
208 <code>http://yoursite.example.com/private</code>,
209 <code>http://yoursite.example.com/private123</code>, et
210 <code>http://yoursite.example.com/private/dir/file.html</code> ainsi qu'à
211 toute requête commençant par la chaîne de caractères <code>/private</code>.</p>
212
213 <div class="example"><p><code>
214 &lt;Location /private&gt;<br />
215 Order Allow,Deny<br />
216 Deny from all<br />
217 &lt;/Location&gt;
218 </code></p></div>
219
220 <p>Le conteneur <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
221 n'a pas besoin de faire référence à un élément du système de fichiers.
222 Par exemple, l'exemple suivant montre comment faire référence à une URL
223 particulière vers un gestionnaire interne du serveur HTTP Apache fourni par le module
224 <code class="module"><a href="./mod/mod_status.html">mod_status</a></code>.
225 Il n'est pas nécessaire de trouver un fichier nommé <code>server-status</code>
226 dans le système de fichiers.</p>
227
228 <div class="example"><p><code>
229 &lt;Location /server-status&gt;<br />
230 SetHandler server-status<br />
231 &lt;/Location&gt;
232 </code></p></div>
233
234
235 <h3><a name="overlapping-webspace" id="overlapping-webspace">Espace web imbriqué</a></h3>
236 <p>Pour contrôler deux URLs imbriquées, on doit tenir compte de l'ordre
237 dans lequel certaines sections ou directives sont évaluées. Pour
238 <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>, on doit
239 avoir :</p>
240 <div class="example"><p><code>
241 &lt;Location /foo&gt;<br />
242 &lt;/Location&gt;<br />
243 &lt;Location /foo/bar&gt;<br />
244 &lt;/Location&gt;
245 </code></p></div>
246 <p>Les directives <code class="directive"><a href="./mod/core.html#alias">&lt;Alias&gt;</a></code>, quant à elles, sont évaluées vice-versa :</p>
247 <div class="example"><p><code>
248 Alias /foo/bar /srv/www/uncommon/bar<br />
249 Alias /foo /srv/www/common/foo<br />
250 </code></p></div>
251 <p>Ceci est aussi vrai pour les directives <code class="directive"><a href="./mod/mod_proxy.html#proxypass">ProxyPass</a></code> :</p>
252 <div class="example"><p><code>
253 ProxyPass /special-area http://special.example.com smax=5 max=10
254 ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
255 </code></p></div>
256  
257
258
259 <h3><a name="wildcards" id="wildcards">Caractères de remplacement
260 et expressions rationnelles</a></h3>
261
262 <p>Les conteneurs
263 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>,
264 <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>, et
265 <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
266 peuvent utiliser des caractères de remplacement de style shell comme dans
267 la fonction <code>fnmatch</code> de la bibliothèque C standard.
268 Le caractère "*"
269 correspond à toute séquence de caractères, "?" à un caractère seul,
270 et "[<em>seq</em>]" à tout caractère contenu dans <em>seq</em>.
271 Le caractère "/"
272 ne peut pas faire l'objet d'un remplacement;
273 il doit être spécifié explicitement.</p>
274
275 <p>Si une définition des critères de correspondance
276 encore plus souple est nécessaire, chaque conteneur
277 possède son équivalent acceptant les expressions rationnelles : <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>, <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>, et <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> acceptent les
278 <a class="glossarylink" href="./glossary.html#regex" title="voir glossaire">expressions rationnelles</a> compatibles Perl
279 pour définir les critères de correspondance.  Mais voyez plus loin la section
280 à propos de la combinaison des sections de configuration
281 pour comprendre comment l'utilisation de
282 conteneurs avec des expressions rationnelles va modifier la manière
283 dont les directives sont appliquées.</p>
284
285 <p>Un conteneur qui modifie la configuration de tous les
286 répertoires utilisateurs à l'aide de caractères de remplacement
287 mais sans utiliser
288 les expressions rationnelles pourrait ressembler à ceci :</p>
289
290 <div class="example"><p><code>
291 &lt;Directory /home/*/public_html&gt;<br />
292 Options Indexes<br />
293 &lt;/Directory&gt;
294 </code></p></div>
295
296 <p>Avec les conteneurs utilisant les expressions rationnelles,
297 on peut interdire l'accès à de nombreux types de fichiers d'images
298 simultanément :</p>
299 <div class="example"><p><code>
300 &lt;FilesMatch \.(?i:gif|jpe?g|png)$&gt;<br />
301 Order allow,deny<br />
302 Deny from all<br />
303 &lt;/FilesMatch&gt;
304 </code></p></div>
305
306
307
308 <h3><a name="whichwhen" id="whichwhen">Que faut-il utiliser et quand ?</a></h3>
309
310 <p>Choisir entre des conteneurs de système de fichiers et des conteneurs
311 d'arborescence du site web est vraiment très simple.
312 Pour appliquer des directives à des objets qui résident dans le système de
313 fichiers, utilisez toujours un conteneur <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> ou <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>.  Pour appliquer des directives à des objets
314 qui ne résident pas dans le système de fichiers (comme une page web générée
315 par une base de données), utilisez un conteneur <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>.</p>
316
317 <p>Il ne faut jamais utiliser un conteneur <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code> pour restreindre l'accès à des
318 objets du système de fichiers, car plusieurs localisations de
319 l'arborescence du site web (URLs) peuvent correspondre à la même localisation
320 du système de fichier, ce qui peut permettre de contourner vos restrictions.
321 Par exemple, imaginez la configuration suivante :</p>
322
323 <div class="example"><p><code>
324 &lt;Location /dir/&gt;<br />
325 Order allow,deny<br />
326 Deny from all<br />
327 &lt;/Location&gt;
328 </code></p></div>
329
330 <p>Elle fonctionne correctement si la requête appelle
331 <code>http://yoursite.example.com/dir/</code>.  Mais que va-t-il se passer si
332 votre système de fichiers est insensible à la casse ?
333 Votre restriction va pouvoir être tout simplement contournée en envoyant une
334 requête sur
335 <code>http://yoursite.example.com/DIR/</code>.  Le conteneur <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, quant à lui, s'appliquera
336 à tout contenu servi à partir de cette localisation,
337 sans tenir compte de la manière dont il est appelé.
338 (Les liens du système de fichiers constituent une exception.
339 Le même répertoire peut être placé dans plusieurs parties du système de
340 fichiers en utilisant des liens symboliques.  Le conteneur
341 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> va suivre le
342 lien symbolique sans modifier le nom du chemin.  Par conséquent, pour plus de
343 sécurité, les liens symboliques doivent être désactivés à l'aide de la
344 directive
345 <code class="directive"><a href="./mod/core.html#options">Options</a></code> appropriée.)</p>
346
347 <p>Si vous pensez que vous n'êtes pas concerné par ce problème
348 parceque vous utilisez un système de fichiers sensible à la casse,
349 gardez à l'esprit qu'il y a de nombreuses autres manières pour faire
350 correspondre plusieurs localisations de l'arborescence du site web à la même
351 localisation du système de fichiers.  C'est pourquoi vous devez autant que
352 possible toujours utiliser les conteneurs de système de fichiers.
353 Il y a cependant une exception à cette règle.  Placer des restrictions de
354 configuration dans un conteneur <code>&lt;Location
355 /&gt;</code> est tout à fait sans rique car ce conteneur va s'appliquer à
356 toutes les requêtes sans tenir compte de l'URL spécifique.</p>
357
358
359 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
360 <div class="section">
361 <h2><a name="virtualhost" id="virtualhost">Hôtes virtuels</a></h2>
362
363 <p>Le conteneur <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
364 contient des directives qui s'appliquent à des hôtes spécifiques.
365 Ceci s'avère utile pour servir des hôtes multiples à partir de la même machine,
366 chacun d'entre eux possédant une configuration différente.  Pour de plus amples
367 informations,
368 voir la <a href="vhosts/">Documentation sur les hôtes virtuels</a>.</p>
369 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
370 <div class="section">
371 <h2><a name="proxy" id="proxy">Mandataire</a></h2>
372
373 <p>Les conteneurs
374 <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
375 et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>
376 appliquent les directives de configuration qu'ils contiennent uniquement aux
377 sites qui correspondent à l'URL spécifiée et auxquels on a
378 accédé via le serveur mandataire du module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>.
379 Par exemple, la configuration suivante
380 va interdire l'utilisation du serveur proxy pour accéder au site
381 <code>cnn.com</code>.</p>
382
383 <div class="example"><p><code>
384 &lt;Proxy http://cnn.com/*&gt;<br />
385 Order allow,deny<br />
386 Deny from all<br />
387 &lt;/Proxy&gt;
388 </code></p></div>
389 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
390 <div class="section">
391 <h2><a name="whatwhere" id="whatwhere">Quelles sont les directives autorisées ?</a></h2>
392
393 <p>Pour déterminer quelles sont les directives autorisées pour tel type de
394 section de configuration, vérifiez le <a href="mod/directive-dict.html#Context">Contexte</a> de la directive.
395 Tout ce qui est autorisé dans les sections
396 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>
397 l'est aussi d'un point de vue syntaxique dans les sections
398 <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>,
399 <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>,
400 <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>,
401 <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>,
402 <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>,
403 <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>,
404 et <code class="directive"><a href="./mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>.
405 Il y a cependant quelques exceptions :</p>
406
407 <ul>
408 <li>La directive <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code>
409 ne fonctionne que dans les sections
410 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>.</li>
411
412 <li>Les <code class="directive"><a href="./mod/core.html#options">Options</a></code> <code>FollowSymLinks</code> et
413 <code>SymLinksIfOwnerMatch</code>  ne fonctionnent que dans les sections
414 <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> ou les fichiers
415 <code>.htaccess</code>.</li>
416
417 <li>La directive <code class="directive"><a href="./mod/core.html#options">Options</a></code> ne peut pas être
418 utilisée dans les sections
419 <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code>
420 et <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>.</li>
421 </ul>
422 </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
423 <div class="section">
424 <h2><a name="mergin" id="mergin">Comment les sections sont combinées entre elles</a></h2>
425
426 <p>Les sections de configuration sont appliquées dans un ordre très particulier.
427 Il est important de savoir comment cet ordre est défini car il peut avoir
428 des effets importants sur la manière dont les directives de configuration
429 sont interprétées.</p>
430
431     <p>L'ordre dans lequel les sections sont combinées est :</p>
432
433     <ol>
434       <li> Les sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> (à l'exception des
435       expressions rationnelles)
436       et les fichiers <code>.htaccess</code> sont appliqués simultanément (avec
437       la possibilité pour <code>.htaccess</code>, s'il y est autorisé, de
438       prévaloir sur
439       <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>)</li>
440
441       <li>Les sections
442       <code class="directive"><a href="./mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>
443       (et <code>&lt;Directory ~&gt;</code>)</li>
444
445       <li>Les sections <code class="directive"><a href="./mod/core.html#files">&lt;Files&gt;</a></code> et <code class="directive"><a href="./mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code> sont appliquées
446       simultanément</li>
447
448       <li>Les sections
449       <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code>
450       et <code class="directive"><a href="./mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> sont appliquées
451       simultanément</li>
452     </ol>
453
454     <p>Mises à part les sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, chaque groupe est traité selon
455     l'ordre dans lequel il apparaît dans les fichiers de configuration.
456     Les sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> (groupe 1 ci-dessus)
457     sont traitées dans l'ordre du répertoire le plus court vers le plus long.
458     Par exemple, <code>&lt;Directory /var/web/dir&gt;</code> sera
459     traité avant <code>&lt;Directory
460     /var/web/dir/subdir&gt;</code>.  Si plusieurs sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> s'appliquent au même
461     répertoire, elles sont traitées selon l'ordre dans lequel elles
462     apparaissent dans le fichier de configuration.
463     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
464     trouvaient réellement dans le fichier qui les inclut à la position de la
465     directive
466     <code class="directive"><a href="./mod/core.html#include">Include</a></code>.</p>
467
468     <p>Les sections situées à l'intérieur de sections <code class="directive"><a href="./mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
469     sont appliquées <em>après</em> les sections correspondantes situées en
470     dehors de la définition de l'hôte virtuel, ce qui permet à l'hôte virtuel
471     de prévaloir sur la configuration du serveur principal.</p>
472
473     <p>Quand la requête est servie par le module <code class="module"><a href="./mod/mod_proxy.html">mod_proxy</a></code>,
474     le conteneur <code class="directive"><a href="./mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
475     prend la place du conteneur <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code> dans l'ordre de traitement.</p>
476
477     <p>Les sections situées plus loin dans le fichier de configuration prévalent
478     sur celles qui les précèdent.</p>
479
480 <div class="note"><h3>Note technique</h3>
481         Une séquence
482         <code>&lt;Location&gt;</code>/<code>&lt;LocationMatch&gt;</code>
483         est réellement traitée juste avant la phase de traduction du nom
484         (où <code>Aliases</code> et <code>DocumentRoots</code>
485       sont utilisés pour faire correspondre les URLs aux noms de fichiers).
486       Les effets de cette séquence disparaissent totalement lorsque
487       la traduction est terminée.
488 </div>
489
490 <h3><a name="merge-examples" id="merge-examples">Quelques exemples</a></h3>
491
492 <p>Voici un exemple imaginaire qui montre l'ordre de combinaison des sections.
493 En supposant qu'elles s'appliquent toutes à la requête, les directives de
494 cet exemple seront appliquées dans l'ordre suivant : A &gt; B &gt; C &gt; D &gt;
495 E.</p>
496
497 <div class="example"><p><code>
498 &lt;Location /&gt;<br />
499 E<br />
500 &lt;/Location&gt;<br />
501 <br />
502 &lt;Files f.html&gt;<br />
503 D<br />
504 &lt;/Files&gt;<br />
505 <br />
506 &lt;VirtualHost *&gt;<br />
507 &lt;Directory /a/b&gt;<br />
508 B<br />
509 &lt;/Directory&gt;<br />
510 &lt;/VirtualHost&gt;<br />
511 <br />
512 &lt;DirectoryMatch "^.*b$"&gt;<br />
513 C<br />
514 &lt;/DirectoryMatch&gt;<br />
515 <br />
516 &lt;Directory /a/b&gt;<br />
517 A<br />
518 &lt;/Directory&gt;<br />
519 <br />
520 </code></p></div>
521
522 <p>Pour un exemple plus concret, considérez ce qui suit.  Sans tenir compte
523 de toute restriction d'accès placée dans les sections <code class="directive"><a href="./mod/core.html#directory">&lt;Directory&gt;</a></code>, la section <code class="directive"><a href="./mod/core.html#location">&lt;Location&gt;</a></code> sera
524 évaluée en dernier et permettra un accès au serveur sans aucune restriction.
525 En d'autres termes, l'ordre de la combinaison des sections est important,
526 soyez donc prudent !</p>
527
528 <div class="example"><p><code>
529 &lt;Location /&gt;<br />
530 Order deny,allow<br />
531 Allow from all<br />
532 &lt;/Location&gt;<br />
533 <br />:if expand("%") == ""|browse confirm w|else|confirm w|endif
534
535 # Arrghs!  Cette section &lt;Directory&gt; n'aura aucun effet<br />
536 &lt;Directory /&gt;<br />
537 Order allow,deny<br />
538 Allow from all<br />
539 Deny from badguy.example.com<br />
540 &lt;/Directory&gt;
541 </code></p></div>
542
543
544
545 </div></div>
546 <div class="bottomlang">
547 <p><span>Langues Disponibles: </span><a href="./en/sections.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
548 <a href="./fr/sections.html" title="Français">&nbsp;fr&nbsp;</a> |
549 <a href="./ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
550 <a href="./ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
551 <a href="./tr/sections.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
552 </div><div id="footer">
553 <p class="apache">Copyright 2010 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
554 <p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a> | <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a> | <a href="./sitemap.html">Plan du site</a></p></div>
555 </body></html>