<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<title>Apache module mod_dir</title>
</head>
<!-- English revision: 1.15 -->
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
<body
 bgcolor="#FFFFFF"
 text="#000000"
 link="#0000FF"
 vlink="#000080"
 alink="#FF0000"
>
    <div align="CENTER">
      <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> 

      <h3>Apache HTTP Server Version 1.3</h3>
    </div>

<h1 align="CENTER">mod_dir モジュール</h1>

<p>このモジュールは、スラッシュで終わる URL へのリクエストがあった際に、
ディレクトリインデックスファイルへリダイレクトして提供します。</p>

<p><a
href="module-dict.html#Status"
rel="Help"
><strong>ステータス:</strong></a> Base
<br>
<a
href="module-dict.html#SourceFile"
rel="Help"
><strong>ソースファイル:</strong></a> mod_dir.c
<br>
<a
href="module-dict.html#ModuleIdentifier"
rel="Help"
><strong>モジュール識別子:</strong></a> dir_module
</p>

<h2>概要</h2>
<p>
ディレクトリインデックスは、次の二つの内どちらかが利用されます。
<ul>
<li>一つ目は、ユーザが作成したファイルを用いるもので、通常 <code>index.html</code>
というファイル名を使います。このファイル名は、<a href="#directoryindex">DirectoryIndex</a> ディレクティブで
指定することができます。この機能は <code>mod_dir</code> モジュールで提供されます。
<li>もう一つの方法は、サーバによって自動的に生成されるディレクトリリストを用いる場合です。
この機能は、<a href="mod_autoindex.html"><code>mod_autoindex</code></a> モジュールにより提供されます。
</ul>
自動的なインデックス生成機能を削除 (もしくは交換) できるように、この二つの機能は分離されています。
</p>
<p>
なお <samp>http://servername/foo/dirname</samp> という URL へのリクエストがあった際に、
<samp>dirname</samp> というディレクトリがあれば、「最後にスラッシュをつけた形」の URL へのリダイレクトを送出します。
ディレクトリへのアクセスはスラッシュで終わっている必要があり、<code>mod_dir</code> は、
<samp>http://servername/foo/dirname/</samp> へのリダイレクトを送出することになります。
</p>

<h2>ディレクティブ</h2>

<menu>
<li><a href="#directoryindex">DirectoryIndex</a>
</menu>
<hr>

<h2><a name="directoryindex">DirectoryIndex</a> ディレクティブ</h2>
<!--%plaintext &lt;?INDEX {\tt DirectoryIndex} directive&gt; -->
<p>
<a
 href="directive-dict.html#Syntax"
 rel="Help"
><strong>構文:</strong></a> DirectoryIndex <em>local-url</em>
    [<em>local-url</em>] ...<br>
<a
 href="directive-dict.html#Default"
 rel="Help"
><strong>デフォルト:</strong></a> <code>DirectoryIndex index.html</code><br>
<a
 href="directive-dict.html#Context"
 rel="Help"
><strong>コンテキスト:</strong></a> server config, virtual host, directory, .htaccess<br>
<a
 href="directive-dict.html#Override"
 rel="Help"
><strong>上書き:</strong></a> Indexes<br>
<a
 href="directive-dict.html#Status"
 rel="Help"
><strong>ステータス:</strong></a> Base<br>
<a
 href="directive-dict.html#Module"
 rel="Help"
><strong>モジュール:</strong></a> mod_dir
</p>
<p>
クライアントが、ディレクトリ名の最後に「/」を指定してディレクトリインデックスを要求する場合に探すリソースのリストを
DirectoryIndex ディレクティブで設定します。
<em>Local-url</em> は、リクエストされたディレクトリに対応する、サーバ上のドキュメントの (% エンコードされた) URL で、
普通はディレクトリ中のファイルの名前です。
複数の URL が設定された場合には、最初に見つかったものを返します。
それらが見つからず、<code>Indexes</code> オプションがセットされている場合、ディレクトリのリストを
生成します。
</p>
<p>
例:
<blockquote><code>
DirectoryIndex index.html
</code></blockquote>
<code>http://myserver/docs/</code> へのアクセスがあり、<code>http://myserver/docs/index.html</code>
が存在すれば、この URL が返されます。
もし存在しなければ、ディレクトリのリストが返されます。
</p>

<p>
注: ドキュメントは同じディレクトリ内に存在する必要ありません。
<blockquote><code>
DirectoryIndex index.html index.txt /cgi-bin/index.pl</code></blockquote>
とした場合、<code>index.html</code> と <code>index.txt</code> のどちらもディレクトリ内で存在しない場合、
CGI スクリプト <code>/cgi-bin/index.pl</code> が実行されます。
</p>

    <hr />

    <h3 align="CENTER">Apache HTTP Server Version 1.3</h3>
    <a href="./"><img src="../images/index.gif" alt="Index" /></a>
    <a href="../"><img src="../images/home.gif" alt="Home" /></a>

</body>
</html>

