四、設(shè)置方法如下:
???????? 在$CATALINA_BASE/server/lib/目錄下找到servlets-ssi.renametojar文件
???????? 將這個文件重命名為servlets-ssi.jar
???????? 在$CATALINA_BASE/conf/目錄下找到web.xml文件
???????? 使用SSI Servlet就刪除在SSI servlet和servlet-mapping周圍的注釋
???????? 使用SSI filter就刪除在SSI filter和filter-mapping周圍的注釋
五、基本指令
??????? 1、SSI指令的語法格式如下:
??????????? <!--#element [attribute=value] [attribute=value] ... -->
?????????????? 這些指令以HTML注釋的形式出現(xiàn),所以如果你沒有正確設(shè)置SSI,瀏覽器會忽略這些指令。如果你正確設(shè)置了SSI,這些指令會被相應(yīng)的結(jié)果替換。
??????? 2、config
??????????? <!--#config timefmt="%B %Y" -->
??????????? config用來指定返回給客戶端瀏覽器的錯誤信息、日期和文件大小的格式。
???????? 常用指令:
??????????? <!--#config errmsg="自定義錯誤信息"-->
??????????? <!--#config sizefmt="顯示單位"-->
??????????? <!--#config timefmt="顯示格式"-->
???????? 參數(shù):
???????????? errmsg 自定義SSI執(zhí)行錯誤信息,可以為任何你喜歡的方式。
???????????? sizefmt 文件大小顯示方式,默認(rèn)為字節(jié)方式("bytes")可以改為千字節(jié)方式("abbrev")
???????????? timefmt 時間顯示方式,最靈活的配置屬性。
???????? Eg:
???????????? <!--#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"--> ??
3、echo
??? echo用來輸出變量的值。
???? <!--#echo var="VARIABLE_NAME" -->
???? <!--#echo var="變量名稱"-->
??? 本文檔名稱:程序代碼:
???? <!--#echo var="DOCUMENT_NAME"-->
??? 現(xiàn)在時間:程序代碼:
???? <!--#echo var="DATE_LOCAL"-->
??? 你的IP地址是程序代碼:
???? <!--#echo var="REMOTE_ADDR"-->
4、exec
?? <!--#exec cmd="COMMOND" -->
?? exec用來執(zhí)行命令。 將某一外部程序的輸出插入到頁面中。可插入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"-->將會顯示密碼文件
??? <!--#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)方便,但是也存在安全問題。
?? 禁止方法:
??? .Apache,將access.conf中的"Options Includes ExecCGI"這行代碼刪除;
??? .在IIS中,要禁用 #exec 命令,可修改 SSIExecDisable 元數(shù)據(jù)庫;
5、flastmod
?? <!--#flastmod file="FILE_NAME" -->
?? flastmod返回FILE_NAME所代表的文件的最后修改時間。
?? Eg:
??? <!--#flastmod file="news.htm"-->
???? 將當(dāng)前目錄下news.htm文件的最近更新日期插插入到當(dāng)前頁面
6、fsize
?? <!--#fsize file="FILE_NAME" -->
?? fsize返回FILE_NAME所代表的文件的大小。
?? <!--#flastmod file="文件名稱"-->
?? <!--#fsize file="文件名稱"-->
?? 參數(shù):
??? file 指定包含文件相對于本文檔的位置 如 info.txt 表示當(dāng)前目錄下的的info.txt文檔
??? virtual 指定相對于服務(wù)器文檔根目錄的位置 如 /hoyi/info.txt 表示
?? 注意:
??? 文件名稱必須帶有擴(kuò)展名。
?? Eg:
??? <!--#fsize file="news.htm"-->
???? 將當(dāng)前目錄下news.htm的文件大小入到當(dāng)前頁面
7、include
?? <!--#include file="文件名稱"-->
?? <!--#include virtual="文件名稱"-->
?? include插入FILE_NAME所代表的文件的內(nèi)容。
?? 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ò)展名最方便
8、printenv
?? <!--#printenv -->
??? printenv返回所有定義的變量的列表。
9、set
?? <!--#set var="VARIABLE_NAME" value="VARIABLE_VALUE" -->
?? set用來自定義變量。在SSI中有許多標(biāo)準(zhǔn)的變量(如DATE_LOCAL),其中也包括對于CGI程序有效的環(huán)境變量。
10、if elif endif else
?? if elif endif else用來?xiàng)l件選擇。
?? #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"-->
??? 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"-->
注意: 用于前面指令中的反斜杠,是用來代換內(nèi)部的引號,以便它們不會被解釋為結(jié)束表達(dá)式。不可省略。
??
六、普通用法
1、下面是一些比較常規(guī)的SSI的用法:
?? 最后修改時間
??? 有兩種方法:
??? This file last modified <!--#flastmod file="ssi.shtml" -->
??? This file last modified <!--#echo var="LAST_MODIFIED" -->
?? 包含一個footer
??? <!--#include virtual="/footer.html" -->
?? 設(shè)置errmsg
??? <!--#config errmsg="[error message!]" -->
?? 設(shè)置sizefmt
??? <!--#config sizefmt="bytes|abbrev" -->
?? 執(zhí)行命令
?? <!--#exec cmd="dir" -->
2、高級SSI
?? XSSI(Extended SSI)是一組高級SSI指令,內(nèi)置于Apache 1.2或更高版本的mod-include模塊之中。
??? 其中可利用的的指令有:
??? <!--#printenv-->
??? <!--#printenv-->
??? <!--#printenv-->
??? <!--#printenv-->
?? 作用: 顯示當(dāng)前存在于WEB服務(wù)器環(huán)境中的所有環(huán)境變量。
?? (1)#set
??? 作用:可給變量賦值,以用于后面的if語句。
??? 語法:程序代碼:
????? <!--#set var="變量名"value="變量值"-->
??? 參數(shù):無
??? 示例: 程序代碼:
???? <!--#set var="color"value="紅色"-->
???? SSI允許自定義變量,這些變量可以用來進(jìn)行比較和條件判斷。
??? 定義變量
???? <!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
??? 條件表達(dá)式
???? <!--#if expr="test_condition" -->
???? <!--#elif expr="test_condition" -->
????? <!--#else -->
???? <!--#endif -->
七 SSI命令大全
<!--#config errmsg="Error!"-->
顯示當(dāng)前日期:<!--#echo var="DATE_LOCAL"-->
<br />
顯示當(dāng)前文檔名稱:<!--#echo var="document_name"-->
<br />
顯示當(dāng)前文檔虛擬路徑:<!--#echo var="document_uri"-->
<br />
顯示文檔最后更新時間:<!--#echo var="LAST_MODIFIED"-->
<br />
顯示服務(wù)器設(shè)定時區(qū)的日期何時間:<!--#config timefmt="%A,the %d of %B,in the year %Y"--><!--#echo var="date_local"-->
<br />
顯示服務(wù)器主機(jī)名,DNS別名或IP地址:<!--#echo var="server_name"-->
<br />
顯示服務(wù)器的響應(yīng)端口:<!--#echo var="server_port"-->
<br />
顯示服務(wù)器軟件名稱和版本:<!--#echo var="server_software"-->
<br />
顯示客戶端文檔請求方法:<!--#echo var="request_method"-->
<br />
顯示客戶端主機(jī)名稱,DNS別名或IP地址:<!--#echo var="remote_host"-->
<br />
顯示發(fā)出請求信息的客戶端IP:<!--#echo var="remote_addr"-->
<br />
顯示用戶身份的驗(yàn)證方法:<!--#echo var="AUTH_TYPE"-->
<br />
顯示訪問受保護(hù)頁面的用戶所使用的帳號名稱:<!--#echo var="remote_user"-->
<br />
<!--下面兩個包含命令都能包含html文件和jsp文件-->
<!--這個命令只能包含與本文件同目錄下的文件-->
<!--#include file="index.html"-->
<br />
<!--這個命令能包含別的目錄下的文件,用虛擬路徑-->
<!--#include virtual="test.jsp"-->
<br />
<!--包含txt文件-->
<p align="center"><!--#include file="testssi.txt"--></p>
<br />
顯示指定文件的大小:<!--#fsize file="WEB-INF/web.xml"-->
<br />
測試最頭上指定的錯誤信息:<!--#fsize file="http://"-->