SSI使用詳細(xì)說明（一）

什么是SSI？

　　SSI是英文Server Side Includes的縮寫，翻譯成中文就是服務(wù)器端包含的意思。從技術(shù)角度上說，SSI就是HTML文件中，可以通過注釋行調(diào)用的命令或指針。SSI 具有強(qiáng)大的功能，只要使用一條簡單的SSI 命令就可以實現(xiàn)整個網(wǎng)站的內(nèi)容更新，動態(tài)顯示時間和日期，以及執(zhí)行shell和CGI腳本程序等復(fù)雜的功能。SSI 可以稱得上是那些資金短缺、時間緊張、工作量大的網(wǎng)站開發(fā)人員的最佳幫手。

　　SSI最初在NCSA服務(wù)器平臺上推出，在Apache服務(wù)器中得到擴(kuò)展和加強(qiáng)，目前已經(jīng)可以在幾乎所有的服務(wù)器上運行。本文將主要結(jié)合Apache服務(wù)器介紹SSI的使用方法。

如何啟動SSI？

　　在Apache服務(wù)器下，可以通過直接編輯服務(wù)器配置文件或者在需要使用SSI的目錄中創(chuàng)建.htaccess文件啟動SSI。具體來說，過程如下：

1.服務(wù)器配置文件

　　如果用戶具有對服務(wù)器配置文件的訪問權(quán)限，可以通過編輯文件access.conf和srm.conf啟動SSI。

　　首先使用Telnet遠(yuǎn)程登錄服務(wù)器，找到配置文件的存放目錄。一般來說，Apache服務(wù)器的配置文件都被保存在“/usr/local/etc/httpd/conf”目錄下。使用任何一種文字編輯器打開文件srm.conf，找到以下幾行：

# If you want to use server side includes, or CGI outside
# ScriptAliased directories, uncomment the following lines.
#AddType text/x-server-parsed-html .shtml

#AddType application/x-httpd-CGI .CGI

　　用戶的配置文件中可能沒有上述的注釋指令行，但是只要找到以AddType開頭的兩行并且去掉每一行最前面的“#”符號即可。

　　保存所做的修改，然后再打開文件access.conf。用戶需要在文件中找到設(shè)置DocumentRoot（根文件）的部分。一般來說該段文本如下，但是不排除$#@60;Directory$#@62;和$#@60;/Directory$#@62;標(biāo)簽之間還包含其它設(shè)置內(nèi)容。

# This should be changed to whatever you set DocumentRoot to.
$#@60;Directory /usr/local/etc/httpd/htdocs$#@62;
# This may also be "None", "All", or any combination of "Indexes",

Options Indexes FollowSymLinks Includes
$#@60;/Directory$#@62;

　　如果用戶不希望執(zhí)行腳本或shell命令，可以在options選項行中加入關(guān)鍵字IncludesNOEXEC，這樣可以允許SSI，但是不能執(zhí)行CGI或腳本命令。（注：最新版本的Apache服務(wù)器只有一個配置文件httpd.conf，以上所提到的內(nèi)容都已經(jīng)被包含在該文件中）

2.創(chuàng)建文件.htaccess

　　如果用戶不能直接訪問服務(wù)器配置文件，可以使用文件編輯器創(chuàng)建一個名為.htaccess的文件。注意，文件名前一定要有符號“.”，這樣服務(wù)器才能知道該文件是隱藏文件，從而提高文件的安全性，避免錯誤操作。在.htaccess文件中需要加入以下三行文字：

Options Indexes FollowSymLinks Includes
AddType application/x-httpd-CGI .CGI
AddType text/x-server-parsed-html .shtml

　　完成之后可以把.htaccess文件上傳到服務(wù)端的相應(yīng)目錄，該文件對所有子目錄有效。如果用戶希望在目錄級上禁止CGI或shell命令，可以在.htaccess文件中的Options選項行加入關(guān)鍵字IncludesNOEXEC。

3.使用.shtml還是.html？

　　任何包含SSI的文件在下傳到客戶端之前，都必須經(jīng)過服務(wù)器的解析過程。雖然從某種程度上這樣會增加服務(wù)器的負(fù)載，但是除非用戶的網(wǎng)站每天有幾百萬的訪問用戶，某則服務(wù)器的性能不會有明顯的下降。不過，如果不是需要在每個頁面都使用SSI的話，確實沒有必要讓服務(wù)器解析每一個頁面。如果用戶只希望在幾個特殊頁面中使用SSI，可以將文件的后綴名改為.shtml，這樣服務(wù)器就可以只解析包含SSI的.shtml文件。另一方面，如果有多個頁面使用了SSI，但是用戶不希望使用.shtml的后綴名時，可以在.htaccess文件中使用以下命令行：

AddType text/x-server-parsed-html .html

SSI語法

SSI在使用時遵循以下格式：

$#@60;!--#directive parameter="value"--$#@62;

　　其中，directive是向服務(wù)器發(fā)送的指令名稱，parameter是指令的操作對象，而value則是用戶希望得到的指令處理結(jié)果。
　　所有的SSI命令都是以“$#@60;!--#”開始，其中“$#@60;!—”和“#”之間不能有任何空格，否則服務(wù)器會把SSI命令當(dāng)稱普通的文件注釋處理，不會顯示出任何結(jié)果，也不會產(chǎn)生錯誤提示。此外，SSI命令中的“=”兩邊不能有空格，右邊的值必須包含在雙引號內(nèi)，后面可以跟空格，最后是結(jié)束標(biāo)簽“--$#@62;”。

SSI命令包含六大類指令以及各自的參數(shù)，具體如下：

[page_break]

下面我們將逐一進(jìn)行介紹。

1.Config命令

Config命令主要用于修改SSI的默認(rèn)設(shè)置。其中：

　　Errmsg：設(shè)置默認(rèn)錯誤信息。為了能夠正常的返回用戶設(shè)定的錯誤信息，在HTML文件中Errmsg參數(shù)必須被放置在其它SSI命令的前面，否則客戶端只能顯示默認(rèn)的錯誤信息，而不是由用戶設(shè)定的自定義信息。

$#@60;!--#config errmsg="Error! Please email webmaster@mydomain.com --$#@62;

　　Timefmt：定義日期和時間的使用格式。Timefmt參數(shù)必須在echo命令之前使用。

$#@60;!--#config timefmt="%A, %B %d, %Y"--$#@62;

$#@60;!--#echo var="LAST_MODIFIED" --$#@62;

顯示結(jié)果為：

Wednesday, April 12, 2000

也許用戶對上例中所使用的%A %B %d感到很陌生，下面我們就以表格的形式總結(jié)一下SSI中較為常用的一些日期和時間格式。

　　Sizefmt：決定文件大小是以字節(jié)、千字節(jié)還是兆字節(jié)為單位表示。如果以字節(jié)為單位，參數(shù)值為“bytes”；對于千字節(jié)和兆字節(jié)可以使用縮寫形式。同樣，sizefmt參數(shù)必須放在fsize命令的前面才能使用。

$#@60;!--#config sizefmt="bytes" --$#@62;

$#@60;!--#fsize file="index.html" --$#@62;