sections.html.fr revision 9c1260efa52c82c2a58e5b5f20cd6902563d95f5
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Sections de configuration - Serveur Apache HTTP</title>
<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
<link href="/images/favicon.ico" rel="shortcut icon" /></head>
<body id="manual-page"><div id="page-header">
<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>
<p class="apache">Serveur Apache HTTP Version 2.3</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<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>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="/en/sections.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/sections.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/sections.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div>
<p>Les directives des <a href="configuring.html">fichiers de configuration</a> peuvent s'appliquer
au serveur dans son ensemble, ou seulement � des r�pertoires, fichiers, h�tes,
ou URLs particuliers. Ce document d�crit comment utiliser les conteneurs de
sections de configuration ou les fichiers <code>.htaccess</code> pour
modifier la port�e des directives de configuration.</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#types">Types de conteneurs de sections de
configuration</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#file-and-web">Syst�me de fichiers et
arborescence du site web</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#virtualhost">H�tes virtuels</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#proxy">Mandataire</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#whatwhere">Quelles sont les directives autoris�es ?</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#mergin">Comment les sections sont combin�es entre elles</a></li>
</ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="types" id="types">Types de conteneurs de sections de
configuration</a></h2>
<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>
<p>Il existe deux grands types de conteneurs. La plupart des conteneurs sont
�valu�s pour chaque requ�te. Les directives qu'ils contiennent s'appliquent
seulement aux requ�tes qui sont concern�es par le conteneur. En revanche,
les conteneurs
<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
<code class="directive"><a href="/mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code> sont
�valu�s seulement au d�marrage et au red�marrage du serveur.
Si leurs conditions sont v�rifi�es au d�marrage, les directives qu'ils contiennent
s'appliqueront � toutes les requ�tes. Si leurs conditions ne sont pas v�rifi�es, les
directives qu'ils contiennent seront ignor�es.</p>
<p>Le conteneur <code class="directive"><a href="/mod/core.html#ifdefine">&lt;IfDefine&gt;</a></code>
contient des directives qui ne seront appliqu�es que si un param�tre
appropri� a �t� d�fini dans la ligne de commande de <code class="program"><a href="/programs/httpd.html">httpd</a></code>.
Par exemple,
avec la configuration suivante, toutes les requ�tes seront redirig�es vers
un autre site si le serveur est d�marr� en utilisant la ligne de commande :
<code>httpd -DClosedForNow</code>:</p>
<div class="example"><p><code>
&lt;IfDefine ClosedForNow&gt;<br />
Redirect / http://otherserver.example.com/<br />
&lt;/IfDefine&gt;
</code></p></div>
<p>Le conteneur <code class="directive"><a href="/mod/core.html#ifmodule">&lt;IfModule&gt;</a></code>
est similaire; les directives qu'il contient ne s'appliqueront que si
un module particulier est disponible au niveau du serveur.
Le module doit �tre soit compil� statiquement dans le serveur, soit
dynamiquement et dans ce cas, la ligne <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code> correspondante doit appara�tre
plus haut dans le fichier de configuration. Ce conteneur ne doit �tre
utilis� que dans le cas o� votre fichier de configuration doit fonctionner
ind�pendamment de la pr�sence ou de l'absence de certains modules.
Il ne doit pas contenir de directives que vous souhaitez voir s'appliquer
syst�matiquement, car vous pouvez perdre ainsi de pr�cieux messages d'erreur
� propos de modules manquants.</p>
<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
module <code class="module"><a href="/mod/mod_mime_magic.html">mod_mime_magic</a></code> est disponible.</p>
<div class="example"><p><code>
&lt;IfModule mod_mime_magic.c&gt;<br />
MimeMagicFile conf/magic<br />
&lt;/IfModule&gt;
</code></p></div>
<p>Le conteneur
<code class="directive"><a href="/mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
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
s'appliqueront que si une version particuli�re du serveur s'ex�cute. Ce
conteneur a �t� con�u pour une utilisation dans les suites de tests
et les grands r�seaux qui doivent prendre en compte diff�rentes versions
et configurations de httpd.</p>
<div class="example"><p><code>
&lt;IfVersion &gt;= 2.1&gt;<br />
<span class="indent">
# les directives situ�es ici ne s'appliquent que si la version <br />
# est sup�rieure ou �gale � 2.1.0.<br />
</span>
&lt;/IfVersion&gt;
</code></p></div>
<p><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
<code class="directive"><a href="/mod/mod_version.html#ifversion">&lt;IfVersion&gt;</a></code>
peuvent inverser leur test conditionnel en le faisant pr�c�der d'un "!".
De plus, ces sections peuvent �tre imbriqu�es afin de d�finir des restrictions
plus complexes.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="file-and-web" id="file-and-web">Syst�me de fichiers et
arborescence du site web</a></h2>
<p>Les conteneurs de sections de configuration les plus couramment utilis�s
sont ceux qui modifient la configuration de points particuliers du syst�me de
fichiers ou de l'arborescence du site web. Tout d'abord, il est important de
comprendre la diff�rence entre les deux. Le syst�me de fichiers est une vue
de vos disques tels qu'ils sont per�us par votre syst�me d'exploitation.
Par exemple, avec une installation par d�faut,
Apache httpd est situ� dans <code>/usr/local/apache2</code> pour le syst�me de
fichiers UNIX, ou <code>"c:/Program Files/Apache Group/Apache2"</code> pour
le syst�me de fichiers Windows. (Notez que des slashes directs doivent
toujours �tre utilis�s comme s�parateur de chemin
dans les fichiers de configuration d'Apache httpd, m�me sous
Windows.) Quant �
l'arborescence du site web, il s'agit d'une vue de votre site
tel que pr�sent� par le
serveur web et per�ue par le client. Ainsi le chemin <code>/dir/</code> dans
l'arborescence du site web correspond au chemin
<code>/usr/local/apache2/htdocs/dir/</code> dans le syst�me de fichiers pour
une installation d'Apache httpd par d�faut sous UNIX.
En outre, l'arborescence du site web n'a pas besoin de correspondre en permanence au
syst�me de fichiers, car les pages web peuvent �tre g�n�r�es dynamiquement
� partir de bases de donn�es ou d'autres emplacements.</p>
<h3><a name="filesystem" id="filesystem">Conteneurs de syst�me de fichiers</a></h3>
<p>Les conteneurs <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>
et <code class="directive"><a href="/mod/core.html#files">&lt;Files&gt;</a></code>,
ainsi que leurs �quivalents acceptant les
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>,
appliquent des directives � certaines parties du syst�me de fichiers.
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
pr�cis�, ainsi qu'� tous ses sous-r�pertoires et aux fichiers que ces
derniers contiennent.
Le m�me effet peut �tre obtenu en utilisant les <a href="howto/htaccess.html">fichiers .htaccess</a>. Par exemple, avec la
configuration suivante, l'indexation sera activ�e pour le r�pertoire
<code>/var/web/dir1</code> et tous ses sous-r�pertoires.</p>
<div class="example"><p><code>
&lt;Directory /var/web/dir1&gt;<br />
Options +Indexes<br />
&lt;/Directory&gt;
</code></p></div>
<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
avec le nom sp�cifi�, quel que soit le r�pertoire dans lequel il se trouve.
Ainsi par exemple, les directives de configuration suivantes, si elles sont
plac�es dans la section principale du fichier de configuration, vont interdire
l'acc�s � tout fichier nomm� <code>private.html</code> quel que soit
l'endroit o� il se trouve.</p>
<div class="example"><p><code>
&lt;Files private.html&gt;<br />
Order allow,deny<br />
Deny from all<br />
&lt;/Files&gt;
</code></p></div>
<p>Pour faire r�f�rence � des fichiers qui se trouvent en des points
particuliers du syst�me de fichiers, 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#directory">&lt;Directory&gt;</a></code>
peuvent �tre combin�es. Par exemple, la configuration suivante va interdire
l'acc�s � <code>/var/web/dir1/private.html</code>,
<code>/var/web/dir1/subdir2/private.html</code>,
<code>/var/web/dir1/subdir3/private.html</code>, ainsi que toute instance de
<code>private.html</code> qui se trouve dans l'arborescence
<code>/var/web/dir1/</code>.</p>
<div class="example"><p><code>
&lt;Directory /var/web/dir1&gt;<br />
&lt;Files private.html&gt;<br />
Order allow,deny<br />
Deny from all<br />
&lt;/Files&gt;<br />
&lt;/Directory&gt;
</code></p></div>
<h3><a name="webspace" id="webspace">Conteneurs de l'arborescence du site web</a></h3>
<p>le conteneur <code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>
et son �quivalent acceptant les
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a>, modifient quant � eux la
configuration de parties de l'arborescence du site web. Par exemple, la
configuration suivante interdit l'acc�s � toute URL dont la partie chemin
commence par /private.
En particulier, l'interdiction s'appliquera aux requ�tes pour :
<code>http://yoursite.example.com/private</code>,
<code>http://yoursite.example.com/private123</code>, et
<code>http://yoursite.example.com/private/dir/file.html</code> ainsi qu'�
toute requ�te commen�ant par la cha�ne de caract�res <code>/private</code>.</p>
<div class="example"><p><code>
&lt;LocationMatch ^/private&gt;<br />
Order Allow,Deny<br />
Deny from all<br />
&lt;/Location&gt;
</code></p></div>
<p>Le conteneur <code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>
n'a pas besoin de faire r�f�rence � un �l�ment du syst�me de fichiers.
Par exemple, l'exemple suivant montre comment faire r�f�rence � une URL
particuli�re vers un gestionnaire interne du serveur HTTP Apache fourni par le module
<code class="module"><a href="/mod/mod_status.html">mod_status</a></code>.
Il n'est pas n�cessaire de trouver un fichier nomm� <code>server-status</code>
dans le syst�me de fichiers.</p>
<div class="example"><p><code>
&lt;Location /server-status&gt;<br />
SetHandler server-status<br />
&lt;/Location&gt;
</code></p></div>
<h3><a name="overlapping-webspace" id="overlapping-webspace">Espace web imbriqu�</a></h3>
<p>Pour contr�ler deux URLs imbriqu�es, on doit tenir compte de l'ordre
dans lequel certaines sections ou directives sont �valu�es. Pour
<code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>, on doit
avoir :</p>
<div class="example"><p><code>
&lt;Location /foo&gt;<br />
&lt;/Location&gt;<br />
&lt;Location /foo/bar&gt;<br />
&lt;/Location&gt;
</code></p></div>
<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>
<div class="example"><p><code>
Alias /foo/bar /srv/www/uncommon/bar<br />
Alias /foo /srv/www/common/foo<br />
</code></p></div>
<p>Ceci est aussi vrai pour les directives <code class="directive"><a href="/mod/mod_proxy.html#proxypass">ProxyPass</a></code> :</p>
<div class="example"><p><code>
ProxyPass /special-area http://special.example.com smax=5 max=10<br />
ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On
</code></p></div>
<h3><a name="wildcards" id="wildcards">Caract�res de remplacement
et expressions rationnelles</a></h3>
<p>Les conteneurs
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>,
<code class="directive"><a href="/mod/core.html#files">&lt;Files&gt;</a></code>, et
<code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>
peuvent utiliser des caract�res de remplacement de style shell comme dans
la fonction <code>fnmatch</code> de la biblioth�que C standard.
Le caract�re "*"
correspond � toute s�quence de caract�res, "?" � un caract�re seul,
et "[<em>seq</em>]" � tout caract�re contenu dans <em>seq</em>.
Le caract�re "/"
ne peut pas faire l'objet d'un remplacement;
il doit �tre sp�cifi� explicitement.</p>
<p>Si une d�finition des crit�res de correspondance
encore plus souple est n�cessaire, chaque conteneur
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
<a class="glossarylink" href="/glossary.html#regex" title="voir glossaire">expressions rationnelles</a> compatibles Perl
pour d�finir les crit�res de correspondance. Mais voyez plus loin la section
� propos de la combinaison des sections de configuration
pour comprendre comment l'utilisation de
conteneurs avec des expressions rationnelles va modifier la mani�re
dont les directives sont appliqu�es.</p>
<p>Un conteneur qui modifie la configuration de tous les
r�pertoires utilisateurs � l'aide de caract�res de remplacement
mais sans utiliser
les expressions rationnelles pourrait ressembler � ceci :</p>
<div class="example"><p><code>
&lt;Directory /home/*/public_html&gt;<br />
Options Indexes<br />
&lt;/Directory&gt;
</code></p></div>
<p>Avec les conteneurs utilisant les expressions rationnelles,
on peut interdire l'acc�s � de nombreux types de fichiers d'images
simultan�ment :</p>
<div class="example"><p><code>
&lt;FilesMatch \.(?i:gif|jpe?g|png)$&gt;<br />
Order allow,deny<br />
Deny from all<br />
&lt;/FilesMatch&gt;
</code></p></div>
<h3><a name="whichwhen" id="whichwhen">Que faut-il utiliser et quand ?</a></h3>
<p>Choisir entre des conteneurs de syst�me de fichiers et des conteneurs
d'arborescence du site web est vraiment tr�s simple.
Pour appliquer des directives � des objets qui r�sident dans le syst�me de
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
qui ne r�sident pas dans le syst�me de fichiers (comme une page web g�n�r�e
par une base de donn�es), utilisez un conteneur <code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>.</p>
<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
objets du syst�me de fichiers, car plusieurs localisations de
l'arborescence du site web (URLs) peuvent correspondre � la m�me localisation
du syst�me de fichier, ce qui peut permettre de contourner vos restrictions.
Par exemple, imaginez la configuration suivante :</p>
<div class="example"><p><code>
&lt;Location /dir/&gt;<br />
Order allow,deny<br />
Deny from all<br />
&lt;/Location&gt;
</code></p></div>
<p>Elle fonctionne correctement si la requ�te appelle
<code>http://yoursite.example.com/dir/</code>. Mais que va-t-il se passer si
votre syst�me de fichiers est insensible � la casse ?
Votre restriction va pouvoir �tre tout simplement contourn�e en envoyant une
requ�te sur
<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
� tout contenu servi � partir de cette localisation,
sans tenir compte de la mani�re dont il est appel�.
(Les liens du syst�me de fichiers constituent une exception.
Le m�me r�pertoire peut �tre plac� dans plusieurs parties du syst�me de
fichiers en utilisant des liens symboliques. Le conteneur
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> va suivre le
lien symbolique sans modifier le nom du chemin. Par cons�quent, pour plus de
s�curit�, les liens symboliques doivent �tre d�sactiv�s � l'aide de la
directive
<code class="directive"><a href="/mod/core.html#options">Options</a></code> appropri�e.)</p>
<p>Si vous pensez que vous n'�tes pas concern� par ce probl�me
parceque vous utilisez un syst�me de fichiers sensible � la casse,
gardez � l'esprit qu'il y a de nombreuses autres mani�res pour faire
correspondre plusieurs localisations de l'arborescence du site web � la m�me
localisation du syst�me de fichiers. C'est pourquoi vous devez autant que
possible toujours utiliser les conteneurs de syst�me de fichiers.
Il y a cependant une exception � cette r�gle. Placer des restrictions de
configuration dans un conteneur <code>&lt;Location
/&gt;</code> est tout � fait sans rique car ce conteneur va s'appliquer �
toutes les requ�tes sans tenir compte de l'URL sp�cifique.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="virtualhost" id="virtualhost">H�tes virtuels</a></h2>
<p>Le conteneur <code class="directive"><a href="/mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
contient des directives qui s'appliquent � des h�tes sp�cifiques.
Ceci s'av�re utile pour servir des h�tes multiples � partir de la m�me machine,
chacun d'entre eux poss�dant une configuration diff�rente. Pour de plus amples
informations,
voir la <a href="vhosts/">Documentation sur les h�tes virtuels</a>.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="proxy" id="proxy">Mandataire</a></h2>
<p>Les conteneurs
<code class="directive"><a href="/mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
et <code class="directive"><a href="/mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>
appliquent les directives de configuration qu'ils contiennent uniquement aux
sites qui correspondent � l'URL sp�cifi�e et auxquels on a
acc�d� via le serveur mandataire du module <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>.
Par exemple, la configuration suivante
va interdire l'utilisation du serveur proxy pour acc�der au site
<code>www.example.com</code>.</p>
<div class="example"><p><code>
&lt;Proxy http://www.example.com/*&gt;<br />
Order allow,deny<br />
Deny from all<br />
&lt;/Proxy&gt;
</code></p></div>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="whatwhere" id="whatwhere">Quelles sont les directives autoris�es ?</a></h2>
<p>Pour d�terminer quelles sont les directives autoris�es pour tel type de
section de configuration, v�rifiez le <a href="mod/directive-dict.html#Context">Contexte</a> de la directive.
Tout ce qui est autoris� dans les sections
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>
l'est aussi d'un point de vue syntaxique dans les sections
<code class="directive"><a href="/mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>,
<code class="directive"><a href="/mod/core.html#files">&lt;Files&gt;</a></code>,
<code class="directive"><a href="/mod/core.html#filesmatch">&lt;FilesMatch&gt;</a></code>,
<code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>,
<code class="directive"><a href="/mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code>,
<code class="directive"><a href="/mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>,
et <code class="directive"><a href="/mod/mod_proxy.html#proxymatch">&lt;ProxyMatch&gt;</a></code>.
Il y a cependant quelques exceptions :</p>
<ul>
<li>La directive <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code>
ne fonctionne que dans les sections
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>.</li>
<li>Les <code class="directive"><a href="/mod/core.html#options">Options</a></code> <code>FollowSymLinks</code> et
<code>SymLinksIfOwnerMatch</code> ne fonctionnent que dans les sections
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> ou les fichiers
<code>.htaccess</code>.</li>
<li>La directive <code class="directive"><a href="/mod/core.html#options">Options</a></code> ne peut pas �tre
utilis�e dans 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>.</li>
</ul>
</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
<div class="section">
<h2><a name="mergin" id="mergin">Comment les sections sont combin�es entre elles</a></h2>
<p>Les sections de configuration sont appliqu�es dans un ordre tr�s particulier.
Il est important de savoir comment cet ordre est d�fini car il peut avoir
des effets importants sur la mani�re dont les directives de configuration
sont interpr�t�es.</p>
<p>L'ordre dans lequel les sections sont combin�es est :</p>
<ol>
<li> Les sections <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> (� l'exception des
expressions rationnelles)
et les fichiers <code>.htaccess</code> sont appliqu�s simultan�ment (avec
la possibilit� pour <code>.htaccess</code>, s'il y est autoris�, de
pr�valoir sur
<code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>)</li>
<li>Les sections
<code class="directive"><a href="/mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></code>
(et <code>&lt;Directory ~&gt;</code>)</li>
<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
simultan�ment</li>
<li>Les sections
<code class="directive"><a href="/mod/core.html#location">&lt;Location&gt;</a></code>
et <code class="directive"><a href="/mod/core.html#locationmatch">&lt;LocationMatch&gt;</a></code> sont appliqu�es
simultan�ment</li>
</ol>
<p>Mises � part les sections <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code>, chaque groupe est trait� selon
l'ordre dans lequel il appara�t dans les fichiers de configuration.
Les sections <code class="directive"><a href="/mod/core.html#directory">&lt;Directory&gt;</a></code> (groupe 1 ci-dessus)
sont trait�es dans l'ordre du r�pertoire le plus court vers le plus long.
Par exemple, <code>&lt;Directory /var/web/dir&gt;</code> sera
trait� avant <code>&lt;Directory
/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
r�pertoire, elles sont trait�es selon l'ordre dans lequel elles
apparaissent dans le fichier de configuration.
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
trouvaient r�ellement dans le fichier qui les inclut � la position de la
directive
<code class="directive"><a href="/mod/core.html#include">Include</a></code>.</p>
<p>Les sections situ�es � l'int�rieur de sections <code class="directive"><a href="/mod/core.html#virtualhost">&lt;VirtualHost&gt;</a></code>
sont appliqu�es <em>apr�s</em> les sections correspondantes situ�es en
dehors de la d�finition de l'h�te virtuel, ce qui permet � l'h�te virtuel
de pr�valoir sur la configuration du serveur principal.</p>
<p>Quand la requ�te est servie par le module <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code>,
le conteneur <code class="directive"><a href="/mod/mod_proxy.html#proxy">&lt;Proxy&gt;</a></code>
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>
<p>Les sections situ�es plus loin dans le fichier de configuration pr�valent
sur celles qui les pr�c�dent.</p>
<div class="note"><h3>Note technique</h3>
Une s�quence
<code>&lt;Location&gt;</code>/<code>&lt;LocationMatch&gt;</code>
est r�ellement trait�e juste avant la phase de traduction du nom
(o� <code>Aliases</code> et <code>DocumentRoots</code>
sont utilis�s pour faire correspondre les URLs aux noms de fichiers).
Les effets de cette s�quence disparaissent totalement lorsque
la traduction est termin�e.
</div>
<h3><a name="merge-examples" id="merge-examples">Quelques exemples</a></h3>
<p>Voici un exemple imaginaire qui montre l'ordre de combinaison des sections.
En supposant qu'elles s'appliquent toutes � la requ�te, les directives de
cet exemple seront appliqu�es dans l'ordre suivant : A &gt; B &gt; C &gt; D &gt;
E.</p>
<div class="example"><p><code>
&lt;Location /&gt;<br />
E<br />
&lt;/Location&gt;<br />
<br />
&lt;Files f.html&gt;<br />
D<br />
&lt;/Files&gt;<br />
<br />
&lt;VirtualHost *&gt;<br />
&lt;Directory /a/b&gt;<br />
B<br />
&lt;/Directory&gt;<br />
&lt;/VirtualHost&gt;<br />
<br />
&lt;DirectoryMatch "^.*b$"&gt;<br />
C<br />
&lt;/DirectoryMatch&gt;<br />
<br />
&lt;Directory /a/b&gt;<br />
A<br />
&lt;/Directory&gt;<br />
<br />
</code></p></div>
<p>Pour un exemple plus concret, consid�rez ce qui suit. Sans tenir compte
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
�valu�e en dernier et permettra un acc�s au serveur sans aucune restriction.
En d'autres termes, l'ordre de la combinaison des sections est important,
soyez donc prudent !</p>
<div class="example"><p><code>
&lt;Location /&gt;<br />
Order deny,allow<br />
Allow from all<br />
&lt;/Location&gt;<br />
<br />:if expand("%") == ""|browse confirm w|else|confirm w|endif
# Arrghs! Cette section &lt;Directory&gt; n'aura aucun effet<br />
&lt;Directory /&gt;<br />
Order allow,deny<br />
Allow from all<br />
Deny from badguy.example.com<br />
&lt;/Directory&gt;
</code></p></div>
</div></div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="/en/sections.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="/fr/sections.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/sections.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/sections.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/sections.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<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>
</body></html>