SSI[編程指令]:SSI是編程指令。基本信息中文名：編程 -百科知識中文網

格式

程式代碼：

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

如程式代碼：

說明：

1．；是HTML語法中表示注釋，當WEB伺服器不支持SSI時，會忽略這些信息。

2．#include為SSI指令之一。

3．file為include的參數，info.htm為參數值，在本指令中指將要包含的文檔名。

注意：

1．<!--與#號間無空格，只有SSI指令與參數間存在空格。

2．上面的標點=""，一個也不能少。

3．SSI指令是大小寫敏感的，因此參數必須是小寫才會起作用。

使用詳解

#echo示範

作用：

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

語法：

程式代碼：

本文檔名稱：程式代碼：

時間：程式代碼：

你的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擴展名（這就看你的愛好了）。[3]

示例：

程式代碼：

；將頭檔案插入到當前頁面

；將尾檔案插入到當前頁面

；將頭檔案插入到當前頁面

；將尾檔案插入到當前頁面

#flastmod和#fsize示範

作用：#flastmod檔案更新日期

#fsize檔案的長度

語法：

程式代碼：

參數：

file指定包含檔案相對於本文檔的位置如info.txt表示當前目錄下的的info.txt文檔

virtual指定相對於伺服器文檔根目錄的位置如/hoyi/info.txt表示

注意：

檔案名稱稱必須帶有擴展名。

示例：

程式代碼：

將當前目錄下news.htm檔案的更新日期插插入到當前頁面

程式代碼：

將當前目錄下news.htm的檔案大小入到當前頁面

#exec示範

作用：

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

語法：

程式代碼：

參數：

cmd常規應用程式

cgiCGI腳本程式

示例：

程式代碼：

；將會顯示密碼檔案

；將會顯示當前目錄下檔案列表

；將會執行CGI程式gb.cgi。

；將會執行CGI程式access_log.cgi。

；將會顯示密碼檔案

；將會顯示當前目錄下檔案列表

；將會執行CGI程式gb.cgi。

；將會執行CGI程式access_log.cgi。

注意：

從上面的示例可以看出，這個指令相當方便，但是也存在安全問題。

禁止方法：

．Apache，將access.conf中的"OptionsIncludesExecCGI"這行代碼刪除；

．在IIS中，要禁用#exec命令，可修改SSIExecDisable元資料庫；

#config

作用：指定返回給客戶端瀏覽器的錯誤信息、日期和檔案大小的格式。

語法：

程式代碼：

參數：

errmsg自定義SSI執行錯誤信息，可以為任何你喜歡的方式。

sizefmt檔案大小顯示方式，默認為位元組方式（"bytes")可以改為千位元組方式（"abbrev")

timefmt時間顯示方式，最靈活的配置屬性。

示例：顯示一個不存在檔案的大小

程式代碼：

以千位元組方式顯示檔案大小

程式代碼：

以特定的時間格式顯示時間

程式代碼：

顯示今天是星期幾，幾月，時區

顯示今天是星期幾，幾月，時區

XSSI

XSSI（ExtendedSSI）是一組高級SSI指令，內置於Apache1.2或更高版本的mod-include模組之中。

其中可利用的的指令有：

#printenv

#set

#if

#printenv

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

語法：程式代碼：

#set

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

語法：程式代碼：

參數：無

示例：程式代碼：

#if

作用：創建可以改變數據的頁面，這些數據根據使用if語句時計算的要求予以顯示。

語法：程式代碼：

顯示內容

顯示內容

顯示內容

顯示內容

顯示內容

顯示內容

示例：

程式代碼：

<!--#ifexpr="$SERVER_NAME歡迎光臨好易CGI工廠在淄博熱線的分站。

<!--#elifexpr="$SERVER_NAME歡迎光臨好易CGI工廠在太陽城的分站。

歡迎光臨好易CGI工廠！

歡迎光臨好易CGI工廠在淄博熱線的分站。

歡迎光臨好易CGI工廠在太陽城的分站。

歡迎光臨好易CGI工廠！

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

1、Config命令

Config命令主要用於修改SSI的默認設定。其中：

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

<!--#configerrmsg="Error!Pleaseemail

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

顯示結果為：

Wednesday,April12,2000

也許用戶對上例中所使用的%A%B%d感到很陌生，下面我們就以表格的形式總結一下SSI中較為常用的一些日期和時間格式。

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

[2]

2、Include命令

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

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

Virtual：給出到伺服器端某個文檔的虛擬路徑。例如：

File：給出到當前目錄的相對路徑，其中不能使用"../"，也不能使用絕對路徑。例如：

這就要求每一個目錄中都包含一個header.html檔案。[3]

3、Echo命令

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

DOCUMENT_NAME：顯示當前文檔的名稱。

顯示結果為：

index.html

DOCUMENT_URI：顯示當前文檔的虛擬路徑。例如：

顯示結果為：

/YourDirectory/YourFilename.html

隨著網站的不斷發展，那些越來越長的URL地址肯定會讓人頭疼。如果使用SSI，一切就會迎刃而解。因為我們可以把網站的域名和SSI命令結合在一起顯示完整的URL，即：

http://yourdomain<;!--#echovar="DOCUMENT_URI"-->

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

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

顯示結果為：

Saturday,the15ofApril,intheyear2000

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：顯示訪問受保護頁面的用戶所使用的帳號名稱。

[2]

4、Fsize命令

顯示指定檔案的大小，可以結合config命令的sizefmt參數定製輸出格式。

[2]

5、Flastmod命令

顯示指定檔案的最後修改日期，可以結合config命令的timefmt參數控制輸出格式。

這裡，我們可以利用flastmod參數顯示出一個頁面上所有連結頁面的更新日期。方法如下：

<AHREF="/directory/file.html">File</A>

<AHREF="/another_directory/another_file.html">AnotherFile</A>

顯示結果為：

FileApril19,2000

AnotherFileJanuary08,2000[2]

6、Exec命令

Exec命令可以執行CGI腳本或者shell命令。使用方法如下：

Cmd：使用/bin/sh執行指定的字串。如果SSI使用了IncludesNOEXEC選項，則該命令將被禁止。

Cgi：可以用來執行CGI腳本。例如，下面這個例子中使用服務端cgi-bin目錄下的腳本程式在每個頁面放置一個計數器：

SSI[編程指令]

基本信息

格式

使用詳解

相關詞條

shtml

ApacheTomcat6高級編程

《Web資料庫編程與套用》

Tomcat與JavaWeb開發技術詳解

Csharp

3D API

Linux系統與網路管理教程(第2版)

嵌入式快閃記憶體

JSP虛擬主機

熱門詞條