ssi基本语法

SSI语法

SSI在使用时遵循以下格式：

$#@60;!--#directive parameter="value"--$#@62;

　　其中，directive是向服务器发送的指令名称，parameter是指令的操作对象，而value则是用户希望得到的指令处理结果。
　　所有的SSI命令都是以“$#@60;!--#”开始，其中“$#@60;!—”和“#”之间不能有任何空格，否则服务器会把SSI命令当称普通的文件注释处理，不会显示出任何结果，也不会产生错误提示。此外，SSI命令中的“=”两边不能有空格，右边的值必须包含在双引号内，后面可以跟空格，最后是结束标签“--$#@62;”。

SSI命令包含六大类指令以及各自的参数，具体如下：


directives
 parameters
 
Config
 errmsg, timefmt, sizefmt
 
include
 virtual, file
 
echo
 var
 
fsize
 file
 
flastmod
 file
 
exec
 cmd, cgi
 


下面我们将逐一进行介绍。


1.Config命令

Config命令主要用于修改SSI的默认设置。其中：

　　Errmsg：设置默认错误信息。为了能够正常的返回用户设定的错误信息，在HTML文件中Errmsg参数必须被放置在其它SSI命令的前面，否则客户端只能显示默认的错误信息，而不是由用户设定的自定义信息。

$#@60;!--#config errmsg="Error! Please email [e-mail]--$#@62;

　　Timefmt：定义日期和时间的使用格式。Timefmt参数必须在echo命令之前使用。

$#@60;!--#config timefmt="%A, %B %d, %Y"--$#@62;

$#@60;!--#echo var="LAST_MODIFIED" --$#@62;

显示结果为：

Wednesday, April 12, 2000

也许用户对上例中所使用的%A %B %d感到很陌生，下面我们就以表格的形式总结一下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小时制的当地时间，格式为%I:%M:%S AM | PM
 01:10:18 AM
 
%S
 一分钟内的第几秒，从00到59
 18
 
%T
 24小时制的%H:%M:%S时间格式
 01:10:18
 
%U
 一年内的第几个星期，从00到52，以星期天作为每个星期的第一天
 15
 
%w
 一星期内的第一天，从0到6
 4
 
%W
 一年内的第几个星期，从00到53，以星期一作为每个星期的第一天
 15
 
%y
 年的缩写形式，从00到99
 00
 
%Y
 用四位数字表示一年
 2000
 
%Z
 时区名称
 MDT
 


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

$#@60;!--#config sizefmt="bytes" --$#@62;

$#@60;!--#fsize file="index.html" --$#@62;