core.html.fr

    <p>Les directives associes aux rpertoires sous forme d'expressions
    rationnelles ne sont prises en compte qu'une fois toutes les
    directives des sections sans expressions rationnelles appliques.
    Alors, tous les rpertoires avec expressions rationnelles sont
    tests selon l'ordre dans lequel ils apparaissent dans le fichier de
    configuration. Par exemple, avec</p>

    <pre class="prettyprint lang-config">&lt;Directory ~ "abc$"&gt;
  # ... directives ici ...
&lt;/Directory&gt;</pre>


    <p>la section avec expression rationnelle ne sera prise en compte
    qu'aprs les sections <code class="directive">&lt;Directory&gt;</code> sans expression rationnelle
    et les fichiers <code>.htaccess</code>. Alors, l'expression
    rationnelle conviendra pour <code>/home/abc/public_html/abc</code>
    et la section <code class="directive">&lt;Directory&gt;</code>
    correspondante s'appliquera.</p>

   <p><strong>Notez que la politique d'accs par dfaut
   dans les sections <code>&lt;Directory "/"&gt;</code> consiste 
   autoriser tout accs sans restriction. Ceci signifie qu'Apache httpd va servir tout fichier
   correspondant  une URL. Il est recommand de modifier cette
   situation  l'aide d'un bloc du style</strong></p>

    <pre class="prettyprint lang-config">&lt;Directory "/"&gt;
  Require all denied
&lt;/Directory&gt;</pre>


    <p><strong>puis d'affiner la configuration pour les rpertoires que vous
    voulez rendre accessibles. Voir la page <a href="../misc/security_tips.html">Conseils  propos de scurit</a>
    pour plus de dtails.</strong></p>

    <p>Les sections <code class="directive">&lt;Directory&gt;</code> se situent
    dans le fichier <code>httpd.conf</code>. Les directives <code class="directive">&lt;Directory&gt;</code> ne peuvent pas tre imbriques
    et ne sont pas autorises dans les sections <code class="directive"><a href="#limit">&lt;Limit&gt;</a></code> ou <code class="directive"><a href="#limitexcept">&lt;LimitExcept&gt;</a></code>.</p>

<h3>Voir aussi</h3>
<ul>
<li><a href="../sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour des
explications  propos de la manire dont ces diffrentes sections se
combinent entre elles  la rception d'une requte</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="directorymatch" id="directorymatch">Directive</a> <a name="DirectoryMatch" id="DirectoryMatch">&lt;DirectoryMatch&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Regroupe des directives qui s'appliquent au contenu de rpertoires
du systme de fichiers correspondant  une expression rationnelle</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;DirectoryMatch <var>regex</var>&gt;
... &lt;/DirectoryMatch&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Les balises <code class="directive">&lt;DirectoryMatch&gt;</code>
    et <code>&lt;/DirectoryMatch&gt;</code> permettent de regrouper un
    ensemble de directives qui ne s'appliqueront qu'au rpertoire
    prcis (et aux fichiers qu'il contient), comme pour la section <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>. Cependant, le
    rpertoire est prcis sous la forme d'une <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expression rationnelle</a>. Par exemple :</p>

    <pre class="prettyprint lang-config">&lt;DirectoryMatch "^/www/(.+/)?[0-9]{3}/"&gt;
    # ...
&lt;/DirectoryMatch&gt;</pre>


    <p>convient pour les sous-rpertoires de <code>/www/</code> dont
    le nom se compose de trois chiffres.</p>

    <div class="note"><h3>Compatibilit</h3>
      Avant la version 2.3.9, cette directive s'appliquait aussi aux
      sous-rpertoires (comme la directive <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>), et ne tenait pas compte du
      symbole de fin de ligne ($). Depuis la version 2.3.9, seuls les
      rpertoires qui correspondent  l'expression sont affects par les
      directives contenues dans la section.
    </div>

    <div class="note"><h3>slash de fin</h3>
      Cette directive s'applique aux requtes pour des rpertoires avec
      ou sans slash de fin ; les expressions contenant un symbole de fin
      de ligne ($) doivent donc faire l'objet d'une attention
      particulire.
    </div>
    
    <p>A partir de la version 2.4.8, les groupes nomms et les
    rfrences arrires sont extraits et enregistrs dans
    l'environnement avec leur nom en majuscules et prfix
    par "MATCH_". Ceci permet
    de rfrencer des URLs dans des <a href="../expr.html">expressions</a>
    ou au sein de modules comme <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code>. Pour
    viter toute confusion, les rfrences arrires numrotes (non
    nommes) sont ignores. Vous devez utiliser  la place des groupes
    nomms.</p>

<pre class="prettyprint lang-config">&lt;DirectoryMatch "^/var/www/combined/(?&lt;sitename&gt;[^/]+)"&gt;
    Require ldap-group cn=%{env:MATCH_SITENAME},ou=combined,o=Example
&lt;/DirectoryMatch&gt;</pre>
    


<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#directory">&lt;Directory&gt;</a></code>
pour une description de la manire dont les expressions rationnelles
sont traites en prsence d'autres sections <code class="directive">&lt;Directory&gt;</code> sans expressions rationnelles</li>
<li><a href="../sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication  propos de la manire dont ces diffrentes sections se
combinent entre elles  la rception d'une requte</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="documentroot" id="documentroot">Directive</a> <a name="DocumentRoot" id="DocumentRoot">DocumentRoot</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Racine principale de l'arborescence des documents visible
depuis Internet</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DocumentRoot <var>chemin rpertoire</var></code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>DocumentRoot "/usr/local/apache/htdocs"</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Cette directive permet de dfinir le rpertoire  partir duquel
    <code class="program"><a href="../programs/httpd.html">httpd</a></code> va servir les fichiers. S'il ne correspond
    pas  un <code class="directive"><a href="../mod/mod_alias.html#alias">Alias</a></code>, le chemin
    de l'URL sera ajout par le serveur  la racine des documents afin
    de construire le chemin du document recherch. Exemple :</p>

    <pre class="prettyprint lang-config">DocumentRoot "/usr/web"</pre>


    <p>un accs  <code>http://my.example.com/index.html</code> se
    rfre alors  <code>/usr/web/index.html</code>. Si <var>chemin
    rpertoire</var> n'est pas un chemin absolu, il est considr comme
    relatif au chemin dfini par la directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>

    <p>Le rpertoire dfini par la directive
    <code class="directive">DocumentRoot</code> ne doit pas comporter de slash
    final.</p>

<h3>Voir aussi</h3>
<ul>
<li><a href="../urlmapping.html#documentroot">Mise en
correspondance des URLs avec le systme de fichiers</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="else" id="else">Directive</a> <a name="Else" id="Else">&lt;Else&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la
condition correspondant  la section <code class="directive"><a href="#if">&lt;If&gt;</a></code> ou <code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code> prcdente n'est pas satisfaite par la
requte  l'excution</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Else&gt; ... &lt;/Else&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td>Les conditions imbriques sont supportes  partir de la version
2.4.26 du serveur HTTP Apache</td></tr>
</table>
    <p>La section <code class="directive">&lt;Else&gt;</code> applique
    les directives qu'elle contient si et seulement si les conditions
    correspondant  la section <code class="directive">&lt;If&gt;</code>
    ou <code class="directive">&lt;ElseIf&gt;</code> immdiatement
    suprieure et dans la mme porte n'ont pas t satisfaites. Par
    exemple, dans :</p>

    <pre class="prettyprint lang-config">&lt;If "-z req('Host')"&gt;
  # ...
&lt;/If&gt;
&lt;Else&gt;
  # ...
&lt;/Else&gt;</pre>


    <p>La condition de la section <code class="directive">&lt;If&gt;</code> serait satisfaite pour les requtes
    HTTP/1.0 sans en-tte <var>Host:</var>, alors que celle de la section
    <code class="directive">&lt;Else&gt;</code> le serait pour les
    requtes comportant un en-tte <var>Host:</var>.</p>


<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
<li><code class="directive"><a href="#elseif">&lt;ElseIf&gt;</a></code></li>
<li><a href="../sections.html">Fonctionnement des sections &lt;Directory&gt;, &lt;Location&gt;,
    &lt;Files&gt;</a> pour une explication de la manire dont ces
    diffrentes section se combinent entre elles lorsqu'une requte est
    reue. Les directives <code class="directive">&lt;If&gt;</code>,
    <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code> s'appliquent en dernier.</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="elseif" id="elseif">Directive</a> <a name="ElseIf" id="ElseIf">&lt;ElseIf&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui ne s'appliquent que si la
condition correspondante est satisfaite par une requte  l'excution,
alors que la condition correspondant  la section <code class="directive"><a href="#if">&lt;If&gt;</a></code> ou <code class="directive">&lt;ElseIf&gt;</code> prcdente ne l'tait pas.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;ElseIf <var>expression</var>&gt; ... &lt;/ElseIf&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td>Les conditions imbriques sont supportes  partir de la version
2.4.26 du serveur HTTP Apache</td></tr>
</table>
    <p>La section <code class="directive">&lt;ElseIf&gt;</code> applique
    les directives qu'elle contient si et seulement si d'une part la
    condition correspondante est satisfaite, et d'autre part la condition
    correspondant  la section <code class="directive">&lt;If&gt;</code>
    ou <code class="directive">&lt;ElseIf&gt;</code> de la mme porte ne
    l'est pas. Par exemple, dans :</p>

    <pre class="prettyprint lang-config">&lt;If "-R '10.1.0.0/16'"&gt;
  #...
&lt;/If&gt;
&lt;ElseIf "-R '10.0.0.0/8'"&gt;
  #...
&lt;/ElseIf&gt;
&lt;Else&gt;
  #...
&lt;/Else&gt;</pre>


    <p>La condition correspondant  la section <code class="directive">&lt;ElseIf&gt;</code> est satisfaite si l'adresse
    distante de la requte appartient au sous-rseau 10.0.0.0/8, mais
    pas si elle appartient au sous-rseau 10.1.0.0/16.</p>


<h3>Voir aussi</h3>
<ul>
<li><a href="../expr.html">Les expressions dans le serveur HTTP
Apache</a>, pour une rfrence complte et d'autres exemples.</li>
<li><code class="directive"><a href="#if">&lt;If&gt;</a></code></li>
<li><code class="directive"><a href="#else">&lt;Else&gt;</a></code></li>
<li><a href="../sections.html">Fonctionnement des sections &lt;Directory&gt;, &lt;Location&gt;,
    &lt;Files&gt;</a> pour une explication de la manire dont ces
    diffrentes section se combinent entre elles lorsqu'une requte est
    reue. Les directives <code class="directive">&lt;If&gt;</code>,
    <code class="directive">&lt;ElseIf&gt;</code>, et <code class="directive">&lt;Else&gt;</code> s'appliquent en dernier.</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="enablemmap" id="enablemmap">Directive</a> <a name="EnableMMAP" id="EnableMMAP">EnableMMAP</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise la projection en mmoire (Memory-Mapping) pour
lire les fichiers pendant qu'ils sont servis</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableMMAP On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>EnableMMAP On</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Cette directive dfinit si <code class="program"><a href="../programs/httpd.html">httpd</a></code> peut utiliser
    la projection en mmoire (Memory-Mapping) quand il doit lire le contenu
    d'un fichier pendant qu'il est servi. Par dfaut, lorsque le
    traitement d'une requte requiert l'accs aux donnes contenues dans
    un fichier -- par exemple, pour servir un fichier interprt par le
    serveur  l'aide de <code class="module"><a href="../mod/mod_include.html">mod_include</a></code> -- Apache httpd projette
    le fichier en mmoire si le systme d'exploitation le permet.</p>

    <p>Cette projection en mmoire induit parfois une amlioration des
    performances. Sur certains systmes cependant, il est prfrable de
    dsactiver la projection en mmoire afin d'viter certains problmes
    oprationnels :</p>

    <ul>
    <li>Sur certains systmes multi-processeurs, la projection en
    mmoire peut dgrader les performances du programme
    <code class="program"><a href="../programs/httpd.html">httpd</a></code>.</li>
    <li>S'il fait l'objet d'une projection en mmoire par
    <code class="program"><a href="../programs/httpd.html">httpd</a></code>, la suppression ou la troncature d'un
    fichier peut provoquer un crash de <code class="program"><a href="../programs/httpd.html">httpd</a></code> avec une
    erreur de segmentation.</li>
    </ul>

    <p>Pour les configurations de serveur sujettes  ce genre de
    problme, il est prfrable de dsactiver la projection en mmoire
    des fichiers servis en spcifiant :</p>
    
    <pre class="prettyprint lang-config">EnableMMAP Off</pre>


    <p>Pour les montages NFS, cette fonctionnalit peut tre
    explicitement dsactive pour les fichiers concerns en spcifiant
    :</p>

    <pre class="prettyprint lang-config">&lt;Directory "/path-to-nfs-files"&gt;
  EnableMMAP Off
&lt;/Directory&gt;</pre>


</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="enablesendfile" id="enablesendfile">Directive</a> <a name="EnableSendfile" id="EnableSendfile">EnableSendfile</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Utilise le support sendfile du noyau pour servir les
fichiers aux clients</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>EnableSendfile On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>EnableSendfile Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td>Par dfaut  Off depuis la version 2.3.9.</td></tr>
</table>
    <p>Cette directive dfinit si le programme <code class="program"><a href="../programs/httpd.html">httpd</a></code>
    peut utiliser le support sendfile du noyau pour transmettre le
    contenu des fichiers aux clients. Par dfaut, lorsque le traitement
    d'une requte ne requiert pas l'accs aux donnes contenues dans un
    fichier -- par exemple, pour la transmission d'un fichier statique
    -- Apache httpd utilise sendfile pour transmettre le contenu du fichier
    sans mme lire ce dernier, si le systme d'exploitation le
    permet.</p>

    <p>Ce mcanisme sendfile vite la sparation des oprations de
    lecture et d'envoi, ainsi que les rservations de tampons. sur
    certains systmes cependant, ou sous certains systmes de fichiers,
    il est prfrable de dsactiver cette fonctionnalit afin d'viter
    certains problmes oprationnels :</p>

    <ul>
    <li>Certains systmes peuvent prsenter un support sendfile
    dfectueux que le systme de compilation n'a pas dtect, en
    particulier si les excutables ont t compils sur une autre
    machine, puis copis sur la premire avec un support sendfile
    dfectueux.</li>
    <li>Sous Linux, l'utilisation de sendfile induit des bogues lors de
    la rcupration des paquets de vrification TCP (TCP-checksum) avec
    certaines cartes rseau lorsqu'on utilise IPv6.</li>
    <li>Sous Linux sur Itanium, <code>sendfile</code> peut s'avrer incapable de
    traiter les fichiers de plus de 2 Go.</li>
    <li>Avec un montage rseau de <code class="directive"><a href="#documentroot">DocumentRoot</a></code> (par exemple NFS, SMB, CIFS,
    FUSE), le
    noyau peut s'avrer incapable de servir un fichier de ce montage
    rseau en passant par son propre cache.</li>
    </ul>

    <p>Pour les configurations de serveur non sujettes  ce genre de
    problme, vous pouvez activer cette fonctionnalit en
    spcifiant :</p>

    <pre class="prettyprint lang-config">EnableSendfile On</pre>


    <p>Pour les montages rseau, cette fonctionnalit peut tre
    explicitement dsactive pour les fichiers concerns en spcifiant
    :</p>

    <pre class="prettyprint lang-config">&lt;Directory "/path-to-nfs-files"&gt;
  EnableSendfile Off
&lt;/Directory&gt;</pre>

    <p>Veuillez noter que la configuration de la directive
    <code class="directive">EnableSendfile</code> dans un contexte de rpertoire
    ou de fichier .htaccess n'est pas supporte par
    <code class="module"><a href="../mod/mod_cache_disk.html">mod_cache_disk</a></code>. Le module ne prend en compte la
    dfinition de <code class="directive">EnableSendfile</code> que dans un
    contexte global.
    </p>

</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="error" id="error">Directive</a> <a name="Error" id="Error">Error</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Interrompt la lecture de la configuration avec un message
d'erreur personnalis</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>Error <var>message</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td> partir de la version 2.3.9</td></tr>
</table>
    <p>Si une erreur peut tre dtecte dans la configuration, souvent
    un module manquant, cette
    directive peut tre utilise pour gnrer un message d'erreur
    personnalis, et interrompre la lecture de la configuration. </p>

    <pre class="prettyprint lang-config"># Exemple
# vrification du chargement de mod_include
&lt;IfModule !include_module&gt;
  Error "mod_include is required by mod_foo.  Load it with LoadModule."
&lt;/IfModule&gt;

# vrification de la dfinition de SSL ou (exclusif) NOSSL
&lt;IfDefine SSL&gt;
&lt;IfDefine NOSSL&gt;
  Error "Both SSL and NOSSL are defined.  Define only one of them."
&lt;/IfDefine&gt;
&lt;/IfDefine&gt;
&lt;IfDefine !SSL&gt;
&lt;IfDefine !NOSSL&gt;
  Error "Either SSL or NOSSL must be defined."
&lt;/IfDefine&gt;
&lt;/IfDefine&gt;</pre>



</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="errordocument" id="errordocument">Directive</a> <a name="ErrorDocument" id="ErrorDocument">ErrorDocument</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Document que le serveur renvoie au client en cas
d'erreur</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ErrorDocument <var>code erreur</var> <var>document</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>Apache httpd peut traiter les problmes et les erreurs de quatre
    manires,</p>

    <ol>
      <li>afficher un simple message d'erreur au contenu fixe</li>

      <li>afficher un message personnalis</li>

      <li>rediriger en interne vers un <var>chemin d'URL</var> local pour traiter
      le problme ou l'erreur</li>

      <li>rediriger vers une <var>URL</var> externe pour traiter
      le problme ou l'erreur</li>
    </ol>

    <p>La premire option constitue le comportement par dfaut; pour
    choisir une des trois autres options, il faut configurer Apache 
    l'aide de la directive <code class="directive">ErrorDocument</code>, suivie
    du code de la rponse HTTP et d'une URL ou d'un message. Apache
    httpd fournit parfois des informations supplmentaires  propos du
    problme ou de l'erreur.</p>

    <p>A partir de la version 2.4.13, il est possible d'utiliser la <a href="../expr.html">syntaxe des expressions</a> dans cette directive
    afin de gnrer des chanes et URLs dynamiques.</p>

    <p>Les URLs peuvent commencer par un slash (/) pour les chemins web
    locaux (relatifs au rpertoire dfini par la directive <code class="directive"><a href="#documentroot">DocumentRoot</a></code>), ou se prsenter sous la
    forme d'une URL complte que le client pourra rsoudre.
    Alternativement, un message  afficher par le navigateur pourra tre
    fourni. Notez que la dcision de considrer le paramtre comme URL,
    chemin ou message intervient avant toute interprtation
    d'expression. Exemples :</p>

    <pre class="prettyprint lang-config">ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
ErrorDocument 404 /errors/bad_urls.php
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry can't allow you access today"
ErrorDocument 403 Forbidden!
ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}</pre>


    <p>De plus, on peut spcifier la valeur spciale <code>default</code>
    pour indiquer l'utilisation d'un simple message d'Apache httpd cod en
    dur. Bien que non ncessaire dans des circonstances normales, la
    spcification de la valeur <code>default</code> va permettre de
    rtablir l'utilisation du simple message d'Apache httpd cod en dur pour
    les configurations qui sans cela, hriteraient d'une directive
    <code class="directive">ErrorDocument</code> existante.</p>

    <pre class="prettyprint lang-config">ErrorDocument 404 /cgi-bin/bad_urls.pl

&lt;Directory "/web/docs"&gt;
  ErrorDocument 404 default
&lt;/Directory&gt;</pre>


    <p>Notez que lorsque vous spcifiez une directive
    <code class="directive">ErrorDocument</code> pointant vers une URL distante
    (c'est  dire tout ce qui commence par le prfixe http), le serveur
    HTTP Apache va
    envoyer une redirection au client afin de lui indiquer o trouver le
    document, mme dans le cas o ce document se trouve sur le serveur
    local. Ceci a de nombreuses consquences dont la plus importante
    rside dans le fait que le client ne recevra pas le code d'erreur
    original, mais au contraire un code de statut de redirection. Ceci
    peut en retour semer la confusion chez les robots web et divers
    clients qui tentent de dterminer la validit d'une URL en examinant
    le code de statut. De plus, si vous utilisez une URL distante avec
    <code>ErrorDocument 401</code>, le client ne saura pas qu'il doit
    demander un mot de passe  l'utilisateur car il ne recevra pas le
    code de statut 401. C'est pourquoi, <strong>si vous utilisez une
    directive <code>ErrorDocument 401</code>, elle devra faire rfrence
     un document par le biais d'un chemin local.</strong></p>

    <p>Microsoft Internet Explorer (MSIE) ignore par dfaut les messages
    d'erreur gnrs par le serveur lorsqu'ils sont trop courts et
    remplacent ses propres messages d'erreur "amicaux". Le seuil de
    taille varie en fonction du type d'erreur, mais en gnral, si la
    taille de votre message d'erreur est suprieure  512 octets, il y a
    peu de chances pour que MSIE l'occulte, et il sera affich par ce
    dernier. Vous trouverez d'avantage d'informations dans l'article de
    la base de connaissances Microsoft <a href="http://support.microsoft.com/default.aspx?scid=kb;en-us;Q294807">Q294807</a>.</p>

    <p>Bien que la plupart des messages d'erreur internes originaux
    puissent tre remplacs, ceux-ci sont cependant conservs dans
    certaines circonstances sans tenir compte de la dfinition de la
    directive <code class="directive"><a href="#errordocument">ErrorDocument</a></code>. En
    particulier, en cas de dtection d'une requte mal forme, le
    processus de traitement normal des requtes est immdiatement
    interrompu, et un message d'erreur interne est renvoy, ceci afin de
    se prmunir contre les problmes de scurit lis aux requtes mal
    formes.</p>

    <p>Si vous utilisez mod_proxy, il est en gnral prfrable
    d'activer <code class="directive"><a href="../mod/mod_proxy.html#proxyerroroverride">ProxyErrorOverride</a></code> afin d'tre en
    mesure de produire des messages d'erreur personnaliss pour le
    compte de votre serveur d'origine. Si vous n'activez pas
    ProxyErrorOverride, Apache httpd ne gnrera pas de messages d'erreur
    personnaliss pour le contenu mandat.</p>


<h3>Voir aussi</h3>
<ul>
<li><a href="../custom-error.html">documentation sur la
personnalisation des rponses</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="errorlog" id="errorlog">Directive</a> <a name="ErrorLog" id="ErrorLog">ErrorLog</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Dfinition du chemin du journal des erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLog <var>file-path</var>|syslog[:[<var>facility</var>][:<var>tag</var>]]</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>ErrorLog logs/error_log (Unix) ErrorLog logs/error.log (Windows and OS/2)</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>La directive <code class="directive">ErrorLog</code> permet de dfinir le
    nom du fichier dans lequel le serveur va journaliser toutes les
    erreurs qu'il rencontre. Si le <var>file-path</var> n'est pas
    absolu, il est considr comme relatif au chemin dfini par la
    directive <code class="directive"><a href="#serverroot">ServerRoot</a></code>.</p>

    <pre class="prettyprint lang-config">ErrorLog "/var/log/httpd/error_log"</pre>


    <p>Si le <var>file-path</var> commence par une barre verticale
    "<code>(|)</code>", il est considr comme une commande  lancer pour traiter la
    journalisation de l'erreur.</p>

    <pre class="prettyprint lang-config">ErrorLog "|/usr/local/bin/httpd_errors"</pre>


    <p>Voir les notes  propos des <a href="../logs.html#piped">journaux
    redirigs</a> pour plus d'informations.</p>

    <p>L'utilisation de <code>syslog</code>  la place d'un nom de
    fichier active la journalisation via syslogd(8) si le systme le
    supporte. Le dispositif syslog par dfaut est <code>local7</code>,
    mais vous pouvez le modifier  l'aide de la syntaxe
    <code>syslog:<var>facility</var></code>, o <var>facility</var> peut
    tre remplac par un des noms habituellement documents dans la page
    de man syslog(1). Le dispositif syslog <code>local7</code> est
    global, et si il est modifi dans un serveur virtuel, le dispositif
    final spcifi affecte l'ensemble du serveur. La mme rgle s'applique au
    tag syslog qui utilise par dfaut le nom du binaire du serveur HTTP Apache
    <code>httpd</code> dans la plupart des cas. Vous pouvez aussi modifier cette
    valeur en utilisant la syntaxe <code>syslog::<var>tag</var></code>.</p>

    <pre class="prettyprint lang-config">ErrorLog syslog:user
ErrorLog syslog:user:httpd.srv1
ErrorLog syslog::httpd.srv2</pre>


    <p>Des modules supplmentaires peuvent fournir leurs propres
    fournisseurs ErrorLog. La syntaxe est similaire  celle de
    l'exemple <code>syslog</code> ci-dessus.</p>

    <p>SECURITE : Voir le document <a href="../misc/security_tips.html#serverroot">conseils  propos de
    scurit</a> pour des dtails sur les raisons pour lesquelles votre
    scurit peut tre compromise si le rpertoire contenant les
    fichiers journaux prsente des droits en criture pour tout autre
    utilisateur que celui sous lequel le serveur est dmarr.</p>
    <div class="warning"><h3>Note</h3>
      <p>Lors de la spcification d'un chemin de fichier sur les
      plates-formes non-Unix, on doit veiller  n'utiliser que des
      slashes (/), mme si la plate-forme autorise l'utilisation des
      anti-slashes (\). Et d'une manire gnrale, il est recommand de
      n'utiliser que des slashes (/) dans les fichiers de
      configuration.</p>
    </div>

<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
<li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="errorlogformat" id="errorlogformat">Directive</a> <a name="ErrorLogFormat" id="ErrorLogFormat">ErrorLogFormat</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Spcification du format des entres du journal des erreurs</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code> ErrorLogFormat [connection|request] <var>format</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>La directive <code class="directive">ErrorLogFormat</code> permet de
    spcifier quelles informations supplmentaires vont tre enregistres
    dans le journal des erreurs en plus du message habituel.</p>

    <pre class="prettyprint lang-config"># Exemple simple
ErrorLogFormat "[%t] [%l] [pid %P] %F: %E: [client %a] %M"</pre>


    <p>La spcification de <code>connection</code> ou
    <code>request</code> comme premier paramtre permet de dfinir des
    formats supplmentaires, ce qui a pour effet de journaliser des
    informations additionnelles lorsque le premier message est
    enregistr respectivement pour une connexion ou une requte
    spcifique. Ces informations additionnelles ne sont enregistres
    qu'une seule fois par connexion/requte. Si le traitement d'une
    connexion ou d'une requte ne gnre aucun message dans le journal,
    alors aucune information additionnelle n'est enregistre.</p>

    <p>Il peut arriver que certains items de la chane de format ne
    produisent aucune sortie. Par exemple, l'en-tte Referer n'est
    prsent que si le message du journal est associ  une requte et s'il
    est gnr  un moment o l'en-tte Referer a dj t lu par le
    client. Si aucune sortie n'est gnre, le comportement par dfaut
    consiste  supprimer tout ce qui se trouve entre l'espace prcdent
    et le suivant. Ceci implique que la ligne de journalisation est
    divise en champs ne contenant pas d'espace spars par des espaces.
    Si un item de la chane de format ne gnre aucune sortie,
    l'ensemble du champ est omis. Par exemple, si l'adresse distante
    <code>%a</code> du format <code>[%t] [%l] [%a] %M&nbsp;</code> n'est
    pas disponible, les crochets qui l'entourent ne seront eux-mmes pas
    enregistrs. Il est possible d'chapper les espaces par un anti-slash
    afin qu'ils ne soient pas considrs comme sparateurs de champs.
    La combinaison '%&nbsp;' (pourcentage espace) est un dlimiteur de
    champ de taille nulle qui ne gnre aucune sortie.</p>

    <p>Ce comportement peut tre chang en ajoutant des modificateurs 
    l'item de la chane de format. Le modificateur <code>-</code>
    (moins) provoque l'enregistrement d'un signe moins si l'item
    considr ne gnre aucune sortie. Pour les formats  enregistrement
    unique par connexion/requte, il est aussi possible d'utiliser le
    modificateur <code>+</code> (plus). Si un item ne gnrant aucune
    sortie possde le modificateur plus, la ligne dans son ensemble est
    omise.</p>

    <p>Un modificateur de type entier permet d'assigner un niveau de
    svrit  un item de format. L'item considr ne
    sera journalis que si la svrit du message n'est pas
    plus haute que le niveau de svrit spcifi. Les
    valeurs possibles vont de 1 (alert)  15 (trace8), en passant par 4
    (warn) ou 7 (debug).</p>

    <p>Par exemple, voici ce qui arriverait si vous ajoutiez des
    modificateurs  l'item <code>%{Referer}i</code> qui enregistre le
    contenu de l'en-tte <code>Referer</code>.</p>

    <table class="bordered"><tr class="header"><th>Item modifi</th><th>Signification</th></tr>
<tr>
    <td><code>%-{Referer}i</code></td>
    <td>Enregistre le caractre <code>-</code> si l'en-tte
    <code>Referer</code> n'est pas dfini.</td>
    </tr>
<tr class="odd">
    <td><code>%+{Referer}i</code></td>
    <td>N'enregistre rien si l'en-tte
    <code>Referer</code> n'est pas dfini.</td>
    </tr>
<tr>
    <td><code>%4{Referer}i</code></td>
    <td>N'enregistre le contenu de l'en-tte <code>Referer</code> que si
    la svrit du message de journalisation est suprieure  4.</td>
    </tr>
</table>

    <p>Certains items de format acceptent des paramtres supplmentaires
    entre accolades.</p>

    <table class="bordered"><tr class="header"><th>Chane&nbsp;de&nbsp;format</th> <th>Description</th></tr>
<tr><td><code>%%</code></td>
        <td>Le signe pourcentage</td></tr>
<tr class="odd"><td><code>%a</code></td>
        <td>Adresse IP et port clients</td></tr>
<tr><td><code>%{c}a</code></td>
        <td>Port et adresse IP sous-jacents du correspondant pour la
	connexion (voir le module
	<code class="module"><a href="../mod/mod_remoteip.html">mod_remoteip</a></code>)</td></tr>
<tr class="odd"><td><code>%A</code></td>
        <td>Adresse IP et port locaux</td></tr>
<tr><td><code>%{<em>name</em>}e</code></td>
        <td>Variable d'environnement de requte <em>name</em></td></tr>
<tr class="odd"><td><code>%E</code></td>
        <td>Etat d'erreur APR/OS et chane</td></tr>
<tr><td><code>%F</code></td>
        <td>Nom du fichier source et numro de ligne de l'appel du
	journal</td></tr>
<tr class="odd"><td><code>%{<em>name</em>}i</code></td>
        <td>En-tte de requte <em>name</em></td></tr>
<tr><td><code>%k</code></td>
        <td>Nombre de requtes persistantes pour cette connexion</td></tr>
<tr class="odd"><td><code>%l</code></td>
        <td>Svrit du message</td></tr>
<tr><td><code>%L</code></td>
        <td>Identifiant journal de la requte</td></tr>
<tr class="odd"><td><code>%{c}L</code></td>
        <td>Identifiant journal de la connexion</td></tr>
<tr><td><code>%{C}L</code></td>
        <td>Identifiant journal de la connexion si utilis dans la
	porte de la connexion, vide sinon</td></tr>
<tr class="odd"><td><code>%m</code></td>
        <td>Nom du module qui effectue la journalisation du message</td></tr>
<tr><td><code>%M</code></td>
        <td>Le message effectif</td></tr>
<tr class="odd"><td><code>%{<em>name</em>}n</code></td>
        <td>Note de requte <em>name</em></td></tr>
<tr><td><code>%P</code></td>
        <td>Identifiant du processus courant</td></tr>
<tr class="odd"><td><code>%T</code></td>
        <td>Identifiant du thread courant</td></tr>
<tr><td><code>%{g}T</code></td>
        <td>Identifiant unique de thread systme du thread courant
	(l'identifiant affich par la commande <code>top</code> par
	exemple ; seulement sous Linux pour l'instant)</td></tr>
<tr class="odd"><td><code>%t</code></td>
        <td>L'heure courante</td></tr>
<tr><td><code>%{u}t</code></td>
        <td>L'heure courante avec les microsecondes</td></tr>
<tr class="odd"><td><code>%{cu}t</code></td>
        <td>L'heure courante au format compact ISO 8601, avec les
	microsecondes</td></tr>
<tr><td><code>%v</code></td>
        <td>Le nom de serveur canonique <code class="directive"><a href="#servername">ServerName</a></code> du serveur courant.</td></tr>
<tr class="odd"><td><code>%V</code></td>
        <td>Le nom de serveur du serveur qui sert la requte en accord
	avec la dfinition de la directive <code class="directive"><a href="#usecanonicalname">UseCanonicalName</a></code>.</td></tr>
<tr><td><code>\&nbsp;</code> (anti-slash espace)</td>
        <td>Espace non dlimiteur</td></tr>
<tr class="odd"><td><code>%&nbsp;</code> (pourcentage espace)</td>
        <td>Dlimiteur de champ (aucune sortie)</td></tr>
</table>

    <p>L'item de format identifiant journal <code>%L</code> gnre un
    identifiant unique pour une connexion ou une requte. Il peut servir
     dterminer quelles lignes correspondent  la mme connexion ou
    requte ou quelle requte est associe  tel connexion. Un item de
    format <code>%L</code> est aussi disponible dans le module
    <code class="module"><a href="../mod/mod_log_config.html">mod_log_config</a></code>, mais il permet dans ce contexte de
    corrler les entres du journal des accs avec celles du journal des
    erreurs. Si le module <code class="module"><a href="../mod/mod_unique_id.html">mod_unique_id</a></code> est charg,
    c'est son identifiant unique qui sera utilis comme identifiant de
    journal pour les requtes.</p>

    <pre class="prettyprint lang-config"># Exemple (format par dfaut pour les MPMs threads)
ErrorLogFormat "[%{u}t] [%-m:%l] [pid %P:tid %T] %7F: %E: [client\ %a] %M%,\referer\%{Referer}i"</pre>


    <p>Cet exemple renverrait un message d'erreur du style :</p>

    <div class="example"><p><code>
    [Thu May 12 08:28:57.652118 2011] [core:error] [pid 8777:tid 4326490112] [client ::1:58619] File does not exist: /usr/local/apache2/htdocs/favicon.ico
    </code></p></div>

    <p>Notez que, comme indiqu plus haut, certains champs sont
    totalement supprims s'ils n'ont pas t dfinis.</p>

    <pre class="prettyprint lang-config"># Exemple (similaire au format 2.2.x)
ErrorLogFormat "[%t] [%l] %7F: %E: [client\ %a] %M%,\referer\%{Referer}i"</pre>


    <pre class="prettyprint lang-config"># Exemple avanc avec identifiants journal de requte/connexion
ErrorLogFormat "[%{uc}t] [%-m:%-l] [R:%L] [C:%{C}L] %7F: %E: %M"
ErrorLogFormat request "[%{uc}t] [R:%L] Request %k on C:%{c}L pid:%P tid:%T"
ErrorLogFormat request "[%{uc}t] [R:%L] UA:'%+{User-Agent}i'"
ErrorLogFormat request "[%{uc}t] [R:%L] Referer:'%+{Referer}i'"
ErrorLogFormat connection "[%{uc}t] [C:%{c}L] local\ %a remote\ %A"</pre>



<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#errorlog">ErrorLog</a></code></li>
<li><code class="directive"><a href="#loglevel">LogLevel</a></code></li>
<li><a href="../logs.html">Fichiers journaux du serveur HTTP Apache</a></li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="extendedstatus" id="extendedstatus">Directive</a> <a name="ExtendedStatus" id="ExtendedStatus">ExtendedStatus</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Extrait des informations d'tat tendues pour chaque
requte</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ExtendedStatus On|Off</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>ExtendedStatus Off</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>

	<p>Cette option permet d'extraire des donnes supplmentaires
	concernant la requte en cours de traitement pour un processus
	donn, et cre un rsum d'utilisation ; vous pouvez accder 
	ces variables pendant l'excution en configurant
	<code class="module"><a href="../mod/mod_status.html">mod_status</a></code>. Notez que d'autres modules sont
	susceptibles de s'appuyer sur ce tableau de bord.</p>

    <p>Cette directive s'applique au serveur dans son ensemble, et ne
    peut pas tre active/dsactive pour un serveur virtuel
    particulier. Notez que l'extraction des informations d'tat tendues
    peut ralentir le serveur. Notez aussi que cette dfinition ne peut
    pas tre modifie au cours d'un redmarrage graceful.</p>

    <div class="note">
    <p>Notez que le chargement de <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> dfinit
    automatiquement ExtendedStatus  On, et que d'autres modules tiers
    sont susceptibles d'en faire de mme. De tels modules ont besoin
    d'informations dtailles  propos de l'tat de tous les processus.
    Depuis la version 2.3.6, <code class="module"><a href="../mod/mod_status.html">mod_status</a></code> a dfinit la
    valeur par dfaut  On, alors qu'elle tait  Off dans les versions
    antrieures.</p>
    </div>


</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="fileetag" id="fileetag">Directive</a> <a name="FileETag" id="FileETag">FileETag</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Caractristiques de fichier utilises lors de la gnration
de l'en-tte de rponse HTTP ETag pour les fichiers statiques</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>FileETag <var>composant</var> ...</code></td></tr>
<tr><th><a href="directive-dict.html#Default">Dfaut:</a></th><td><code>FileETag MTime Size</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>FileInfo</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit:</a></th><td>La valeur par dfaut tait "INode&nbsp;MTime&nbsp;Size"
dans les versions 2.3.14 et antrieures.</td></tr>
</table>
    <p>
    La directive <code class="directive">FileETag</code> dfinit les
    caractristiques de fichier utilises lors de la gnration de
    l'en-tte de rponse HTTP <code>ETag</code> (entity tag) quand le
    document est contenu dans un fichier statique(la valeur de
    <code>ETag</code>
    est utilise dans le cadre de la gestion du cache pour prserver la
    bande passante rseau). La directive
    <code class="directive">FileETag</code> vous permet maintenant de choisir
    quelles caractristiques du fichier vont tre utilises, le cas
    chant. Les mots-cls reconnus sont :
    </p>

    <dl>
     <dt><strong>INode</strong></dt>
     <dd>Le numro d'i-node du fichier sera inclus dans le processus de
     gnration</dd>
     <dt><strong>MTime</strong></dt>
     <dd>La date et l'heure auxquelles le fichier a t modifi la
     dernire fois seront incluses</dd>
     <dt><strong>Size</strong></dt>
     <dd>La taille du fichier en octets sera incluse</dd>
     <dt><strong>All</strong></dt>
     <dd>Tous les champs disponibles seront utiliss. Cette dfinition
     est quivalente  : 
     <pre class="prettyprint lang-config">FileETag INode MTime Size</pre>
</dd>
     <dt><strong>None</strong></dt>
     <dd>Si le document se compose d'un fichier, aucun champ
     <code>ETag</code> ne sera inclus dans la rponse</dd>
    </dl>

    <p>Les mots-cls <code>INode</code>, <code>MTime</code>, et
    <code>Size</code> peuvent tre prfixs par <code>+</code> ou
    <code>-</code>, ce qui permet de modifier les valeurs par dfaut
    hrites d'un niveau de configuration plus gnral. Tout mot-cl
    apparaissant sans aucun prfixe annule entirement et immdiatement
    les configurations hrites.</p>

    <p>Si la configuration d'un rpertoire contient
    <code>FileETag&nbsp;INode&nbsp;MTime&nbsp;Size</code>, et si un de
    ses sous-rpertoires contient <code>FileETag&nbsp;-INode</code>, la
    configuration de ce sous-rpertoire (qui sera propage vers tout
    sous-rpertoire qui ne la supplante pas), sera quivalente 
    <code>FileETag&nbsp;MTime&nbsp;Size</code>.</p>
    <div class="warning"><h3>Avertissement</h3>
    Ne modifiez pas les valeurs par dfaut pour les rpertoires ou
    localisations o WebDAV est activ et qui utilisent
    <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> comme fournisseur de stockage.
    <code class="module"><a href="../mod/mod_dav_fs.html">mod_dav_fs</a></code> utilise
    <code>MTime&nbsp;Size</code> comme format fixe pour les
    comparaisons de champs <code>ETag</code> dans les requtes
    conditionnelles. Ces requtes conditionnelles choueront si le
    format <code>ETag</code> est modifi via la directive
    <code class="directive">FileETag</code>.
    </div>
    <div class="note"><h3>Inclusions ct serveur</h3>
    Aucun champ ETag n'est gnr pour les rponses interprtes par
    <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>, car l'entit de la rponse peut
    changer sans modification de l'INode, du MTime, ou de la taille du
    fichier statique contenant les directives SSI.
    </div>



</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="files" id="files">Directive</a> <a name="Files" id="Files">&lt;Files&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent aux fichiers
prciss</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;Files <var>nom fichier</var>&gt; ... &lt;/Files&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>La directive <code class="directive">&lt;Files&gt;</code> limite
    la porte des directives qu'elle contient aux fichiers prciss.
    Elle est comparable aux directives <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Elle doit se terminer par une
    balise <code>&lt;/Files&gt;</code>. Les directives contenues dans
    cette section s'appliqueront  tout objet dont le nom de base (la
    dernire partie du nom de fichier) correspond au fichier spcifi.
    Les sections <code class="directive">&lt;Files&gt;</code> sont
    traites selon l'ordre dans lequel elles apparaissent dans le
    fichier de configuration, aprs les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et la lecture des fichiers
    <code>.htaccess</code>, mais avant les sections <code class="directive"><a href="#location">&lt;Location&gt;</a></code>. Notez que les
    sections <code class="directive">&lt;Files&gt;</code> peuvent tre
    imbriques dans les sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> afin de restreindre la portion
    du systme de fichiers  laquelle ces dernires vont
    s'appliquer.</p>

    <p>L'argument <var>filename</var> peut contenir un nom de fichier
    ou une chane de caractres avec caractres gnriques, o
    <code>?</code> remplace un caractre, et <code>*</code> toute chane
    de caractres.</p>
    <pre class="prettyprint lang-config">&lt;Files "cat.html"&gt;
    # Insrer ici des directives qui s'appliquent au fichier cat.html
&lt;/Files&gt;

&lt;Files "?at.*"&gt;
    # Les directives insres ici s'appliqueront aux fichiers
    # cat.html, bat.html, hat.php, et ainsi de suite.
&lt;/Files&gt;</pre>

    
    <p>On peut aussi utiliser les <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">Expressions rationnelles</a> en ajoutant la
    caractre <code>~</code>. Par exemple :</p>

    <pre class="prettyprint lang-config">&lt;Files ~ "\.(gif|jpe?g|png)$"&gt;
    #...
&lt;/Files&gt;</pre>


    <p>correspondrait  la plupart des formats graphiques de l'Internet.
    Il est cependant prfrable d'utiliser la directive <code class="directive"><a href="#filesmatch">&lt;FilesMatch&gt;</a></code>.</p>

    <p>Notez qu' la diffrence des sections <code class="directive"><a href="#directory">&lt;Directory&gt;</a></code> et <code class="directive"><a href="#location">&lt;Location&gt;</a></code>, les sections <code class="directive">&lt;Files&gt;</code> peuvent tre utilises dans les
    fichiers <code>.htaccess</code>. Ceci permet aux utilisateurs de
    contrler l'accs  leurs propres ressources, fichier par
    fichier.</p>


<h3>Voir aussi</h3>
<ul>
<li><a href="../sections.html">Comment fonctionnent les sections
&lt;Directory&gt;, &lt;Location&gt; et &lt;Files&gt;</a> pour une
explication de la manire dont ces diffrentes sections se combinent
entre elles  la rception d'une requte</li>
</ul>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
<div class="directive-section"><h2><a name="filesmatch" id="filesmatch">Directive</a> <a name="FilesMatch" id="FilesMatch">&lt;FilesMatch&gt;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Contient des directives qui s'appliquent  des fichiers
spcifis sous la forme d'expressions rationnelles</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>&lt;FilesMatch <var>expression rationnelle</var>&gt; ...
&lt;/FilesMatch&gt;</code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, rpertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>All</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Core</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>core</td></tr>
</table>
    <p>La section <code class="directive">&lt;FilesMatch&gt;</code>
    limite la porte des directives qu'elle contient aux fichiers
    spcifis, tout comme le ferait une section <code class="directive"><a href="#files">&lt;Files&gt;</a></code>. Mais elle accepte aussi les
    <a class="glossarylink" href="../glossary.html#regex" title="voir glossaire">expressions rationnelles</a>. Par
    exemple :</p>

    <pre class="prettyprint lang-config">&lt;FilesMatch ".+\.(gif|jpe?g|png)$"&gt;
    # ...
&lt;/FilesMatch&gt;</pre>


    <p>correspondrait  la plupart des formats graphiques de
    l'Internet.</p>

    <div class="note">Les caractres <code>.+</code> au dbut de l'expression
    rationnelle permettent de s'assurer que les fichiers de nom
    <code>.png</code>, ou <code>.gif</code>, par exemple, ne seront pas
    pris en compte.</div>

    <p>A partir de la version 2.4.8, les groupes nomms et les
    rfrences arrires sont extraits et enregistrs dans
    l'environnement avec leur nom en majuscules et prfix