SHTML完全教程

來源:互聯網
上載者:User
教程|shtml

什麼是 SHTML

使用SSI(Server Side Include)的html副檔名,SSI(Server Side Include),通常稱為“伺服器端嵌入”或者叫“伺服器端包含”,是一種類似於ASP的基於伺服器的網頁製作技術。

SSI工作原理:

將內容發送到瀏覽器之前,可以使用“伺服器端包含 (SSI)”指令將文本、圖形或應用程式資訊包含到網頁中。例如,可以使用 SSI 包含時間/日期戳、著作權聲明或供客戶填寫並返回的表單。對於在多個檔案中重複出現的文本或圖形,使用包含檔案是一種簡便的方法。將內容存入一個包含檔案中即可,而不必將內容輸入所有檔案。通過一個非常簡單的語句即可調用包含檔案,此語句指示 Web 服務器將內容插入適當網頁。而且,使用包含檔案時,對內容的所有更改只需在一個地方就能完成。

因為包含 SSI 指令的檔案要求特殊處理,所以必須為所有 SSI 檔案賦予 SSI 副檔名。預設副檔名是 .stm、.shtm 和 .shtml。

Web 服務器在處理網頁的同時處理 SSI 指令。當 Web 服務器遇到 SSI 指令時,直接將包含檔案的內容插入 HTML 網頁。如果“包含檔案”中包含 SSI 指令,則同時插入此檔案。除了用於包含檔案的基本指令之外,還可以使用 SSI 指令插入檔案的相關資訊(如檔案的大小)或者運行應用程式或 shell 命令。

網站維護常常碰到的一個問題是,網站的結構已經固定,卻為了更新一點內容而不得不重做一大批網頁。SSI提供了一種簡單、有效方法來解決這一問題,它將一個網站的基本結構放在幾個簡單的HTML檔案中(模板),以後我們要做的只是將文本傳到伺服器,讓程式按照模板自動產生網頁,從而使管理大型網站變得容易。

所以,利用SHTML格式的頁面目的和 ASP 差不多,但是因為是 API 所以運轉速度更快,效率更高,比ASP快,比HTML慢,但由於可以使用伺服器端包含,因此使頁面更新容易(特別是批次更新banner,著作權等),想象一下吧,你有一段 HTML,要在中間穿插一些特殊的服務端指令碼,比如插入其他 HTML 段落,你選擇 ASP 來完成這個任務,但是如果任務更繁重,需要更多的時間,比如 5 s,這個時候你不用 ASP 而用  SHTML,或許處理時間就只用 4s 了。

SSI有什麼用?

之所以要扯到 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<XSSI>可設定變數使用if條件陳述式。

使用SSI

SSI是為WEB伺服器提供的一套命令,這些命令只要直接嵌入到HTML文檔的注釋內容之中即可。如:

<!--#include file="info.htm"-->

就是一條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如:

AddType text/x-server-parsed-html .shtml 將只對.shtml副檔名的檔案解析SSI指令
AddType text/x-server-parsed-html .html 將對所有HTML文檔解析SSI指令

Netscape WEB伺服器直接使用 Administration Server(管理伺服器)可開啟SSI功能。
Website 使用 Server Admin 程式中的 Mapping 標籤,副檔名新增內容類型為:wwwserver/html-ssi
Cern 伺服器不支援SSI,可用SSI詐騙法,到 http://sw.cse.bris.ac.uk/WebTools/fakessi.html 上下載一個PERL指令碼,即可使你的CERN伺服器使用一些SSI指令。(不支援exec指令。)

SSI指令基本格式

程式碼:

<!-- 指令名稱="指令參數">

樣本:

<!--#include file="info.htm"-->

說明:

  1. <!-- -->是HTML文法中表示注釋,當WEB伺服器不支援SSI時,會忽略這些資訊。
  2. #include 為SSI指令之一。
  3. file 為include的參數, info.htm為參數值,在本指令中指將要包含的文檔名。

注意:

  1. <!--與#號間無空格,只有SSI指令與參數間存在空格。
  2. 上面的標點="",一個也不能少。
  3. SSI指令是大小寫敏感的,因此參數必須是小寫才會起作用。

SSI指令使用詳解

#echo 示範

作用:將環境變數插入到頁面中。

文法:

<!--#echo var="變數名稱"-->

樣本:

<!--#echo var="DOCUMENT_NAME"--> 本文檔名稱
<!--#echo var="DATE_LOCAL"--> 現在時間
<!--#echo var="REMOTE_ADDR"--> 你的IP地址

#include 示範

作用:將文字檔的內容直接插入到文檔頁面中。

文法:

<!--#include file="檔案名稱"-->
<!--#include virtual="檔案名稱"-->

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 副檔名(這就看你的愛好了)。

樣本:

<!--#include file="nav_head.htm"--> 將標頭檔插入到當前頁面
<!--#include file="nav_foot.htm"--> 將尾檔案插入到當前頁面

#flastmod 和 #fsize 示範

作用:

#flastmod 檔案最新動向日期
#fsize 檔案的長度

文法:

<!--#flastmod file="檔案名稱"-->
<!--#fsize file="檔案名稱"-->

參數:

file 指定包含檔案相對於本文檔的位置 如 info.txt 表示目前的目錄下的的info.txt文檔
virtual 指定相對於伺服器主目錄的位置 如 /hoyi/info.txt 表示

注意:檔案名稱必須帶有副檔名。

樣本:

<!--#flastmod file="news.htm"--> 將目前的目錄下news.htm檔案的最新動向日期插插入到當前頁面
<!--#fsize file="news.htm"--> 將目前的目錄下news.htm的檔案大小入到當前頁面

#exec 示範

作用:將某一外部程式的輸出插入到頁面中。可插入CGI程式或者是常規應用程式的輸入,這取決於使用的參數是cmd還是cgi。

文法:

<!--#exec cmd="檔案名稱"-->
<!--#exec cgi="檔案名稱"-->

參數:

cmd 常規應用程式
cgi CGI指令碼程式

樣本:

<!--#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。

注意:從上面的樣本可以看出,這個指令相當方便,但是也存在安全問題。

禁止方法:

  1. Apache,將access.conf中的"Options Includes ExecCGI"這行代碼刪除;
  2. 在IIS中,要禁用 #exec 命令,可修改 SSIExecDisable 中繼資料庫;

#config

作用: 指定返回給用戶端瀏覽器的錯誤資訊、日期和檔案大小的格式。

文法:

<!--#config errmsg="自訂錯誤資訊"-->
<!--#config sizefmt="顯示單位"-->
<!--#config timefmt="顯示格式"-->

參數:

errmsg 自訂SSI執行錯誤資訊,可以為任何你喜歡的方式。
sizefmt 檔案大小顯示方式,預設為位元組方式("bytes")可以改為KB方式("abbrev")
timefmt 時間顯示方式,最靈活的配置屬性。

樣本:顯示一個不存在檔案的大小

<!--#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"-->

XSSI

XSSI(Extended SSI)是一組進階SSI指令,內建於Apache 1.2或更高版本的mod-include模組之中。其中可利用的的指令有:

#printenv
#set
#if

#printenv

作用: 顯示當前存在於WEB伺服器環境中的所有環境變數。

文法:

<!--#printenv-->

#set

作用:可給變數賦值,以用於後面的if語句。

文法:

<!--#set var="變數名" value="變數值"-->

樣本:

<!--#set var="color" value="紅色"-->

#if

作用:建立可以改變資料的頁面,這些資料根據使用if語句時計算的要求予以顯示。

文法:

<!--#if expr="$變數名=\"變數值A\""-->
  顯示內容
<!--#elif expr="$變數名=\"變數值B\""-->
  顯示內容
<!--#else-->
  顯示內容
<!--#endif"-->

樣本:

<!--#if expr="$SERVER_NAME=\"www.baidu.com\""-->
  歡迎光臨 http://www.baidu.com
<!--#elif expr="$SERVER_NAME=\"www.google.com\"" -->
  歡迎光臨 http://www.google.com
<!--#else-->
  歡迎光臨 Afly's Blog!
<!--#endif"-->

注意:用於前面指令中的反斜線,是用來代換內部的引號,以便它們不會被解釋為結束運算式。不可省略。

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中較為常用的一些日期和時間格式。

Sizefmt:決定檔案大小是以位元組、KB還是MB為單位表示。如果以位元組為單位,參數值為"bytes";對於KB和MB可以使用縮寫形式。同樣,sizefmt參數必須放在fsize命令的前面才能使用。

<!--#config sizefmt="bytes" -->
<!--#fsize file="index.html" -->

2、Include 命令

Include 命令可以把其它文檔中的文字或圖片插入到當前被解析的文檔中,這是整個SSI的關鍵所在。通過Include命令只需要改動一個檔案就可以瞬間更新整個網站!

Include 命令具有兩個不同的參數:

Virtual:給出到伺服器端某個文檔的虛擬路徑。
File:給出到目前的目錄的相對路徑,其中不能使用"../",也不能使用絕對路徑。

<!--#include virtual="/includes/header.html" -->
<!--#include file="header.html" --> 這就要求每一個目錄中都包含一個header.html檔案。

3、Echo 命令

Echo 命令可以顯示以下各環境變數:

DOCUMENT_NAME:顯示當前文檔的名稱。
DOCUMENT_URI:顯示當前文檔的虛擬路徑。例如:

<!--#echo var="DOCUMENT_NAME" -->
<!--#echo var="DOCUMENT_URI" -->

隨著網站的不斷髮展,那些越來越長的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

6、Exec

Exec命令可以執行CGI指令碼或者shell命令。使用方法如下:

Cmd:使用/bin/sh執行指定的字串。如果SSI使用了IncludesNOEXEC選項,則該命令將被屏蔽。
Cgi:可以用來執行CGI指令碼。例如,下面這個例子中使用服務端cgi-bin目錄下的counter.pl指令碼程式在每個頁面放置一個計數器:

<!--#exec cgi="/cgi-bin/counter.pl" -->

關於SHTML和HTML的區別

讓我們先來看看SHTML和HTML的區別,如果用一句話來解釋就是:SHTML 不是HTML而是一種伺服器 API,shtml是伺服器動態產成的html.

雖然兩者都是超文字格式設定,但shtml是一種用於SSI技術的檔案。也就是Server Side Include--SSI 伺服器端包含指令。如果Web Server有SSI功能的話,大多數(尤其是基於Unix平台)的WEB伺服器,如Netscape Enterprise Server等均支援SSI命令。



相關關鍵詞:
相關文章

Alibaba Cloud 10 Year Anniversary

With You, We are Shaping a Digital World, 2009-2019

Learn more >

Apsara Conference 2019

The Rise of Data Intelligence, September 25th - 27th, Hangzhou, China

Learn more >

Alibaba Cloud Free Trial

Learn and experience the power of Alibaba Cloud with a free trial worth $300-1200 USD

Learn more >

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。