Linux中文HOW TO 1---阿帕奇 HTTP 服务器参考手册(10)
4.6 mod_dir 模组
这个模组包含在 mod_dir.c 文件里，而且依预设会编译进来。它提供
作为目录索引之用。
4.6.1 摘要
这个模组控制目录索引。目录的索引可以有两种来源:
。一个由使用者所撰写的文件，典型是称为 index.html 的文件
。DrectoryIndex 指令设定这个文件的名称。
。另一种是由服务器所产生的列表。其它的指令控制这个列表的
格式。AddIcon, AddIconByEncoding and AddIconByType 都
是用来设定显示不同文件型态所使用的图示列表；对於每种列
出的文件型态，显示列出的第一个符合的图示。
4.6.2 AddDescription
语法: AddDescription 字串 文件 文件 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这是设定某文件所要显示的描述，供象徵索引(FancyIndexing) 使用。
文件是指所要描述之文件的副文件名，部份文件名称，替代字元表示式或
完整文件名称。 字串以双引号(") 括起。例如:
AddDescription "The planet Mars" /web/pics/mars.gif
4.6.3 AddIcon
语法: AddIcon 图示 名称 名称 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在文件名称之後的图示供作象徵索引之用。图示可以是某个
图示的相对 URL 或是给非图形化浏览器使用的文字标签。
对於目录可以使用 ^^DIRECTORY^^ 这个名称，^^BLANKICON^^ 可以用
在空白行（使列表的格式正确），名称也可以是扩充文件名，替代字元表
示式，部份或完整的文件名称。例如:
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
AddIcon /icons/dir.xbm ^^DIRECTORY^^
AddIcon /icons/backup.xbm *~
可能的话，使用 AddIconByType 应该比 AddIcon 好。
4.6.4 AddIconByEncoding
语法: AddIconByEncoding icon mime-encoding mime-encoding ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在有 mime-encoding 的文件名称之後的图示供作象徵索引
之用。图示可以是某个图示的相对 URL 或是给非图形化浏览器使用的
文字标签。
Mime-encoding 是个符合要求之编码内容的替代字元表示式。例如:
AddIconByEncoding /icons/compress.xxbm x-compress
4.6.5 AddIconByType
语法: AddIconByType icon mime-type mime-type ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在 mime-type 的文件名称之後的图示供作象徵索引之用。
图示可以是某个图示的相对 URL 或是给非图形化浏览器使用的文字标
签。
Mime-encoding 是个符合要求之 mime 型态的替代字元表示式。例如:
AddIconByType (IMG, /icons/image.xbm) image/*
4.6.6 DefaultIcon
语法: DefaultIcon url
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
DefaultIcon 这个指令设定当不知道指定的图示为何时显示的图示供作
象徵索引之用。URl 是该图示的(%-escaped) 相对 URL 。例如:
DefaultIcon /icon/unknow.xbm
4.6.7 DirectoryIndex
语法: DirectoryIndex local-url local-url
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
DirectoryIndex 这个指令设定当客户端藉由指定没有以文件做结尾的
目录名称请求该目录的索引时所要找寻的来源列表。Local-url 是在伺
服器上相对於请求之目录的文件；它通常是目录里某个文件的名称。可
以有好几个 URL ；服务器会回传它找到的第一个。如果这些来源没有
一个存在，那麽服务器将会自行产生一份该目录的列表。例如：
DirectoryIndex index.html
然後，对於 http://myserver/docs/ 的请求若该来源设定的文件存在
的话会回传 http://myserver/docs/index.html，如果不存在就回传该
目录的列表。
注意该文件并不需要是相对於该目录的:
DirectoryIndex index.html index.txt /cgi-bin/index.pl
这会使得 /cgi-bin/index.pl 这个 CGI 指令稿在 index.html 以及
index.txt 都不存在於该目录的情况下被起动。
4.6.8 FancyIndexing
语法: FancyIndexing 布林值
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
FancyIndexing 此指令设定目录的象徵索引选项。布林值可以是 on 或
off。IndexOptions 这个指令应该用来参照之。
4.6.9 HeaderName
语法: HeaderName 文件名称
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
HeaderName 这个指令设定插入索引列示顶部的文件名称。当案名称是
要含入的文件知名称，而且相对於索引的目录。服务器首先会把他当作
是 HTML 文件试图含入文件名称.html ，否则就当它是普通文本文件含入
。例如:
HeaderName HEADER
当产生 /web 目录的索引时，服务器首先将会找寻 /web/HEADER.html
这个 HTML 文件，若找到则将其含入，否则会含入 /web/HEADER 这个
普通文本文件，如果存在的话。
参阅 ReadmeName 。
4.6.10 IndexIgnore
语法: IndexIgnore 文件 文件 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
IndexIgnore 这个指令把列出目录时要隐藏的文件加到列表中。文件
是指所要忽略之文件的副文件名，部份文件名称，替代字元表示式或是
完整文件名称。多个 IndexIgnore 指令会把文件继续加入列表中而
不会取代前面的设定的忽略文件列表。依预设，此列表包含 `.' 。
例如:
IndexIgnore README .htaccess *~
4.6.11 IndexOptions
语法: IndexOptions 选项 选项 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
IndexOptions 这个指令指定进行目录索引时的动作。选项可以是下列
其中之一
FancyIndexing
这打该目录的象徵索引。
IconsAreLinks
这使图示成为文件链结的一部份以作为象徵索引之用。
ScanHTMLTitles
这打开撷取 HTML 文件的标题以作为象徵索引使用的功能。如果
该文件并没有藉由 AddDescription 所给的描述那麽 httpd 将
会为了取得此值而读取文件的 TITLE 标签。这会加重 CPU 及
磁碟的负担。
SuppressModified
这将会隐瞒象徵索引列示中的最後修改日期。
SuppressSize
这将会隐瞒象徵索引列示中的文件大小。
SuppressDescription
这将会隐瞒象徵索引列示中的文件名数。
预设是没有打开任何一个选项。如果有多个 IndexOptions 可以应用到
一个目录上，那麽最明白的那个会被完全采用；选项不会合并。例如:
IndexOptions FancyIndexing
IndexOptions ScanHTMLTitles
那麽 /web/doc/spec 目录将只设为 ScanHTMLTitles 。
4.6.12 ReadmeName
语法: ReadmeName 文件名称 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
ReadmeName 这个指令要附加到索引列示後面的文件之名称。文件名称
是指要含入的文件，而且是相对於索引的目录。服务器首先会把他当作
是 HTML 文件试图含入文件名称.html ，否则就当它是普通文本文件含入
。例如:
ReadmeName README
当产生 /web 目录的索引时，服务器首先将会找寻 /web/README.html
这个 HTML 文件，若找到则将其含入，否则会含入 /web/README 这个
普通文本文件，如果存在的话。
参阅 HeaderName 。
这个模组包含在 mod_dir.c 文件里，而且依预设会编译进来。它提供
作为目录索引之用。
4.6.1 摘要
这个模组控制目录索引。目录的索引可以有两种来源:
。一个由使用者所撰写的文件，典型是称为 index.html 的文件
。DrectoryIndex 指令设定这个文件的名称。
。另一种是由服务器所产生的列表。其它的指令控制这个列表的
格式。AddIcon, AddIconByEncoding and AddIconByType 都
是用来设定显示不同文件型态所使用的图示列表；对於每种列
出的文件型态，显示列出的第一个符合的图示。
4.6.2 AddDescription
语法: AddDescription 字串 文件 文件 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这是设定某文件所要显示的描述，供象徵索引(FancyIndexing) 使用。
文件是指所要描述之文件的副文件名，部份文件名称，替代字元表示式或
完整文件名称。 字串以双引号(") 括起。例如:
AddDescription "The planet Mars" /web/pics/mars.gif
4.6.3 AddIcon
语法: AddIcon 图示 名称 名称 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在文件名称之後的图示供作象徵索引之用。图示可以是某个
图示的相对 URL 或是给非图形化浏览器使用的文字标签。
对於目录可以使用 ^^DIRECTORY^^ 这个名称，^^BLANKICON^^ 可以用
在空白行（使列表的格式正确），名称也可以是扩充文件名，替代字元表
示式，部份或完整的文件名称。例如:
AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
AddIcon /icons/dir.xbm ^^DIRECTORY^^
AddIcon /icons/backup.xbm *~
可能的话，使用 AddIconByType 应该比 AddIcon 好。
4.6.4 AddIconByEncoding
语法: AddIconByEncoding icon mime-encoding mime-encoding ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在有 mime-encoding 的文件名称之後的图示供作象徵索引
之用。图示可以是某个图示的相对 URL 或是给非图形化浏览器使用的
文字标签。
Mime-encoding 是个符合要求之编码内容的替代字元表示式。例如:
AddIconByEncoding /icons/compress.xxbm x-compress
4.6.5 AddIconByType
语法: AddIconByType icon mime-type mime-type ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
这设定显示在 mime-type 的文件名称之後的图示供作象徵索引之用。
图示可以是某个图示的相对 URL 或是给非图形化浏览器使用的文字标
签。
Mime-encoding 是个符合要求之 mime 型态的替代字元表示式。例如:
AddIconByType (IMG, /icons/image.xbm) image/*
4.6.6 DefaultIcon
语法: DefaultIcon url
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
DefaultIcon 这个指令设定当不知道指定的图示为何时显示的图示供作
象徵索引之用。URl 是该图示的(%-escaped) 相对 URL 。例如:
DefaultIcon /icon/unknow.xbm
4.6.7 DirectoryIndex
语法: DirectoryIndex local-url local-url
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
DirectoryIndex 这个指令设定当客户端藉由指定没有以文件做结尾的
目录名称请求该目录的索引时所要找寻的来源列表。Local-url 是在伺
服器上相对於请求之目录的文件；它通常是目录里某个文件的名称。可
以有好几个 URL ；服务器会回传它找到的第一个。如果这些来源没有
一个存在，那麽服务器将会自行产生一份该目录的列表。例如：
DirectoryIndex index.html
然後，对於 http://myserver/docs/ 的请求若该来源设定的文件存在
的话会回传 http://myserver/docs/index.html，如果不存在就回传该
目录的列表。
注意该文件并不需要是相对於该目录的:
DirectoryIndex index.html index.txt /cgi-bin/index.pl
这会使得 /cgi-bin/index.pl 这个 CGI 指令稿在 index.html 以及
index.txt 都不存在於该目录的情况下被起动。
4.6.8 FancyIndexing
语法: FancyIndexing 布林值
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
FancyIndexing 此指令设定目录的象徵索引选项。布林值可以是 on 或
off。IndexOptions 这个指令应该用来参照之。
4.6.9 HeaderName
语法: HeaderName 文件名称
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
HeaderName 这个指令设定插入索引列示顶部的文件名称。当案名称是
要含入的文件知名称，而且相对於索引的目录。服务器首先会把他当作
是 HTML 文件试图含入文件名称.html ，否则就当它是普通文本文件含入
。例如:
HeaderName HEADER
当产生 /web 目录的索引时，服务器首先将会找寻 /web/HEADER.html
这个 HTML 文件，若找到则将其含入，否则会含入 /web/HEADER 这个
普通文本文件，如果存在的话。
参阅 ReadmeName 。
4.6.10 IndexIgnore
语法: IndexIgnore 文件 文件 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
IndexIgnore 这个指令把列出目录时要隐藏的文件加到列表中。文件
是指所要忽略之文件的副文件名，部份文件名称，替代字元表示式或是
完整文件名称。多个 IndexIgnore 指令会把文件继续加入列表中而
不会取代前面的设定的忽略文件列表。依预设，此列表包含 `.' 。
例如:
IndexIgnore README .htaccess *~
4.6.11 IndexOptions
语法: IndexOptions 选项 选项 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
IndexOptions 这个指令指定进行目录索引时的动作。选项可以是下列
其中之一
FancyIndexing
这打该目录的象徵索引。
IconsAreLinks
这使图示成为文件链结的一部份以作为象徵索引之用。
ScanHTMLTitles
这打开撷取 HTML 文件的标题以作为象徵索引使用的功能。如果
该文件并没有藉由 AddDescription 所给的描述那麽 httpd 将
会为了取得此值而读取文件的 TITLE 标签。这会加重 CPU 及
磁碟的负担。
SuppressModified
这将会隐瞒象徵索引列示中的最後修改日期。
SuppressSize
这将会隐瞒象徵索引列示中的文件大小。
SuppressDescription
这将会隐瞒象徵索引列示中的文件名数。
预设是没有打开任何一个选项。如果有多个 IndexOptions 可以应用到
一个目录上，那麽最明白的那个会被完全采用；选项不会合并。例如:
IndexOptions FancyIndexing
IndexOptions ScanHTMLTitles
那麽 /web/doc/spec 目录将只设为 ScanHTMLTitles 。
4.6.12 ReadmeName
语法: ReadmeName 文件名称 ...
用於: server config, virtual host, directory, .htaccess
需求: Indexes
状态: 基础
模组: mod_dir
ReadmeName 这个指令要附加到索引列示後面的文件之名称。文件名称
是指要含入的文件，而且是相对於索引的目录。服务器首先会把他当作
是 HTML 文件试图含入文件名称.html ，否则就当它是普通文本文件含入
。例如:
ReadmeName README
当产生 /web 目录的索引时，服务器首先将会找寻 /web/README.html
这个 HTML 文件，若找到则将其含入，否则会含入 /web/README 这个
普通文本文件，如果存在的话。
参阅 HeaderName 。
你是我们最后的希望