SSI指令

 

1.SSI定义

  SSI是英文Server Side Includes的缩写, 即“服务器端包含”或“服务器端嵌入”技术。

  SSI在HTML文件中,可以通过注释行调用的命令或指针,是一种基于服务器端的网页制作技术。shtml文件就是应用了SSI技术的html文件SSI工作原理因为是基于服务器端的网页制作技术,所以在.shtml页面返回到客户端前,页面中的SSI指令将被服务器解析,在给客户端返回的页面中不会包含SSI指令。如果SSI指令不能被解析,则浏览器会将其做为普通的HTML注释处理。

  SSI的速度介于类似于.asp与.html之间。比.asp快,但比.html慢。SSI能使页面在维护的时候更简单,维护的效率也更高。

 

2.SSI指令基本格式
基本格式:<!--指令名称="指令参数">

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

说明:

  1.<!-- -->是HTML语法中表示注释,当WEB服务器不支持SSI时,会忽略这些信息。

  2.#include 为SSI指令之一。

  3.file为include的参数,info.htm为参数值,在本指令中指将要包含的文档名。

注意:

  1.<!--与#号间无空格,只有SSI指令与参数间存在空格。

  2.上面的标点="",一个也不能少。

  3.SSI指令是大小写敏感的,因此参数必须是小写才会起作用(经过测试大写也可以)。

 

3.SSI语法

1、config指令:用于修改SSI的默认设置

参数:errmsg, timefmt, sizefmt

errmsg:设置默认的错误信息,该指令必须入在其它指令的前面

eg:<!--#config errmsg="error!please email mamager!"-->

Timefmt:设置日期与时间的显示格式,需放在echo指令前

eg:<!--#config timefmt="%A, %B %d, %Y"-->

  <!--#echo var="last_modified"-->

Sizefmt:设置表示文件大小的单位。如bytes。该指令需要放在fsize指令前使用。

eg:<!--#config sizefmt="bytes"-->

  <!--#fsize file="head.html"-->

 

2、Include指令:用于将其它文档或元素包含在当前文档中

参数:virtual ,file

virtual:给出到服务器端某个文档的虚拟路径

eg:<!--include virtual="/includes/header.html"-->

file:给出到当前目录的相对路径,其中不能使用"../",也不能使用绝对路径

eg:<!--include file="header.html"-->

这就要求每一个目录中都包含一个header.html文件。

 

3exec指令:将某一外部程序的输出插入到页面中,执行 CGI 脚本或者 shell 命令

参数:cmd,cgi

cmd 常规应用程序:<!--#exec cmd="文件名称"-->

cgi CGI脚本程序:<!--#exec cgi="文件名称"-->

注意:这个指令相当方便,但是也存在安全问题。

 

4Echo:用于显示各种环境变量

参数:var

eg:<!--#config timefmt="%A,the %d of %B,in the year %Y"-->

  <!--#echo var="DATE_LOCAL"-->

输出结果:Saturday, the 15 of April, in the year 2000

以下是常见的服务器变量:

DOCUMENT_NAME:显示当前文档的名称

DOCUMENT_URI:显示当前文档的虚拟路径

QUERY_STRING_UNESCAPED:显示未经转义处理的由客户端发送的查询字串,其中所有的特殊字符前面都有转义符"\

DATE_LOCAL:显示服务器设定时区的日期和时间。用户可以结合config命令的timefmt参数,定制输出信息

DATE_GMT:功能与DATE_LOCAL一样,只不过返回的是以格林尼治标准时间为基准的日期

LAST_MODIFIED:显示当前文档的最后更新时间

除了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:显示访问受保护页面的用户所使用的帐号名称

 

5Fsize:显示指定文件的大小,可以结合config命令的sizefmt参数定制输出格式

参数:file

eg:<!--#fsize file="index_working.html"-->

Sizefmt:决定文件大小是以字节、千字节还是兆字节为单位表示。如果以字节为单位,参数值为 "bytes";对于千字节和兆字节可以使用缩写形式。同样,sizefmt 参数必须放在 fsize 命令的前面才能使用。

eg:<!--#config sizefmt="bytes"-->

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

 

6Flastmod:显示指定文件的最后修改日期,可以结合config 命令的timefmt参数控制输出格式

参数:file

eg:<!--#config timefmt="%A, the %d of %B, in the year %Y"-->

  <!--#flastmod file="file.html"-->

 

XSSI(Extended SSI)是一组高级SSI指令,内置于Apache1.2或更高版本的mod-include模块之中。
#printenv:显示当前存在于WEB服务器环境中的所有环境变量。
语法:<!--#printenv-->

#set:可给变量赋值,以用于后面的if语句。
语法:<!--#set var="变量名" value="变量值"-->
eg:
<!--#set var="color" value="red"-->
<!--#echo var="color"-->

#if:创建可以改变数据的页面,这些数据根据使用if语句时计算的要求予以显示。
语法:
<!--#if expr="$变量名='变量值A'"-->
  显示内容
<!--#elif expr="$变量名='变量值B'"-->
  显示内容
<!--#else-->
  显示内容
<!--#endif-->
eg:
<!--#if expr="$color='red'"-->
    红色
<!--#elif expr="$color='blue'"-->
    蓝色
<!--#else-->
    黑色
<!--#endif-->

 

SSI内置的变量:
  AUTH_TYPE ——针对用户的认证授权方式: BASIC , FORM , etc. 和 Tomcat 内的认证方式同步
  CONTENT_LENGTH ——从服务器表单传过来的数据长度,字符数目或者数据的字节数
  CONTENT_TYPE ——服务器访问呢数据的 MIME 类型,比如“ text/html ”
  DATE_GMT ——目前的时间格式方式使用 GMT
  DATE_LOCAL ——目前的时间格式方式设置成为本地时间格式
  DOCUMENT_NAME ——当前上下文环境的文件地址
  DOCUMENT_URI ——虚拟路径定义的文件地址
  GATEWAY_INTERFACE —— CGI 的版本定义:“ CGI/1.1 ”
  HTTP_ACCEPT ——一个客户端可以接受的 MIME 类型列表
  HTTP_ACCEPT_ENCODING ——客户端可以接受的压缩文件类型的列表
  HTTP_ACCEPT_LANGUAGE ——客户端可以支持的语言列表
  HTTP_CONNECTION ——管理客户端的连接:是“ Close ”还是“ Keep-Alive ”
  HTTP_HOST ——客户端请求的站点地址
  HTTP_REFERER ——客户端请求之前所在的 URL 地址
  HTTP_USER_AGENT ——客户使用的浏览器端的请求结果
  LAST_MODIFIED ——当前页面上一次访问和修改的时间
  PATH_INFO ——访问此 Servlet 的路径信息
  PATH_TRANSLATED —— PATH_INFO 提供的 translated 版本
  QUERY_STRING ——在 URL 地址 ? 之后的请求参数列表
  QUERY_STRING_D ——没有经过编码过的请求参数
  REMOTE_ADDR ——用户请求客户端 IP 地址
  REMOTE_HOST ——用户发送请求的主机名
  REMOTE_PORT ——用户发送请求的端口号
  REMOTE_USER ——认证授权需要的发送请求的用户名
  REQUEST_METHOD ——请求使用方法: GET 或者 POST
  REQUEST_URI ——客户端原来访问请求的 Web 页面的 URI 地址
  SCRIPT_FILENAME ——在服务器上当前页面的地址
  SCRIPT_NAME ——当前页面的名称
  SERVER_ADDR ——服务器所在的 IP 地址
  SERVER_NAME ——服务器的主机名或者 IP 地址
  SERVER_PORT ——服务器接受请求的端口号
  SERVER_PROTOCOL ——服务器处理请求的协议:“ HTTP/1.1 ”
  SERVER_SOFTWARE ——服务器响应客户端请求的名称和版本号

SSI中日期格式的定义:
     %a 一周七天的缩写形式 Thu
    %A 一周七天 Thursday
    %b 月的缩写形式 Apr
    %B 月 April
    %d 一个月内的第几天 13
    %D mm/dd/yy日期格式 04/13/00
    %H 小时(24小时制,从00到23) 01
    %I 小时(12小时制,从00到11) 01
    %j 一年内的第几天,从01到365 104
    %m 一年内的第几个月,从01到12 04
    %M 一小时内的第几分钟,从00到59 10
    %p AM或PM AM
    %r 12小时制的当地时间,格式为 01:10:18 AM
    %S 一分钟内的第几秒,从00到59 18
    %T 24小时制的%H:%M:%S时间格式 01:10:18
    %U 一年内的第几个星期,从00到52,以星期天作为每个星期的第一天
    %w 一星期内的第一天,从0到6 4
    %W 一年内的第几个星期,从00到 53,以星期一作为每个星期的第一天
    %y 年的缩写形式,从00到99 00
    %Y 用四位数字表示一年 2000
    %Z 时区名称 MDT

 

posted @ 2016-04-28 14:40  爱笑的蛙蛙  阅读(2010)  评论(0编辑  收藏  举报