SSI使用詳解(2)

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

1、Config命令

Config命令主要用於修改SSI的預設設定。其中：

Errmsg：設定預設錯誤資訊。為了能夠正常的返回使用者設定的錯誤資訊，在HTML檔案中Errmsg參數必須被放置在其它SSI命令的前面，否則用戶端只能顯示預設的錯誤資訊，而不是由使用者設定的自訂資訊。

　　　　<!--#config errmsg="Error! Please email webmaster@mydomain.com -->

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

　　　　<!--#config timefmt="%A, %B %d, %Y"-->
　　　　<!--#echo var="LAST_MODIFIED" -->

顯示結果為：

　　　　Wednesday, April 12, 2000

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

Sizefmt：決定檔案大小是以位元組、KB還是MB為單位表示。如果以位元組為單位，參數值為"bytes"；對於KB和MB可以使用縮寫形式。同樣，sizefmt參數必須放在fsize命令的前面才能使用。

　　　　<!--#config sizefmt="bytes" -->
　　　　<!--#fsize file="index.html" -->

2、Include命令

Include命令可以把其它文檔中的文字或圖片插入到當前被解析的文檔中，這是整個SSI的關鍵所在。通過Include命令只需要改動一個檔案就可以瞬間更新整個網站！

Include命令具有兩個不同的參數：

Virtual：給出到伺服器端某個文檔的虛擬路徑。例如：

　　　　<!--#include virtual="/includes/header.html" -->

File：給出到目前的目錄的相對路徑，其中不能使用"../"，也不能使用絕對路徑。例如：

　　　　<!--#include file="header.html" -->

這就要求每一個目錄中都包含一個header.html檔案。

3、Echo命令

Echo命令可以顯示以下各環境變數：

DOCUMENT_NAME：顯示當前文檔的名稱。

　　　　<!--#echo var="DOCUMENT_NAME" -->

顯示結果為：

index.html

DOCUMENT_URI：顯示當前文檔的虛擬路徑。例如：

　　　　<!--#echo var="DOCUMENT_URI" -->

顯示結果為：

　　　　/YourDirectory/YourFilename.html

隨著網站的不斷髮展，那些越來越長的URL地址肯定會讓人頭疼。如果使用SSI，一切就會迎刃而解。因為我們可以把網站的網域名稱和SSI命令結合在一起顯示完整的URL，即：

　　http://YourDomain<!--#echo var="DOCUMENT_URI" -->

QUERY_STRING_UNESCAPED：顯示未經轉義處理的由用戶端發送的查詢字串，其中所有的特殊字元前面都有轉義符"\"。例如：

　　<!--#echo var="QUERY_STRING_UNESCAPED" -->

DATE_LOCAL：顯示伺服器設定時區的日期和時間。使用者可以結合config命令的timefmt參數，定製輸出資訊。例如：

　　<!--#config timefmt="%A, the %d of %B, in the year %Y" -->
　<!--#echo var="DATE_LOCAL" -->

顯示結果為：

　　Saturday, the 15 of April, in the year 2000

DATE_GMT：功能與DATE_LOCAL一樣，只不過返回的是以格林尼治標準時間為基準的日期。例如：

　　<!--#echo var="DATE_GMT" -->

LAST_MODIFIED：顯示當前文檔的最後更新時間。同樣，這是SSI中非常實用的一個功能，只要在HTML文檔中加入以下這行簡單的文字，就可以在頁面上動態顯示更新時間。

　　<!--#echo var="LAST_MODIFIED" -->