SHTML介紹

建議你看看 Apache的rewrite模組和SSI(Server Side Include).
====================================================================
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（根檔案）的部分。一般來說該段文本如下，但是不排除<Directory>和</Directory>標籤之間還包含其它設定內容。
# This should be changed to whatever you set DocumentRoot to.
<Directory /usr/local/etc/httpd/htdocs>
# This may also be "None", "All", or any combination of "Indexes",
# "Includes", or "FollowSymLinks"
Options Indexes FollowSymLinks Includes
</Directory>
如果使用者不希望執行指令碼或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在使用時遵循以下格式：
<!--#directive parameter="value"-->
其中，directive是向伺服器發送的指令名稱，parameter是指令的操作對象，而value則是使用者希望得到的指令處理結果。
所有的SSI命令都是以“<!--#”開始，其中“<!—”和“#”之間不能有任何空格，否則伺服器會把SSI命令當稱普通的檔案注釋處理，不會顯示出任何結果，也不會產生錯誤提示。此外，SSI命令中的“=”兩邊不能有空格，右邊的值必須包含在雙引號內，後面可以跟空格，最後是結束標籤“-->”。
SSI命令包含六大類指令以及各自的參數，具體如下:
directives parameters
Config errmsg, timefmt, sizefmt
include virtual, file
echo var
fsize file
flastmod file
exec cmd, cgi
下面我們將逐一進行介紹。
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中較為常用的一些日期和時間格式。
格式 說明 執行個體
%% %
%a 一周七天的縮寫形式 Thu
%A 一周七天 Thursday
%b 月的縮寫形式 Apr
%B 月 April
%d 一個月內的第幾天 13
%D mm/dd/yy日期格式 04/13/00
%H 小時（24小時制，從00到23） 01
%I 小時（12小時制，從00到11） 01
%j 一年內的第幾天，從01到365 104
%m 一年內的第幾個月，從01到12 04
%M 一小時內的第幾分鐘，從00到59 10
%p AM或PM AM
%r 12小時制的當地時間，格式為 01:10:18 AM
%I:%M:%S AM | PM
%S 一分鐘內的第幾秒，從00到59 18
%T 24小時制的%H:%M:%S時間格式 01:10:18
%U 一年內的第幾個星期，從00到 15
52，以星期天作為每個星期的
第一天
%w 一星期內的第一天，從0到6 4
%W 一年內的第幾個星期，從00 15
到53，以星期一作為每個星期
的第一天
%y 年的縮寫形式，從00到99 00
%Y 用四位元字表示一年 2000
%Z 時區名稱 MDT
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" -->
為了更加合理的組織網站的內容，使用者可以在根目錄下建立includes子目錄來存放所有的包含檔案。Virtual參數可以通知伺服器所要包含的是一個虛擬檔案，即檔案和當前被解析的文檔不是位於同一個目錄，而是存放在其它目錄中。伺服器會根據該參數的值找到根目錄下的includes子目錄。使用這種方法，使用者可以把所有HTML文檔包含的檔案放在一個目錄中，而根據相互之間的關係把不同的頁面儲存在不同的目錄或子目錄中。無論伺服器解析哪一個文檔都可以找到所包含的檔案，不會產生任何錯誤。
不過這裡有一個小問題需要解決。一般我們都會在頁面中加入一些TITLE和META標籤，如果我們規定所有的頁面都調用相同的頁首檔案的話，就顯得很不靈活。使用者碰到這樣的問題時，可以使用兩個包含檔案，一個設定TITLE標籤前的內容，另一個設定META標籤後的部分，而在兩個包含檔案之間則可以添加任何定製內容。例如：
<!--#include virtual="/includes/header1.html" -->
<TITLE>Your Page Title</TITLE>
<LINK rel = STYLESHEET href = "http://domain.com/styles/my.css" Type = "text/css" >
<META NAME = "Description" CONTENT = " Description of page">
<META NAME = "Keywords" CONTENT = "keywords for page" >
<!--#include virtual="/includes/header2.html" -->
這裡放置頁面內容
<!--#include virtual="/includes/footer.html" -->
從上我們可以看出通過在頁面中包含頁首和頁尾可以大大減少網站更新的工作量。但是如果我們希望動態顯示一些內容，例如頁面的最後更新時間等該怎麼辦呢？沒問題，我們可以把包含檔案使用.html尾碼儲存，這樣就可以在包含檔案中調用其它的包含檔案。
File：給出到目前的目錄的相對路徑，其中不能使用“../”，也不能使用絕對路徑。例如：
<!--#include file="header.html" -->
這就要求每一個目錄中都包含一個header.html檔案。當然，採用這樣的方法並不比更新每一個頁面簡單多少，但是如果使用者只更新一、兩個檔案的話還是很方便的。例如，如果我們不希望讓一個對HTML不熟悉的人直接改動網站中的新聞頁面的話，可以只讓他更新一個單獨的文字檔，然後再把該檔案包含到HMTL文檔中，這樣即不會破壞原頁面，同時又更新了內容，兩全其美
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" -->
CGI環境變數
除了SSI環境變數之外，echo命令還可以顯示以下CGI環境變數：
SERVER_SOFTWARE：顯示伺服器軟體的名稱和版本。例如：
<!--#echo var="SERVER_SOFTWARE" -->
SERVER_NAME： 顯示伺服器的主機名稱，DNS別名或IP地址。例如：
<!--#echo var="SERVER_NAME" -->
SERVER_PROTOCOL：顯示用戶端請求所使用的協議名稱和版本，如HTTP/1.0。例如：
<!--#echo var="SERVER_PROTOCOL" -->
SERVER_PORT：顯示伺服器的響應連接埠。例如：
<!--#echo var="SERVER_PORT" -->
REQUEST_METHOD：顯示用戶端的文檔要求方法，包括GET, HEAD, 和POST。例如：
<!--#echo var="REQUEST_METHOD" -->
REMOTE_HOST：顯示發出請求資訊的用戶端主機名稱。
<!--#echo var="REMOTE_HOST" -->
REMOTE_ADDR：顯示發出請求資訊的用戶端IP地址。
<!--#echo var="REMOTE_ADDR" -->
AUTH_TYPE：顯示使用者身份的驗證方法。
<!--#echo var="AUTH_TYPE" -->
REMOTE_USER：顯示訪問受保護頁面的使用者所使用的帳號名稱。
<!--#echo var="REMOTE_USER" -->
4.Fsize：顯示指定檔案的大小，可以結合config命令的sizefmt參數定製輸出格式。
<!--#fsize file="index_working.html" -->
5.Flastmod：顯示指定檔案的最後修改日期，可以結合config 命令的timefmt參數控制輸出格式。
<!--#config timefmt="%A, the %d of %B, in the year %Y" -->
<!--#flastmod file="file.html" -->
這裡，我們可以利用flastmod參數顯示出一個頁面上所有連結頁面的更新日期。方法如下：
<!--#config timefmt=" %B %d, %Y" -->
<A HREF="/directory/file.html">File</A>
<!--#flastmod virtual="/directory/file.html" -->
<A HREF="/another_directory/another_file.html">Another File</A>
<!--#flastmod virtual="/another_directory/another_file.html" -->
顯示結果為：
File April 19, 2000
Another File January 08, 2000
也許有的讀者會認為兩個連結就這麼複雜，一點也不方便。其實，如果頁面上有20個或者更多的連結，而且每個連結都定期更新的話，就可以看出使用flastmod顯示修改日期的作用。
6.Exec
Exec命令可以執行CGI指令碼或者shell命令。使用方法如下：
Cmd：使用/bin/sh執行指定的字串。如果SSI使用了IncludesNOEXEC選項，則該命令將被屏蔽。
Cgi：可以用來執行CGI指令碼。例如，下面這個例子中使用服務端cgi-bin目錄下的counter.pl指令碼程式在每個頁面放置一個計數器：
<!--#exec cgi="/cgi-bin/counter.pl"-->