一、介紹：
??SSI是Server Side Includes的縮寫(xiě)，是嵌入到HTML頁(yè)面的一組指令的集合。在返回請(qǐng)求的頁(yè)面(包含SSI指令)前，服務(wù)器會(huì)處理這些指令，并用處理的結(jié)果替換指令，然??后把頁(yè)面返回。這樣就允許在HTML頁(yè)面中添加動(dòng)態(tài)產(chǎn)生的內(nèi)容。
??SSI是向頁(yè)面中添加小的信息片段的很好的方法。如果頁(yè)面的大部分都是產(chǎ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>(如文件制作日期/大小顯示方式) 高級(jí)SSI<XSSI>可設(shè)置變量使用if條件語(yǔ)句。
三、設(shè)置Tomcat
?????Tomcat對(duì)SSI提供了支持，但在默認(rèn)的情況下這種支持是關(guān)閉的。如果你用Tomcat做為HTTP服務(wù)器并且需要SSI，那么需要自己來(lái)設(shè)置。

四、設(shè)置方法如下：

????????在$CATALINA_BASE/server/lib/目錄下找到servlets-ssi.renametojar文件?
????????將這個(gè)文件重命名為servlets-ssi.jar?
????????在$CATALINA_BASE/conf/目錄下找到web.xml文件?
????????使用SSI Servlet就刪除在SSI servlet和servlet-mapping周圍的注釋?
????????使用SSI filter就刪除在SSI filter和filter-mapping周圍的注釋

五、基本指令
???????1、SSI指令的語(yǔ)法格式如下：
???????????<!--#element [attribute=value] [attribute=value] ... -->
??????????????這些指令以HTML注釋的形式出現(xiàn)，所以如果你沒(méi)有正確設(shè)置SSI，瀏覽器會(huì)忽略這些指令。如果你正確設(shè)置了SSI，這些指令會(huì)被相應(yīng)的結(jié)果替換。
???????2、config
???????????<!--#config timefmt="%B %Y" -->
???????????config用來(lái)指定返回給客戶端瀏覽器的錯(cuò)誤信息、日期和文件大小的格式。
????????常用指令：
???????????<!--#config errmsg="自定義錯(cuò)誤信息"-->?
???????????<!--#config sizefmt="顯示單位"-->?
???????????<!--#config timefmt="顯示格式"-->?
????????參數(shù)：?
????????????errmsg 自定義SSI執(zhí)行錯(cuò)誤信息，可以為任何你喜歡的方式。?
????????????sizefmt 文件大小顯示方式，默認(rèn)為字節(jié)方式("bytes")可以改為千字節(jié)方式("abbrev")?
????????????timefmt 時(shí)間顯示方式，最靈活的配置屬性。?
????????Eg:
????????????<!--#config errmsg="服務(wù)器執(zhí)行錯(cuò)誤，請(qǐng)聯(lián)系管理員 yiho@126.com，謝謝！"-->?
????????????<!--#fsize file="不存在的文件.htm"-->

????????????以千字節(jié)方式顯示文件大小?
????????????<!--#config sizefmt="abbrev"-->?
????????????<!--#fsizefile="news.htm"-->?
???????????以特定的時(shí)間格式顯示時(shí)間
???<!--#config timefmt="%Y年/%m月%d日 星期%W 北京時(shí)間%H:%M:%s，%Y年已過(guò)去了%j天 今天是%Y年的第%U個(gè)星期"-->
???<!--#echo var="DATE_LOCAL"--> 顯示今天是星期幾,幾月,時(shí)區(qū)
???<!--#config timefmt="今天%A, %B ,服務(wù)器時(shí)區(qū)是 %z，是"-->
???<!--#echo var="DATE_LOCAL"--> ??
?3、echo
???echo用來(lái)輸出變量的值。
????<!--#echo var="VARIABLE_NAME" -->
????<!--#echo var="變量名稱"-->
???本文檔名稱：程序代碼:
????<!--#echo var="DOCUMENT_NAME"-->
???現(xiàn)在時(shí)間：程序代碼:
????<!--#echo var="DATE_LOCAL"-->
???你的IP地址是程序代碼:
????<!--#echo var="REMOTE_ADDR"-->
?4、exec
??<!--#exec cmd="COMMOND" -->
??exec用來(lái)執(zhí)行命令。 將某一外部程序的輸出插入到頁(yè)面中。可插入CGI程序或者是常規(guī)應(yīng)用程序的輸入，這取決于使用的參數(shù)是cmd還是cgi。
???<!--#exec cmd="文件名稱"-->
???<!--#exec cgi="文件名稱"-->
???<!--#exec cmd="文件名稱"-->
???<!--#exec cgi="文件名稱"-->
??參數(shù)：
???cmd 常規(guī)應(yīng)用程序
???cgi CGI腳本程序
??Eg：
???<!--#exec cmd="cat /etc/passwd"-->將會(huì)顯示密碼文件
???<!--#exec cmd="dir /b"-->將會(huì)顯示當(dāng)前目錄下文件列表
???<!--#exec cgi="/cgi-bin/gb.cgi"-->將會(huì)執(zhí)行CGI程序gb.cgi。
???<!--#exec cgi="/cgi-bin/access_log.cgi"-->將會(huì)執(zhí)行CGI程序access_log.cgi。
??注意：
???從上面的示例可以看出，這個(gè)指令相當(dāng)方便，但是也存在安全問(wèn)題。
??禁止方法：
???．Apache，將access.conf中的"Options Includes ExecCGI"這行代碼刪除；
???．在IIS中，要禁用 #exec 命令，可修改 SSIExecDisable 元數(shù)據(jù)庫(kù)； ?
?5、flastmod
??<!--#flastmod file="FILE_NAME" -->
??flastmod返回FILE_NAME所代表的文件的最后修改時(shí)間。
??Eg:
???<!--#flastmod file="news.htm"-->
????將當(dāng)前目錄下news.htm文件的最近更新日期插插入到當(dāng)前頁(yè)面
?6、fsize
??<!--#fsize file="FILE_NAME" -->
??fsize返回FILE_NAME所代表的文件的大小。
??<!--#flastmod file="文件名稱"-->
??<!--#fsize file="文件名稱"-->
??參數(shù)：
???file 指定包含文件相對(duì)于本文檔的位置 如 info.txt 表示當(dāng)前目錄下的的info.txt文檔
???virtual 指定相對(duì)于服務(wù)器文檔根目錄的位置 如 /hoyi/info.txt 表示
??注意：
???文件名稱必須帶有擴(kuò)展名。
??Eg:?
???<!--#fsize file="news.htm"-->
????將當(dāng)前目錄下news.htm的文件大小入到當(dāng)前頁(yè)面
?7、include
??<!--#include file="文件名稱"-->
??<!--#include virtual="文件名稱"-->
??include插入FILE_NAME所代表的文件的內(nèi)容。
??file 文件名是一個(gè)相對(duì)路徑，該路徑相對(duì)于使用 #include 指令的文檔所在的目錄。被包含文件可以在同一級(jí)目錄或其子目錄中，但不能在上一級(jí)目錄中。如表示當(dāng)前目??錄下的的nav_head.htm文檔，則為file="nav_head.htm"。
??virtual 文件名是 Web 站點(diǎn)上的虛擬目錄的完整路徑。如表示相對(duì)于服務(wù)器文檔根目錄下hoyi目錄下的nav_head.htm文件；則為file="/hoyi/nav_head.htm"
??參數(shù)：
???file 指定包含文件相對(duì)于本文檔的位置
???virtual 指定相對(duì)于服務(wù)器文檔根目錄的位置
??注意：
???1、文件名稱必須帶有擴(kuò)展名。
???2、被包含的文件可以具有任何文件擴(kuò)展名，我覺(jué)得直接使用htm擴(kuò)展名最方便
?8、printenv
??<!--#printenv -->
???printenv返回所有定義的變量的列表。
?9、set
??<!--#set var="VARIABLE_NAME" value="VARIABLE_VALUE" -->
??set用來(lái)自定義變量。在SSI中有許多標(biāo)準(zhǔn)的變量(如DATE_LOCAL)，其中也包括對(duì)于CGI程序有效的環(huán)境變量。
?10、if elif endif else
??if elif endif else用來(lái)?xiàng)l件選擇。
??#if
??作用： 創(chuàng)建可以改變數(shù)據(jù)的頁(yè)面，這些數(shù)據(jù)根據(jù)使用if語(yǔ)句時(shí)計(jì)算的要求予以顯示。
????語(yǔ)法： 程序代碼:
???<!--#if expr="$變量名="變量值A(chǔ)""-->
???顯示內(nèi)容
????<!--#elif expr="$變量名="變量值B""-->
???顯示內(nèi)容
????<!--#else-->
???顯示內(nèi)容
????<!--#endif"-->
???Eg:
????<!--#if expr="$SERVER_NAME="hoyi.zb169.net""-->
?????中華E搜網(wǎng)http://www.eshoo.com.cn
????<!--#elif expr="$SERVER_NAME="linux.cqi.com.cn"" -->
?????中華E搜網(wǎng)http://www.eshoo.com.cn/bbs
????<!--#else-->
?????中華E搜網(wǎng)http://www.eshoo.com.cn
????<!--#endif"-->
注意： 用于前面指令中的反斜杠，是用來(lái)代換內(nèi)部的引號(hào)，以便它們不會(huì)被解釋為結(jié)束表達(dá)式。不可省略。
??
六、普通用法
?1、下面是一些比較常規(guī)的SSI的用法：
??最后修改時(shí)間
???有兩種方法：
???This file last modified <!--#flastmod file="ssi.shtml" -->
???This file last modified <!--#echo var="LAST_MODIFIED" -->
??包含一個(gè)footer
???<!--#include virtual="/footer.html" -->
??設(shè)置errmsg
???<!--#config errmsg="[error message!]" -->
??設(shè)置sizefmt
???<!--#config sizefmt="bytes|abbrev" -->
??執(zhí)行命令
??<!--#exec cmd="dir" -->
?2、高級(jí)SSI
??XSSI（Extended SSI）是一組高級(jí)SSI指令，內(nèi)置于Apache 1.2或更高版本的mod-include模塊之中。
???其中可利用的的指令有：
???<!--#printenv-->
???<!--#printenv-->
???<!--#printenv-->
???<!--#printenv-->
??作用： 顯示當(dāng)前存在于WEB服務(wù)器環(huán)境中的所有環(huán)境變量。
??（1）#set
???作用：可給變量賦值，以用于后面的if語(yǔ)句。
???語(yǔ)法：程序代碼:
?????<!--#set var="變量名"value="變量值"-->
???參數(shù)：無(wú)
???示例： 程序代碼:
????<!--#set var="color"value="紅色"-->
????SSI允許自定義變量，這些變量可以用來(lái)進(jìn)行比較和條件判斷。
???定義變量
????<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
???條件表達(dá)式
????<!--#if expr="test_condition" -->
????<!--#elif expr="test_condition" -->
?????<!--#else -->
????<!--#endif -->