1.把文件$CATALINA_HOME/server/lib/servlets-ssi.renametojar重新命名為$CATALINA_HOME/server/lib/servlets-ssi.jar.
2.在文件$CATALINA_HOME/conf/web.xml中,你需要把兩個地方的注釋去掉,servlet 聲明和servlet mapping。 servlet 聲明看起來類似于下面:
<servlet>
<servlet-name>ssi</servlet-name>
...
</servlet>
而servlet mapping看起來類似于下面:
<servlet-mapping>
<servlet-name>ssi</servlet-name>
<url-pattern>*.shtml</url-pattern>
</servlet-mapping>
這些servlet 聲明和mapping可以交替地加入到你的Web 應用程序部署描述符中。
SSI基本指令
1、SSI指令的語法格式如下:
<!--#element [attribute=value] [attribute=value] ... -->
這些指令以HTML注釋的形式出現,所以如果你沒有正確設置SSI,瀏覽器會忽略這些指令。如果你正確設置了SSI,這些指令會被相應的結果替換。
2、config
<!--#config timefmt="%B %Y" -->
config用來指定返回給客戶端瀏覽器的錯誤信息、日期和文件大小的格式。
常用指令:
<!--#config errmsg="自定義錯誤信息"-->
<!--#config sizefmt="顯示單位"-->
<!--#config timefmt="顯示格式"-->
參數:
errmsg 自定義SSI執行錯誤信息,可以為任何你喜歡的方式。
sizefmt 文件大小顯示方式,默認為字節方式("bytes")可以改為千字節方式("abbrev")
timefmt 時間顯示方式,最靈活的配置屬性。
Eg:
<!--#config errmsg="服務器執行錯誤,請聯系管理員 yiho@126.com,謝謝!"-->
<!--#fsize file="不存在的文件.htm"-->
以千字節方式顯示文件大小
<!--#config sizefmt="abbrev"-->
<!--#fsizefile="news.htm"-->
以特定的時間格式顯示時間
<!--#config timefmt="%Y年/%m月%d日 星期%W 北京時間%H:%M:%s,%Y年已過去了%j天 今天是%Y年的第%U個星期"-->
<!--#echo var="DATE_LOCAL"--> 顯示今天是星期幾,幾月,時區
<!--#config timefmt="今天%A, %B ,服務器時區是 %z,是"-->
<!--#echo var="DATE_LOCAL"-->
3、echo
echo用來輸出變量的值。
<!--#echo var="VARIABLE_NAME" -->
<!--#echo var="變量名稱"-->
本文檔名稱:程序代碼:
<!--#echo var="DOCUMENT_NAME"-->
現在時間:程序代碼:
<!--#echo var="DATE_LOCAL"-->
你的IP地址是程序代碼:
<!--#echo var="REMOTE_ADDR"-->
4、exec
<!--#exec cmd="COMMOND" -->
exec用來執行命令。 將某一外部程序的輸出插入到頁面中。可插入CGI程序或者是常規應用程序的輸入,這取決于使用的參數是cmd還是cgi。
<!--#exec cmd="文件名稱"-->
<!--#exec cgi="文件名稱"-->
<!--#exec cmd="文件名稱"-->
<!--#exec cgi="文件名稱"-->
參數:
cmd 常規應用程序
cgi CGI腳本程序
Eg:
<!--#exec cmd="cat /etc/passwd"-->將會顯示密碼文件
<!--#exec cmd="dir /b"-->將會顯示當前目錄下文件列表
<!--#exec cgi="/cgi-bin/gb.cgi"-->將會執行CGI程序gb.cgi。
<!--#exec cgi="/cgi-bin/access_log.cgi"-->將會執行CGI程序access_log.cgi。
注意:
從上面的示例可以看出,這個指令相當方便,但是也存在安全問題。
禁止方法:
.Apache,將access.conf中的"Options Includes ExecCGI"這行代碼刪除;
.在IIS中,要禁用 #exec 命令,可修改 SSIExecDisable 元數據庫;
5、flastmod
<!--#flastmod file="FILE_NAME" -->
flastmod返回FILE_NAME所代表的文件的最后修改時間。
Eg:
<!--#flastmod file="news.htm"-->
將當前目錄下news.htm文件的最近更新日期插插入到當前頁面
6、fsize
<!--#fsize file="FILE_NAME" -->
fsize返回FILE_NAME所代表的文件的大小。
<!--#flastmod file="文件名稱"-->
<!--#fsize file="文件名稱"-->
參數:
file 指定包含文件相對于本文檔的位置 如 info.txt 表示當前目錄下的的info.txt文檔
virtual 指定相對于服務器文檔根目錄的位置 如 /hoyi/info.txt 表示
注意:
文件名稱必須帶有擴展名。
Eg:
<!--#fsize file="news.htm"-->
將當前目錄下news.htm的文件大小入到當前頁面
7、include
<!--#include file="文件名稱"-->
<!--#include virtual="文件名稱"-->
include插入FILE_NAME所代表的文件的內容。
file 文件名是一個相對路徑,該路徑相對于使用 #include 指令的文檔所在的目錄。被包含文件可以在同一級目錄或其子目錄中,但不能在上一級目錄中。如表示當前目 錄下的的nav_head.htm文檔,則為file="nav_head.htm"。
virtual 文件名是 Web 站點上的虛擬目錄的完整路徑。如表示相對于服務器文檔根目錄下hoyi目錄下的nav_head.htm文件;則為file="/hoyi/nav_head.htm"
參數:
file 指定包含文件相對于本文檔的位置
virtual 指定相對于服務器文檔根目錄的位置
注意:
1、文件名稱必須帶有擴展名。
2、被包含的文件可以具有任何文件擴展名,我覺得直接使用htm擴展名最方便
8、printenv
<!--#printenv -->
printenv返回所有定義的變量的列表。
9、set
<!--#set var="VARIABLE_NAME" value="VARIABLE_VALUE" -->
set用來自定義變量。在SSI中有許多標準的變量(如DATE_LOCAL),其中也包括對于CGI程序有效的環境變量。
10、if elif endif else
if elif endif else用來條件選擇。
#if
作用: 創建可以改變數據的頁面,這些數據根據使用if語句時計算的要求予以顯示。
語法: 程序代碼:
<!--#if expr="$變量名="變量值A""-->
顯示內容
<!--#elif expr="$變量名="變量值B""-->
顯示內容
<!--#else-->
顯示內容
<!--#endif"-->
Eg:
<!--#if expr="$SERVER_NAME="hoyi.zb169.net""-->
中華E搜網http://www.eshoo.com.cn
<!--#elif expr="$SERVER_NAME="linux.cqi.com.cn"" -->
中華E搜網http://www.eshoo.com.cn/bbs
<!--#else-->
中華E搜網http://www.eshoo.com.cn
<!--#endif"-->
注意: 用于前面指令中的反斜杠,是用來代換內部的引號,以便它們不會被解釋為結束表達式。不可省略。
六、普通用法
1、下面是一些比較常規的SSI的用法:
最后修改時間
有兩種方法:
This file last modified <!--#flastmod file="ssi.shtml" -->
This file last modified <!--#echo var="LAST_MODIFIED" -->
包含一個footer
<!--#include virtual="/footer.html" -->
設置errmsg
<!--#config errmsg="[error message!]" -->
設置sizefmt
<!--#config sizefmt="bytes|abbrev" -->
執行命令
<!--#exec cmd="dir" -->
2、高級SSI
XSSI(Extended SSI)是一組高級SSI指令,內置于Apache 1.2或更高版本的mod-include模塊之中。
其中可利用的的指令有:
<!--#printenv-->
<!--#printenv-->
<!--#printenv-->
<!--#printenv-->
作用: 顯示當前存在于WEB服務器環境中的所有環境變量。
(1)#set
作用:可給變量賦值,以用于后面的if語句。
語法:程序代碼:
<!--#set var="變量名"value="變量值"-->
參數:無
示例: 程序代碼:
<!--#set var="color"value="紅色"-->
SSI允許自定義變量,這些變量可以用來進行比較和條件判斷。
定義變量
<!--#set var="date" value="${DATE_LOCAL}_${DATE_GMT}" -->
條件表達式
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->