Tomcat配置SSI

 Tomcat配置SSI
一、介紹：
  SSI是Server Side Includes的縮寫，是嵌入到HTML頁面的一組指令的集合。在返回

請求的頁面(包含SSI指令)前，伺服器會處理這些指令，並用處理的結果替換指令，然 

後把頁面返回。這樣就允許在HTML頁面中添加動態產生的內容。
  SSI是向頁面中添加小的資訊片段的很好的方法。如果頁面的大部分都是產生的則需

要選擇其它的解決方案。
二、主要用途
  目前，主要有以下幾種用用途：
　　1、顯示伺服器端環境變數<#echo>
　　2、將常值內容直接插入到文檔中<#include>
　　3、顯示WEB文檔相關資訊<#flastmod #fsize> (如檔案製作日期/大小等)
　　4、直接執行伺服器上的各種程式<#exec>(如CGI或其他可執行程式)
　　5、設定SSI資訊顯示格式<#config>(如檔案製作日期/大小顯示方式) 進階

SSI<XSSI>可設定變數使用if條件陳述式。
三、設定Tomcat
     Tomcat對SSI提供了支援，但在預設的情況下這種支援是關閉的。如果你用Tomcat

做為HTTP伺服器並且需要SSI，那麼需要自己來設定。

四、設定方法如下：

        在$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注釋的形式出現，所以如果你沒有正確設定SSI，瀏

覽器會忽略這些指令。如果你正確設定了SSI，這些指令會被相應的結果替換。
       2、config
           <!--#config timefmt="%B %Y" -->
           config用來指定返回給用戶端瀏覽器的錯誤資訊、日期和檔案大小的格式

。
        常用指令：
           <!--#config errmsg="自訂錯誤資訊"-->
           <!--#config sizefmt="顯示單位"-->
           <!--#config timefmt="顯示格式"-->
        參數：
            errmsg 自訂SSI執行錯誤資訊，可以為任何你喜歡的方式。
            sizefmt 檔案大小顯示方式，預設為位元組方式("bytes")可以改為KB

方式("abbrev")
            timefmt 時間顯示方式，最靈活的配置屬性。
        Eg:
            <!--#config errmsg="伺服器執行錯誤，請聯絡管理員 yiho@126.com，

謝謝！"-->
            <!--#fsize file="不存在的檔案.htm"-->

            以KB方式顯示檔案大小
            <!--#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 -->Search