ssi的使用 開啓 配置等

版權聲明:本文爲博主原創文章,未經博主容許不得轉載。 https://blog.csdn.net/lsfhack/article/details/69664402
ssi的定義SSI(Server Side Include),一般稱爲服務器端嵌入,是一種相似於ASP的基於服務器的網頁製做技術。大多數(尤爲是基於Unix平臺)的WEB服務器如Netscape Enterprise Server等均支持SSI命令。另外,在計算機硬件領域SSI是同步串行接口(Synchronous Serial Interface)的英文縮寫。php

SSI工做原理:html

  將內容發送到瀏覽器以前,可使用「服務器端包含 (SSI)」指令將文本、圖形或應用程序信息包含到網頁中。例如,可使用 SSI 包含時間/日期戳、版權聲明或供客戶填寫並返回的表單。對於在多個文件中重複出現的文本或圖形,使用包含文件是一種簡便的方法。將內容存入一個包含文件中便可,而沒必要將內容輸入全部文件。經過一個很是簡單的語句便可調用包含文件,此語句指示 Web 服務器將內容插入適當網頁。並且,使用包含文件時,對內容的全部更改只需在一個地方就能完成。
  由於包含 SSI 指令的文件要求特殊處理,因此必須爲全部 SSI 文件賦予 SSI 文件擴展名。默認擴展名是 .stm、.shtm 和 .shtml
SSI有什麼用?mysql

  之因此要扯到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引用進來的。
  目前,主要有如下幾種用用途:
  一、顯示服務器端環境變量<#echo>
  二、將文本內容直接插入到文檔中<#include>
  三、顯示WEB文檔相關信息<#flastmod #fsize> (如文件製做日期/大小等)
  四、直接執行服務器上的各類程序<#exec>(如CGI或其餘可執行程序)
  五、設置SSI信息顯示格式<#config>(如文件製做日期/大小顯示方式) 高級SSI<XSSI>可設置變量使用if條件語句。
如何使你的Apache服務器支持SSI?linux

  Apache默認是不支持SSI的,須要咱們更改httpd.conf來進行配置。我這裏以windows平臺的Apache 2.0.x爲例:打開conf目錄下的httpd.conf文件,搜索「AddType text/html .shtml」,搜索結果:
  # AddType text/html .shtml
  # AddOutputFilter INCLUDES .shtml
  把這兩行前面的#去掉。
  而後搜索「Options Indexes FollowSymLinks」
  在搜索到的那一行後面添加「 Includes」
  即將該行改變爲:
  Options Indexes FollowSymLinks Includes
  保存httpd.conf,重起apache便可。
  開啓shtml
  打開文件 ./include/config.inc.php <?php
  //數據庫配置信息
  define('DB_HOST', 'localhost'); //數據庫服務器主機地址
  define('DB_USER', 'root'); //數據庫賬號
  define('DB_PW', 'root'); //數據庫密碼
  define('DB_NAME', 'phpcmsutf'); //數據庫名
  define('DB_PRE', 'phpcms_'); //數據庫表前綴,同一數據庫安裝多套Phpcms時,請修改表前綴
  define('DB_CHARSET', 'utf8'); //數據庫字符集
  define('DB_PCONNECT', 0); //0 或1,是否使用持久鏈接
  define('DB_DATABASE', 'mysql'); //數據庫類型
  //網站路徑配置
  define('PHPCMS_PATH', '/cms/phpcms_utf/'); //Phpcms框架訪問路徑,相對於域名
  //shtml 支持
  define('SHTML', 0); //是否支持 shtml,須要服務器支持,而且生成文件擴展名爲 shtml
  將它:
  define('SHTML', 0); //是否支持 shtml,須要服務器支持,而且生成文件擴展名爲 shtml
  改爲:
  define('SHTML', 1); //是否支持 shtml,須要服務器支持,而且生成文件擴展名爲 shtml
使用SSIweb

  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指令基本格式:sql

  程序代碼:
  <!-– 指令名稱="指令參數">
  <!-– 指令名稱="指令參數">
  如 程序代碼:
  <!--#include file="info.htm"-->
  <!--#include file="info.htm"-->
  說明:
  1.<!-- -->是HTML語法中表示註釋,當WEB服務器不支持SSI時,會忽略這些信息。
  2.#include 爲SSI指令之一。
  3.file 爲include的參數, info.htm爲參數值,在本指令中指將要包含的文檔名。
  注意:
  1.<!--與#號間無空格,只有SSI指令與參數間存在空格。
  2.上面的標點="",一個也不能少。
  3.SSI指令是大小寫敏感的,所以參數必須是小寫纔會起做用。
SSI指令使用詳解shell

  #echo 示範
  做用:
  將環境變量插入到頁面中。
  語法:
  程序代碼:
  <!--#echo var="變量名稱"-->
  <!--#echo var="變量名稱"-->
  本文檔名稱:程序代碼:
  <!--#echo var="DOCUMENT_NAME"-->
  <!--#echo var="DOCUMENT_NAME"-->
  如今時間:程序代碼:
  <!--#echo var="DATE_LOCAL"-->
  <!--#echo var="DATE_LOCAL"-->
  你的IP地址是程序代碼:
  <!--#echo var="REMOTE_ADDR"-->
  <!--#echo var="REMOTE_ADDR"-->
  #include 示範
  做用:
  將文本文件的內容直接插入到文檔頁面中。
  語法:
  程序代碼:
  <!--#include file="文件名稱"-->
  <!--#include virtual="文件名稱"-->
  <!--#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 指定相對於服務器文檔根目錄的位置
  注意:
  一、文件名稱必須帶有擴展名。
  二、被包含的文件能夠具備任何文件擴展名,我以爲直接使用htm擴展名最方便,微軟公司推薦使用 .inc 擴展名(這就看你的愛好了)。
  示例:
  程序代碼:
  <!--#include file="nav_head.htm"-->將頭文件插入到當前頁面
  <!--#include file="nav_foot.htm"-->將尾文件插入到當前頁面
  <!--#include file="nav_head.htm"-->將頭文件插入到當前頁面
  <!--#include file="nav_foot.htm"-->將尾文件插入到當前頁面
  #flastmod 和#fsize 示範
  做用: #flastmod 文件最近更新日期
  #fsize 文件的長度
  語法:
  程序代碼:
  <!--#flastmod file="文件名稱"-->
  <!--#fsize file="文件名稱"-->
  <!--#flastmod file="文件名稱"-->
  <!--#fsize file="文件名稱"-->
  參數:
  file 指定包含文件相對於本文檔的位置 如 info.txt 表示當前目錄下的的info.txt文檔
  virtual 指定相對於服務器文檔根目錄的位置 如 /hoyi/info.txt 表示
  注意:
  文件名稱必須帶有擴展名。
  示例:
  程序代碼:
  <!--#flastmod file="news.htm"-->
  <!--#flastmod file="news.htm"-->
  將當前目錄下news.htm文件的最近更新日期插插入到當前頁面
  程序代碼:
  <!--#fsize file="news.htm"-->
  <!--#fsize file="news.htm"-->
  將當前目錄下news.htm的文件大小入到當前頁面
  #exec 示範
  做用:
  將某一外部程序的輸出插入到頁面中。可插入CGI程序或者是常規應用程序的輸入,這取決於使用的參數是cmd仍是cgi。
  語法:
  程序代碼:
  <!--#exec cmd="文件名稱"-->
  <!--#exec 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。
  <!--#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。
  注意:
  從上面的示例能夠看出,這個指令至關方便,可是也存在安全問題。
  禁止方法:
  .Apache,將access.conf中的"Options Includes ExecCGI"這行代碼刪除;
  .在IIS中,要禁用 #exec 命令,可修改 SSIExecDisable 元數據庫;
  #config
  做用: 指定返回給客戶端瀏覽器的錯誤信息、日期和文件大小的格式。
  語法:
  程序代碼:
  <!--#config errmsg="自定義錯誤信息"-->
  <!--#config sizefmt="顯示單位"-->
  <!--#config timefmt="顯示格式"-->
  <!--#config errmsg="自定義錯誤信息"-->
  <!--#config sizefmt="顯示單位"-->
  <!--#config timefmt="顯示格式"-->
  參數:
  errmsg 自定義SSI執行錯誤信息,能夠爲任何你喜歡的方式。
  sizefmt 文件大小顯示方式,默認爲字節方式("bytes")能夠改成千字節方式("abbrev")
  timefmt 時間顯示方式,最靈活的配置屬性。
  示例: 顯示一個不存在文件的大小
  程序代碼:
  <!--#config errmsg="服務器執行錯誤,請聯繫管理員 yiho@126.com,謝謝!"-->
  <!--#fsize file="不存在的文件.htm"-->
  <!--#config errmsg="服務器執行錯誤,請聯繫管理員 yiho@126.com,謝謝!"-->
  <!--#fsize file="不存在的文件.htm"-->
  以千字節方式顯示文件大小
  程序代碼:
  <!--#config sizefmt="abbrev"-->
  <!--#fsizefile="news.htm"-->
  <!--#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"-->
  <!--#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-->
  <!--#printenv-->
  <!--#printenv-->
  <!--#printenv-->
  #set
  做用:可給變量賦值,以用於後面的if語句。
  語法:程序代碼:
  <!--#set var="變量名"value="變量值"-->
  <!--#set var="變量名"value="變量值"-->
  參數:無
  示例: 程序代碼:
  <!--#set var="color"value="紅色"-->
  <!--#set var="color"value="紅色"-->
  #if
  做用: 建立能夠改變數據的頁面,這些數據根據使用if語句時計算的要求予以顯示。
  語法: 程序代碼:
  <!--#if expr="$變量名=\"變量值A\""-->
  顯示內容
  <!--#elif expr="$變量名=\"變量值B\""-->
  顯示內容
  <!--#else-->
  顯示內容
  <!--#endif"-->
  <!--#if expr="$變量名=\"變量值A\""-->
  顯示內容
  <!--#elif expr="$變量名=\"變量值B\""-->
  顯示內容
  <!--#else-->
  顯示內容
  <!--#endif"-->
  示例:
  程序代碼:
  <!--#if expr="$SERVER_NAME=\"hoyi.zb169.net\""-->
  歡迎光臨好易CGI工廠在淄博熱線的分站http://hoyi.zb169.net。
  <!--#elif expr="$SERVER_NAME=\"linux.cqi.com.cn\"" -->
  歡迎光臨好易CGI工廠在太陽城的分站http://linux.cqi.com.cn/~hoyi。
  <!--#else-->
  歡迎光臨好易CGI工廠!
  <!--#endif"-->
  <!--#if expr="$SERVER_NAME=\"hoyi.zb169.net\""-->
  歡迎光臨好易CGI工廠在淄博熱線的分站http://hoyi.zb169.net。
  <!--#elif expr="$SERVER_NAME=\"linux.cqi.com.cn\"" -->
  歡迎光臨好易CGI工廠在太陽城的分站http://linux.cqi.com.cn/~hoyi。
  <!--#else-->
  歡迎光臨好易CGI工廠!
  <!--#endif"-->
  注意: 用於前面指令中的反斜槓,是用來代換內部的引號,以便它們不會被解釋爲結束表達式。不可省略。
  一、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:決定文件大小是以字節、千字節仍是兆字節爲單位表示。若是以字節爲單位,參數值爲"bytes";對於千字節和兆字節可使用縮寫形式。一樣,sizefmt參數必須放在fsize命令的前面才能使用。
  <!--#config sizefmt="bytes" -->
  <!--#fsize file="index.html" -->
  二、Include命令
  Include命令能夠把其它文檔中的文字或圖片插入到當前被解析的文檔中,這是整個SSI的關鍵所在。經過Include命令只須要改動一個文件就能夠瞬間更新整個站點!
  Include命令具備兩個不一樣的參數:
  Virtual:給出到服務器端某個文檔的虛擬路徑。例如:
  <!--#include virtual="/includes/header.html" -->
  File:給出到當前目錄的相對路徑,其中不能使用"../",也不能使用絕對路徑。例如:
  <!--#include file="header.html" -->
  這就要求每個目錄中都包含一個header.html文件。
  三、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_D:顯示未經轉義處理的由客戶端發送的查詢字串,其中全部的特殊字符前面都有轉義符"\"。例如:
  <!--#echo var="QUERY_STRING_D" -->
  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" -->
  四、Fsize:顯示指定文件的大小,能夠結合config命令的sizefmt參數定製輸出格式。
  <!--#fsize file="index_working.html" -->
  五、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
  六、Exec
  Exec命令能夠執行CGI腳本或者shell命令。使用方法以下:
  Cmd:使用/bin/sh執行指定的字串。若是SSI使用了IncludesNOEXEC選項,則該命令將被屏蔽。
  Cgi:能夠用來執行CGI腳本。例如,下面這個例子中使用服務端cgi-bin目錄下的counter.pl腳本程序在每一個頁面放置一個計數器:
  <!--#exec cgi="/cgi-bin/counter.pl" -->
  SSI也能夠表示爲單一系統映像(Single Systerm Image),主要應用於集羣系統。
---------------------
做者:lsfhack
來源:CSDN
原文:https://blog.csdn.net/lsfhack/article/details/69664402
版權聲明:本文爲博主原創文章,轉載請附上博文連接!數據庫

相關文章
相關標籤/搜索