shtml精簡教程

2024-09-08 23:41:17

字體：大中小

來源：轉載

供稿：網友

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文檔的注釋內容之中即可。如：
　　
　　就是一條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指令基本格式
ssi指令基本格式：
程序代碼:

<!-– 指令名稱="指令參數">
<!-– 指令名稱="指令參數">
如
程序代碼:



說明:
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。
將會顯示密碼文件
將會顯示當前目錄下文件列表
將會執行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工廠在淄博熱線的分站http://hoyi.zb169.net。

歡迎光臨好易cgi工廠在太陽城的分站http://linux.cqi.com.cn/~hoyi。

歡迎光臨好易cgi工廠！


歡迎光臨好易cgi工廠在淄博熱線的分站http://hoyi.zb169.net。

歡迎光臨好易cgi工廠在太陽城的分站http://linux.cqi.com.cn/~hoyi。

歡迎光臨好易cgi工廠！

注意：用于前面指令中的反斜杠，是用來代換內部的引號，以便它們不會被解釋為結束表達式。不可省略。
|||

1、config命令

　　config命令主要用于修改ssi的默認設置。其中：

　　errmsg：設置默認錯誤信息。為了能夠正常的返回用戶設定的錯誤信息，在html文件中errmsg參數必須被放置在其它ssi命令的前面，否則客戶端只能顯示默認的錯誤信息，而不是由用戶設定的自定義信息。

　　　　

　　timefmt：定義日期和時間的使用格式。timefmt參數必須在echo命令之前使用。

　　　　
　　　　

　　顯示結果為：

　　　　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

　　query_string_unescaped：顯示未經轉義處理的由客戶端發送的查詢字串，其中所有的特殊字符前面都有轉義符"/"。例如：

　　

　　date_local：顯示服務器設定時區的日期和時間。用戶可以結合config命令的timefmt參數，定制輸出信息。例如：

　　
　

　　顯示結果為：

　　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參數顯示出一個頁面上所有鏈接頁面的更新日期。方法如下：

　　　　
　　　　<a href="/directory/file.html">file</a>
　　　　
　　　　<a href="/another_directory/another_file.html">another file</a>
　　　　
　　顯示結果為：
　　　　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腳本程序在每個頁面放置一個計數器：

上一篇：mod_perl編程的簡單應用實例介紹

下一篇：Perl直接入門詳盡指南