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文件。
3、exec指令:将某一外部程序的输出插入到页面中,执行 CGI 脚本或者 shell 命令
参数:cmd,cgi
cmd 常规应用程序:<!--#exec cmd="文件名称"-->
cgi CGI脚本程序:<!--#exec cgi="文件名称"-->
注意:这个指令相当方便,但是也存在安全问题。
4、Echo:用于显示各种环境变量
参数: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:显示访问受保护页面的用户所使用的帐号名称
5、Fsize:显示指定文件的大小,可以结合config命令的sizefmt参数定制输出格式
参数:file
eg:<!--#fsize file="index_working.html"-->
Sizefmt:决定文件大小是以字节、千字节还是兆字节为单位表示。如果以字节为单位,参数值为 "bytes";对于千字节和兆字节可以使用缩写形式。同样,sizefmt 参数必须放在 fsize 命令的前面才能使用。
eg:<!--#config sizefmt="bytes"-->
<!--#fsize file="index.html"-->
6、Flastmod:显示指定文件的最后修改日期,可以结合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