什麼是 SHTML
使用SSI（Server Side Include）的html檔案副檔名，SSI（Server Side Include），通常稱為“伺服器端
嵌入”或稱為“伺服器端包含”，是一種類似於ASP的基於伺服器的網頁製作技術。
SSI運作原理：
將內容傳送到瀏覽器之前，可以使用「伺服器端包含 (SSI)」指令將文字、圖形或應用程式資訊包含在網頁
中。例如，可以使用 SSI 包含時間/日期戳記、版權聲明或供顧客填寫並回傳的表單。對於在多個文件中重複
出現的文字或圖形，使用包含文件是一種簡單的方法。將內容存入一個包含文件中即可，而不必將內容輸入
所有文件。透過一個非常簡單的語句即可呼叫包含文件，此語句指示 Web 伺服器將內容插入適當網頁。而
且，使用包含文件時，對內容的所有變更只需在一個地方就能完成。
因為包含 SSI 指令的文件要求特別處理，所以必須為所有 SSI 檔案給予 SSI 檔案副檔名。預設副檔名是
.stm、.shtm 和 .shtml。
Web 伺服器在處理網頁的同時處理 SSI 指令。當 Web 伺服器遇到 SSI 指令時，直接將包含檔案的內容插入
入 HTML 網頁。如果「包含文件」中包含 SSI 指令，則同時插入此文件。除了用於包含檔案的基本指令之
外，還可以使用 SSI 指令插入檔案的相關資訊（如檔案的大小）或執行應用程式或 shell 指令。
網站維護常常碰到的一個問題是，網站的結構已經固定，卻為了更新一點內容而不得不重做一大批網頁。
SSI提供了一種簡單、有效的方法來解決這個問題，它將一個網站的基本結構放在幾個簡單的HTML文件中（
模板），以後我們要做的只是將文本傳到伺服器，讓程式按照範本自動產生網頁，讓管理大型網站變得
容易。
所以，利用SHTML格式的頁面目的和 ASP 差不多，但是因為是 API 所以運轉速度更快，效率更高，比ASP快
，比HTML慢，但由於可以使用伺服器端包含，因此使頁面更新容易（特別是批量更新banner，版權等），想
像一下吧，你有一段 HTML，要在中間穿插一些特殊的服務端腳本，比如插入其他 HTML 段落，你選擇 ASP
來完成這個任務，但是如果任務更繁重，需要更多的時間，比如 5 s，這個時候你不用 ASP 而用 SHTML，
或許處理時間就只用 4s 了。
SSI有什麼用？
之所以要扯到 SSI，是因爲 Shtml - Server-Parsed HTML 的縮寫。包含有嵌入式伺服器方包含命
令的 HTML 文字。在傳送給瀏覽器之前，伺服器會對 SHTML 文件進行完全讀取、分析以及修改。 shtml
和asp 有些相似，以shtml命名的檔案裡，使用了ssi的一些指令，就像asp中的指令，你可以在SHTML檔案
中寫入SSI指令，當客戶端存取這些shtml檔案時，伺服器端會把這些SHTML檔案讀取解釋，把SHTML文
件包含的SSI指令解釋出來例如：你可以在SHTML檔案中用SSI指令引用其他的html檔案（#include ），服
務器傳送給客戶端的文件，是已經解釋的SHTML不會有SSI指令。它實現了HTML所沒有的功能，就是可以實現
了動態的SHTML，可以說是HTML的一種進化吧。像新浪的新聞系統就是這樣的，新聞內容是固定的但它上面
的廣告和菜單等就是用#include引用進來的。
目前，主要有以下幾種用途：
顯示伺服器端環境變數
將文字內容直接插入文件中
顯示WEB文件相關資訊 (如檔案製作日期/大小等)
直接執行伺服器上的各種程式(如CGI或其他可執行程式)
設定SSI資訊顯示格式(如檔案製作日期/大小顯示方式)
進階SSI
使用SSI
SSI是為WEB伺服器提供的一套指令，這些指令只要直接嵌入到HTML文件的註解內容之中即可。如：
就是一條SSI指令，其作用是將"info.htm"的內容拷貝到目前的頁面中，當訪客來瀏覽時，會看到其它
HTML文件一樣顯示info.htm其中的內容。其它的SSI指令使用形式基本上同剛才的舉例差不多，可見SSI使用只
是插入一點代碼而已，使用形式非常簡單。當然，如果WEB伺服器不支援SSI，它就會只不過將它當作註解信
息，直接跳過其中的內容；瀏覽器也會忽略這些資訊。
如何在我的WEB伺服器上設定SSI功能？
在一些WEB伺服器上（如IIS 4.0/SAMBAR 4.2），包含 #include 指令的檔案必須使用已被對應到 SSI 解釋
程式的副檔名；否則，Web 伺服器將不會處理該指令；預設情況下，副檔名 .stm、.shtm 和 .shtml 被
對應到解釋程式（Ssinc.dll）。
Apache則是根據你的設定情況而定，修改srm.conf如：
AddType text/x-server-parsed-html .shtml 將只對.shtml副檔名的檔案解析SSISSIA> AddType text/x-server-parsed-html .html 將對所有HTML文件解析SSI指令
Netscape WEB伺服器直接使用 Administration Server(管理伺服器)可開啟SSI功能。
Website 使用 Server Admin 程式中的 Mapping 標籤，副檔名新增內容類型為：wwwserver/html-ssi
Cern 伺服器不支援SSI，可用SSI詐騙法，到 http://sw.cse.bris. ac.uk/WebTools/fakessi.html 上下載
一個PERL腳本，即可讓你的CERN伺服器使用一些SSI指令。 （不支援exec指令。）
SSI指令基本格式
程式碼：
說明：
是HTML語法中表示註釋，當WEB伺服器不支援SSI時，會忽略這些資訊。
#include 為SSI指令之一。
file 為include的參數， info.htm為參數值，本指令指將要包含的文件名稱。
註：
範例：
本文件名稱
現在時間
你的IP位址
#include 示範
作用：將文字檔案的內容直接插入到文件頁面中。
語法：
file 檔案名稱是一個相對路徑，該路徑相對於使用 #include 指令的文件所在的目錄。被包含檔案可以在同
一級目錄或其子目錄中，但不能在上一層目錄中。如表示目前目錄下的nav_head.htm文檔，則為
file="nav_head.htm"。
virtual 檔案名稱是 Web 網站上的虛擬目錄的完整路徑。如表示相對於伺服器文件根目錄下hoyi目錄下的
nav_head.htm檔案；則為file="/hoyi/nav_head.htm"
參數：
file 指定包含檔案相對於本文檔的位置
virtual 指定相對於伺服器文件根目錄的位置
注意：
檔案名稱必須有副檔名。
被包含的檔案可以有任何檔案副檔名，我覺得直接使用htm副檔名最方便，微軟公司推薦使用 .inc 擴充功能
名（這就看你的愛好了）。
範例：
將頭檔插入到目前頁面
將尾檔插入目前頁面
#flastmod 和 #fsize 示範
作用：
#flastmod 檔案最近更新日期
#fsize 檔案的長度
語法：
#fsize 檔案的長度
語法：
參數：
file 指定包含檔案相對於本文件的位置 如 info. txt 表示目前目錄下的info.txt文件
virtual 指定相對於伺服器文件根目錄的位置 如 /hoyi/info.txt 表示
注意：檔案名稱必須有副檔名。
範例：
將目前目錄下news.htm檔案的最近更新日期插入到目前頁面
將目前目錄下news.htm的檔案大小入到目前頁面
#exec 示範作用：將某一外部程式的輸出插入到頁面中。可插入CGI程式或常規應用程式的輸入，這取決於使用的 參數是cmd還是cgi。
語法：
參數：
cmd常規應用程式
cgi CGI腳本程式
範例：
將會顯示密碼檔案
將會顯示目前目錄下檔案清單
將會執行CGI程式gb.cgi 。
將會執行CGI程式access_log.cgi。
注意：從上面的範例可以看出，這個指令相當方便，但是也存在安全問題。
禁止方法：
Apache，將access.conf中的"Options Includes ExecCGI"這行程式碼刪除；
在IIS中，要停用 #exec 指令，可修改 SSIExecDisable 元資料庫； config
作用：指定傳回給客戶端瀏覽器的錯誤訊息、日期和檔案大小的格式。
語法：
參數：
errmsg 自訂SSI執行錯誤訊息，可以為任何你喜歡的方式。
sizefmt 檔案大小顯示方式，預設為位元組方式("bytes")可以改為千位元組方式("abbrev")
timefmt 時間顯示方式，最靈活的設定屬性。
範例：顯示一個不存在檔案的大小
以千位元組方式顯示檔案大小
語法：
以特定的時間格式顯示時間
顯示今天是星期幾，幾月，時區
XSSI
XSSI（Extended SSI）是一組進階SSI指令，內建在Apache 1.2或更高版本的mod-include模組之中。其中可
利用的的指令有：
#printenv
#set
#if
#printenv
作用： 顯示目前存在於WEB伺服器環境中的所有環境變數。
語法：
#set
作用：可給變數賦值，以用於後面的if語句。
語法：
範例：
#if
作用：建立可以改變資料的頁面，這些資料根據使用if語句時計算的要求予以顯示。
語法：
顯示內容
顯示內容
顯示內容
範例：
歡迎光臨好易CGI工廠在淄博熱線的分站 http://hoyi.zb169.net 。 .com.cn/~hoyi。前面指令中的反斜杠，是用來代換內部的引號，以便它們不會被解釋為結束表達式。不可省略。
1、Config 指令
Config 指令主要用於修改SSI的預設設定。其中：
Errmsg：設定預設錯誤訊息。為了能夠正常的回傳使用者設定的錯誤訊息，在HTML檔案中Errmsg參數必須被放
置在其它SSI指令的前面，否則客戶端只能顯示預設的錯誤訊息，而不是由使用者設定的自訂資訊。
Timefmt：定義日期和時間的使用格式。 Timefmt參數必須在echo指令之前使用。
顯示結果為：
Wednesday， April 12， 2000
也許用戶對上例中所使用的%A %B %d感到很陌生，下面我們就以表格的形式總結一下SSI中較為常用的一些
日期和時間格式。
Sizefmt：決定檔案大小是以位元組、千位元組還是兆位元組為單位表示。如果以位元組為單位，參數值為"bytes"；
對於千位元組和兆位元組可以使用縮寫形式。同樣，sizefmt參數必須放在fsize指令的前面才能使用。
2、Include 指令
Include 指令可以把其它文件中的文字或圖片插入到目前被解析的文件中，這是整個SSI的關鍵所在。透過
Include指令只需要改變一個檔案就可以瞬間更新整個網站！
Include 指令有兩個不同的參數：
Virtual：給出到伺服器端某個文件的虛擬路徑。
File：給出到目前目錄的相對路徑，其中不能使用"../"，也不能使用絕對路徑。
這就要求每一個目錄中都包含一個header.html檔。
3、Echo 指令
Echo 指令可以顯示下列各環境變數：
DOCUMENT_NAME：顯示目前文件的名稱。
DOCUMENT_URI：顯示目前文件的虛擬路徑。例如：
隨著網站的不斷發展，那些越來越長的URL地址肯定會讓人頭痛。如果使用SSI，一切就會迎刃而解。因為我
們可以把網站的網域和SSI指令結合在一起顯示完整的URL，即：
http://YourDomain
QUERY_STRING_UNESCAPEDED ：顯示未經轉義處理的由客戶端發送的查詢字串，其中所有的特殊字元前面都有轉
義符""。例如：
DATE_LOCAL：顯示伺服器設定時區的日期和時間。使用者可以結合config指令的timefmt參數，客製化輸出資訊
。例如：
顯示結果為：
Saturday， the 15 of April， in the year 2000
DATE_GMT：功能與DATE_LOCAL一樣，只不過返回的是以格林尼治標準時間為基準的日期。例如：
LAST_MODIFIED：顯示目前文件的最後更新時間。同樣，這是SSI中非常實用的功能，只要在HTML文件中
加入以下這行簡單的文字，就可以在頁面上動態的顯示更新時間。
CGI環境變數
除了SSI環境變數之外，echo指令也可以顯示下列CGI環境變數：
SERVER_SOFTWARE：顯示伺服器軟體的名稱和版本。例如：
SERVER_NAME： 顯示伺服器的主機名稱，DNS別名或IP位址。例如：
SERVER_PROTOCOL：顯示客戶端請求所使用的協定名稱和版本，如HTTP/1.0。例如：
SERVER_PORT：顯示伺服器的回應埠。例如：
REQUEST_METHOD：顯示客戶端的文件請求方法，包括GET， HEAD，和POST。例如：
REMOTE_HOST：顯示發出要求訊息的客戶端主機名稱。
REMOTE_ADDR：顯示發出要求訊息的客戶端IP位址。
AUTH_TYPE：顯示使用者身分的驗證方法。
REMOTE_USER：顯示造訪受保護頁面的使用者所使用的帳號名稱。
4、Fsize：顯示指定檔案的大小，可結合config指令的sizefmt參數自訂輸出格式。
5、Flastmod：顯示指定檔案的最後修改日期，可結合config 指令的timefmt參數控制輸出格式。
這裡，我們可以利用flastmod參數顯示出一個頁面上所有連結頁面的更新日期。方法如下：
File
Another File
顯示結果為：
File April 19， 2000
Another File J1 CGI腳本或shell指令。使用方法如下：
Cmd：使用/bin/sh執行指定的字串。如果SSI使用了IncludesNOEXEC選項，則該指令將被封鎖。
Cgi：可以用來執行CGI腳本。例如，下面這個範例中使用服務端cgi-bin目錄下的counter.pl腳本程式在每
個頁面放置一個計數器：
http://www.bkjia.com/PHPjc/317227.html
