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。