mirror of
https://github.com/apache/httpd.git
synced 2025-10-31 19:10:37 +03:00
f88b50dec4
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@91116 13f79535-47bb-0310-9956-ffa450edef68
116 lines
4.2 KiB
HTML
116 lines
4.2 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
|
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
|
|
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta name="generator" content="HTML Tidy, see www.w3.org" />
|
|
|
|
<title>Apache module mod_dir</title>
|
|
</head>
|
|
<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
|
|
|
|
<body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
|
|
vlink="#000080" alink="#FF0000">
|
|
<!--#include virtual="header.html" -->
|
|
|
|
<h1 align="CENTER">Module mod_dir</h1>
|
|
|
|
<p>This module provides for "trailing slash" redirects and
|
|
serving directory index files.</p>
|
|
|
|
<p><a href="module-dict.html#Status"
|
|
rel="Help"><strong>Status:</strong></a> Base<br />
|
|
<a href="module-dict.html#SourceFile"
|
|
rel="Help"><strong>Source File:</strong></a> mod_dir.c<br />
|
|
<a href="module-dict.html#ModuleIdentifier"
|
|
rel="Help"><strong>Module Identifier:</strong></a>
|
|
dir_module</p>
|
|
|
|
<h2>Summary</h2>
|
|
The index of a directory can come from one of two sources:
|
|
|
|
<ul>
|
|
<li>A file written by the user, typically called
|
|
<code>index.html</code>. The <a
|
|
href="#directoryindex">DirectoryIndex</a> directive sets the
|
|
name of this file. This is controlled by
|
|
<code>mod_dir</code>.</li>
|
|
|
|
<li>Otherwise, a listing generated by the server. This is
|
|
provided by <a
|
|
href="mod_autoindex.html"><code>mod_autoindex</code></a>.</li>
|
|
</ul>
|
|
The two functions are separated so that you can completely
|
|
remove (or replace) automatic index generation should you want
|
|
to.
|
|
|
|
<p>A "trailing slash" redirect is issued when the server
|
|
receives a request for a URL
|
|
<samp>http://servername/foo/dirname</samp> where
|
|
<samp>dirname</samp> is a directory. Directories require a
|
|
trailing slash, so <code>mod_dir</code> issues a redirect to
|
|
<samp>http://servername/foo/dirname/</samp>.</p>
|
|
|
|
<h2>Directives</h2>
|
|
|
|
<ul>
|
|
<li><a href="#directoryindex">DirectoryIndex</a></li>
|
|
</ul>
|
|
<hr />
|
|
|
|
<h2><a id="directoryindex"
|
|
name="directoryindex">DirectoryIndex</a> directive</h2>
|
|
<!--%plaintext <?INDEX {\tt DirectoryIndex} directive> -->
|
|
<a href="directive-dict.html#Syntax"
|
|
rel="Help"><strong>Syntax:</strong></a> DirectoryIndex
|
|
<em>local-url</em> [<em>local-url</em>] ...<br />
|
|
<a href="directive-dict.html#Default"
|
|
rel="Help"><strong>Default:</strong></a> <code>DirectoryIndex
|
|
index.html</code><br />
|
|
<a href="directive-dict.html#Context"
|
|
rel="Help"><strong>Context:</strong></a> server config, virtual
|
|
host, directory, .htaccess<br />
|
|
<a href="directive-dict.html#Override"
|
|
rel="Help"><strong>Override:</strong></a> Indexes<br />
|
|
<a href="directive-dict.html#Status"
|
|
rel="Help"><strong>Status:</strong></a> Base<br />
|
|
<a href="directive-dict.html#Module"
|
|
rel="Help"><strong>Module:</strong></a> mod_dir
|
|
|
|
<p>The DirectoryIndex directive sets the list of resources to
|
|
look for, when the client requests an index of the directory by
|
|
specifying a / at the end of the a directory name.
|
|
<em>Local-url</em> is the (%-encoded) URL of a document on the
|
|
server relative to the requested directory; it is usually the
|
|
name of a file in the directory. Several URLs may be given, in
|
|
which case the server will return the first one that it finds.
|
|
If none of the resources exist and the <code>Indexes</code>
|
|
option is set, the server will generate its own listing of the
|
|
directory.</p>
|
|
|
|
<p>Example:</p>
|
|
|
|
<blockquote>
|
|
<code>DirectoryIndex index.html</code>
|
|
</blockquote>
|
|
then a request for <code>http://myserver/docs/</code> would
|
|
return <code>http://myserver/docs/index.html</code> if it
|
|
exists, or would list the directory if it did not.
|
|
|
|
<p>Note that the documents do not need to be relative to the
|
|
directory;</p>
|
|
|
|
<blockquote>
|
|
<code>DirectoryIndex index.html index.txt
|
|
/cgi-bin/index.pl</code>
|
|
</blockquote>
|
|
would cause the CGI script <code>/cgi-bin/index.pl</code> to be
|
|
executed if neither <code>index.html</code> or
|
|
<code>index.txt</code> existed in a directory.
|
|
|
|
<p><!--#include virtual="footer.html" -->
|
|
</p>
|
|
</body>
|
|
</html>
|
|
|