什么是 SHTML

使用SSI（Server Side Include）的html文件擴(kuò)展名，SSI（Server Side Include），通常稱為“服務(wù)器端嵌入”或者叫“服務(wù)器端包含”，是一種類似于ASP的基于服務(wù)器的網(wǎng)頁制作技術(shù)。

SSI工作原理：

將內(nèi)容發(fā)送到瀏覽器之前，可以使用“服務(wù)器端包含 (SSI)”指令將文本、圖形或應(yīng)用程序信息包含到網(wǎng)頁中。例如，可以使用 SSI 包含時間/日期戳、版權(quán)聲明或供客戶填寫并返回的表單。對于在多個文件中重復(fù)出現(xiàn)的文本或圖形，使用包含文件是一種簡便的方法。將內(nèi)容存入一個包含文件中即可，而不必將內(nèi)容輸入所有文件。通過一個非常簡單的語句即可調(diào)用包含文件，此語句指示 Web 服務(wù)器將內(nèi)容插入適當(dāng)網(wǎng)頁。而且，使用包含文件時，對內(nèi)容的所有更改只需在一個地方就能完成。

因?yàn)榘?SSI 指令的文件要求特殊處理，所以必須為所有 SSI 文件賦予 SSI 文件擴(kuò)展名。默認(rèn)擴(kuò)展名是 .stm、.shtm 和 .shtml。

Web 服務(wù)器在處理網(wǎng)頁的同時處理 SSI 指令。當(dāng) Web 服務(wù)器遇到 SSI 指令時，直接將包含文件的內(nèi)容插入 HTML 網(wǎng)頁。如果“包含文件”中包含 SSI 指令，則同時插入此文件。除了用于包含文件的基本指令之外，還可以使用 SSI 指令插入文件的相關(guān)信息（如文件的大?。┗蛘哌\(yùn)行應(yīng)用程序或 shell 命令。

網(wǎng)站維護(hù)常常碰到的一個問題是，網(wǎng)站的結(jié)構(gòu)已經(jīng)固定，卻為了更新一點(diǎn)內(nèi)容而不得不重做一大批網(wǎng)頁。SSI提供了一種簡單、有效的方法來解決這一問題，它將一個網(wǎng)站的基本結(jié)構(gòu)放在幾個簡單的HTML文件中（模板），以后我們要做的只是將文本傳到服務(wù)器，讓程序按照模板自動生成網(wǎng)頁，從而使管理大型網(wǎng)站變得容易。

所以，利用SHTML格式的頁面目的和 ASP 差不多，但是因?yàn)槭?API 所以運(yùn)轉(zhuǎn)速度更快，效率更高，比ASP快，比HTML慢，但由于可以使用服務(wù)器端包含，因此使頁面更新容易（特別是批量更新banner，版權(quán)等），想象一下吧，你有一段 HTML，要在中間穿插一些特殊的服務(wù)端腳本，比如插入其他 HTML 段落，你選擇 ASP 來完成這個任務(wù)，但是如果任務(wù)更繁重，需要更多的時間，比如 5 s，這個時候你不用 ASP 而用  SHTML，或許處理時間就只用 4s 了。

SSI有什么用？

之所以要扯到 SSI ，是因爲(wèi) Shtml - Server-Parsed HTML 的首字母縮略詞。包含有嵌入式服務(wù)器方包含命令的 HTML 文本。在被傳送給瀏覽器之前，服務(wù)器會對 SHTML 文檔進(jìn)行完全地讀取、分析以及修改。shtml和asp 有一些相似，以shtml命名的文件里，使用了ssi的一些指令，就像asp中的指令，你可以在SHTML文件中寫入SSI指令，當(dāng)客戶端訪問這些 shtml文件時，服務(wù)器端會把這些SHTML文件進(jìn)行讀取和解釋，把SHTML文件中包含的SSI指令解釋出來比如：你可以在SHTML文件中用SSI 指令引用其他的html文件（#include ），服務(wù)器傳送給客戶端的文件，是已經(jīng)解釋的SHTML不會有SSI指令。它實(shí)現(xiàn)了HTML所沒有的功能，就是可以實(shí)現(xiàn)了動態(tài)的SHTML，可以說是 HTML的一種進(jìn)化吧。像新浪的新聞系統(tǒng)就是這樣的，新聞內(nèi)容是固定的但它上面的廣告和菜單等就是用#include引用進(jìn)來的。

目前，主要有以下幾種用用途：

1. 顯示服務(wù)器端環(huán)境變量<#echo>

2. 將文本內(nèi)容直接插入到文檔中<#include>

3. 顯示W(wǎng)EB文檔相關(guān)信息<#flastmod #fsize> (如文件制作日期/大小等)

4. 直接執(zhí)行服務(wù)器上的各種程序<#exec>(如CGI或其他可執(zhí)行程序)

5. 設(shè)置SSI信息顯示格式<#config>(如文件制作日期/大小顯示方式)

高級SSI<XSSI>可設(shè)置變量使用if條件語句。

使用SSI

SSI是為WEB服務(wù)器提供的一套命令，這些命令只要直接嵌入到HTML文檔的注釋內(nèi)容之中即可。如：

<!--#include file="info.htm"-->

就是一條SSI指令，其作用是將"info.htm"的內(nèi)容拷貝到當(dāng)前的頁面中，當(dāng)訪問者來瀏覽時，會看到其它HTML文檔一樣顯示 info.htm其中的內(nèi)容。其它的SSI指令使用形式基本同剛才的舉例差不多，可見SSI使用只是插入一點(diǎn)代碼而已，使用形式非常簡單。當(dāng)然，如果 WEB服務(wù)器不支持SSI，它就會只不過將它當(dāng)作注釋信息，直接跳過其中的內(nèi)容；瀏覽器也會忽略這些信息。

如何在我的WEB服務(wù)器上配置SSI功能？

在一些WEB服務(wù)器上（如IIS 4.0/SAMBAR 4.2），包含 #include 指令的文件必須使用已被映射到 SSI 解釋程序的擴(kuò)展名；否則，Web 服務(wù)器將不會處理該SSI指令；默認(rèn)情況下，擴(kuò)展名 .stm、.shtm 和 .shtml 被映射到解釋程序（Ssinc.dll）。
Apache則是根據(jù)你的設(shè)置情況而定，修改srm.conf如：

AddType text/x-server-parsed-html .shtml 將只對.shtml擴(kuò)展名的文件解析SSI指令
AddType text/x-server-parsed-html .html 將對所有HTML文檔解析SSI指令

Netscape WEB服務(wù)器直接使用 Administration Server(管理服務(wù)器)可打開SSI功能。
Website 使用 Server Admin 程序中的 Mapping 標(biāo)簽，擴(kuò)展名添加內(nèi)容類型為：wwwserver/html-ssi
Cern 服務(wù)器不支持SSI，可用SSI詐騙法，到 http://sw.cse./WebTools/fakessi.html 上下載一個PERL腳本，即可使你的CERN服務(wù)器使用一些SSI指令。（不支持exec指令。）

SSI指令基本格式

程序代碼：

<!-- 指令名稱="指令參數(shù)">

示例：

<!--#include file="info.htm"-->

說明：

1. <!-- -->是HTML語法中表示注釋，當(dāng)WEB服務(wù)器不支持SSI時，會忽略這些信息。
2. #include 為SSI指令之一。
3. file 為include的參數(shù)， info.htm為參數(shù)值，在本指令中指將要包含的文檔名。

注意：

1. <!--與#號間無空格，只有SSI指令與參數(shù)間存在空格。
2. 上面的標(biāo)點(diǎn)=""，一個也不能少。
3. SSI指令是大小寫敏感的，因此參數(shù)必須是小寫才會起作用。

SSI指令使用詳解

#echo 示范

作用：將環(huán)境變量插入到頁面中。

語法：

<!--#echo var="變量名稱"-->

示例：

<!--#echo var="DOCUMENT_NAME"--> 本文檔名稱
<!--#echo var="DATE_LOCAL"--> 現(xiàn)在時間
<!--#echo var="REMOTE_ADDR"--> 你的IP地址

#include 示范

作用：將文本文件的內(nèi)容直接插入到文檔頁面中。

語法：

<!--#include file="文件名稱"-->
<!--#include virtual="文件名稱"-->

file 文件名是一個相對路徑，該路徑相對于使用 #include 指令的文檔所在的目錄。被包含文件可以在同一級目錄或其子目錄中，但不能在上一級目錄中。如表示當(dāng)前目錄下的的nav_head.htm文檔，則為file="nav_head.htm"。
virtual 文件名是 Web 站點(diǎn)上的虛擬目錄的完整路徑。如表示相對于服務(wù)器文檔根目錄下hoyi目錄下的nav_head.htm文件；則為file="/hoyi/nav_head.htm"

參數(shù)：

file 指定包含文件相對于本文檔的位置
virtual 指定相對于服務(wù)器文檔根目錄的位置

注意：

1. 文件名稱必須帶有擴(kuò)展名。

2. 被包含的文件可以具有任何文件擴(kuò)展名，我覺得直接使用htm擴(kuò)展名最方便，微軟公司推薦使用 .inc 擴(kuò)展名（這就看你的愛好了）。

示例：

<!--#include file="nav_head.htm"--> 將頭文件插入到當(dāng)前頁面
<!--#include file="nav_foot.htm"--> 將尾文件插入到當(dāng)前頁面

#flastmod 和 #fsize 示范

作用：

#flastmod 文件最近更新日期
#fsize 文件的長度

語法：

<!--#flastmod file="文件名稱"-->
<!--#fsize file="文件名稱"-->

參數(shù)：

file 指定包含文件相對于本文檔的位置 如 info.txt 表示當(dāng)前目錄下的的info.txt文檔
virtual 指定相對于服務(wù)器文檔根目錄的位置 如 /hoyi/info.txt 表示

注意：文件名稱必須帶有擴(kuò)展名。

示例：

<!--#flastmod file="news.htm"--> 將當(dāng)前目錄下news.htm文件的最近更新日期插插入到當(dāng)前頁面
<!--#fsize file="news.htm"--> 將當(dāng)前目錄下news.htm的文件大小入到當(dāng)前頁面

#exec 示范

作用：將某一外部程序的輸出插入到頁面中?？刹迦隒GI程序或者是常規(guī)應(yīng)用程序的輸入，這取決于使用的參數(shù)是cmd還是cgi。

語法：

<!--#exec cmd="文件名稱"-->
<!--#exec cgi="文件名稱"-->

參數(shù)：

cmd 常規(guī)應(yīng)用程序
cgi CGI腳本程序

示例：

<!--#exec cmd="cat /etc/passwd"--> 將會顯示密碼文件
<!--#exec cmd="dir /b"--> 將會顯示當(dāng)前目錄下文件列表
<!--#exec cgi="/cgi-bin/gb.cgi"--> 將會執(zhí)行CGI程序gb.cgi。
<!--#exec cgi="/cgi-bin/access_log.cgi"--> 將會執(zhí)行CGI程序access_log.cgi。

注意：從上面的示例可以看出，這個指令相當(dāng)方便，但是也存在安全問題。

禁止方法：

1. Apache，將access.conf中的"Options Includes ExecCGI"這行代碼刪除；
2. 在IIS中，要禁用 #exec 命令，可修改 SSIExecDisable 元數(shù)據(jù)庫；

#config

作用： 指定返回給客戶端瀏覽器的錯誤信息、日期和文件大小的格式。

語法：

<!--#config errmsg="自定義錯誤信息"-->
<!--#config sizefmt="顯示單位"-->
<!--#config timefmt="顯示格式"-->

參數(shù)：

errmsg 自定義SSI執(zhí)行錯誤信息，可以為任何你喜歡的方式。
sizefmt 文件大小顯示方式，默認(rèn)為字節(jié)方式("bytes")可以改為千字節(jié)方式("abbrev")
timefmt 時間顯示方式，最靈活的配置屬性。

示例：顯示一個不存在文件的大小

<!--#config errmsg="服務(wù)器執(zhí)行錯誤，請聯(lián)系管理員 yiho@126.com ，謝謝！"-->
<!--#fsize file="不存在的文件.htm"-->

以千字節(jié)方式顯示文件大小

語法：

<!--#config sizefmt="abbrev"-->
<!--#fsizefile="news.htm"-->

以特定的時間格式顯示時間

<!--#config timefmt="%Y年/%m月%d日 星期%W 北京時間%H:%M:%s，%Y年已過去了%j天 今天是%Y年的第%U個星期"-->
<!--#echo var="DATE_LOCAL"--> 顯示今天是星期幾，幾月，時區(qū)
<!--#config timefmt="今天%A， %B ，服務(wù)器時區(qū)是 %z，是"-->
<!--#echo var="DATE_LOCAL"-->

XSSI

XSSI（Extended SSI）是一組高級SSI指令，內(nèi)置于Apache 1.2或更高版本的mod-include模塊之中。其中可利用的的指令有：

#printenv
#set
#if

#printenv

作用： 顯示當(dāng)前存在于WEB服務(wù)器環(huán)境中的所有環(huán)境變量。

語法：

<!--#printenv-->

#set

作用：可給變量賦值，以用于后面的if語句。

語法：

<!--#set var="變量名" value="變量值"-->

示例：

<!--#set var="color" value="紅色"-->

#if

作用：創(chuàng)建可以改變數(shù)據(jù)的頁面，這些數(shù)據(jù)根據(jù)使用if語句時計(jì)算的要求予以顯示。

語法：

<!--#if expr="$變量名=\"變量值A(chǔ)\""-->
  顯示內(nèi)容
<!--#elif expr="$變量名=\"變量值B\""-->
  顯示內(nèi)容
<!--#else-->
  顯示內(nèi)容
<!--#endif"-->

示例：

<!--#if expr="$SERVER_NAME=\"www.baidu.com\""-->
  歡迎光臨 http://www.baidu.com
<!--#elif expr="$SERVER_NAME=\"www.google.com\"" -->
  歡迎光臨 http://www.google.com
<!--#else-->
  歡迎光臨 Afly's Blog！
<!--#endif"-->

注意：用于前面指令中的反斜杠，是用來代換內(nèi)部的引號，以便它們不會被解釋為結(jié)束表達(dá)式。不可省略。

1、Config 命令

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

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

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

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

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

顯示結(jié)果為：

Wednesday， April 12， 2000

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

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

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

2、Include 命令

Include 命令可以把其它文檔中的文字或圖片插入到當(dāng)前被解析的文檔中，這是整個SSI的關(guān)鍵所在。通過Include命令只需要改動一個文件就可以瞬間更新整個站點(diǎn)！

Include 命令具有兩個不同的參數(shù)：

Virtual ：給出到服務(wù)器端某個文檔的虛擬路徑。
File ：給出到當(dāng)前目錄的相對路徑，其中不能使用"../"，也不能使用絕對路徑。

<!--#include virtual="/includes/header.html" -->
<!--#include file="header.html" --> 這就要求每一個目錄中都包含一個header.html文件。

3、Echo 命令

Echo 命令可以顯示以下各環(huán)境變量：

DOCUMENT_NAME ：顯示當(dāng)前文檔的名稱。
DOCUMENT_URI ：顯示當(dāng)前文檔的虛擬路徑。例如：

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

隨著網(wǎng)站的不斷發(fā)展，那些越來越長的URL地址肯定會讓人頭疼。如果使用SSI，一切就會迎刃而解。因?yàn)槲覀兛梢园丫W(wǎng)站的域名和SSI命令結(jié)合在一起顯示完整的URL，即：

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

QUERY_STRING_UNESCAPED ：顯示未經(jīng)轉(zhuǎn)義處理的由客戶端發(fā)送的查詢字串，其中所有的特殊字符前面都有轉(zhuǎn)義符"\"。例如：

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

DATE_LOCAL ：顯示服務(wù)器設(shè)定時區(qū)的日期和時間。用戶可以結(jié)合config命令的timefmt參數(shù)，定制輸出信息。例如：

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

顯示結(jié)果為：

Saturday， the 15 of April， in the year 2000

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

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

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

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

CGI環(huán)境變量

除了SSI環(huán)境變量之外，echo命令還可以顯示以下CGI環(huán)境變量：

SERVER_SOFTWARE：顯示服務(wù)器軟件的名稱和版本。例如：
<!--#echo var="SERVER_SOFTWARE" -->
SERVER_NAME： 顯示服務(wù)器的主機(jī)名稱，DNS別名或IP地址。例如：
<!--#echo var="SERVER_NAME" -->
SERVER_PROTOCOL：顯示客戶端請求所使用的協(xié)議名稱和版本，如HTTP/1.0。例如：
<!--#echo var="SERVER_PROTOCOL" -->
SERVER_PORT：顯示服務(wù)器的響應(yīng)端口。例如：
<!--#echo var="SERVER_PORT" -->
REQUEST_METHOD：顯示客戶端的文檔請求方法，包括GET， HEAD， 和POST。例如：
<!--#echo var="REQUEST_METHOD" -->
REMOTE_HOST：顯示發(fā)出請求信息的客戶端主機(jī)名稱。
<!--#echo var="REMOTE_HOST" -->
REMOTE_ADDR：顯示發(fā)出請求信息的客戶端IP地址。
<!--#echo var="REMOTE_ADDR" -->
AUTH_TYPE：顯示用戶身份的驗(yàn)證方法。
<!--#echo var="AUTH_TYPE" -->
REMOTE_USER：顯示訪問受保護(hù)頁面的用戶所使用的賬號名稱。
<!--#echo var="REMOTE_USER" -->

4、Fsize ：顯示指定文件的大小，可以結(jié)合config命令的sizefmt參數(shù)定制輸出格式。

<!--#fsize file="index_working.html" -->

5、Flastmod ：顯示指定文件的最后修改日期，可以結(jié)合config 命令的timefmt參數(shù)控制輸出格式。

<!--#config timefmt="%A， the %d of %B， in the year %Y" -->
<!--#flastmod file="file.html" -->

這里，我們可以利用flastmod參數(shù)顯示出一個頁面上所有鏈接頁面的更新日期。方法如下：

<!--#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" -->

顯示結(jié)果為：

File April 19， 2000
Another File January 08， 2000

6、Exec

Exec命令可以執(zhí)行CGI腳本或者shell命令。使用方法如下：

Cmd ：使用/bin/sh執(zhí)行指定的字串。如果SSI使用了IncludesNOEXEC選項(xiàng)，則該命令將被屏蔽。
Cgi ：可以用來執(zhí)行CGI腳本。例如，下面這個例子中使用服務(wù)端cgi-bin目錄下的counter.pl腳本程序在每個頁面放置一個計(jì)數(shù)器：

<!--#exec cgi="/cgi-bin/counter.pl" -->

關(guān)于SHTML和HTML的區(qū)別

讓我們先來看看SHTML和HTML的區(qū)別，如果用一句話來解釋就是:SHTML 不是HTML而是一種服務(wù)器 API，shtml是服務(wù)器動態(tài)產(chǎn)成的html.

雖然兩者都是超文本格式，但shtml是一種用于SSI技術(shù)的文件。也就是Server Side Include--SSI 服務(wù)器端包含指令。如果Web Server有SSI功能的話，大多數(shù)（尤其是基于Unix平臺）的WEB服務(wù)器，如Netscape Enterprise Server等均支持SSI命令。

ddd