Apache HTTP Server Version 1.3

Module mod_dir

Ce module est implémenté dans le fichier mod_dir.c, et est compilé par défaut. Il gère la redirection d'URL avec "slash final" et renvoie l'index de répertoire.

Résumé

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

Un fichier écrit par l'utilisateur, par exemple appelé index.html. La directive DirectoryIndex définit le nom attendu pour ce fichier. Ceci est contrôlé par le module mod_dir.
Alternativement, une liste de fichiers générée par le serveur. Cette fnctionnalité est donnée par le module mod_autoindex.

Les deux fonctions sont séparées, ce qui vous permet de complètement arrêter (ou remplacer) la génération automatique d'index de répertoire si vous le souhaitez.

Une redirection sur "slash final" est renvoyée lorsque le serveur reçoit une requête vers une URL http://servername/foo/nomRepertoire dans laquelle nomRepertoire est un répertoire de fichiers. L'accès à des répertoires nécessite d'écrire un slash final à la fin de l'URI. ET donc, mod_dir renvoie une redirection vers http://servername/foo/nomRepertoire/.

Directives

DirectoryIndex

Directive : DirectoryIndex

Syntaxe : DirectoryIndex url-locale url-locale ...
Défaut : DirectoryIndex index.html
Contexte : configuration serveur, hôte virtuel, répertoire, .htaccess
Surcharge : Indexes
Statut : Base
Module : mod_dir

La directive DirectoryIndex définit la liste des ressources à chercher lorsque le client requiert un index du répertoire par ajout du slash final à une URL pointant sur ce répertoire. url-locale est l'URL (%-encodée) d'un document sur le serveur relativement au répertoire requis. Ce sera usuellement le nom d'un fichier dans ce même répertoire. On pourra donner plusieurs URL, auquel cas le serveur renverra la premiere ressource qu'il trouve. Si aucune de ces ressources n'existe, et si l'option Indexes est active, le serveur génèrera sa propre liste.

Exemple :

DirectoryIndex index.html

alors une requête vers http://myserver/docs/ renverra la ressource http://myserver/docs/index.html si elle existe, ou donnera la liste du contenu du répertoire dans le cas contraire.

Notez qu'il n'est pas obligatoire que le chemin d'accès à la ressource soit relatif ; il peut être une URL absolue :

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

ferait exécuter le script CGI /cgi-bin/index.pl si aucun des fichiers index.html ou index.txt n'existaient dans le répertoire.

Apache HTTP Server Version 1.3