Serveur Apache HTTP Version 2.4
Serveur Apache HTTP Version 2.4
| Description: | R�pertoires propres � un utilisateur |
|---|---|
| Statut: | Base |
| Identificateur�de�Module: | userdir_module |
| Fichier�Source: | mod_userdir.c |
Ce module permet l'acc�s aux r�pertoires propres � un utilisateur en
utilisant la syntaxe http://example.com/~utilisateur/.
| Description: | Chemin des r�pertoires propres � un utilisateur |
|---|---|
| Syntaxe: | UserDir nom-r�pertoire [nom-r�pertoire] ...
|
| Contexte: | configuration du serveur, serveur virtuel |
| Statut: | Base |
| Module: | mod_userdir |
La directive UserDir permet de d�finir le
r�pertoire r�el du r�pertoire home d'un utilisateur � utiliser � la
r�ception d'une requ�te pour un document de cet utilisateur.
nom-r�pertoire peut se pr�senter sous la forme suivante
:
disabled. Toutes les
traductions nom d'utilisateur vers r�pertoire sont alors
d�sactiv�es, � l'exception de celles comportant le mot-cl�
enabled (voir ci-dessous).disabled suivi d'une liste de noms
d'utilisateurs s�par�s par des espaces. Les noms d'utilisateurs
apparaissant dans une telle liste ne feront jamais
l'objet d'une traduction vers un r�pertoire, m�me dans le cas o�
ils appara�tront dans une clause enabled.enabled suivi d'une liste de noms
d'utilisateurs s�par�s par des espaces. Les noms d'utilisateurs
apparaissant dans une telle liste seront traduits en r�pertoires
m�me dans le cas o� une clause disable globale est active, mais
pas s'ils apparaissent aussi dans une clause
disabled.Si aucun mot-cl� enabled ou disabled
n'apparait dans la directive Userdir, l'argument est
trait� en tant que mod�le de fichier, et utilis� pour traduire le
nom d'utilisateur en une sp�cification de r�pertoire. Une requ�te
pour http://www.example.com/~bob/un/deux.html sera
traduite en :
| Directive Userdir utilis�e | Chemin traduit |
|---|---|
| UserDir public_html | ~bob/public_html/un/deux.html |
| UserDir /usr/web | /usr/web/bob/un/deux.html |
| UserDir /home/*/www | /home/bob/www/un/deux.html |
Les directives suivantes vont envoyer des redirections au client :
| Directive Userdir utilis�e | Chemin traduit |
|---|---|
| UserDir http://www.example.com/utilisateurs | http://www.example.com/utilisateurs/bob/un/deux.html |
| UserDir http://www.example.com/*/usr | http://www.example.com/bob/usr/un/deux.html |
| UserDir http://www.example.com/~*/ | http://www.example.com/~bob/un/deux.html |
"UserDir ./" ferait correspondre
"/~root" � "/" - ce qui n'est
probablement pas souhait�. Il est fortement recommand� d'inclure
une d�claration "UserDir disabled root" dans votre
configuration. Voir aussi la directive Directory et la page Conseils en mati�re de
s�curit� pour plus d'informations.
Exemples suppl�mentaires :
Pour permettre � quelques utilisateurs et seulement � ceux-ci de
poss�der des r�pertoires UserDir, utilisez la
configuration suivante :
UserDir disabled
UserDir enabled user1 user2 user3
Pour permettre � la plupart des utilisateurs de poss�der des
r�pertoires UserDir, mais l'interdire � quelques uns,
utilisez la configuration suivante :
UserDir disabled utilisateur4 utilisateur5 utilisateur6
Il est aussi possible de sp�cifier des r�pertoires utilisateurs alternatifs. Si vous utilisez une commande comme :
UserDir public_html /usr/web http://www.example.com/
Avec une requ�te pour
http://www.example.com/~bob/un/deux.html, le serveur
tentera tout d'abord de trouver la page �
~bob/public_html/un/deux.html, puis �
/usr/web/bob/un/deux.html, et enfin il enverra une
redirection vers
http://www.example.com/bob/un/deux.html.
Si vous sp�cifiez une redirection, elle doit �tre la derni�re alternative de la liste. Apache httpd ne pouvant pas d�terminer si la redirection a r�ussi, si cette derni�re ne se trouve pas en fin de liste, c'est cette alternative qui sera toujours utilis�e.
La substitution de r�pertoire utilisateur n'est pas activ�e par
d�faut depuis la version 2.1.4. Dans les versions pr�c�dentes,
UserDir public_html �tait sous-entendu si aucune
directive UserDir
n'�tait pr�sente.
Lorsqu'on passe du contexte global au contexte de serveur virtuel, les listes d'utilisateurs sp�cifiques activ�s ou d�sactiv�s sont remplac�es par les listes du contexte, et non fusionn�es.