SSI
伺服器端
伺服器端嵌入：Server Side Include，是一種類似於ASP的基於伺服器的網頁製作技術。大多數（尤其是基於Unix平台）的WEB伺服器如Netscape Enterprise Server等均支持SSI命令。另外，在計算機硬體領域SSI是同步串列介面（Synchronous Serial Interface）的英文縮寫。
將內容發送到瀏覽器之前，可以使用“伺服器端包含 (SSI）”指令將文本、圖形或應用程序信息包含到網頁中。例如，可以使用 SSI 包含時間/日期戳、版權聲明或供客戶填寫並返回的表單。對於在多個文件中重複出現的文本或圖形，使用包含文件是一種簡便的方法。將內容存入一個包含文件中即可，而不必將內容輸入所有文件。通過一個非常簡單的語句即可調用包含文件，此語句指示 Web 伺服器將內容插入適當網頁。而且，使用包含文件時，對內容的所有更改只需在一個地方就能完成。
因為包含 SSI 指令的文件要求特殊處理，所以必須為所有 SSI 文件賦予 SSI文件擴展名。默認擴展名是 .stm、.shtm 和 .shtml
之所以要扯到SSI，是因為shtml--server-parsed HTML 的首字母縮略詞。包含有嵌入式伺服器端命令的HTML文本。在被傳送給瀏覽器之前，伺服器會對 SHTML 文檔進行完全地讀取、分析以及修改。
shtml和asp 有一些相似，以shtml命名的文件里，使用了ssi的一些指令，就像asp中的指令，你可以在SHTML文件中寫入SSI指令，當客戶端訪問這些shtml文件時，伺服器端會把這些SHTML文件進行讀取和解釋，把SHTML文件中包含的SSI指令解釋出來。
比如：你可以在SHTML文件中用SSI指令引用其他的html文件（#include ），伺服器傳送給客戶端的文件，是已經解釋的SHTML不會有SSI指令。它實現了HTML所沒有的功能，就是可以實現了動態的SHTML，可以說是HTML的一種進化吧。像新浪的新聞系統就是這樣的，新聞內容是固定的但它上面的廣告和菜單等就是用#include引用進來的。
主要有以下幾種用用途：
1、顯示伺服器端環境變數<#echo>
2、將文本內容直接插入到文檔中<#include>
3、顯示WEB文檔相關信息<#flastmod #fsize> （如文件製作日期/大小等）
4、直接執行伺服器上的各種程序<#exec>(如CGI或其他可執行程序）
5、設置SSI信息顯示格式<#config>；（如文件製作日期/大小顯示方式）高級SSI；可設置變數使用if條件語句。
Apache默認是不支持SSI的，需要我們更改httpd.conf來進行配置。我這裡以windows平台的Apache 2.0.x為例：打開conf目錄下的httpd.conf文件，搜索“AddType text/html .shtml”，搜索結果：
# AddType text/html .shtml
# AddOutputFilter INCLUDES .shtml
把這兩行前面的＃去掉。
然後搜索“Options Indexes FollowSymLinks”
在搜索到的那一行後面添加“ Includes”
即將該行改變為：
OptionsIndexes FollowSymLinks Includes
保存httpd.conf，重啟apache即可。
開啟shtml
打開文件 ./include/config.inc.php
//資料庫配置信息
define('DB_USER','root'); //資料庫帳號
define('DB_PW','root'); //資料庫密碼
define('DB_NAME','phpcmsutf'); //資料庫名
define('DB_PRE','phpcms_'); //資料庫表前綴，同一資料庫安裝多套Phpcms時，請修改表前綴
define('DB_CHARSET','utf8'); //資料庫字符集
define('DB_PCONNECT',0); //0 或1，是否使用持久連接
define('DB_DATABASE','mysql'); //資料庫類型
//網站路徑配置
define('PHPCMS_PATH','/cms/phpcms_utf/'); //Phpcms框架訪問路徑，相對於域名
//shtml 支持
將它：
define('SHTML',0); //是否支持 shtml，需要伺服器支持，並且生成文件擴展名為 shtml
改成：
define('SHTML',1); //是否支持 shtml，需要伺服器支持，並且生成文件擴展名為 shtml。
編輯nginx配置文件 vi /usr/local/nginx/conf/nginx.conf
加入如下代碼ssi on;
ssi_silent_errorson;
ssi_typestext/shtml;
保存 重啟 nginx
SSI是為WEB伺服器提供的一套命令，這些命令只要直接嵌入到HTML文檔的註釋內容之中即可。如：
就是一條SSI指令，其作用是將"info.htm"的內容拷貝到當前的頁面中，當訪問者來瀏覽時，會看到其它HTML文檔一樣顯示info.htm其中的內容。
其它的SSI指令使用形式基本同剛才的舉例差不多，可見SSI使用只是插入一點代碼而已，使用形式非常簡單。
當然，如果WEB伺服器不支持SSI，它就會只不過將它當作註釋信息，直接跳過其中的內容；瀏覽器也會忽略這些信息。
如何在我的WEB伺服器上配置SSI功能？
在一些WEB伺服器上（如IIS 4.0/SAMBAR 4.2），包含 #include 指令的文件必須使用已被映射到 SSI解釋程序的擴展名；否則，Web 伺服器將不會處理該SSI指令；默認情況下，擴展名 .stm、.shtm 和 .shtml 被映射到解釋程序（Ssinc.dll）。
Apache則是根據你的設置情況而定，修改srm.conf如：
AddTypetext/x-server-parsed-html .shtml 將只對.shtml擴展名的文件解析SSI指令
AddTypetext/x-server-parsed-html .html將對所有HTML文檔解析SSI指令
NetscapeWEB伺服器直接使用Administration Server（管理伺服器）可打開SSI功能。
Website使用Server Admin程序中的Mapping標籤，擴展名添加內容類型為：wwwserver/html-ssi
Cern伺服器不支持SSI，可用SSI詐騙法，上下載一個PERL腳本，即可使你的CERN伺服器使用一些SSI指令。（不支持exec指令。）
指令
編輯
格式
程序代碼：
如程序代碼：
說明：
1．；是HTML語法中表示註釋，當WEB伺服器不支持SSI時，會忽略這些信息。
2．#include 為SSI指令之一。
3．file 為include的參數，info.htm為參數值，在本指令中指將要包含的文檔名。
注意：
1．
本文檔名稱：程序代碼：
時間：程序代碼：
你的IP地址是程序代碼：
#include 示範
作用：
將文本文件的內容直接插入到文檔頁面中。
語法：
程序代碼：
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擴展名最方便，微軟公司推薦使用 .inc 擴展名（這就看你的愛好了）。
示例：
程序代碼：
；將頭文件插入到當前頁面
；將尾文件插入到當前頁面
；將頭文件插入到當前頁面
；將尾文件插入到當前頁面
#flastmod 和#fsize 示範
作用：#flastmod 文件更新日期
#fsize 文件的長度
語法：
程序代碼：
參數：
file 指定包含文件相對於本文檔的位置 如 info.txt 表示當前目錄下的的info.txt文檔
virtual 指定相對於伺服器文檔根目錄的位置 如 /hoyi/info.txt 表示
注意：
文件名稱必須帶有擴展名。
示例：
程序代碼：
將當前目錄下news.htm文件的更新日期插插入到當前頁面
程序代碼：
將當前目錄下news.htm的文件大小入到當前頁面
#exec 示範
作用：
將某一外部程序的輸出插入到頁面中。可插入CGI程序或者是常規應用程序的輸入，這取決於使用的參數是cmd還是cgi。
語法：
程序代碼：
參數：
cmd 常規應用程序
cgi CGI腳本程序
示例：
程序代碼：
；將會顯示密碼文件
；將會顯示當前目錄下文件列表
；將會執行CGI程序gb.cgi。
；將會執行CGI程序access_log.cgi。
注意：
從上面的示例可以看出，這個指令相當方便，但是也存在安全問題。
禁止方法：
．Apache，將access.conf中的"Options Includes ExecCGI"這行代碼刪除；
．在IIS中，要禁用 #exec 命令，可修改 SSIExecDisable 元資料庫；
#config
作用：指定返回給客戶端瀏覽器的錯誤信息、日期和文件大小的格式。
語法：
程序代碼：
參數：
errmsg 自定義SSI執行錯誤信息，可以為任何你喜歡的方式。
sizefmt 文件大小顯示方式，默認為位元組方式（"bytes")可以改為千位元組方式（"abbrev")
timefmt 時間顯示方式，最靈活的配置屬性。
示例：顯示一個不存在文件的大小
程序代碼：
以千位元組方式顯示文件大小
程序代碼：
以特定的時間格式顯示時間
程序代碼：
顯示今天是星期幾，幾月，時區
顯示今天是星期幾，幾月，時區
XSSI
XSSI（Extended SSI）是一組高級SSI指令，內置於Apache 1.2或更高版本的mod-include模塊之中。
其中可利用的的指令有：
#printenv
#set
#if
#printenv
作用：顯示當前存在於WEB伺服器環境中的所有環境變數。
語法：程序代碼：
#set
作用：可給變數賦值，以用於後面的if語句。
語法：程序代碼：
參數：無
示例：程序代碼：
#if
作用：創建可以改變數據的頁面，這些數據根據使用if語句時計算的要求予以顯示。
語法：程序代碼：
顯示內容
顯示內容
顯示內容
顯示內容
顯示內容
顯示內容
示例：
程序代碼：
歡迎光臨好易CGI工廠！
歡迎光臨好易CGI工廠在淄博熱線的分站。
歡迎光臨好易CGI工廠在太陽城的分站。
歡迎光臨好易CGI工廠！
注意：用於前面指令中的反斜杠，是用來代換內部的引號，以便它們不會被解釋為結束表達式。不可省略。
1、Config命令
Config命令主要用於修改SSI的默認設置。其中：
Errmsg：設置默認錯誤信息。為了能夠正常的返回用戶設定的錯誤信息，在HTML文件中Errmsg參數必須被放置在其它SSI命令的前面，否則客戶端只能顯示默認的錯誤信息，而不是由用戶設定的自定義信息。
顯示結果為：
Wednesday,April 12,2000
也許用戶對上例中所使用的%A %B %d感到很陌生，下面我們就以表格的形式總結一下SSI中較為常用的一些日期和時間格式。
Sizefmt：決定文件大小是以位元組、千位元組還是兆位元組為單位表示。如果以位元組為單位，參數值為"bytes"；對於千位元組和兆位元組可以使用縮寫形式。同樣，sizefmt參數必須放在fsize命令的前面才能使用。
2、Include命令
Include命令可以把其它文檔中的文字或圖片插入到當前被解析的文檔中，這是整個SSI的關鍵所在。通過Include命令只需要改動一個文件就可以瞬間更新整個站點！
Include命令具有兩個不同的參數：
Virtual：給出到伺服器端某個文檔的虛擬路徑。例如：
File：給出到當前目錄的相對路徑，其中不能使用"../"，也不能使用絕對路徑。例如：
這就要求每一個目錄中都包含一個header.html文件。
3、Echo命令
Echo命令可以顯示以下各環境變數：
DOCUMENT_NAME：顯示當前文檔的名稱。
顯示結果為：
index.html
DOCUMENT_URI：顯示當前文檔的虛擬路徑。例如：
顯示結果為：
/YourDirectory/YourFilename.html
隨著網站的不斷發展，那些越來越長的URL地址肯定會讓人頭疼。如果使用SSI，一切就會迎刃而解。因為我們可以把網站的域名和SSI命令結合在一起顯示完整的URL，即：
http://yourdomain<;!--#echo var="DOCUMENT_URI" -->
QUERY_STRING_UNESCAPED：顯示未經轉義處理的由客戶端發送的查詢字串，其中所有的特殊字元前面都有轉義符"\"。
顯示結果為：
Saturday,the 15 of April,in the year 2000
DATE_GMT：功能與DATE_LOCAL一樣，只不過返回的是以格林尼治標準時間為基準的日期。例如：
LAST_MODIFIED：顯示當前文檔的最後更新時間。同樣，這是SSI中非常實用的一個功能，只要在HTML文檔中加入以下這行簡單的文字，就可以在頁面上動態的顯示更新時間。
CGI環境變數
除了SSI環境變數之外，echo命令還可以顯示以下CGI環境變數：
SERVER_SOFTWARE：顯示伺服器軟體的名稱和版本。例如：
SERVER_NAME：顯示伺服器的主機名稱，DNS別名或IP地址。例如：
SERVER_PROTOCOL：顯示客戶端請求所使用的協議名稱和版本，如HTTP/1.0。例如：
SERVER_PORT：顯示伺服器的響應埠。例如：
REQUEST_METHOD：顯示客戶端的文檔請求方法，包括GET,HEAD，和POST。例如：
REMOTE_HOST：顯示發出請求信息的客戶端主機名稱。
REMOTE_ADDR：顯示發出請求信息的客戶端IP地址。
AUTH_TYPE：顯示用戶身份的驗證方法。
REMOTE_USER：顯示訪問受保護頁面的用戶所使用的帳號名稱。
4、Fsize命令
顯示指定文件的大小，可以結合config命令的sizefmt參數定製輸出格式。
5、Flastmod命令
顯示指定文件的最後修改日期，可以結合config 命令的timefmt參數控制輸出格式。
這裡，我們可以利用flastmod參數顯示出一個頁面上所有鏈接頁面的更新日期。方法如下：
directory/file.html">File
顯示結果為：
File April 19,2000
Another File January 08,2000
6、Exec命令
Exec命令可以執行CGI腳本或者shell命令。使用方法如下：
Cmd：使用/bin/sh執行指定的字串。如果SSI使用了IncludesNOEXEC選項，則該命令將被屏蔽。
Cgi：可以用來執行CGI腳本。例如，下面這個例子中使用服務端cgi-bin目錄下的腳本程序在每個頁面放置一個計數器：
目錄