Apache HTTP Server Version 1.3

Module mod_dir

이 모듈은 mod_dir.c 파일 안에 포함되어 있으며 , 기본값으로 컴파일되어져 있다. 이 모듈의 역할은 "trailing slash" 리다이렉트기능과 디렉토리 목록을 보여주는 기능을 제공한다.

Summary

디렉토리의 인덱스는 두가지 중 하나의 소스로부터 올 수 있다.

유저에 의해 작성된 파일, 일반적으로 index.html 로 설정된다. 이 파일의 이름은 DirectoryIndex 선언에서 지정된다. 이것은 mod_dir 에 의하여 제어된다.
그렇지않으면 서버에 의하여 생성되어진 파일인데, 이 파일은 mod_autoindex 에 의해서 제공된다.

이 두기능들은 독립적이어서, 디렉토리목록을 보여주는 기능의 사용을 마음데로 할 수 있다.

"trailing slash" 리다이렉트는 서버가 URL http://servername/foo/dirname (dirname .은 디렉토리) 에 대한 요청을 받았을 때 발생 된다. 디렉토리들은 "trailing slash"를 요청하고 ,이 때 mod_dir 은 http://servername/foo/dirname/ 으로 Redirect 를 발생시킨다.

Directives

DirectoryIndex

DirectoryIndex

Syntax: DirectoryIndex local-url local-url ...
Default: DirectoryIndex index.html
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Base
Module: mod_dir

DirectoryIndex directive 는 클라이언트가 디렉토리의 이름 끝에 / 를 붙혀서 디렉토리의 목록(index)을 요청할 때 , 이를 찾기 위한 리소스들의 목록을 설정한다. Local-url 은 요청된 디렉토리에 관련된 서버내 문서의 (%-encoded)URL 이다. 이것은 보통 디렉토리안에 있는 파일의 이름이다. 주어진 것인 다수의 URL 들이면 , 이 경우 서버는 발견된 첫 번째의 것을 리턴할 것이다. 만약 리소는내에 아무 것도존재하지 않고 Indexes 옵션을 설정되어 있으면 , 서버는 자신의 디렉토리 목록을 생성하여 보여 줄 것이다.

Example:

DirectoryIndex index.html

then a request for http://myserver/docs/ 의 요청에 대해 http://myserver/docs/index.html 를 돌려 준다(이 파일이 존재할 경우). 거나 디렉토리 목록을 보여준다.(index.html 파일이 없을 경우)

여기서 지정할 문서는 꼭 디렉토리 내에 있어야 할 필요는 없다.;

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

이 예에서 index.html 이나 index.txt 파일이 존재하지 않을 경우에는 CGI script /cgi-bin/index.pl 를 실행하게 된다.