一、介紹：
  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")可以改為千字節方式("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 -->