IDC资讯中心
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:/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。
