ssi服務器端指令詳解(shtml)

你是否曾經或正在爲如何可以在最短的時間內完成對一個包含上千個頁面的網站的修改而苦惱？那麼能夠看一下本文的介紹，或許可以對你有所幫助。
什麼是SSI？
SSI是英文Server Side Includes的縮寫，翻譯成中文就是服務器端包含的意思。從技術角度上說，SSI就是HTML文件中，能夠經過註釋行調用的命令或指針。SSI 具備強大的功能，只要使用一條簡單的SSI 命令就能夠實現整個網站的內容更新，動態顯示時間和日期，以及執行shell和CGI腳本程序等複雜的功能。SSI 能夠稱得上是那些資金短缺、時間緊張、工做量大的網站開發人員的最佳幫手。
SSI最初在NCSA服務器平臺上推出，在Apache服務器中獲得擴展和增強，目前已經能夠在幾乎全部的服務器上運行。本文將主要結合Apache服務器介紹SSI的使用方法。
如何啓動SSI？
在Apache服務器下，能夠經過直接編輯服務器配置文件或者在須要使用SSI的目錄中建立.htaccess文件啓動SSI。具體來講，過程以下：
1.服務器配置文件
若是用戶具備對服務器配置文件的訪問權限，能夠經過編輯文件access.conf和srm.conf啓動SSI。
首先使用Telnet遠程登陸服務器，找到配置文件的存放目錄。通常來講，Apache服務器的配置文件都被保存在「/usr/local/etc/httpd/conf」目錄下。使用任何一種文字編輯器打開文件srm.conf，找到如下幾行：
# If you want to use server side includes, or CGI outside 
# ScriptAliased directories, uncomment the following lines. 
#AddType text/x-server-parsed-html .shtml
#AddType application/x-httpd-CGI .CGI
用戶的配置文件中可能沒有上述的註釋指令行，可是隻要找到以AddType開頭的兩行而且去掉每一行最前面的「#」符號便可。
保存所作的修改，而後再打開文件access.conf。用戶須要在文件中找到設置DocumentRoot（根文件）的部分。通常來講該段文本以下，可是不排除<Directory>和</Directory>標籤之間還包含其它設置內容。
# This should be changed to whatever you set DocumentRoot to. 
<Directory /usr/local/etc/httpd/htdocs> 
# This may also be "None", "All", or any combination of "Indexes", 
# "Includes", or "FollowSymLinks" 
Options Indexes FollowSymLinks Includes 
</Directory>
若是用戶不但願執行腳本或shell命令，能夠在options選項行中加入關鍵字IncludesNOEXEC，這樣能夠容許SSI，可是不能執行CGI或腳本命令。（注：最新版本的Apache服務器只有一個配置文件httpd.conf，以上所提到的內容都已經被包含在該文件中）
2.建立文件.htaccess
若是用戶不能直接訪問服務器配置文件，可使用文件編輯器建立一個名爲.htaccess的文件。注意，文件名前必定要有符號「.」，這樣服務器才能知道該文件是隱藏文件，從而提升文件的安全性，避免錯誤操做。在.htaccess文件中須要加入如下三行文字：
Options Indexes FollowSymLinks Includes 
AddType application/x-httpd-CGI .CGI 
AddType text/x-server-parsed-html .shtml
完成以後能夠把.htaccess文件上傳到服務端的相應目錄，該文件對全部子目錄有效。若是用戶但願在目錄級上禁止CGI或shell命令，能夠在.htaccess文件中的Options選項行加入關鍵字IncludesNOEXEC。
3.使用.shtml仍是.html？
任何包含SSI的文件在下傳到客戶端以前，都必須通過服務器的解析過程。雖然從某種程度上這樣會增長服務器的負載，可是除非用戶的網站天天有幾百萬的訪問用戶，某則服務器的性能不會有明顯的降低。不過，若是不是須要在每一個頁面都使用SSI的話，確實沒有必要讓服務器解析每個頁面。若是用戶只但願在幾個特殊頁面中使用SSI，能夠將文件的後綴名改成.shtml，這樣服務器就能夠只解析包含SSI的.shtml文件。另外一方面，若是有多個頁面使用了SSI，可是用戶不但願使用.shtml的後綴名時，能夠在.htaccess文件中使用如下命令行：
AddType text/x-server-parsed-html .html
SSI語法
SSI在使用時遵循如下格式：
<!--#directive parameter="value"-->
其中，directive是向服務器發送的指令名稱，parameter是指令的操做對象，而value則是用戶但願獲得的指令處理結果。 
全部的SSI命令都是以「<!--#」開始，其中「<!—」和「#」之間不能有任何空格，不然服務器會把SSI命令當稱普通的文件註釋處理，不會顯示出任何結果，也不會產生錯誤提示。此外，SSI命令中的「=」兩邊不能有空格，右邊的值必須包含在雙引號內，後面能夠跟空格，最後是結束標籤「-->」。
SSI命令包含六大類指令以及各自的參數，具體以下:
directives parameters
Config errmsg, timefmt, sizefmt
include virtual, file
echo var
fsize file
flastmod file
exec cmd, cgi
下面咱們將逐一進行介紹。
1.Config命令
Config命令主要用於修改SSI的默認設置。其中：
Errmsg：設置默認錯誤信息。爲了可以正常的返回用戶設定的錯誤信息，在HTML文件中Errmsg參數必須被放置在其它SSI命令的前面，不然客戶端只能顯示默認的錯誤信息，而不是由用戶設定的自定義信息.
<!--#config errmsg="Error! Please email webmaster@mydomain.com -->
Timefmt：定義日期和時間的使用格式。Timefmt參數必須在echo命令以前使用。
<!--#config timefmt="%A, %B %d, %Y"-->
<!--#echo var="LAST_MODIFIED" -->
顯示結果爲：
Wednesday, April 12, 2000
也許用戶對上例中所使用的%A %B %d感到很陌生，下面咱們就以表格的形式總結一下SSI中較爲經常使用的一些日期和時間格式。
格式 說明 實例
%% % 
%a 一週七天的縮寫形式 Thu 
%A 一週七天 Thursday 
%b 月的縮寫形式 Apr 
%B 月 April 
%d 一個月內的第幾天 13 
%D mm/dd/yy日期格式 04/13/00 
%H 小時（24小時制，從00到23） 01 
%I 小時（12小時制，從00到11） 01 
%j 一年內的第幾天，從01到365 104 
%m 一年內的第幾個月，從01到12 04 
%M 一小時內的第幾分鐘，從00到59 10 
%p AM或PM AM 
%r 12小時制的當地時間，格式爲 01:10:18 AM 
%I:%M:%S AM | PM 
%S 一分鐘內的第幾秒，從00到59 18 
%T 24小時制的%H:%M:%S時間格式 01:10:18 
%U 一年內的第幾個星期，從00到 15 
52，以星期天做爲每一個星期的 
第一天
%w 一星期內的第一天，從0到6 4 
%W 一年內的第幾個星期，從00 15 
到53，以星期一做爲每一個星期 
的第一天 
%y 年的縮寫形式，從00到99 00 
%Y 用四位數字表示一年 2000 
%Z 時區名稱 MDT
Sizefmt：決定文件大小是以字節、千字節仍是兆字節爲單位表示。若是以字節爲單位，參數值爲「bytes」；對於千字節和兆字節可使用縮寫形式。一樣，sizefmt參數必須放在fsize命令的前面才能使用.
<!--#config sizefmt="bytes" -->
<!--#fsize file="index.html" -->

2.Include命令
Include命令能夠把其它文檔中的文字或圖片插入到當前被解析的文檔中，是整個SSI的關鍵所在。經過Include命令只須要改動一個文件就能夠瞬間更新整個站點！
Include命令具備兩個不一樣的參數，若是使用錯誤的參數更新站點的話，不只達不到初衷，反而會獲得一大堆的錯誤信息。
Virtual：給出到服務器端某個文檔的虛擬路徑。例如：
<!--#include virtual="/includes/header.html" -->
爲了更加合理的組織站點的內容，用戶能夠在根目錄下建立includes子目錄來存放全部的包含文件。Virtual參數能夠通知服務器所要包含的是一個虛擬文件，即文件和當前被解析的文檔不是位於同一個目錄，而是存放在其它目錄中。服務器會根據該參數的值找到根目錄下的includes子目錄。使用這種方法，用戶能夠把全部HTML文檔包含的文件放在一個目錄中，而根據相互之間的關係把不一樣的頁面保存在不一樣的目錄或子目錄中。不管服務器解析哪個文檔均可以找到所包含的文件，不會產生任何錯誤。
不過這裏有一個小問題須要解決。通常咱們都會在頁面中加入一些TITLE和META標籤，若是咱們規定全部的頁面都調用相同的頁眉文件的話，就顯得很不靈活。用戶碰到這樣的問題時，可使用兩個包含文件，一個設置TITLE標籤前的內容，另外一個設置META標籤後的部分，而在兩個包含文件之間則能夠添加任何定製內容。例如：
<!--#include virtual="/includes/header1.html" --> 
<TITLE>Your Page Title</TITLE> 
<LINK rel = STYLESHEET href = "http://domain.com/styles/my.css" Type = "text/css" > 
<META NAME = "Description" CONTENT = " Description of page"> 
<META NAME = "Keywords" CONTENT = "keywords for page" > 
<!--#include virtual="/includes/header2.html" -->
這裏放置頁面內容
<!--#include virtual="/includes/footer.html" -->
從上咱們能夠看出經過在頁面中包含頁眉和頁腳能夠大大減小站點更新的工做量。可是若是咱們但願動態顯示一些內容，例如頁面的最後更新時間等該怎麼辦呢？沒問題，咱們能夠把包含文件使用.html後綴保存，這樣就能夠在包含文件中調用其它的包含文件。
File：給出到當前目錄的相對路徑，其中不能使用「../」，也不能使用絕對路徑。例如：
<!--#include file="header.html" -->
這就要求每個目錄中都包含一個header.html文件。固然，採用這樣的方法並不比更新每個頁面簡單多少，可是若是用戶只更新1、兩個文件的話仍是很方便的。例如，若是咱們不但願讓一個對HTML不熟悉的人直接改動網站中的新聞頁面的話，能夠只讓他更新一個單獨的文本文件，而後再把該文件包含到HMTL文檔中，這樣即不會破壞原頁面，同時又更新了內容，一箭雙鵰
3.Echo:
Echo命令能夠顯示如下各環境變量：
DOCUMENT_NAME：顯示當前文檔的名稱。
<!--#echo var="DOCUMENT_NAME" -->
顯示結果爲：
index.html
DOCUMENT_URI：顯示當前文檔的虛擬路徑。例如：
<!--#echo var="DOCUMENT_URI" -->
顯示結果爲：
/YourDirectory/YourFilename.html
隨着網站的不斷髮展，那些愈來愈長的URL地址確定會讓人頭疼。若是使用SSI，一切就會迎刃而解。由於咱們能夠把網站的域名和SSI命令結合在一塊兒顯示完整的URL，即：
http://YourDomain<!--#echo var="DOCUMENT_URI" -->
QUERY_STRING_UNESCAPED：顯示未經轉義處理的由客戶端發送的查詢字串，其中全部的特殊字符前面都有轉義符「\」。例如：
<!--#echo var="QUERY_STRING_UNESCAPED" -->
DATE_LOCAL：顯示服務器設定時區的日期和時間。用戶能夠結合config命令的timefmt參數，定製輸出信息。例如：
<!--#config timefmt="%A, the %d of %B, in the year %Y" --> 
<!--#echo var="DATE_LOCAL" -->
顯示結果爲：
Saturday, the 15 of April, in the year 2000
DATE_GMT：功能與DATE_LOCAL同樣，只不過返回的是以格林尼治標準時間爲基準的日期。例如：
<!--#echo var="DATE_GMT" -->
LAST_MODIFIED：顯示當前文檔的最後更新時間。一樣，這是SSI中很是實用的一個功能，只要在HTML文檔中加入如下這行簡單的文字，就能夠在頁面上動態的顯示更新時間。
<!--#echo var="LAST_MODIFIED" -->
CGI環境變量
除了SSI環境變量以外，echo命令還能夠顯示如下CGI環境變量：
SERVER_SOFTWARE：顯示服務器軟件的名稱和版本。例如：
<!--#echo var="SERVER_SOFTWARE" -->
SERVER_NAME： 顯示服務器的主機名稱，DNS別名或IP地址。例如：
<!--#echo var="SERVER_NAME" -->
SERVER_PROTOCOL：顯示客戶端請求所使用的協議名稱和版本，如HTTP/1.0。例如：
<!--#echo var="SERVER_PROTOCOL" -->
SERVER_PORT：顯示服務器的響應端口。例如：
<!--#echo var="SERVER_PORT" -->
REQUEST_METHOD：顯示客戶端的文檔請求方法，包括GET, HEAD, 和POST。例如：
<!--#echo var="REQUEST_METHOD" -->
REMOTE_HOST：顯示發出請求信息的客戶端主機名稱。
<!--#echo var="REMOTE_HOST" -->
REMOTE_ADDR：顯示發出請求信息的客戶端IP地址。
<!--#echo var="REMOTE_ADDR" -->
AUTH_TYPE：顯示用戶身份的驗證方法。
<!--#echo var="AUTH_TYPE" -->
REMOTE_USER：顯示訪問受保護頁面的用戶所使用的賬號名稱。
<!--#echo var="REMOTE_USER" -->
4.Fsize：顯示指定文件的大小，能夠結合config命令的sizefmt參數定製輸出格式。
<!--#fsize file="index_working.html" -->
5.Flastmod：顯示指定文件的最後修改日期，能夠結合config 命令的timefmt參數控制輸出格式。
<!--#config timefmt="%A, the %d of %B, in the year %Y" --> 
<!--#flastmod file="file.html" -->
這裏，咱們能夠利用flastmod參數顯示出一個頁面上全部連接頁面的更新日期。方法以下：
<!--#config timefmt=" %B %d, %Y" --> 
<A HREF="/directory/file.html">File</A> 
<!--#flastmod virtual="/directory/file.html" --> 
<A HREF="/another_directory/another_file.html">Another File</A> 
<!--#flastmod virtual="/another_directory/another_file.html" -->
顯示結果爲：
File April 19, 2000 
Another File January 08, 2000
也許有的讀者會認爲兩個連接就這麼複雜，一點也不方便。其實，若是頁面上有20個或者更多的連接，並且每一個連接都按期更新的話，就能夠看出使用flastmod顯示修改日期的做用。
6.Exec
Exec命令能夠執行CGI腳本或者shell命令。使用方法以下：
Cmd：使用/bin/sh執行指定的字串。若是SSI使用了IncludesNOEXEC選項，則該命令將被屏蔽。
Cgi：能夠用來執行CGI腳本。例如，下面這個例子中使用服務端cgi-bin目錄下的counter.pl腳本程序在每一個頁面放置一個計數器：
<!--#exec cgi="/cgi-bin/counter.pl"-->