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_d