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, .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 可以应用到
一个目录上，那麽最明白的那个会被完全采用；选项不会合并。例如:
<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://cfan.net.cn/info/"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。
……