SSI使用詳細說明（一）

什么是SSI？

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

　　SSI最初在NCSA服務器平臺上推出，在Apache服務器中得到擴展和加強，目前已經可以在幾乎所有的服務器上運行。本文將主要結合Apache服務器介紹SSI的使用方法。

如何啟動SSI？

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

1.服務器配置文件

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

　　首先使用Telnet遠程登錄服務器，找到配置文件的存放目錄。一般來說，Apache服務器的配置文件都被保存在“/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。用戶需要在文件中找到設置DocumentRoot（根文件）的部分。一般來說該段文本如下，但是不排除$#@60;Directory$#@62;和$#@60;/Directory$#@62;標簽之間還包含其它設置內容。

# 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;

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

2.創建文件.htaccess

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

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

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

3.使用.shtml還是.html？

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

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

SSI語法

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

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

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

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

[page_break]

下面我們將逐一進行介紹。

1.Config命令

Config命令主要用于修改SSI的默認設置。其中：

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

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

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

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

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

顯示結果為：

Wednesday, April 12, 2000

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

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

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

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