granicus.if.org Git - apache/blob - docs/manual/mod/mod_userdir.xml.fr

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
   4 <!-- English Revision: 1745711 -->
   5 <!-- French translation : Lucien GENTIS -->
   6
   7 <!--
   8  Licensed to the Apache Software Foundation (ASF) under one or more
   9  contributor license agreements.  See the NOTICE file distributed with
  10  this work for additional information regarding copyright ownership.
  11  The ASF licenses this file to You under the Apache License, Version 2.0
  12  (the "License"); you may not use this file except in compliance with
  13  the License.  You may obtain a copy of the License at
  14
  15      http://www.apache.org/licenses/LICENSE-2.0
  16
  17  Unless required by applicable law or agreed to in writing, software
  18  distributed under the License is distributed on an "AS IS" BASIS,
  19  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  20  See the License for the specific language governing permissions and
  21  limitations under the License.
  22 -->
  23
  24 <modulesynopsis metafile="mod_userdir.xml.meta">
  25
  26 <name>mod_userdir</name>
  27 <description>Répertoires propres à un utilisateur</description>
  28 <status>Base</status>
  29 <sourcefile>mod_userdir.c</sourcefile>
  30 <identifier>userdir_module</identifier>
  31
  32 <summary>
  33 <p>Ce module permet l'accès aux répertoires propres à un utilisateur en
  34 utilisant la syntaxe <code>http://example.com/~utilisateur/</code>.</p>
  35 </summary>
  36
  37 <seealso><a href="../urlmapping.html">Mise en correspondance des URLs
  38 avec le système de fichiers</a></seealso>
  39 <seealso><a href="../howto/public_html.html">Tutoriel
  40 public_html</a></seealso>
  41
  42 <directivesynopsis>
  43
  44 <name>UserDir</name>
  45 <description>Chemin des répertoires propres à un
  46 utilisateur</description>
  47 <syntax>UserDir <em>nom-répertoire</em> [<em>nom-répertoire</em>] ...
  48 </syntax>
  49 <contextlist><context>server config</context>
  50 <context>virtual host</context></contextlist>
  51
  52 <usage>
  53
  54     <p>La directive <directive>UserDir</directive> permet de définir le
  55     répertoire réel du répertoire home d'un utilisateur à utiliser à la
  56     réception d'une requête pour un document de cet utilisateur.
  57     <em>nom-répertoire</em> peut se présenter sous la forme suivante
  58     :</p>
  59
  60     <ul>
  61       <li>Le nom d'un répertoire ou un modèle tel que ceux présentés
  62       ci-dessous.</li>
  63
  64       <li>Le mot-clé <code>disabled</code>. <em>Toutes</em> les
  65       traductions nom d'utilisateur vers répertoire sont alors
  66       désactivées, à l'exception de celles comportant le mot-clé
  67       <code>enabled</code> (voir ci-dessous).</li>
  68
  69       <li>Le mot-clé <code>disabled</code> suivi d'une liste de noms
  70       d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
  71       apparaissant dans une telle liste ne feront <em>jamais</em>
  72       l'objet d'une traduction vers un répertoire, même dans le cas où
  73       ils apparaîtront dans une clause <code>enabled</code>.</li>
  74
  75       <li>Le mot-clé <code>enabled</code> suivi d'une liste de noms
  76       d'utilisateurs séparés par des espaces. Les noms d'utilisateurs
  77       apparaissant dans une telle liste seront traduits en répertoires
  78       même dans le cas où une clause disable globale est active, mais
  79       pas s'ils apparaissent aussi dans une clause
  80       <code>disabled</code>.</li>
  81     </ul>
  82
  83     <p>Si aucun mot-clé <code>enabled</code> ou <code>disabled</code>
  84     n'apparait dans la directive <directive>Userdir</directive>, l'argument est
  85     traité en tant que modèle de fichier, et utilisé pour traduire le
  86     nom d'utilisateur en une spécification de répertoire. Une requête
  87     pour <code>http://www.example.com/~bob/un/deux.html</code> sera
  88     traduite en :</p>
  89
  90     <table>
  91       <tr><th>Directive Userdir utilisée</th>
  92           <th>Chemin traduit</th></tr>
  93       <tr><td>UserDir public_html</td>
  94           <td>~bob/public_html/un/deux.html</td></tr>
  95       <tr><td>UserDir /usr/web</td>
  96           <td>/usr/web/bob/un/deux.html</td></tr>
  97       <tr><td>UserDir /home/*/www</td>
  98           <td>/home/bob/www/un/deux.html</td></tr>
  99     </table>
 100
 101     <p>Les directives suivantes vont envoyer des redirections au client
 102     :</p>
 103
 104     <table>
 105       <tr><th>Directive Userdir utilisée</th>
 106           <th>Chemin traduit</th></tr>
 107       <tr><td>UserDir http://www.example.com/utilisateurs</td>
 108           <td>http://www.example.com/utilisateurs/bob/un/deux.html</td></tr>
 109       <tr><td>UserDir http://www.example.com/*/usr</td>
 110           <td>http://www.example.com/bob/usr/un/deux.html</td></tr>
 111       <tr><td>UserDir http://www.example.com/~*/</td>
 112           <td>http://www.example.com/~bob/un/deux.html</td></tr>
 113     </table>
 114
 115     <note>
 116       <strong>Soyez prudent avec cette directive ; par exemple,
 117       <code>"UserDir ./"</code> ferait correspondre
 118       <code>"/~root"</code> à <code>"/"</code> - ce qui n'est
 119       probablement pas souhaité. Il est fortement recommandé d'inclure
 120       une déclaration "<code>UserDir disabled root</code>" dans votre
 121       configuration. Voir aussi la directive <directive
 122       module="core">Directory</directive> et la page <a
 123       href="../misc/security_tips.html">Conseils en matière de
 124       sécurité</a> pour plus d'informations.</strong>
 125     </note>
 126
 127     <p>Exemples supplémentaires :</p>
 128
 129     <p>Pour permettre à quelques utilisateurs et seulement à ceux-ci de
 130     posséder des répertoires <code>UserDir</code>, utilisez la
 131     configuration suivante :</p>
 132
 133     <highlight language="config">
 134 UserDir disabled
 135 UserDir enabled user1 user2 user3
 136     </highlight>
 137
 138     <p>Pour permettre à la plupart des utilisateurs de posséder des
 139     répertoires <code>UserDir</code>, mais l'interdire à quelques uns,
 140     utilisez la configuration suivante :</p>
 141
 142     <highlight language="config">
 143       UserDir disabled utilisateur4 utilisateur5 utilisateur6
 144     </highlight>
 145
 146     <p>Il est aussi possible de spécifier des répertoires utilisateurs
 147     alternatifs. Si vous utilisez une commande comme :</p>
 148
 149     <highlight language="config">
 150       UserDir "public_html" "/usr/web" "http://www.example.com/"
 151     </highlight>
 152
 153     <p>Avec une requête pour
 154     <code>http://www.example.com/~bob/un/deux.html</code>, le serveur
 155     tentera tout d'abord de trouver la page à
 156     <code>~bob/public_html/un/deux.html</code>, puis à
 157     <code>/usr/web/bob/un/deux.html</code>, et enfin il enverra une
 158     redirection vers
 159     <code>http://www.example.com/bob/un/deux.html</code>.</p>
 160
 161     <p>Si vous spécifiez une redirection, elle doit être la dernière
 162     alternative de la liste. Apache httpd ne pouvant pas déterminer si la
 163     redirection a réussi, si cette dernière ne se trouve pas en fin de
 164     liste, c'est cette alternative qui sera toujours utilisée.</p>
 165
 166     <p>La substitution de répertoire utilisateur n'est pas activée par
 167     défaut depuis la version 2.1.4. Dans les versions précédentes,
 168     <code>UserDir public_html</code> était sous-entendu si aucune
 169     directive <directive>UserDir</directive>
 170     n'était présente.</p>
 171
 172     <note><title>Détails à propos de la fusion</title>
 173     <p>Lorsqu'on passe du contexte global au contexte de serveur
 174     virtuel, les listes d'utilisateurs spécifiques activés ou désactivés
 175     sont remplacées par les listes du contexte, et non fusionnées.</p></note>
 176
 177 </usage>
 178
 179 <seealso>
 180   <a href="../howto/public_html.html">Tutoriel sur les répertoires web
 181   utilisateur</a>
 182 </seealso>
 183
 184 </directivesynopsis>
 185 </modulesynopsis>
 186
 187