mirror of
https://github.com/apache/httpd.git
synced 2025-08-13 14:40:20 +00:00
1dc3771f4b
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1449163 13f79535-47bb-0310-9956-ffa450edef68
189 lines
7.3 KiB
Plaintext
189 lines
7.3 KiB
Plaintext
<?xml version="1.0"?>
|
|
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
|
|
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
|
|
<!-- English Revision : 1334026 -->
|
|
<!-- 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
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
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_userdir.xml.meta">
|
|
|
|
<name>mod_userdir</name>
|
|
<description>Répertoires propres à un utilisateur</description>
|
|
<status>Base</status>
|
|
<sourcefile>mod_userdir.c</sourcefile>
|
|
<identifier>userdir_module</identifier>
|
|
|
|
<summary>
|
|
<p>Ce module permet l'accès aux répertoires propres à un utilisateur en
|
|
utilisant la syntaxe <code>http://example.com/~utilisateur/</code>.</p>
|
|
</summary>
|
|
|
|
<seealso><a href="../urlmapping.html">Mise en correspondance des URLs
|
|
avec le système de fichiers</a></seealso>
|
|
<seealso><a href="../howto/public_html.html">Tutoriel
|
|
public_html</a></seealso>
|
|
|
|
<directivesynopsis>
|
|
|
|
<name>UserDir</name>
|
|
<description>Chemin des répertoires propres à un
|
|
utilisateur</description>
|
|
<syntax>UserDir <em>nom-répertoire</em> [<em>nom-répertoire</em>] ...
|
|
</syntax>
|
|
<contextlist><context>server config</context>
|
|
<context>virtual host</context></contextlist>
|
|
|
|
<usage>
|
|
|
|
<p>La directive <directive>UserDir</directive> 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.
|
|
<em>nom-répertoire</em> peut se présenter sous la forme suivante
|
|
:</p>
|
|
|
|
<ul>
|
|
<li>Le nom d'un répertoire ou un modèle tel que ceux présentés
|
|
ci-dessous.</li>
|
|
|
|
<li>Le mot-clé <code>disabled</code>. <em>Toutes</em> les
|
|
traductions nom d'utilisateur vers répertoire sont alors
|
|
désactivées, à l'exception de celles comportant le mot-clé
|
|
<code>enabled</code> (voir ci-dessous).</li>
|
|
|
|
<li>Le mot-clé <code>disabled</code> 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 <em>jamais</em>
|
|
l'objet d'une traduction vers un répertoire, même dans le cas où
|
|
ils apparaîtront dans une clause <code>enabled</code>.</li>
|
|
|
|
<li>Le mot-clé <code>enabled</code> 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
|
|
<code>disabled</code>.</li>
|
|
</ul>
|
|
|
|
<p>Si aucun mot-clé <code>enabled</code> ou <code>disabled</code>
|
|
n'apparait dans la directive <code>Userdir</code>, 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 <code>http://www.example.com/~bob/un/deux.html</code> sera
|
|
traduite en :</p>
|
|
|
|
<table>
|
|
<tr><th>Directive Userdir utilisée</th>
|
|
<th>Chemin traduit</th></tr>
|
|
<tr><td>UserDir public_html</td>
|
|
<td>~bob/public_html/un/deux.html</td></tr>
|
|
<tr><td>UserDir /usr/web</td>
|
|
<td>/usr/web/bob/un/deux.html</td></tr>
|
|
<tr><td>UserDir /home/*/www</td>
|
|
<td>/home/bob/www/un/deux.html</td></tr>
|
|
</table>
|
|
|
|
<p>Les directives suivantes vont envoyer des redirections au client
|
|
:</p>
|
|
|
|
<table>
|
|
<tr><th>Directive Userdir utilisée</th>
|
|
<th>Chemin traduit</th></tr>
|
|
<tr><td>UserDir http://www.example.com/utilisateurs</td>
|
|
<td>http://www.example.com/utilisateurs/bob/un/deux.html</td></tr>
|
|
<tr><td>UserDir http://www.example.com/*/usr</td>
|
|
<td>http://www.example.com/bob/usr/un/deux.html</td></tr>
|
|
<tr><td>UserDir http://www.example.com/~*/</td>
|
|
<td>http://www.example.com/~bob/un/deux.html</td></tr>
|
|
</table>
|
|
|
|
<note>
|
|
<strong>Soyez prudent avec cette directive ; par exemple,
|
|
<code>"UserDir ./"</code> ferait correspondre
|
|
<code>"/~root"</code> à <code>"/"</code> - ce qui n'est
|
|
probablement pas souhaité. Il est fortement recommandé d'inclure
|
|
une déclaration "<code>UserDir disabled root</code>" dans votre
|
|
configuration. Voir aussi la directive <directive
|
|
module="core">Directory</directive> et la page <a
|
|
href="../misc/security_tips.html">Conseils en matière de
|
|
sécurité</a> pour plus d'informations.</strong>
|
|
</note>
|
|
|
|
<p>Exemples supplémentaires :</p>
|
|
|
|
<p>Pour permettre à quelques utilisateurs et seulement à ceux-ci de
|
|
posséder des répertoires <code>UserDir</code>, utilisez la
|
|
configuration suivante :</p>
|
|
|
|
<highlight language="config">
|
|
UserDir disabled
|
|
UserDir enabled user1 user2 user3
|
|
</highlight>
|
|
|
|
<p>Pour permettre à la plupart des utilisateurs de posséder des
|
|
répertoires <code>UserDir</code>, mais l'interdire à quelques uns,
|
|
utilisez la configuration suivante :</p>
|
|
|
|
<highlight language="config">
|
|
UserDir disabled utilisateur4 utilisateur5 utilisateur6
|
|
</highlight>
|
|
|
|
<p>Il est aussi possible de spécifier des répertoires utilisateurs
|
|
alternatifs. Si vous utilisez une commande comme :</p>
|
|
|
|
<highlight language="config">
|
|
UserDir public_html /usr/web http://www.example.com/
|
|
</highlight>
|
|
|
|
<p>Avec une requête pour
|
|
<code>http://www.example.com/~bob/un/deux.html</code>, le serveur
|
|
tentera tout d'abord de trouver la page à
|
|
<code>~bob/public_html/un/deux.html</code>, puis à
|
|
<code>/usr/web/bob/un/deux.html</code>, et enfin il enverra une
|
|
redirection vers
|
|
<code>http://www.example.com/bob/un/deux.html</code>.</p>
|
|
|
|
<p>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.</p>
|
|
|
|
<p>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,
|
|
<code>UserDir public_html</code> était sous-entendu si aucune
|
|
directive <directive module="mod_userdir">UserDir</directive>
|
|
n'était présente.</p>
|
|
|
|
<note><title>Détails à propos de la fusion</title>
|
|
<p>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.</p></note>
|
|
|
|
</usage>
|
|
|
|
<seealso>
|
|
<a href="../howto/public_html.html">Tutoriel sur les répertoires web
|
|
utilisateur</a>
|
|
</seealso>
|
|
|
|
</directivesynopsis>
|
|
</modulesynopsis>
|
|
|
|
|