Apache HTTP Server Version 1.3

Module mod_userdir

Ce module est implémenté dans le fichier mod_userdir.c, et est compilé par défaut. Il autorise la définition de répertoires propres à un utilisateur.

UserDir

Directive : UserDir

Syntaxe : UserDir repertoire/nomFichier
Défaut : UserDir public_html
Contexte : configuration serveur, hôtes virtuels
Statut : Base
Module : mod_userdir
Compatibilité : Toutes les formes sauf UserDir public_html ne sont disponibles qu'à partir de la version 1.1 d'Apache. L'utilisation des clauses enabled, ou disabled avec une liste de noms d'utilisateurs n'est possible qu'en version 1.3.

La directive UserDir définit le répertoire effectif accédé dans un répertoire personnel d'utilisateur lorsqu'une requête pour un document pointe dans l'espace de cet utilisateur. repertoire/nomFichier doit être l'un des suivants :

Le nom d'un répertoire ou un motif tel que ceux indiqués ci-dessous.
Le mot clef disabled. Ceci désactive toute translation utilisateur-vers-répertoire qui n'auraient pas été explicitement définies par la clause enabled (voir ci-dessous).
Le mot clef disabled suivi par une liste de noms d'utilisateurs séparée par des espaces. Il ne sera jamais fait de translation vers un répertoire pour les utilisateurs dans cette liste, même si ces utilisateurs sont associés à une clause enabled.
Le mot-clef enabled suivi par une liste de noms d'utilisateurs séparée par des espaces. Il sera fait une translation vers un répertoire même si ce service est globalement désactivé, mais pas si ces utilisateurs apparaissent dans une clause disabled.

Si aucun des deux mots-clefs enabled ou disabled n'aparaissent dans la directive Userdir, l'argument est considéré comme un motif de nom de fichier, et est utilisé pour constituer le répertoire translaté. Une requête vers http://www.foo.com/~bob/one/two.html sera translaté vers :

UserDir public_html     -> ~bob/public_html/one/two.html
UserDir /usr/web        -> /usr/web/bob/one/two.html
UserDir /home/*/www     -> /home/bob/www/one/two.html

Les directives suivantes renverront un avis de redirection vers le client :

UserDir http://www.foo.com/users   -> http//www.foo.com/users/bob/one/two.html
UserDir http://www.foo.com/*/usr   -> http://www.foo.com/bob/usr/one/two.html
UserDir http://www.foo.com/~*/     -> http://www.foo.com/~bob/one/two.html

Faites bien attention en utilisant ces directives ; par exemple, "UserDir ./" associerait "/~root" à "/" - ce qui n'est certainement pas souhaitable. Si vous exécutez Apache en version 1.3 ou supérieure, il est très fortement recommandé qu'une déclaration "UserDir disabled root" apparaisse dans votre fichier de configuration. Voir également la directive <Directory> et la page sur la sécurité pour plus de renseignements.

Apache HTTP Server Version 1.3