HTML靜態(tài)頁面引入公共html文件(ssi服務(wù)器端指令詳解)
你是否曾經(jīng)或正在為如何能夠在最短的時間內(nèi)完成對一個包含上千個頁面的網(wǎng)站的修改而苦惱?
那么可以看一下本文的介紹,或許能夠?qū)δ阌兴鶐椭?nbsp;
什么是SSI?
SSI是英文Server Side Includes的縮寫,翻譯成中文就是服務(wù)器端包含的意思。從技術(shù)角度上說,SSI就是HTML文件中,可以通過注釋行調(diào)用的命令或指針。
SSI 具有強(qiáng)大的功能,只要使用一條簡單的SSI 命令就可以實(shí)現(xiàn)整個網(wǎng)站的內(nèi)容更新,動態(tài)顯示時間和日期,以及執(zhí)行shell和CGI腳本程序等復(fù)雜的功能。SSI 可以稱得上是那些資金短缺、時間緊張、工作量大的網(wǎng)站開發(fā)人員的最佳幫手。
SSI最初在NCSA服務(wù)器平臺上推出,在Apache服務(wù)器中得到擴(kuò)展和加強(qiáng),目前已經(jīng)可以在幾乎所有的服務(wù)器上運(yùn)行。本文將主要結(jié)合Apache服務(wù)器介紹SSI的使用方法。
如何啟動SSI?
在Apache服務(wù)器下,可以通過直接編輯服務(wù)器配置文件或者在需要使用SSI的目錄中創(chuàng)建.htaccess文件啟動SSI。具體來說,過程如下:
1.服務(wù)器配置文件
如果用戶具有對服務(wù)器配置文件的訪問權(quán)限,可以通過編輯文件access.conf和srm.conf啟動SSI。
首先使用Telnet遠(yuǎn)程登錄服務(wù)器,找到配置文件的存放目錄。
一般來說,Apache服務(wù)器的配置文件都被保存在“/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。用戶需要在文件中找到設(shè)置DocumentRoot(根文件)的部分。一般來說該段文本如下,但是不排除<Directory>和</Directory>標(biāo)簽之間還包含其它設(shè)置內(nèi)容。
# 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>
如果用戶不希望執(zhí)行腳本或shell命令,可以在options選項(xiàng)行中加入關(guān)鍵字IncludesNOEXEC,這樣可以允許SSI,但是不能執(zhí)行CGI或腳本命令。
(注:最新版本的Apache服務(wù)器只有一個配置文件httpd.conf,以上所提到的內(nèi)容都已經(jīng)被包含在該文件中)
2.創(chuàng)建文件.htaccess
如果用戶不能直接訪問服務(wù)器配置文件,可以使用文件編輯器創(chuàng)建一個名為.htaccess的文件。注意,文件名前一定要有符號“.”,這樣服務(wù)器才能知道該文件是隱藏文件,從而提高文件的安全性,避免錯誤操作。在.htaccess文件中需要加入以下三行文字:
Options Indexes FollowSymLinks Includes AddType application/x-httpd-CGI .CGI AddType text/x-server-parsed-html .shtml
完成之后可以把.htaccess文件上傳到服務(wù)端的相應(yīng)目錄,該文件對所有子目錄有效。如果用戶希望在目錄級上禁止CGI或shell命令,可以在.htaccess文件中的Options選項(xiàng)行加入關(guān)鍵字IncludesNOEXEC。
3.使用.shtml還是.html?
任何包含SSI的文件在下傳到客戶端之前,都必須經(jīng)過服務(wù)器的解析過程。
雖然從某種程度上這樣會增加服務(wù)器的負(fù)載,但是除非用戶的網(wǎng)站每天有幾百萬的訪問用戶,某則服務(wù)器的性能不會有明顯的下降。
不過,如果不是需要在每個頁面都使用SSI的話,確實(shí)沒有必要讓服務(wù)器解析每一個頁面。如果用戶只希望在幾個特殊頁面中使用SSI,可以將文件的后綴名改為.shtml,這樣服務(wù)器就可以只解析包含SSI的.shtml文件。
另一方面,如果有多個頁面使用了SSI,但是用戶不希望使用.shtml的后綴名時,可以在.htaccess文件中使用以下命令行:
AddType text/x-server-parsed-html .html
SSI語法
SSI在使用時遵循以下格式:
<!--#directive parameter="value"-->
其中,directive是向服務(wù)器發(fā)送的指令名稱,parameter是指令的操作對象,而value則是用戶希望得到的指令處理結(jié)果。
所有的SSI命令都是以“<!--#”開始,其中“<!—”和“#”之間不能有任何空格,否則服務(wù)器會把SSI命令當(dāng)稱普通的文件注釋處理,不會顯示出任何結(jié)果,也不會產(chǎn)生錯誤提示。
此外,SSI命令中的“=”兩邊不能有空格,右邊的值必須包含在雙引號內(nèi),后面可以跟空格,最后是結(jié)束標(biāo)簽“-->”。
SSI命令包含六大類指令以及各自的參數(shù),具體如下:
directives parameters
Config errmsg, timefmt, sizefmt
include virtual, file
echo var
fsize file
flastmod file
exec cmd, cgi
下面我們將逐一進(jìn)行介紹。
1.Config命令
Config命令主要用于修改SSI的默認(rèn)設(shè)置。其中:
Errmsg:設(shè)置默認(rèn)錯誤信息。為了能夠正常的返回用戶設(shè)定的錯誤信息,在HTML文件中Errmsg參數(shù)必須被放置在其它SSI命令的前面,否則客戶端只能顯示默認(rèn)的錯誤信息,而不是由用戶設(shè)定的自定義信息.
<!--#config errmsg="Error! Please email webmaster@mydomain.com -->
Timefmt:定義日期和時間的使用格式。Timefmt參數(shù)必須在echo命令之前使用。
<!--#config timefmt="%A, %B %d, %Y"-->
<!--#echo var="LAST_MODIFIED" -->
顯示結(jié)果為:
Wednesday, April 12, 2000
也許用戶對上例中所使用的%A %B %d感到很陌生,下面我們就以表格的形式總結(jié)一下SSI中較為常用的一些日期和時間格式。
格式 說明 實(shí)例
%% %
%a 一周七天的縮寫形式 Thu
%A 一周七天 Thursday
%b 月的縮寫形式 Apr
%B 月 April
%d 一個月內(nèi)的第幾天 13
%D mm/dd/yy日期格式 04/13/00
%H 小時(24小時制,從00到23) 01
%I 小時(12小時制,從00到11) 01
%j 一年內(nèi)的第幾天,從01到365 104
%m 一年內(nèi)的第幾個月,從01到12 04
%M 一小時內(nèi)的第幾分鐘,從00到59 10
%p AM或PM AM
%r 12小時制的當(dāng)?shù)貢r間,格式為 01:10:18 AM
%I:%M:%S AM | PM
%S 一分鐘內(nèi)的第幾秒,從00到59 18
%T 24小時制的%H:%M:%S時間格式 01:10:18
%U 一年內(nèi)的第幾個星期,從00到 15 52,以星期天作為每個星期的第一天
%w 一星期內(nèi)的第一天,從0到6 4
%W 一年內(nèi)的第幾個星期,從00 15 到53,以星期一作為每個星期的第一天
%y 年的縮寫形式,從00到99 00
%Y 用四位數(shù)字表示一年 2000
%Z 時區(qū)名稱 MDT
Sizefmt:決定文件大小是以字節(jié)、千字節(jié)還是兆字節(jié)為單位表示。如果以字節(jié)為單位,參數(shù)值為“bytes”;對于千字節(jié)和兆字節(jié)可以使用縮寫形式。同樣,sizefmt參數(shù)必須放在fsize命令的前面才能使用.
<!--#config sizefmt="bytes" -->
<!--#fsize file="index.html" -->
2.Include命令
Include命令可以把其它文檔中的文字或圖片插入到當(dāng)前被解析的文檔中,是整個SSI的關(guān)鍵所在。通過Include命令只需要改動一個文件就可以瞬間更新整個站點(diǎn)!
Include命令具有兩個不同的參數(shù),如果使用錯誤的參數(shù)更新站點(diǎn)的話,不僅達(dá)不到初衷,反而會得到一大堆的錯誤信息。
Virtual:給出到服務(wù)器端某個文檔的虛擬路徑。例如:
<!--#include virtual="/includes/header.html" -->
File:給出到當(dāng)前目錄的相對路徑,其中不能使用"../",也不能使用絕對路徑。例如:
<!--#include file="header.html" -->
這就要求每一個目錄中都包含一個header.html文件。
為了更加合理的組織站點(diǎn)的內(nèi)容,用戶可以在根目錄下創(chuàng)建includes子目錄來存放所有的包含文件。Virtual參數(shù)可以通知服務(wù)器所要包含的是一個虛擬文件,即文件和當(dāng)前被解析的文檔不是位于同一個目錄,而是存放在其它目錄中。
服務(wù)器會根據(jù)該參數(shù)的值找到根目錄下的includes子目錄。使用這種方法,用戶可以把所有HTML文檔包含的文件放在一個目錄中,而根據(jù)相互之間的關(guān)系把不同的頁面保存在不同的目錄或子目錄中。
無論服務(wù)器解析哪一個文檔都可以找到所包含的文件,不會產(chǎn)生任何錯誤。
不過這里有一個小問題需要解決。一般我們都會在頁面中加入一些TITLE和META標(biāo)簽,如果我們規(guī)定所有的頁面都調(diào)用相同的頁眉文件的話,就顯得很不靈活。
用戶碰到這樣的問題時,可以使用兩個包含文件,一個設(shè)置TITLE標(biāo)簽前的內(nèi)容,另一個設(shè)置META標(biāo)簽后的部分,而在兩個包含文件之間則可以添加任何定制內(nèi)容。例如:
<!--#include virtual="/includes/header1.html" --> <TITLE>Your Page Title</TITLE> <LINK rel = STYLESHEET Type = "text/css" > <META NAME = "Description" CONTENT = " Description of page"> <META NAME = "Keywords" CONTENT = "keywords for page" > <!--#include virtual="/includes/header2.html" -->
這里放置頁面內(nèi)容
<!--#include virtual="/includes/footer.html" -->
從上我們可以看出通過在頁面中包含頁眉和頁腳可以大大減少站點(diǎn)更新的工作量。但是如果我們希望動態(tài)顯示一些內(nèi)容,例如頁面的最后更新時間等該怎么辦呢?沒問題,我們可以把包含文件使用.html后綴保存,這樣就可以在包含文件中調(diào)用其它的包含文件。
File:給出到當(dāng)前目錄的相對路徑,其中不能使用“../”,也不能使用絕對路徑。例如:
<!--#include file="header.html" -->
這就要求每一個目錄中都包含一個header.html文件。當(dāng)然,采用這樣的方法并不比更新每一個頁面簡單多少,但是如果用戶只更新一、兩個文件的話還是很方便的。例如,如果我們不希望讓一個對HTML不熟悉的人直接改動網(wǎng)站中的新聞頁面的話,可以只讓他更新一個單獨(dú)的文本文件,然后再把該文件包含到HMTL文檔中,這樣即不會破壞原頁面,同時又更新了內(nèi)容,兩全其美
3.Echo:
Echo命令可以顯示以下各環(huán)境變量:
DOCUMENT_NAME:顯示當(dāng)前文檔的名稱。
<!--#echo var="DOCUMENT_NAME" -->
顯示結(jié)果為:
index.html
DOCUMENT_URI:顯示當(dāng)前文檔的虛擬路徑。例如:
<!--#echo var="DOCUMENT_URI" -->
顯示結(jié)果為:
/YourDirectory/YourFilename.html
隨著網(wǎng)站的不斷發(fā)展,那些越來越長的URL地址肯定會讓人頭疼。如果使用SSI,一切就會迎刃而解。因?yàn)槲覀兛梢园丫W(wǎng)站的域名和SSI命令結(jié)合在一起顯示完整的URL,即:
http://YourDomain<!--#echo var="DOCUMENT_URI" -->
QUERY_STRING_UNESCAPED:顯示未經(jīng)轉(zhuǎn)義處理的由客戶端發(fā)送的查詢字串,其中所有的特殊字符前面都有轉(zhuǎn)義符“\”。例如:
<!--#echo var="QUERY_STRING_UNESCAPED" -->
DATE_LOCAL:顯示服務(wù)器設(shè)定時區(qū)的日期和時間。用戶可以結(jié)合config命令的timefmt參數(shù),定制輸出信息。例如:
<!--#config timefmt="%A, the %d of %B, in the year %Y" -->
<!--#echo var="DATE_LOCAL" -->
顯示結(jié)果為:
Saturday, the 15 of April, in the year 2000
DATE_GMT:功能與DATE_LOCAL一樣,只不過返回的是以格林尼治標(biāo)準(zhǔn)時間為基準(zhǔn)的日期。例如:
<!--#echo var="DATE_GMT" -->
LAST_MODIFIED:顯示當(dāng)前文檔的最后更新時間。同樣,這是SSI中非常實(shí)用的一個功能,只要在HTML文檔中加入以下這行簡單的文字,就可以在頁面上動態(tài)的顯示更新時間。
<!--#echo var="LAST_MODIFIED" -->
CGI環(huán)境變量
除了SSI環(huán)境變量之外,echo命令還可以顯示以下CGI環(huán)境變量:
SERVER_SOFTWARE:顯示服務(wù)器軟件的名稱和版本。例如:
<!--#echo var="SERVER_SOFTWARE" -->
SERVER_NAME: 顯示服務(wù)器的主機(jī)名稱,DNS別名或IP地址。例如:
<!--#echo var="SERVER_NAME" -->
SERVER_PROTOCOL:顯示客戶端請求所使用的協(xié)議名稱和版本,如HTTP/1.0。例如:
<!--#echo var="SERVER_PROTOCOL" -->
SERVER_PORT:顯示服務(wù)器的響應(yīng)端口。例如:
<!--#echo var="SERVER_PORT" -->
REQUEST_METHOD:顯示客戶端的文檔請求方法,包括GET, HEAD, 和POST。例如:
<!--#echo var="REQUEST_METHOD" -->
REMOTE_HOST:顯示發(fā)出請求信息的客戶端主機(jī)名稱。
<!--#echo var="REMOTE_HOST" -->
REMOTE_ADDR:顯示發(fā)出請求信息的客戶端IP地址。
<!--#echo var="REMOTE_ADDR" -->
AUTH_TYPE:顯示用戶身份的驗(yàn)證方法。
<!--#echo var="AUTH_TYPE" -->
REMOTE_USER:顯示訪問受保護(hù)頁面的用戶所使用的帳號名稱。
<!--#echo var="REMOTE_USER" -->
4.Fsize:
顯示指定文件的大小,可以結(jié)合config命令的sizefmt參數(shù)定制輸出格式。
<!--#fsize file="index_working.html" -->
5.Flastmod:
顯示指定文件的最后修改日期,可以結(jié)合config 命令的timefmt參數(shù)控制輸出格式。
<!--#config timefmt="%A, the %d of %B, in the year %Y" -->
<!--#flastmod file="file.html" -->
這里,我們可以利用flastmod參數(shù)顯示出一個頁面上所有鏈接頁面的更新日期。方法如下:
<!--#config timefmt=" %B %d, %Y" --> <A href="/directory/file.html" rel="external nofollow" >File</A> <!--#flastmod virtual="/directory/file.html" --> <A href="/another_directory/another_file.html" rel="external nofollow" >Another File</A> <!--#flastmod virtual="/another_directory/another_file.html" -->
顯示結(jié)果為:
File April 19, 2000
Another File January 08, 2000
也許有的讀者會認(rèn)為兩個鏈接就這么復(fù)雜,一點(diǎn)也不方便。其實(shí),如果頁面上有20個或者更多的鏈接,而且每個鏈接都定期更新的話,就可以看出使用flastmod顯示修改日期的作用。
6.Exec
Exec命令可以執(zhí)行CGI腳本或者shell命令。使用方法如下:
Cmd:使用/bin/sh執(zhí)行指定的字串。如果SSI使用了IncludesNOEXEC選項(xiàng),則該命令將被屏蔽。
Cgi:可以用來執(zhí)行CGI腳本。例如,下面這個例子中使用服務(wù)端cgi-bin目錄下的counter.pl腳本程序在每個頁面放置一個計(jì)數(shù)器:
<!--#exec cgi="/cgi-bin/counter.pl"-->
相關(guān)文章
WIN2003系統(tǒng)IIS下PHP5+MySQL5+ZendOptimizer配置圖解教程
WIN2003系統(tǒng)IIS下PHP5+MySQL5+ZendOptimizer配置圖解教程...2007-03-03用ISAPI_Rewrite讓IIS也支持如Apache下.htaccess的URL重寫
用ISAPI_Rewrite讓IIS也支持如Apache下.htaccess的URL重寫...2007-02-02win2003 iis6 Rewrite權(quán)限設(shè)置問題 解決了 大家共享 2003NTFS用戶 你不看肯定開不開
win2003 iis6 Rewrite權(quán)限設(shè)置問題 解決了 大家共享 2003NTFS用戶 你不看肯定開不開...2007-07-07windows下Apache+MySql+PHP3+PHP4+PERL安裝配置
這里一定有許多和我一樣喜歡嘗試新鮮事物的朋友,尤其是當(dāng)聽說 某某軟件有了新的版本時一定也會迫不及待的去下載一份回來用用再說。 這里我想和大家探討一下以下流行軟件的應(yīng)用,意在拋磚引玉。2008-03-03