mod_dir.xml.fr revision 17d2fcb33284ba6a887ec86305dcaddcd5459dd4
<?xml version="1.0"?>
<!-- English Revision : 1044701 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<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épertoire</description>
<status>Base</status>
<identifier>dir_module</identifier>
<summary>
<p>L'index d'un répertoire peut provenir de deux sources :</p>
<ul>
<li>Un fichier écrit par l'utilisateur, dont le nom, en général
directive <directive module="mod_dir">DirectoryIndex</directive>
fournie par le module <module>mod_dir</module>.</li>
<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
le souhaitez.</p>
<p>Une redirection "slash de fin" est effectuée lorsque le serveur
reçoit une requête pour une URL du style
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
</summary>
<directivesynopsis>
<name>DirectoryIndex</name>
<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>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<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 '/' à 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>
DirectoryIndex index.html
</example>
<p>Avec cette configuration, une requête pour l'URL
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écessaire que les documents soient
relatifs au répertoire ;</p>
<example>
</example>
<p>provoquerait l'exécution du script CGI
répertoire considéré.</p>
<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êmes des arguments "disabled".</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>DirectorySlash</name>
<description>Activation/Désactivation de la redirection "slash de
fin"</description>
<syntax>DirectorySlash On|Off</syntax>
<default>DirectorySlash On</default>
<contextlist><context>server config</context><context>virtual
host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<compatibility>Disponible depuis le version 2.0.51
d'Apache</compatibility>
<usage>
<p>La directive <directive>DirectorySlash</directive> permet de
déterminer si <module>mod_dir</module> doit corriger ou non les URLs
pointant vers un répertoire.</p>
<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ê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 é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>Donc, 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 de la manière suivante :</p>
<example>
# voir l'avertissement de sécurité ci-dessous !<br />
<indent>
DirectorySlash Off<br />
SetHandler un-gestionnaire<br />
</indent>
</Location>
</example>
<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ù la directive <directive module="mod_dir"
>DirectoryIndex</directive> a pour valeur une ressource valide (par
particulier n'a été défini pour cette URL. Dans ce cas, une requête
avec slash de fin afficherait le contenu du fichier
de fin afficherait un listing du contenu du
répertoire</strong>.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>FallbackResource</name>
<description>Définit une URL par défaut pour les requêtes qui ne ciblent
aucun fichier</description>
<syntax>FallbackResource <var>url-locale</var></syntax>
<default>Aucune - httpd renvoie un code d'erreur 404 (Not Found)</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>Indexes</override>
<usage>
<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>
<example>
</example>
<p>fait en sorte que les requêtes ne correspondant à aucun fichier
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ô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>
<example>
</example>
<p>Les fichiers existants comme des images, des fichiers css, etc...
seront traités normalement.</p>
<p>Pour un URI intermédiaire tel que
spécifié en tant que <var>url-locale</var> :</p>
<example>
<code>
<indent>
</indent>
</Directory>
</code>
</example>
</usage>
</directivesynopsis>
</modulesynopsis>