XML updates.

<?xml version="1.0"?>

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1673563 -->

<!-- English Revision: 1755988 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

<modulesynopsis metafile="mod_dir.xml.meta">

<name>mod_dir</name>

<description>Permet la redirection des adresses se terminant par un

répertoire sans slash de fin et la mise à disposition des fichiers index

de r&eacute;pertoire</description>

répertoire sans slash de fin et la mise à disposition des fichiers index

de répertoire</description>

<status>Base</status>

<sourcefile>mod_dir.c</sourcefile>

<identifier>dir_module</identifier>

<summary>

    <p>L'index d'un r&eacute;pertoire peut provenir de deux sources :</p>

    <p>L'index d'un répertoire peut provenir de deux sources :</p>

    <ul>

      <li>Un fichier &eacute;crit par l'utilisateur, dont le nom, en g&eacute;n&eacute;ral

      appel&eacute; <code>index.html</code>, peut &ecirc;tre d&eacute;fini &agrave; l'aide de la

      <li>Un fichier écrit par l'utilisateur, dont le nom, en général

      appelé <code>index.html</code>, peut être défini à l'aide de la

      directive <directive module="mod_dir">DirectoryIndex</directive>

      fournie par le module <module>mod_dir</module>.</li>

      <li>Un listing g&eacute;n&eacute;r&eacute; par le serveur, par l'interm&eacute;diaire du

      <li>Un listing généré par le serveur, par l'intermédiaire du

      module <module>mod_autoindex</module>.</li>

    </ul>

    <p>Les deux fonctions sont bien distinctes, si bien que vous pouvez

    supprimer (ou remplacer) la génération automatique d'index, si vous

    supprimer (ou remplacer) la génération automatique d'index, si vous

    le souhaitez.</p>

    <p>Une redirection "slash de fin" est effectu&eacute;e lorsque le serveur

    reçoit une requête pour une URL du style

    <code>http://nom-serveur/foo/nom-rep</code> o&ugrave; <code>nom-rep</code>

    est le nom d'un répertoire. Comme les répertoires nécessitent un slash de

    <p>Une redirection "slash de fin" est effectuée lorsque le serveur

    reçoit une requête pour une URL du style

    <code>http://nom-serveur/foo/nom-rep</code> où <code>nom-rep</code>

    est le nom d'un répertoire. Comme les répertoires nécessitent un slash de

    fin, <module>mod_dir</module> effectue une redirection vers

    <code>http://nom-serveur/foo/nom-rep/</code>.</p>

</summary>

<directivesynopsis>

<name>DirectoryIndex</name>

<description>Liste des fichiers ressources &agrave; rechercher lorsque le

client envoie une requ&ecirc;te pour un r&eacute;pertoire</description>

<description>Liste des fichiers ressources à rechercher lorsque le

client envoie une requête pour un répertoire</description>

<syntax>DirectoryIndex

    disabled | <var>url locale</var> [<var>url locale</var>] ...</syntax>

<default>DirectoryIndex index.html</default>

<usage>

    <p>La directive <directive>DirectoryIndex</directive> permet de

    définir une liste de fichiers ressources à rechercher lorsqu'un

    client envoie une requête pour l'index d'un répertoire, en ajoutant

    un '/' &agrave; la fin du nom de ce dernier. <var>url locale</var> est

    l'URL (codée avec caractères '%') d'un document du serveur, relative

    au répertoire faisant l'objet de la requête ; il s'agit en général

    du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont

    fournies, le serveur renverra la première d'entre elles qui

    correspond à une ressource existante. Si aucune ressource ne

    correspond à la liste des URLs spécifiées, et si l'option

    <code>Indexes</code> est d&eacute;finie, le serveur g&eacute;n&eacute;rera son propre

    listing du r&eacute;pertoire.</p>

    définir une liste de fichiers ressources à rechercher lorsqu'un

    client envoie une requête pour l'index d'un répertoire, en ajoutant

    un '/' à la fin du nom de ce dernier. <var>url locale</var> est

    l'URL (codée avec caractères '%') d'un document du serveur, relative

    au répertoire faisant l'objet de la requête ; il s'agit en général

    du nom d'un fichier situé dans le répertoire. Si plusieurs URLs sont

    fournies, le serveur renverra la première d'entre elles qui

    correspond à une ressource existante. Si aucune ressource ne

    correspond à la liste des URLs spécifiées, et si l'option

    <code>Indexes</code> est définie, le serveur générera son propre

    listing du répertoire.</p>

    <example><title>Exemple</title>

    <highlight language="config">

      </highlight>

    </example>

    <p>Avec cette configuration, une requ&ecirc;te pour l'URL

    <p>Avec cette configuration, une requête pour l'URL

    <code>http://example.com/docs/</code> renverrait au client la

    ressource <code>http://example.com/docs/index.html</code> si elle

    existe, ou provoquerait la génération du listing du répertoire si la

    existe, ou provoquerait la génération du listing du répertoire si la

    ressource n'existe pas.</p>

    <p>Notez qu'il n'est pas n&eacute;cessaire que les documents soient

    relatifs au r&eacute;pertoire ;</p>

    <p>Notez qu'il n'est pas nécessaire que les documents soient

    relatifs au répertoire ;</p>

    <highlight language="config">

      DirectoryIndex index.html index.txt  /cgi-bin/index.pl

    </highlight>

    <p>provoquerait l'ex&eacute;cution du script CGI

    <p>provoquerait l'exécution du script CGI

    <code>/cgi-bin/index.pl</code> si aucun des fichiers

    <code>index.html</code> ou <code>index.txt</code> n'existe dans le

    r&eacute;pertoire consid&eacute;r&eacute;.</p>

    répertoire considéré.</p>

    <p>La sp&eacute;cification du seul argument "disabled" emp&ecirc;che

    <p>La spécification du seul argument "disabled" empêche

    <module>mod_dir</module> de rechercher un index. Un argument

    "disabled" sera interprété de manière littérale si d'autres

    arguments sont présents avant ou après lui, même s'ils sont

    eux-m&ecirc;mes des arguments "disabled".</p>

    "disabled" sera interprété de manière littérale si d'autres

    arguments sont présents avant ou après lui, même s'ils sont

    eux-mêmes des arguments "disabled".</p>

    <p><strong>Note:</strong> Positionner plusieurs directives <directive>DirectoryIndex</directive>

    au coeur du <a href="../sections.html"><em>m&ecirc;me context</em></a> compl&egrave;te la liste des ressources et ne l'&eacute;crase pas :

    au coeur du <a href="../sections.html"><em>même context</em></a> complète la liste des ressources et ne l'écrase pas :

    </p>

    <highlight language="config">

# Exemple A: Positionner index.html en page d'index, puis ajouter index.php.

    DirectoryIndex index.php

</Directory>

# Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive.

# Exemple B: La même chose que l'exemple A, mais réalisé au moyen d'une seule directive.

<Directory "/foo">

    DirectoryIndex index.html index.php

</Directory>

# Exemple C: Pour remplacer la liste des ressources, il faut d'abord la vider :

# Ici, seul index.php restera référencé comme ressource d'index.

# Ici, seul index.php restera référencé comme ressource d'index.

<Directory "/foo">

    DirectoryIndex index.html

    DirectoryIndex disabled

<directivesynopsis>

<name>DirectoryIndexRedirect</name>

<description>D&eacute;finit une redirection externe pour les index de

répertoires.

<description>Définit une redirection externe pour les index de

répertoires.

</description>

<syntax>DirectoryIndexRedirect on | off | permanent | temp | seeother |

<var>3xx-code</var>

<compatibility>Disponible depuis la version 2.3.14</compatibility>

<usage>

    <p>Par d&eacute;faut, c'est la page d&eacute;finie par la directive

    <directive>DirectoryIndex</directive> qui est s&eacute;lectionn&eacute;e et

    renvoyée de manière transparente au client. La directive

    <p>Par défaut, c'est la page définie par la directive

    <directive>DirectoryIndex</directive> qui est sélectionnée et

    renvoyée de manière transparente au client. La directive

    <directive>DirectoryIndexRedirect</directive> permet de rediriger le

    client via une redirection de type 3xx.</p>

    <p>Les arguments accept&eacute;s sont :</p>

    <p>Les arguments acceptés sont :</p>

    <ul>

     <li><code>on</code> : envoie une redirection 302 vers l'index choisi.</li>

     <li><code>off</code> : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.</li>

     <li><code>permanent</code> : envoie une redirection 301 (permanent) vers l'index choisi.</li>

     <li><code>temp</code> : ceci est &eacute;quivalent &agrave; <code>on</code></li>

     <li><code>seeother</code> : envoie une redirection 303 (&eacute;galement appel&eacute;e "See Other") vers l'index choisi.</li>

     <li><var>3xx-code</var> : envoie une redirection accompagn&eacute;e du code 3xx choisi.</li>

     <li><code>temp</code> : ceci est équivalent à <code>on</code></li>

     <li><code>seeother</code> : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.</li>

     <li><var>3xx-code</var> : envoie une redirection accompagnée du code 3xx choisi.</li>

    </ul>

      </highlight>

    </example>

    <p>Une requ&ecirc;te pour <code>http://example.com/docs/</code> se

    <p>Une requête pour <code>http://example.com/docs/</code> se

    solderait par une redirection temporaire vers

    <code>http://example.com/docs/index.html</code> si cette ressource

    existe.</p>

<directivesynopsis>

<name>DirectorySlash</name>

<description>Activation/D&eacute;sactivation de la redirection "slash de

<description>Activation/Désactivation de la redirection "slash de

fin"</description>

<syntax>DirectorySlash On|Off</syntax>

<default>DirectorySlash On</default>

<usage>

    <p>La directive <directive>DirectorySlash</directive> permet de

    d&eacute;terminer si <module>mod_dir</module> doit corriger ou non les URLs

    pointant vers un r&eacute;pertoire.</p>

    déterminer si <module>mod_dir</module> doit corriger ou non les URLs

    pointant vers un répertoire.</p>

    <p>En g&eacute;n&eacute;ral, si un utilisateur envoie une requ&ecirc;te pour une

    ressource sans slash de fin, cette ressource représentant un

    r&eacute;pertoire, <module>mod_dir</module> le redirige vers la m&ecirc;me

    <p>En général, si un utilisateur envoie une requête pour une

    ressource sans slash de fin, cette ressource représentant un

    répertoire, <module>mod_dir</module> le redirige vers la même

    ressource, mais <em>en ajoutant</em> un slash de fin, et ceci pour

    plusieurs bonnes raisons :</p>

    <ul>

    <li>La requ&ecirc;te de l'utilisateur contiendra finalement l'URL

    <li>La requête de l'utilisateur contiendra finalement l'URL

    canonique de la ressource</li>

    <li><module>mod_autoindex</module> fonctionnera correctement. Comme

    il n'indique pas le chemin dans le lien, le chemin de l'URL serait

    incorrect.</li>

    <li>La directive <directive

    module="mod_dir">DirectoryIndex</directive> n'est &eacute;valu&eacute;e

    <em>que</em> pour les r&eacute;pertoires se terminant par un slash.</li>

    <li>Les r&eacute;f&eacute;rences &agrave; des URLs relatives dans les pages html

    module="mod_dir">DirectoryIndex</directive> n'est évaluée

    <em>que</em> pour les répertoires se terminant par un slash.</li>

    <li>Les références à des URLs relatives dans les pages html

    fonctionneront alors correctement.</li>

    </ul>

    <p>Si vous ne souhaitez pas voir ces effets, <em>et</em> si

    les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous

    pouvez désactiver la redirection comme indiqué ci-dessous.

    Gardez cependant à l'esprit que ceci peut avoir des répercutions en

    mati&egrave;re de s&eacute;curit&eacute;.</p>

    les raisons évoquées ci-dessus ne s'appliquent pas à vous, vous

    pouvez désactiver la redirection comme indiqué ci-dessous.

    Gardez cependant à l'esprit que ceci peut avoir des répercutions en

    matière de sécurité.</p>

    <highlight language="config">

# voir l'avertissement de sécurité ci-dessous !

# voir l'avertissement de sécurité ci-dessous !

<Location "/some/path">

    DirectorySlash Off

    SetHandler some-handler

</Location>

    </highlight>

    <note type="warning"><title>Avertissement de s&eacute;curit&eacute;</title>

    <p>La d&eacute;sactivation de la redirection "slash de fin" peut entra&icirc;ner

    la divulgation d'informations. Considérons la situation où

    <note type="warning"><title>Avertissement de sécurité</title>

    <p>La désactivation de la redirection "slash de fin" peut entraîner

    la divulgation d'informations. Considérons la situation où

    <module>mod_autoindex</module> est actif (<code>Options

    +Indexes</code>), o&ugrave; la directive <directive module="mod_dir"

    +Indexes</code>), où la directive <directive module="mod_dir"

    >DirectoryIndex</directive> a pour valeur une ressource valide (par

    exemple <code>index.html</code>), et o&ugrave; aucun gestionnaire

    particulier n'a été défini pour cette URL. Dans ce cas, une requête

    exemple <code>index.html</code>), et où aucun gestionnaire

    particulier n'a été défini pour cette URL. Dans ce cas, une requête

    avec slash de fin afficherait le contenu du fichier

    <code>index.html</code> ; <strong>par contre, une requ&ecirc;te sans slash

    <code>index.html</code> ; <strong>par contre, une requête sans slash

    de fin afficherait un listing du contenu du

    r&eacute;pertoire</strong>.</p>

    répertoire</strong>.</p>

    </note>

    <p>Notez aussi que certains navigateurs peuvent modifier par erreur

    des requêtes POST en requêtes GET lors d'une redirection, les

    donn&eacute;es POST &eacute;tant alors perdues.</p>

    des requêtes POST en requêtes GET lors d'une redirection, les

    données POST étant alors perdues.</p>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>FallbackResource</name>

<description>D&eacute;finit une URL par d&eacute;faut pour les requ&ecirc;tes qui ne ciblent

<description>Définit une URL par défaut pour les requêtes qui ne ciblent

aucun fichier</description>

<syntax>FallbackResource disabled | <var>url-locale</var></syntax>

<default>disabled - httpd renvoie un code d'erreur 404 (Not Found)</default>

<compatibility>L'argument <code>disabled</code> est disponible à partir

de la version 2.4.4 du serveur HTTP Apache.</compatibility>

<usage>

    <p>Cette directive permet de d&eacute;finir un traitement pour toute URL

    qui ne correspond à aucune ressource de votre système de fichiers,

    <p>Cette directive permet de définir un traitement pour toute URL

    qui ne correspond à aucune ressource de votre système de fichiers,

    et qui provoquerait sans cela l'envoi d'un code d'erreur HTTP 404

    (Not Found).

    Par exemple</p>

    <highlight language="config">

        FallbackResource /not-404.php

    </highlight>

    <p>fait en sorte que les requ&ecirc;tes ne correspondant &agrave; aucun fichier

    soient trait&eacute;es par <code>non-404.php</code>, sans affecter les

    requ&ecirc;tes pour des fichiers existants.</p>

    <p>fait en sorte que les requêtes ne correspondant à aucun fichier

    soient traitées par <code>non-404.php</code>, sans affecter les

    requêtes pour des fichiers existants.</p>

    <p>Il est souvent souhaitable qu'un seul fichier ou ressource traite

    toutes les requêtes à destination d'un répertoire

    particulier, sauf pour les requêtes qui correspondent à un fichier

    ou script existant. On y fait souvent référence sous le terme

    'contr&ocirc;leur frontal'.</p>

    <p>Dans les versions plus anciennes de httpd, cet effet n&eacute;cessitait

    en g&eacute;n&eacute;ral <module>mod_rewrite</module>, et l'utilisation des tests

    conditionnels <code>-f</code> et <code>-d</code> pour v&eacute;rifier

    l'existence des fichiers et répertoires. Maintenant, une seule ligne

    de configuration est n&eacute;cessaire.</p>

    toutes les requêtes à destination d'un répertoire

    particulier, sauf pour les requêtes qui correspondent à un fichier

    ou script existant. On y fait souvent référence sous le terme

    'contrôleur frontal'.</p>

    <p>Dans les versions plus anciennes de httpd, cet effet nécessitait

    en général <module>mod_rewrite</module>, et l'utilisation des tests

    conditionnels <code>-f</code> et <code>-d</code> pour vérifier

    l'existence des fichiers et répertoires. Maintenant, une seule ligne

    de configuration est nécessaire.</p>

    <highlight language="config">

        FallbackResource /index.php

    </highlight>

    <p>Les fichiers existants comme des images, des fichiers css, etc...

    seront trait&eacute;s normalement.</p>

    seront traités normalement.</p>

    <p>L'argument <code>disabled</code> permet de désactiver cette

    fonctionnalité dans le cas où l'héritage d'un répertoire parent

    n'est pas souhaité.</p>

    <p>Pour un URI interm&eacute;diaire tel que

    <em>http://example.com/blog/</em>, cet URI interm&eacute;diaire doit &ecirc;tre

    sp&eacute;cifi&eacute; en tant que <var>url-locale</var> :</p>

    <p>Pour un URI intermédiaire tel que

    <em>http://example.com/blog/</em>, cet URI intermédiaire doit être

    spécifié en tant que <var>url-locale</var> :</p>

    <highlight language="config">

<Directory "/web/example.com/htdocs/blog">

    FallbackResource /blog/index.php

<directivesynopsis>

<name>DirectoryCheckHandler</name>

<description>D&eacute;finit la r&eacute;ponse de ce module lorsqu'un autre

gestionnaire est utilis&eacute;</description>

<description>Définit la réponse de ce module lorsqu'un autre

gestionnaire est utilisé</description>

<syntax>DirectoryCheckHandler On|Off</syntax>

<default>DirectoryCheckHandler Off</default>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>Indexes</override>

<compatibility>Disponible depuis la version 2.4.8 du serveur HTTP

Apache. Les versions antérieures à 2.4 se comportaient implicitement

comme si "DirectoryCheckHandler ON" avait &eacute;t&eacute; sp&eacute;cifi&eacute;.</compatibility>

Apache. Les versions antérieures à 2.4 se comportaient implicitement

comme si "DirectoryCheckHandler ON" avait été spécifié.</compatibility>

<usage>

    <p>La directive <directive>DirectoryCheckHandler</directive> permet

    de faire en sorte que <module>mod_dir</module> recherche un index

    de répertoire ou ajoute des slashes de fin lorsqu'un autre

    gestionnaire à été défini pour l'URL considérée. Les gestionnaires

    peuvent être définis à via des directives telles que

    de répertoire ou ajoute des slashes de fin lorsqu'un autre

    gestionnaire à été défini pour l'URL considérée. Les gestionnaires

    peuvent être définis à via des directives telles que

    <directive module="core">SetHandler</directive> ou par d'autres

    modules tels que <module>mod_rewrite</module> au cours des

    substitutions de niveau répertoire.</p>

    <p>Dans les versions ant&eacute;rieures &agrave; 2.4, ce module ne modifiait pas

    son comportement si un autre gestionnaire avait été défini pour

    l'URL considérée. Ceci permettait de servir des index de répertoires

    m&ecirc;me si une directive <directive>SetHandler</directive> avait &eacute;t&eacute;

    définie pour un répertoire entier, mais pouvait aussi être à

    l'origine de conflits avec d'autres modules.</p> 

    <p>Dans les versions antérieures à 2.4, ce module ne modifiait pas son

    comportement si un autre gestionnaire avait été défini pour l'URL

    considérée. Ceci permettait de servir des index de répertoires même si une

    directive <directive>SetHandler</directive> avait été définie pour un

    répertoire entier, mais pouvait aussi être à l'origine de conflits avec

    d'autres modules comme <module>mod_rewrite</module>.</p> 

</usage>

</directivesynopsis>

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1747804:1755363 (outdated) -->

<!-- English Revision: 1755363 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

sécurité.</li>

<li>Lorsqu'on utilise le moteur de réécriture dans un fichier

<code>.htaccess</code>, le chemin de base du répertoire courant (qui est

toujours le même pour ce même répertoire) est automatiquement

<em>supprimé</em> au cours de la comparaison avec le modèle de la règle

de réécriture, et automatiquement <em>ajouté</em> lorsqu'une

substitution relative (ne débutant pas par un slash ou un nom de

protocole) arrive à la fin d'un jeu de règles. Voir la directive

<directive module="mod_rewrite">RewriteBase</directive> pour plus de

détails à propos de l'ajout du préfixe après les substitutions

relatives.</li>

<code>.htaccess</code>, le chemin de base du répertoire courant (autrement dit

le chemin URI qui représente le répertoire contenant ce fichier

<code>.htaccess</code>) est automatiquement <em>supprimé</em> au cours de la

comparaison avec le modèle de la règle de réécriture, et automatiquement

<em>ajouté</em> lorsqu'une substitution relative (ne débutant pas par un slash

ou un nom de protocole) arrive à la fin d'un jeu de règles. Voir la directive

<directive module="mod_rewrite">RewriteBase</directive> pour plus de détails à

propos de l'ajout du préfixe après les substitutions relatives.</li>

<li>Si vous souhaitez effectuer une comparaison en prenant en compte

l'intégralité du

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1753074 -->

<!-- English Revision: 1755987 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

    <p>Deux modules, <code>mod_whatkilledus</code> et

    <code>mod_backtrace</code> utilisent ce hook. Veuillez vous

    référer à la <a

    href="http://people.apache.org/~trawick/exception_hook.html"

    href="https://emptyhammock.com/projects/httpd/diag/"

    >page EnableExceptionHook</a> de Jeff Trawick pour plus

    d'informations à leur sujet.</p>

</usage>

<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

<!-- English Revision: 1731194:1755978 (outdated) -->

<!-- English Revision: 1755978 -->

<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

accédé via le serveur mandataire du module <module>mod_proxy</module>.

Par exemple, la configuration suivante n'autorisera qu'un sous-ensemble de

clients à accéder au site <code>www.example.com</code> en passant par le serveur

mandataire :.</p>

mandataire :</p>

<highlight language="config">

<Proxy "http://www.example.com/*">