docs/manual/mod/mod_userdir.xml.ja

   1 <?xml version="1.0" encoding="UTF-8" ?>
   2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
   3 <?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>
   4 <!-- English Revision: 657842:698483 (outdated) -->
   5
   6 <!--
   7  Licensed to the Apache Software Foundation (ASF) under one or more
   8  contributor license agreements.  See the NOTICE file distributed with
   9  this work for additional information regarding copyright ownership.
  10  The ASF licenses this file to You under the Apache License, Version 2.0
  11  (the "License"); you may not use this file except in compliance with
  12  the License.  You may obtain a copy of the License at
  13
  14      http://www.apache.org/licenses/LICENSE-2.0
  15
  16  Unless required by applicable law or agreed to in writing, software
  17  distributed under the License is distributed on an "AS IS" BASIS,
  18  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  19  See the License for the specific language governing permissions and
  20  limitations under the License.
  21 -->
  22
  23 <modulesynopsis metafile="mod_userdir.xml.meta">
  24
  25 <name>mod_userdir</name>
  26 <description>ユーザ専用のディレクトリを提供
  27   </description>
  28 <status>Base</status>
  29 <sourcefile>mod_userdir.c</sourcefile>
  30 <identifier>userdir_module</identifier>
  31
  32 <summary>
  33 <p>このモジュールは、
  34 <code>http://example.com/~user/</code>
  35 構文を使ってユーザ専用ディレクトリにアクセスできるようにします。</p>
  36 </summary>
  37
  38 <seealso><a href="../urlmapping.html">URL から
  39 ファイルシステムへのマッピング</a></seealso>
  40 <seealso><a href="../howto/public_html.html">public_html
  41 チュートリアル</a></seealso>
  42
  43 <directivesynopsis>
  44
  45 <name>UserDir</name>
  46 <description>ユーザ専用ディレクトリの位置</description>
  47 <syntax>UserDir <em>directory-filename</em> [<em>directory-filename</em>] ...</syntax>
  48 <contextlist><context>server config</context>
  49 <context>virtual host</context></contextlist>
  50
  51 <usage>
  52
  53     <p><directive>UserDir</directive> ディレクティブは、
  54     ユーザのドキュメントへのリクエストを受けた時に使う
  55     ユーザのホームディレクトリ中の、実際のディレクトリを
  56     設定します。
  57     <em>directory-filename</em> には次のどれかを指定します:</p>
  58
  59     <ul>
  60       <li>ディレクトリ名か下に示すようなパターン。</li>
  61
  62       <li><code>disabled</code> キーワード。
  63       <code>enabled</code> キーワード (下記参照) で明示的に
  64       指定されたユーザ以外の
  65       <em>全ての</em>ユーザ名-ディレクトリ変換を
  66       しないようにします。</li>
  67
  68       <li><code>disabled</code> キーワードと、スペース区切りのユーザ名リスト。
  69       このリスト中に含まれるユーザ名に対しては、たとえ
  70       <code>enabled</code> 節にあったとしても、
  71       <em>決して</em>ディレクトリ変換は行われません。</li>
  72
  73       <li><code>enebled</code> キーワードとスペース区切りのユーザ名リスト。
  74       全体では変換が無効になっていたといたとしても、
  75       これらのユーザ名にはディレクトリ変換が行われます。
  76       ただし、<code>disabled</code> 節にもあれば変換はされません。
  77       </li>
  78     </ul>
  79
  80     <p>もし <code>enabled</code> も <code>disabled</code>
  81     キーワードも <code>UserDir</code> に現われていなければ、
  82     引数はファイル名パターンとして扱われ、
  83     名前からディレクトリへの変換の指定を行なう時に使われます。
  84     <code>http://www.example.com/~bob/one/two.html</code>
  85     へのリクエストは次のように変換されます:</p>
  86
  87 <table>
  88 <tr><th>UserDir ディレクティブ</th>
  89 <th>変換後のパス</th></tr>
  90 <tr><td>UserDir public_html</td><td>~bob/public_html/one/two.html</td></tr>
  91 <tr><td>UserDir /usr/web</td><td>/usr/web/bob/one/two.html</td></tr>
  92 <tr><td>UserDir /home/*/www</td><td>/home/bob/www/one/two.html</td></tr>
  93 </table>
  94
  95     <p>次のディレクティブはクライアントに対してリダイレクトを
  96     送信します:</p>
  97
  98 <table>
  99 <tr><th>UserDir ディレクティブ</th>
 100 <th>変換後のパス</th></tr>
 101 <tr><td>UserDir http://www.example.com/users</td><td>http://www.example.com/users/bob/one/two.html</td></tr>
 102 <tr><td>UserDir
 103 http://www.example.com/*/usr</td><td>http://www.example.com/bob/usr/one/two.html</td></tr>
 104 <tr><td>UserDir
 105 http://www.example.com/~*/</td><td>http://www.example.com/~bob/one/two.html</td></tr>
 106 </table>
 107
 108 <note>
 109       <strong>このディレクティブを使うときは注意してください;
 110       "<code>UserDir ./</code>" は
 111       "<code>/~root</code>" から "<code>/</code>" へマップしますが、
 112       これは望ましい動作ではないでしょう。
 113       "<code>UserDir disabled root</code>" 宣言を
 114       設定の中に含めておくことを強くお薦めします。
 115       追加情報に <directive module="core">Directory</directive>
 116       ディレクティブや
 117       <a href="../misc/security_tips.html">セキュリティ
 118       Tips</a> のページもご覧下さい。</strong>
 119 </note>
 120
 121 <p>追加の例:</p>
 122
 123 <p>少数のユーザのみが <code>UserDir</code>
 124 ディレクトリを利用し、それ以外には利用させたくない場合は
 125 次を使いましょう:</p>
 126
 127 <example>
 128 UserDir disabled<br />
 129 UserDir enabled user1 user2 user3
 130 </example>
 131
 132 <p>大部分のユーザは <code>UserDir</code> ディレクトリを利用するけれど、
 133 少数の人は不許可にしたい場合は、次を使いましょう:</p>
 134
 135 <example>
 136 UserDir enabled<br />
 137 UserDir disabled user4 user5 user6
 138 </example>
 139
 140 <p>他のユーザディレクトリを指定することもできます。
 141 次のようなコマンドを使うと:</p>
 142
 143 <example>
 144 Userdir public_html /usr/web http://www.example.com/
 145 </example>
 146
 147 <p>http://www.example.com/~bob/one/two.html へのリクエストはまず
 148 ~bob/public_html/one/two.html のページを調べ、その次に
 149 /usr/web/bob/one/two.html を調べ、最後に http://www.example.com/bob/one/two.html
 150 へのリダイレクトを送ります。</p>
 151
 152 <p>リダイレクトを加える場合は、リストの最後の選択肢でなければなりません。
 153 Apache はリダイレクトが成功するかどうかを決めることはできませんので、
 154 リストの前の方にリダイレクトを書くと、それが必ず使用される選択肢に
 155 なってしまいます。</p>
 156
 157 <p>2.1.4 以降では、ユーザディレクトリ置換機能はデフォルトでは起動しません。
 158 それ以前のバージョンでは、<directive module="mod_userdir">UserDir</directive>
 159 ディレクティブが存在しなければ、<code>UserDir public_html</code>
 160 であると仮定されていました。</p>
 161
 162 </usage>
 163
 164 <seealso><a href="../howto/public_html.html">public_html
 165 チュートリアル</a></seealso>
 166
 167 </directivesynopsis>
 168 </modulesynopsis>
 169
 170