2d2eda71267231c2526be701fe655db125852c1ffielding<?xml version="1.0" encoding="UTF-8" ?>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<?xml-stylesheet type="text/xsl" href="/style/manual.ja.xsl"?>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<modulesynopsis metafile="mod_dir.xml.meta">

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

2d2eda71267231c2526be701fe655db125852c1ffielding<name>mod_dir</name>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<description>「最後のスラッシュ」のリダイレクトと、ディレクトリの

f062ed7bd262a37a909dd77ce5fc23b446818823fieldingインデックスファイルを扱う機能を提供する</description>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<status>Base</status>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<sourcefile>mod_dir.c</sourcefile>

2d2eda71267231c2526be701fe655db125852c1ffielding<identifier>dir_module</identifier>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding<summary>

64185f9824e42f21ca7b9ae6c004484215c031a7rbb <p>ディレクトリインデックスは、次の二つのうちどちらかが利用されます:</p>

2d2eda71267231c2526be701fe655db125852c1ffielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <ul>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <li>一つ目は、ユーザが作成したファイルを用いるもので、通常

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <code>index.html</code> というファイル名を使います。このファイル名は、

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <directive module="mod_dir">DirectoryIndex</directive> ディレクティブで

2d2eda71267231c2526be701fe655db125852c1ffielding 指定することができます。この機能は <module>mod_dir</module>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding モジュールで提供されます。</li>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <li>もう一つの方法は、

f062ed7bd262a37a909dd77ce5fc23b446818823fielding サーバによって自動的に生成されるディレクトリリストを用いる場合です。

f062ed7bd262a37a909dd77ce5fc23b446818823fielding この機能は、<module>mod_autoindex</module>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding モジュールにより提供されます。</li>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding </ul>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <p>自動的なインデックス生成機能を削除 (もしくは交換)

2d2eda71267231c2526be701fe655db125852c1ffielding できるように、この二つの機能は分離されています。</p>

f062ed7bd262a37a909dd77ce5fc23b446818823fielding

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <p>なお <code>http://servername/foo/dirname</code> という URL

f062ed7bd262a37a909dd77ce5fc23b446818823fielding へのリクエストがあった際に、<code>dirname</code>

2d2eda71267231c2526be701fe655db125852c1ffielding というディレクトリがあれば、「最後にスラッシュをつけた形」の URL

f062ed7bd262a37a909dd77ce5fc23b446818823fielding へのリダイレクトを送出します。

f062ed7bd262a37a909dd77ce5fc23b446818823fielding ディレクトリへのアクセスはスラッシュで終わっている必要があり、

f062ed7bd262a37a909dd77ce5fc23b446818823fielding <code>mod_dir</code> は、<code>http://servername/foo/dirname/</code>

2d2eda71267231c2526be701fe655db125852c1ffielding へのリダイレクトを送出することになります。</p>

2d2eda71267231c2526be701fe655db125852c1ffielding</summary>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding<name>DirectoryIndex</name>

2d2eda71267231c2526be701fe655db125852c1ffielding<description>クライアントがディレクトリをリクエストしたときに調べる

2d2eda71267231c2526be701fe655db125852c1ffieldingリソースのリスト</description>

2d2eda71267231c2526be701fe655db125852c1ffielding<syntax>DirectoryIndex

2d2eda71267231c2526be701fe655db125852c1ffielding <var>local-url</var> [<var>local-url</var>] ...</syntax>

2d2eda71267231c2526be701fe655db125852c1ffielding<default>DirectoryIndex index.html</default>

2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>server config</context><context>virtual host</context>

2d2eda71267231c2526be701fe655db125852c1ffielding<context>directory</context><context>.htaccess</context></contextlist>

2d2eda71267231c2526be701fe655db125852c1ffielding<override>Indexes</override>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<usage>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb クライアントが、ディレクトリ名の最後に「/」

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb を指定してディレクトリインデックスを要求する場合に探すリソースのリストを

2d2eda71267231c2526be701fe655db125852c1ffielding <directive>DirectoryIndex</directive> ディレクティブで設定します。

30c289e6bc6d28d210b21edd800ab2cfc78a8381wrowe <var>Local-url</var>

bd53cb2bf4d77574fd502e1c02d8c3c0d5431967stoddard は、リクエストされたディレクトリに対応する、サーバ上のドキュメントの

b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb (% エンコードされた) URL で、普通はディレクトリ中のファイルの名前です。

b4c8a80f7dbfc9b56dbe03bdc28f0b5eb5f23697rbb 複数の URL が設定された場合には、最初に見つかったものを返します。

44c46ef733836b32585d135d2d90856e7cfd9929rbb それらが見つからず、<code>Indexes</code>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb オプションがセットされている場合、ディレクトリのリストを生成します。

2d2eda71267231c2526be701fe655db125852c1ffielding </p>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <example><title>例</title>

14bea4ba98aabaf554e37165a07123bb05d6736bstoddard DirectoryIndex index.html

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb </example>

9731f9232bddd7dbac757c780b2b1a2a6931dce7stoddard

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p><code>http://myserver/docs/</code> へのアクセスがあり、

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <code>http://myserver/docs/index.html</code>

2d2eda71267231c2526be701fe655db125852c1ffielding が存在すれば、この URL が返されます。

2d2eda71267231c2526be701fe655db125852c1ffielding もし存在しなければ、ディレクトリのリストが返されます。</p>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <p>注: ドキュメントが同じディレクトリ内に存在するは必要ありません。

2d2eda71267231c2526be701fe655db125852c1ffielding </p>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <example>

2d2eda71267231c2526be701fe655db125852c1ffielding DirectoryIndex index.html index.txt /cgi-bin/index.pl

2d2eda71267231c2526be701fe655db125852c1ffielding </example>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <p>とした場合、<code>index.html</code> と <code>index.txt</code>

2d2eda71267231c2526be701fe655db125852c1ffielding のどちらもディレクトリ内に存在しない場合、CGI スクリプト

2d2eda71267231c2526be701fe655db125852c1ffielding <code>/cgi-bin/index.pl</code> が実行されます。</p>

2e123e8beedc9f921448c113e2d6823a92fd5261fielding</usage>

2e123e8beedc9f921448c113e2d6823a92fd5261fielding</directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding<name>DirectorySlash</name>

2d2eda71267231c2526be701fe655db125852c1ffielding<description>パス末尾のスラッシュでリダイレクトするかどうかのオンオフをトグルさせる</description>

2d2eda71267231c2526be701fe655db125852c1ffielding<syntax>DirectorySlash On|Off</syntax>

2d2eda71267231c2526be701fe655db125852c1ffielding<default>DirectorySlash On</default>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<contextlist><context>server config</context><context>virtual host</context>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<context>directory</context><context>.htaccess</context></contextlist>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<override>Indexes</override>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<compatibility>2.0.51 以降</compatibility>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb<usage>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <p>要求のあった URL がディレクトリを指すかどうかを、

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb <module>mod_dir</module> が調整するべきかどうかを

2d2eda71267231c2526be701fe655db125852c1ffielding <directive>DirectorySlash</directive>

2d2eda71267231c2526be701fe655db125852c1ffielding ディレクティブで設定します。</p>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <p>典型的には、ユーザが末尾のスラッシュ無しでリソースへのリクエストを発行し、

2d2eda71267231c2526be701fe655db125852c1ffielding そして、そのリソースがディレクトリを指していた場合、<module>mod_dir</module>

2d2eda71267231c2526be701fe655db125852c1ffielding は、末尾にスラッシュを<em>付加</em>した上で同じリソースにリダイレクトさせます。

2d2eda71267231c2526be701fe655db125852c1ffielding この挙動には幾つか理由があります:</p>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <ul>

2d2eda71267231c2526be701fe655db125852c1ffielding <li>ユーザは、最終的にはリソースの別名 URL をリクエストすることになる。</li>

2d2eda71267231c2526be701fe655db125852c1ffielding <li><module>mod_autoindex</module> が期待通りに動く。<module>mod_autoindex</module>

2d2eda71267231c2526be701fe655db125852c1ffielding の生成するリンクはパスを出力しませんので、スラッシュがない場合は間違ったパスを

2d2eda71267231c2526be701fe655db125852c1ffielding 指してしまうことになります。</li>

2d2eda71267231c2526be701fe655db125852c1ffielding <li><directive module="mod_dir">DirectoryIndex</directive> は、

2d2eda71267231c2526be701fe655db125852c1ffielding 末尾にスラッシュがついているリクエストについて<em>のみ</em>評価される。</li>

2d2eda71267231c2526be701fe655db125852c1ffielding <li>HTML ページの相対 URL 参照が正しく動作する。</li>

2d2eda71267231c2526be701fe655db125852c1ffielding </ul>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <p>とはいえ、もしこういった効果を望まない、かつ、

2d2eda71267231c2526be701fe655db125852c1ffielding 上記のような理由が当てはまらない場合は、リダイレクトを次のようにしてオフにできます:</p>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <example>

2d2eda71267231c2526be701fe655db125852c1ffielding # see security warning below!<br />

2d2eda71267231c2526be701fe655db125852c1ffielding &lt;Location /some/path&gt;<br />

2d2eda71267231c2526be701fe655db125852c1ffielding <indent>

b0f20a4a26bcfa85724b1c2e5ec6a077f12ef44crbb DirectorySlash Off<br />

2d2eda71267231c2526be701fe655db125852c1ffielding SetHandler some-handler<br />

2d2eda71267231c2526be701fe655db125852c1ffielding </indent>

2d2eda71267231c2526be701fe655db125852c1ffielding &lt;/Location&gt;

2d2eda71267231c2526be701fe655db125852c1ffielding </example>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding <note type="warning"><title>セキュリティ警告</title>

2d2eda71267231c2526be701fe655db125852c1ffielding <p>末尾のスラッシュでのリダイレクトをオフにすると、結果的に情報漏洩を

2d2eda71267231c2526be701fe655db125852c1ffielding 招くことになるかもしれません。

2d2eda71267231c2526be701fe655db125852c1ffielding <module>mod_autoindex</module> が有効 (<code>Options +Indexes</code>) で、

2d2eda71267231c2526be701fe655db125852c1ffielding <directive module="mod_dir">DirectoryIndex</directive> が有効なリソース (例えば

2d2eda71267231c2526be701fe655db125852c1ffielding <code>index.html</code>) を指していて、また、要求のあった URL に特別な

2d2eda71267231c2526be701fe655db125852c1ffielding ハンドラが設定されていない場合を考えてみてください。

2d2eda71267231c2526be701fe655db125852c1ffielding この場合末尾にスラッシュのついているリクエストに対しては <code>index.html</code>

2d2eda71267231c2526be701fe655db125852c1ffielding ファイルが返されます。<strong>しかしスラッシュのないリクエストに対しては、

2d2eda71267231c2526be701fe655db125852c1ffielding ディレクトリの内容一覧を返してしまいます。</strong></p>

2d2eda71267231c2526be701fe655db125852c1ffielding </note>

2d2eda71267231c2526be701fe655db125852c1ffielding</usage>

2d2eda71267231c2526be701fe655db125852c1ffielding</directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding<directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding<name>FallbackResource</name>

2d2eda71267231c2526be701fe655db125852c1ffielding<description>Define a default URL for requests that don't map to a file</description>

2d2eda71267231c2526be701fe655db125852c1ffielding<contextlist><context>server config</context><context>virtual host</context><context>directory</context><context>.htaccess</context></contextlist>

2d2eda71267231c2526be701fe655db125852c1ffielding<usage><p>Documentation not yet translated. Please see English version of document.</p></usage>

2d2eda71267231c2526be701fe655db125852c1ffielding</directivesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding

2d2eda71267231c2526be701fe655db125852c1ffielding</modulesynopsis>

2d2eda71267231c2526be701fe655db125852c1ffielding