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 webmaster@mydomain.com --$#@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;