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" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body id="manual-page"><div id="page-header"> 17<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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> 18<p class="apache">Serveur Apache HTTP Version 2.4</p> 19<img alt="" src="/images/feather.gif" /></div> 20<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 21<div id="path"> 22<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.4</a></div><div id="page-content"><div id="preamble"><h1>Sections de configuration</h1> 23<div class="toplang"> 24<p><span>Langues Disponibles: </span><a href="/en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> | 25<a href="/fr/sections.html" title="Fran�ais"> fr </a> | 26<a href="/ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 27<a href="/ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 28<a href="/tr/sections.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 29</div> 30<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version 31 anglaise pour les changements r�cents.</div> 32 <p>Les directives des <a href="configuring.html">fichiers de configuration</a> peuvent s'appliquer 33au serveur dans son ensemble, ou seulement � des r�pertoires, fichiers, h�tes, 34ou URLs particuliers. Ce document d�crit comment utiliser les conteneurs de 35sections de configuration ou les fichiers <code>.htaccess</code> pour 36modifier la port�e des directives de configuration.</p> 37</div> 38<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#types">Types de conteneurs de sections de 39configuration</a></li> 40<li><img alt="" src="/images/down.gif" /> <a href="#file-and-web">Syst�me de fichiers, 41arborescence 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> 48<div class="section"> 49<h2><a name="types" id="types">Types de conteneurs de sections de 50configuration</a></h2> 51 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> 53 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 56seulement aux requ�tes qui sont concern�es par le conteneur. En revanche, 57les conteneurs 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. 61Si leurs conditions sont v�rifi�es au d�marrage, les directives qu'ils contiennent 62s'appliqueront � toutes les requ�tes. Si leurs conditions ne sont pas v�rifi�es, les 63directives qu'ils contiennent seront ignor�es.</p> 64 65<p>Le conteneur <code class="directive"><a href="/mod/core.html#ifdefine"><IfDefine></a></code> 66contient des directives qui ne seront appliqu�es que si un param�tre 67appropri� a �t� d�fini dans la ligne de commande de <code class="program"><a href="/programs/httpd.html">httpd</a></code>. 68Par exemple, 69avec la configuration suivante, toutes les requ�tes seront redirig�es vers 70un autre site si le serveur est d�marr� en utilisant la ligne de commande : 71<code>httpd -DClosedForNow</code>:</p> 72 73<pre class="prettyprint lang-config"><IfDefine ClosedForNow> 74 Redirect / http://otherserver.example.com/ 75</IfDefine></pre> 76 77 78<p>Le conteneur <code class="directive"><a href="/mod/core.html#ifmodule"><IfModule></a></code> 79est similaire; les directives qu'il contient ne s'appliqueront que si 80un module particulier est disponible au niveau du serveur. 81Le module doit �tre soit compil� statiquement dans le serveur, soit 82dynamiquement et dans ce cas, la ligne <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante doit appara�tre 83plus haut dans le fichier de configuration. Ce conteneur ne doit �tre 84utilis� que dans le cas o� votre fichier de configuration doit fonctionner 85ind�pendamment de la pr�sence ou de l'absence de certains modules. 86Il ne doit pas contenir de directives que vous souhaitez voir s'appliquer 87syst�matiquement, car vous pouvez perdre ainsi de pr�cieux messages d'erreur 88� propos de modules manquants.</p> 89 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 91module <code class="module"><a href="/mod/mod_mime_magic.html">mod_mime_magic</a></code> est disponible.</p> 92 93<pre class="prettyprint lang-config"><IfModule mod_mime_magic.c> 94 MimeMagicFile conf/magic 95</IfModule></pre> 96 97 98<p>Le conteneur 99<code class="directive"><a href="/mod/mod_version.html#ifversion"><IfVersion></a></code> 100est 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 101s'appliqueront que si une version particuli�re du serveur s'ex�cute. Ce 102conteneur a �t� con�u pour une utilisation dans les suites de tests 103et les grands r�seaux qui doivent prendre en compte diff�rentes versions 104et configurations de httpd.</p> 105 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> 110 111 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> 115peuvent inverser leur test conditionnel en le faisant pr�c�der d'un "!". 116De plus, ces sections peuvent �tre imbriqu�es afin de d�finir des restrictions 117plus 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, 121arborescence du site web et expressions bool�ennes</a></h2> 122 123<p>Les conteneurs de sections de configuration les plus couramment utilis�s 124sont ceux qui modifient la configuration de points particuliers du syst�me de 125fichiers ou de l'arborescence du site web. Tout d'abord, il est important de 126comprendre la diff�rence entre les deux. Le syst�me de fichiers est une vue 127de vos disques tels qu'ils sont per�us par votre syst�me d'exploitation. 128Par exemple, avec une installation par d�faut, 129Apache httpd est situ� dans <code>/usr/local/apache2</code> pour le syst�me de 130fichiers UNIX, ou <code>"c:/Program Files/Apache Group/Apache2"</code> pour 131le syst�me de fichiers Windows. (Notez que des slashes directs doivent 132toujours �tre utilis�s comme s�parateur de chemin 133dans les fichiers de configuration d'Apache httpd, m�me sous 134Windows.) Quant � 135l'arborescence du site web, il s'agit d'une vue de votre site 136tel que pr�sent� par le 137serveur web et per�ue par le client. Ainsi le chemin <code>/dir/</code> dans 138l'arborescence du site web correspond au chemin 139<code>/usr/local/apache2/htdocs/dir/</code> dans le syst�me de fichiers pour 140une installation d'Apache httpd par d�faut sous UNIX. 141En outre, l'arborescence du site web n'a pas besoin de correspondre en permanence au 142syst�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"><Directory></a></code> 148et <code class="directive"><a href="/mod/core.html#files"><Files></a></code>, 149ainsi que leurs �quivalents acceptant les 150<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, 151appliquent des directives � certaines parties du syst�me de fichiers. 152Les directives contenues dans une section <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> s'appliquent au r�pertoire 153pr�cis�, ainsi qu'� tous ses sous-r�pertoires et aux fichiers que ces 154derniers contiennent. 155Le m�me effet peut �tre obtenu en utilisant les <a href="howto/htaccess.html">fichiers .htaccess</a>. Par exemple, avec la 156configuration suivante, l'indexation sera activ�e pour le r�pertoire 157<code>/var/web/dir1</code> et tous ses sous-r�pertoires.</p> 158 159<pre class="prettyprint lang-config"><Directory /var/web/dir1> 160 Options +Indexes 161</Directory></pre> 162 163 164<p>Les directives contenues dans une section <code class="directive"><a href="/mod/core.html#files"><Files></a></code> s'appliquent � tout fichier 165avec le nom sp�cifi�, quel que soit le r�pertoire dans lequel il se trouve. 166Ainsi par exemple, les directives de configuration suivantes, si elles sont 167plac�es dans la section principale du fichier de configuration, vont interdire 168l'acc�s � tout fichier nomm� <code>private.html</code> quel que soit 169l'endroit o� il se trouve.</p> 170 171<pre class="prettyprint lang-config"><Files private.html> 172 Require all denied 173</Files></pre> 174 175 176<p>Pour faire r�f�rence � des fichiers qui se trouvent en des points 177particuliers 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> 180peuvent �tre combin�es. Par exemple, la configuration suivante va interdire 181l'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> 186 187<pre class="prettyprint lang-config"><Directory /var/web/dir1> 188 <Files private.html> 189 Require all denied 190 </Files> 191</Directory></pre> 192 193 194 195<h3><a name="webspace" id="webspace">Conteneurs de l'arborescence du site web</a></h3> 196 197<p>le conteneur <code class="directive"><a href="/mod/core.html#location"><Location></a></code> 198et son �quivalent acceptant les 199<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, modifient quant � eux la 200configuration de parties de l'arborescence du site web. Par exemple, la 201configuration suivante interdit l'acc�s � toute URL dont la partie chemin 202commence par /private. 203En 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'� 207toute requ�te commen�ant par la cha�ne de caract�res <code>/private</code>.</p> 208 209<pre class="prettyprint lang-config"><LocationMatch ^/private> 210 Require all denied 211</LocationMatch></pre> 212 213 214<p>Le conteneur <code class="directive"><a href="/mod/core.html#location"><Location></a></code> 215n'a pas besoin de faire r�f�rence � un �l�ment du syst�me de fichiers. 216Par exemple, l'exemple suivant montre comment faire r�f�rence � une URL 217particuli�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>. 219Il n'est pas n�cessaire de trouver un fichier nomm� <code>server-status</code> 220dans le syst�me de fichiers.</p> 221 222<pre class="prettyprint lang-config"><Location /server-status> 223 SetHandler server-status 224</Location></pre> 225 226 227 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 230dans lequel certaines sections ou directives sont �valu�es. Pour 231<code class="directive"><a href="/mod/core.html#location"><Location></a></code>, on doit 232avoir :</p> 233<pre class="prettyprint lang-config"><Location /foo> 234</Location> 235<Location /foo/bar> 236</Location></pre> 237 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 240Alias /foo /srv/www/common/foo</pre> 241 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 244ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On</pre> 245 246 247 248 249<h3><a name="wildcards" id="wildcards">Caract�res de remplacement 250et expressions rationnelles</a></h3> 251 252<p>Les conteneurs 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> 256peuvent utiliser des caract�res de remplacement de style shell comme dans 257la fonction <code>fnmatch</code> de la biblioth�que C standard. 258Le caract�re "*" 259correspond � toute s�quence de caract�res, "?" � un caract�re seul, 260et "[<em>seq</em>]" � tout caract�re contenu dans <em>seq</em>. 261Le caract�re "/" 262ne peut pas faire l'objet d'un remplacement; 263il doit �tre sp�cifi� explicitement.</p> 264 265<p>Si une d�finition des crit�res de correspondance 266encore plus souple est n�cessaire, chaque conteneur 267poss�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 269pour d�finir les crit�res de correspondance. Mais voyez plus loin la section 270� propos de la combinaison des sections de configuration 271pour comprendre comment l'utilisation de 272conteneurs avec des expressions rationnelles va modifier la mani�re 273dont les directives sont appliqu�es.</p> 274 275<p>Un conteneur qui modifie la configuration de tous les 276r�pertoires utilisateurs � l'aide de caract�res de remplacement 277mais sans utiliser 278les expressions rationnelles pourrait ressembler � ceci :</p> 279 280<pre class="prettyprint lang-config"><Directory /home/*/public_html> 281 Options Indexes 282</Directory></pre> 283 284 285<p>Avec les conteneurs utilisant les expressions rationnelles, 286on peut interdire l'acc�s � de nombreux types de fichiers d'images 287simultan�ment :</p> 288<pre class="prettyprint lang-config">+<FilesMatch \.(?i:gif|jpe?g|png)$> 289 Require all denied 290</FilesMatch></pre> 291 292 293<p>Les expressions rationnelles contenant des <strong>groupes nomm�s et 294des r�f�rences arri�res</strong> sont ajout�es � l'environnement avec 295leur nom en majuscules. Ceci permet de r�f�rencer des �l�ments de 296chemins 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> 298 299<pre class="prettyprint lang-config"><DirectoryMatch ^/var/www/combined/(?<SITENAME>[^/]+)> 300 require ldap-group cn=%{env:SITENAME},ou=combined,o=Example 301</DirectoryMatch></pre> 302 303 304 305 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> 308permet 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 310suivant, l'acc�s est interdit si l'en-t�te HTTP Referer ne commence pas 311par "http://www.example.com/".</p> 312<pre class="prettyprint lang-config"><If "!(%{HTTP_REFERER} -strmatch 'http://www.example.com/*')"> 313 Require all denied 314</If></pre> 315 316 317 318 319<h3><a name="whichwhen" id="whichwhen">Que faut-il utiliser et quand ?</a></h3> 320 321<p>Choisir entre des conteneurs de syst�me de fichiers et des conteneurs 322d'arborescence du site web est vraiment tr�s simple. 323Pour appliquer des directives � des objets qui r�sident dans le syst�me de 324fichiers, 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 325qui ne r�sident pas dans le syst�me de fichiers (comme une page web g�n�r�e 326par une base de donn�es), utilisez un conteneur <code class="directive"><a href="/mod/core.html#location"><Location></a></code>.</p> 327 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 329objets du syst�me de fichiers, car plusieurs localisations de 330l'arborescence du site web (URLs) peuvent correspondre � la m�me localisation 331du syst�me de fichier, ce qui peut permettre de contourner vos restrictions. 332Par exemple, imaginez la configuration suivante :</p> 333 334<pre class="prettyprint lang-config"><Location /dir/> 335 Require all denied 336</Location></pre> 337 338 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 341votre syst�me de fichiers est insensible � la casse ? 342Votre restriction va pouvoir �tre tout simplement contourn�e en envoyant une 343requ�te sur 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, 346sans tenir compte de la mani�re dont il est appel�. 347(Les liens du syst�me de fichiers constituent une exception. 348Le m�me r�pertoire peut �tre plac� dans plusieurs parties du syst�me de 349fichiers en utilisant des liens symboliques. Le conteneur 350<code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> va suivre le 351lien symbolique sans modifier le nom du chemin. Par cons�quent, pour plus de 352s�curit�, les liens symboliques doivent �tre d�sactiv�s � l'aide de la 353directive 354<code class="directive"><a href="/mod/core.html#options">Options</a></code> appropri�e.)</p> 355 356<p>Si vous pensez que vous n'�tes pas concern� par ce probl�me 357parceque vous utilisez un syst�me de fichiers sensible � la casse, 358gardez � l'esprit qu'il y a de nombreuses autres mani�res pour faire 359correspondre plusieurs localisations de l'arborescence du site web � la m�me 360localisation du syst�me de fichiers. C'est pourquoi vous devez autant que 361possible toujours utiliser les conteneurs de syst�me de fichiers. 362Il y a cependant une exception � cette r�gle. Placer des restrictions de 363configuration dans un conteneur <code><Location 364/></code> est tout � fait sans rique car ce conteneur va s'appliquer � 365toutes les requ�tes sans tenir compte de l'URL sp�cifique.</p> 366 367 368<h3><a name="nesting" id="nesting">Imbrication des sections</a></h3> 369 370<p>Certains types de sections peuvent �tre imbriqu�s : d'une part, on 371peut 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 372peut utiliser les 373directives <code class="directive"><a href="/mod/core.html#if"><If></a></code> � 374l'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 375rationnelles correspondant aux sections nomm�es se comportent de mani�re 376identique.</p> 377 378<p>Les sections imbriqu�es sont fusionn�es apr�s les sections 379non-imbriqu�es de m�me type.</p> 380 381 382 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> 386 387<p>Le conteneur <code class="directive"><a href="/mod/core.html#virtualhost"><VirtualHost></a></code> 388contient des directives qui s'appliquent � des h�tes sp�cifiques. 389Ceci s'av�re utile pour servir des h�tes multiples � partir de la m�me machine, 390chacun d'entre eux poss�dant une configuration diff�rente. Pour de plus amples 391informations, 392voir 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> 396 397<p>Les conteneurs 398<code class="directive"><a href="/mod/mod_proxy.html#proxy"><Proxy></a></code> 399et <code class="directive"><a href="/mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code> 400appliquent les directives de configuration qu'ils contiennent uniquement aux 401sites qui correspondent � l'URL sp�cifi�e et auxquels on a 402acc�d� via le serveur mandataire du module <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>. 403Par exemple, la configuration suivante 404va interdire l'utilisation du serveur proxy pour acc�der au site 405<code>www.example.com</code>.</p> 406 407<pre class="prettyprint lang-config"><Proxy http://www.example.com/*>; 408 Require all granted 409</Proxy></pre> 410 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> 414 415<p>Pour d�terminer quelles sont les directives autoris�es pour tel type de 416section de configuration, v�rifiez le <a href="mod/directive-dict.html#Context">Contexte</a> de la directive. 417Tout ce qui est autoris� dans les sections 418<code class="directive"><a href="/mod/core.html#directory"><Directory></a></code> 419l'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>, 426et <code class="directive"><a href="/mod/mod_proxy.html#proxymatch"><ProxyMatch></a></code>. 427Il y a cependant quelques exceptions :</p> 428 429<ul> 430<li>La directive <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> 431ne fonctionne que dans les sections 432<code class="directive"><a href="/mod/core.html#directory"><Directory></a></code>.</li> 433 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> 438 439<li>La directive <code class="directive"><a href="/mod/core.html#options">Options</a></code> ne peut pas �tre 440utilis�e dans les sections 441<code class="directive"><a href="/mod/core.html#files"><Files></a></code> 442et <code class="directive"><a href="/mod/core.html#filesmatch"><FilesMatch></a></code>.</li> 443</ul> 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> 447 448<p>Les sections de configuration sont appliqu�es dans un ordre tr�s particulier. 449Il est important de savoir comment cet ordre est d�fini car il peut avoir 450des effets importants sur la mani�re dont les directives de configuration 451sont interpr�t�es.</p> 452 453 <p>L'ordre dans lequel les sections sont combin�es est :</p> 454 455 <ol> 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 460 pr�valoir sur 461 <code class="directive"><a href="/mod/core.html#directory"><Directory></a></code>)</li> 462 463 <li>Les sections 464 <code class="directive"><a href="/mod/core.html#directorymatch"><DirectoryMatch></a></code> 465 (et <code><Directory ~></code>)</li> 466 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 468 simultan�ment</li> 469 470 <li>Les sections 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 473 simultan�ment</li> 474 475 <li>Les directives <code class="directive"><a href="/mod/core.html#if"><If></a></code> 476 </li> 477 </ol> 478 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 490 directive 491 <code class="directive"><a href="/mod/core.html#include">Include</a></code>.</p> 492 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> 497 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> 501 502 <p>Les sections situ�es plus loin dans le fichier de configuration pr�valent 503 sur celles qui les pr�c�dent ; cependant, chaque 504 module est responsable de la d�finition de la forme que doit prendre 505 cette pr�valence. Une section de configuration ult�rieure contenant 506 des directives d'un certain module peut �tre � l'origine d'une 507 fusion conceptuelle de certaines directives, de toutes les 508 directives, ou un remplacement complet de la configuration du module 509 par ses valeurs par d�faut et les directives explicitement d�finies 510 dans cette section ult�rieure.</p> 511 512<div class="note"><h3>Note technique</h3> 513 Une s�quence 514 <code><Location></code>/<code><LocationMatch></code> 515 est r�ellement trait�e juste avant la phase de traduction du nom 516 (o� <code>Aliases</code> et <code>DocumentRoots</code> 517 sont utilis�s pour faire correspondre les URLs aux noms de fichiers). 518 Les effets de cette s�quence disparaissent totalement lorsque 519 la traduction est termin�e. 520</div> 521 522<h3><a name="merge-examples" id="merge-examples">Quelques exemples</a></h3> 523 524<p>Voici un exemple imaginaire qui montre l'ordre de combinaison des sections. 525En supposant qu'elles s'appliquent toutes � la requ�te, les directives de 526cet exemple seront appliqu�es dans l'ordre suivant : A > B > C > D > 527E.</p> 528 529<pre class="prettyprint lang-config"><Location /> 530 E 531</Location> 532 533<Files f.html> 534 D 535</Files> 536 537<VirtualHost *> 538<Directory /a/b> 539 B 540</Directory> 541</VirtualHost> 542 543<DirectoryMatch "^.*b$"> 544 C 545</DirectoryMatch> 546 547<Directory /a/b> 548 A 549</Directory></pre> 550 551 552<p>Pour un exemple plus concret, consid�rez ce qui suit. Sans tenir compte 553de 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 554�valu�e en dernier et permettra un acc�s au serveur sans aucune restriction. 555En d'autres termes, l'ordre de la combinaison des sections est important, 556soyez donc prudent !</p> 557 558<pre class="prettyprint lang-config"><Location /> 559 Require all granted 560</Location> 561 562# Arrghs! Cette section <Directory> n'aura aucun effet 563<Directory /> 564 <RequireAll> 565 Require all granted 566 Require not host badguy.example.com 567 </RequireAll> 568</Directory></pre> 569 570 571 572 573</div></div> 574<div class="bottomlang"> 575<p><span>Langues Disponibles: </span><a href="/en/sections.html" hreflang="en" rel="alternate" title="English"> en </a> | 576<a href="/fr/sections.html" title="Fran�ais"> fr </a> | 577<a href="/ja/sections.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 578<a href="/ko/sections.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 579<a href="/tr/sections.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 580</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> 581<script type="text/javascript"><!--//--><![CDATA[//><!-- 582var comments_shortname = 'httpd'; 583var comments_identifier = 'http://httpd.apache.org/docs/2.4/sections.html'; 584(function(w, d) { 585 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 586 d.write('<div id="comments_thread"><\/div>'); 587 var s = d.createElement('script'); 588 s.type = 'text/javascript'; 589 s.async = true; 590 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 591 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 592 } 593 else { 594 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 595 } 596})(window, document); 597//--><!]]></script></div><div id="footer"> 598<p class="apache">Copyright 2014 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 599<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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[//><!-- 600if (typeof(prettyPrint) !== 'undefined') { 601 prettyPrint(); 602} 603//--><!]]></script> 604</body></html>
