Module Apache mod_dir

Langues Disponibles: en | + fr | + ja | + ko | + tr

+ + + +

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
Statut:	Base
Identificateur de Module:	dir_module
Fichier Source:	mod_dir.c

Sommaire

+ +

L'index d'un répertoire peut provenir de deux sources :

+ +

Un fichier écrit par l'utilisateur, dont le nom, en général + appelé index.html, peut être défini à l'aide de la + directive DirectoryIndex + fournie par le module mod_dir.
Un listing généré par le serveur, par l'intermédiaire du + module mod_autoindex.

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.

+ +

Une redirection "slash de fin" est effectuée lorsque le serveur + reçoit une requête pour une URL du style + http://nom-serveur/foo/nom-rep où nom-rep + est le nom d'un répertoire. Comme les répertoires nécessitent un slash de + fin, mod_dir effectue une redirection vers + http://nom-serveur/foo/nom-rep/.

Traitement des bugs

Voir aussi

Commentaires

+ +

Directive DirectoryCheckHandler

+ + + + + + + + + +

Description:	Définit la réponse de ce module lorsqu'un autre +gestionnaire est utilisé
Syntaxe:	`DirectoryCheckHandler On\|Off`
Défaut:	`DirectoryCheckHandler Off`
Contexte:	configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:	Indexes
Statut:	Base
Module:	mod_dir
Compatibilité:	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 été spécifié.

La directive DirectoryCheckHandler permet + de faire en sorte que mod_dir 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 + SetHandler ou par d'autres + modules tels que mod_rewrite au cours des + substitutions de niveau répertoire.

+ +

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 SetHandler avait été définie pour un + répertoire entier, mais pouvait aussi être à l'origine de conflits avec + d'autres modules comme mod_rewrite.

+ +

Directive DirectoryIndex

+ + + + + + + + +

Description:	Liste des fichiers ressources à rechercher lorsque le +client envoie une requête pour un répertoire
Syntaxe:	`DirectoryIndex + disabled \| url locale [url locale] ...`
Défaut:	`DirectoryIndex index.html`
Contexte:	configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:	Indexes
Statut:	Base
Module:	mod_dir

La directive DirectoryIndex 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. url locale 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 + Indexes est définie, le serveur générera son propre + listing du répertoire.

+ +

Exemple

DirectoryIndex index.html

+ +

Avec cette configuration, une requête pour l'URL + http://example.com/docs/ renverrait au client la + ressource http://example.com/docs/index.html si elle + existe, ou provoquerait la génération du listing du répertoire si la + ressource n'existe pas.

+ +

Notez qu'il n'est pas nécessaire que les documents soient + relatifs au répertoire ;

+ +

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

+ + +

provoquerait l'exécution du script CGI + /cgi-bin/index.pl si aucun des fichiers + index.html ou index.txt n'existe dans le + répertoire considéré.

+ +

La spécification du seul argument "disabled" empêche + mod_dir 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".

+ +

Note: Positionner plusieurs directives DirectoryIndex + au coeur du même context complète la liste des ressources et ne l'écrase pas : +

# Exemple A: Positionner index.html en page d'index, puis ajouter index.php.
+<Directory "/foo">
+    DirectoryIndex index.html
+    DirectoryIndex index.php
+</Directory>
+
+# 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.
+<Directory "/foo">
+    DirectoryIndex index.html
+    DirectoryIndex disabled
+    DirectoryIndex index.php
+</Directory>

+ + + +

Directive DirectoryIndexRedirect

+ + + + + + + + + +

Description:	Définit une redirection externe pour les index de +répertoires. +
Syntaxe:	`DirectoryIndexRedirect on \| off \| permanent \| temp \| seeother \| +3xx-code +`
Défaut:	`DirectoryIndexRedirect off`
Contexte:	configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:	Indexes
Statut:	Base
Module:	mod_dir
Compatibilité:	Disponible depuis la version 2.3.14

Par défaut, c'est la page définie par la directive + DirectoryIndex qui est sélectionnée et + renvoyée de manière transparente au client. La directive + DirectoryIndexRedirect permet de rediriger le + client via une redirection de type 3xx.

+ +

Les arguments acceptés sont :

on : envoie une redirection 302 vers l'index choisi.
off : n'envoie aucune redirection. Il s'agit du comportement historique de mod_dir.
permanent : envoie une redirection 301 (permanent) vers l'index choisi.
temp : ceci est équivalent à on
seeother : envoie une redirection 303 (également appelée "See Other") vers l'index choisi.
3xx-code : envoie une redirection accompagnée du code 3xx choisi.

+ + + +

Exemple

DirectoryIndexRedirect on

+ +

Une requête pour http://example.com/docs/ se + solderait par une redirection temporaire vers + http://example.com/docs/index.html si cette ressource + existe.

+ + +

Directive DirectorySlash

+ + + + + + + + +

Description:	Activation/Désactivation de la redirection "slash de +fin"
Syntaxe:	`DirectorySlash On\|Off`
Défaut:	`DirectorySlash On`
Contexte:	configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:	Indexes
Statut:	Base
Module:	mod_dir

La directive DirectorySlash permet de + déterminer si mod_dir doit corriger ou non les URLs + pointant vers un répertoire.

+ +

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, mod_dir le redirige vers la même + ressource, mais en ajoutant un slash de fin, et ceci pour + plusieurs bonnes raisons :

+ +

La requête de l'utilisateur contiendra finalement l'URL + canonique de la ressource
mod_autoindex fonctionnera correctement. Comme + il n'indique pas le chemin dans le lien, le chemin de l'URL serait + incorrect.
La directive DirectoryIndex n'est évaluée + que pour les répertoires se terminant par un slash.
Les références à des URLs relatives dans les pages html + fonctionneront alors correctement.

+ +

Si vous ne souhaitez pas voir ces effets, et 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ère de sécurité.

+ +

# voir l'avertissement de sécurité ci-dessous !
+<Location "/some/path">
+    DirectorySlash Off
+    SetHandler some-handler
+</Location>

+ + +

Avertissement de sécurité

La désactivation de la redirection "slash de fin" peut entraîner + la divulgation d'informations. Considérons la situation où + mod_autoindex est actif (Options + +Indexes), où la directive DirectoryIndex a pour valeur une ressource valide (par + exemple index.html), 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 + index.html ; par contre, une requête sans slash + de fin afficherait un listing du contenu du + répertoire.

Notez aussi que certains navigateurs peuvent modifier par erreur + des requêtes POST en requêtes GET lors d'une redirection, les + données POST étant alors perdues.

+ +

Directive FallbackResource

+ + + + + + + + + +

Description:	Définit une URL par défaut pour les requêtes qui ne ciblent +aucun fichier
Syntaxe:	`FallbackResource disabled \| url-locale`
Défaut:	`disabled - httpd renvoie un code d'erreur 404 (Not Found)`
Contexte:	configuration globale, serveur virtuel, répertoire, .htaccess
Surcharges autorisées:	Indexes
Statut:	Base
Module:	mod_dir
Compatibilité:	L'argument `disabled` est disponible à partir +de la version 2.4.4 du serveur HTTP Apache.

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

FallbackResource /not-404.php

+ +

fait en sorte que les requêtes ne correspondant à aucun fichier + soient traitées par non-404.php, sans affecter les + requêtes pour des fichiers existants.

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'.

Dans les versions plus anciennes de httpd, cet effet nécessitait + en général mod_rewrite, et l'utilisation des tests + conditionnels -f et -d pour vérifier + l'existence des fichiers et répertoires. Maintenant, une seule ligne + de configuration est nécessaire.

FallbackResource /index.php

+ +

Les fichiers existants comme des images, des fichiers css, etc... + seront traités normalement.

L'argument disabled permet de désactiver cette + fonctionnalité dans le cas où l'héritage d'un répertoire parent + n'est pas souhaité.

Pour un URI intermédiaire tel que + http://example.com/blog/, cet URI intermédiaire doit être + spécifié en tant que url-locale :

<Directory "/web/example.com/htdocs/blog">
+    FallbackResource /blog/index.php
+</Directory>
+<Directory "/web/example.com/htdocs/blog/images">
+    FallbackResource disabled
+</Directory>

+ +

Un gestionnaire de ressource par défaut (dans l'exemple ci-dessus + /blog/index.php) peut accéder à l'URL de la requête originale + via la variable de serveur REQUEST_URI. Pour accéder à cette + variable en PHP, par exemple, utilisez $_SERVER['REQUEST_URI'].

+ +

Module Apache mod_dir

Sommaire

Directives

Traitement des bugs

Voir aussi

Directive DirectoryCheckHandler

Directive DirectoryIndex

Exemple

Directive DirectoryIndexRedirect

Exemple

Directive DirectorySlash

Avertissement de sécurité

Directive FallbackResource

Commentaires