APACHE(4)

4.5 mod_cgi 模组

这个模组包含在 mod_cgi.c 文件里，而且依预设会编译进来。它提供
CGI 指令稿的执行能力。任何 mime 型态为 application/x-httpd-cgi
的文件都将由这个模组处理。


4.5.1 摘要

任何拥有 application/x-httpd-cgi 之 mime 型态的文件都会被当作
CGI 指令稿，而且由服务器执行，并把输出传回客户端。文件可以藉由
使用 AddType 指令所定义的副文件名，或是藉由放在 ScriptAlias 所
设定的目录来成为这种型态。

当服务器启动一个 CGI 指令稿时，它将加上一个称为 DOCUMENT_ROOT
的环境参数。这个参数将会包含 DocumentRoot 配置的内容。


4.5.2 CGI 环境参数

这个服务器将会设立定义在 CGI 规格中的 CGI 环境参数，配合下列
的但书:

REMOTE_HOST
这只有在服务器没有配合 MINIMAL_DNS 编译的时候才会设定。

REMOTE_IDENT
这只有在 IdentityCheck 设为 on 的时候才会设定。

REMOTE_USER
这只有在 CGI 指令稿需要验认的时候才会设定。


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, .htaclearcase/" target="_blank" >ccess
需求: 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 可以应用到
一个目录上，那麽最明白的那个会被完全采用；选项不会合并。例如:

<Directory /web/docs>
IndexOptions FancyIndexing
</Directory>
<Directory /web/docs/spec>
IndexOptions ScanHTMLTitles
</Directory>

那麽 /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 。


4.7 mod_imap 模组

这个模组包含在 mod_imap.c 文件里，而且依预设会编译进来。它是为
处理 .map 文件而提供的，用来代替 imagemap 这个 CGI 程序的功能
。任何含有 mime 型态为 application/x-httpd-imap 之资料的文件都
将由这个模组处理。

4.7.1 摘要

为了使用服务端剖析(server-parsed) 的影像地图(imagemap)档，你首
先必须把这个模组编译到服务器里去，并且在服务器配置档中加入下列
这一行。这个项目指出影像地图档将会以 .map 副文件名命名。

AddType application/x-httpd-imap map


4.7.2 新特色

imagemap 这个模组加入了一些先前发行的 iamgemap 程序版本不可能
达成的新特色。


。URL 参照相对於 Referer: 的资讯
。经由新的 base_uri 栏位指定预设的 <BASE>
。不需要 imagemap.conf 文件
。Point 参照


base_uri 选项:


map
提供预设及旧式的 map 关连参考之功能。

refer
使用 Referer: 标头资讯参照相对目前文件的 URL 。

http://whateverurl
设定 URL 的 <BASE> 设定使所有的参照都相对於 <BASE> 。


地图档□例

default http:/lincoln/
base_uri referer
rect .. 0,0 77,27
poly http://www.inetnebr.com/ 78,0 194,27
circle http://www.inetnebr.com/loncoln/feedback/ 195,0 305,27
rect search_index 306,0 419,27
point http://www.zyzzyva.com/ 420,0 549,27


参照你的地图档

<A HREF:"http://maps/imagemap1.map">
<IMG ISMAP SRC="http:/images/imagemap1.gif">
</A>


4.8 mod_include 模组

这个模组包含在 mod_include.c 文件里，而且依预设会编译进来。它
提供给服务端剖析的 html 文件用，即所知的 SPML 文件。任何含mime
型态 text/x-server-parsed-html 或 text/x-server-parsed-html3
的文件将会由这个模组剖析，输出之结果的 mime 型态是 text/html。

原文转自：http://www.ltesting.net