このモジュールは、
http://example.com/~user/
構文を使ってユーザ専用ディレクトリにアクセスできるようにします。
disabled キーワード。
enabled キーワード (下記参照) で明示的に
指定されたユーザ以外の
全てのユーザ名-ディレクトリ変換を
しないようにします。disabled キーワードと、スペース区切りのユーザ名リスト。
このリスト中に含まれるユーザ名に対しては、たとえ
enabled 節にあったとしても、
決してディレクトリ変換は行われません。enabled キーワードとスペース区切りのユーザ名リスト。
全体では変換が無効になっていたとしても、
これらのユーザ名にはディレクトリ変換が行われます。
ただし、disabled 節にもあれば変換はされません。
もし enabled も disabled
キーワードも UserDir に現われていなければ、
引数はファイル名パターンとして扱われ、
名前からディレクトリへの変換の指定を行なう時に使われます。
http://www.example.com/~bob/one/two.html
へのリクエストは次のように変換されます:
| UserDir ディレクティブ | 変換後のパス |
|---|---|
| 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 |
次のディレクティブはクライアントに対してリダイレクトを 送信します:
| UserDir ディレクティブ | 変換後のパス |
|---|---|
| UserDir http://www.example.com/users | http://www.example.com/users/bob/one/two.html |
| UserDir http://www.example.com/*/usr | http://www.example.com/bob/usr/one/two.html |
| UserDir http://www.example.com/~*/ | http://www.example.com/~bob/one/two.html |
UserDir ./" は
"/~root" から "/" へマップしますが、
これは望ましい動作ではないでしょう。
"UserDir disabled root" 宣言を
設定の中に含めておくことを強くお薦めします。
追加情報に 追加の例:
少数のユーザのみが UserDir
ディレクトリを利用し、それ以外には利用させたくない場合は
次を使いましょう:
大部分のユーザは UserDir ディレクトリを利用するけれど、
少数の人は不許可にしたい場合は、次を使いましょう:
他のユーザディレクトリを指定することもできます。 次のようなコマンドを使うと:
http://www.example.com/~bob/one/two.html へのリクエストはまず ~bob/public_html/one/two.html のページを調べ、その次に /usr/web/bob/one/two.html を調べ、最後に http://www.example.com/bob/one/two.html へのリダイレクトを送ります。
リダイレクトを加える場合は、リストの最後の選択肢でなければなりません。 Apache はリダイレクトが成功するかどうかを決めることはできませんので、 リストの前の方にリダイレクトを書くと、それが必ず使用される選択肢に なってしまいます。
2.1.4 以降では、ユーザディレクトリ置換機能はデフォルトでは起動しません。
それ以前のバージョンでは、UserDir public_html
であると仮定されていました。