SSI的命令和变量

在[url=http://maleo.iteye.com/blog/670287]JBoss 5.1中配置SSI[/url]中讲到了如何在JBoss 5.1下配置SSI，SSI的实现原理主要是在静态页面中写入可以通过注释来调用的命令使得静态页面具有动态效果，SSI自身也定义了一些常用的变量，需要注意的是SSI是大小写敏感的。

SSI命令：

[color=blue]config[/color]:指定返回给客户端的错误信息，日期时间格式和文件大小格式。
[color=blue]<!--#config errmsg="自定义错误信息"-->[/color]：自定义的SSI执行错误信息。
[color=blue]<!--#config sizefmt="bytes"-->[/color]：定义文件大小的显示格式，默认为bytes,可改为千字节方式(abbrev)。
[color=blue]<!--#config datefmt="%Z %Y %m %H %M %d %a"-->[/color]：自定义日期的显示格式。

[color=blue]include[/color]:把其他文件插入到当前文档中，被包含的文件必须到有扩展名。
[color=blue]<!--include file="header.html" -->[/color]：file文件名是一个相对路径，被包含的文件只能位于同级或者下级目录中。
[color=blue]<!--include virtual="/includes/header.html" -->[/color]：virtual文件名表示的是Web站点虚拟目录的完整路径。

[color=blue]echo[/color]:将变量插入到文档中。
[color=blue]<!--#echo var="DOCUMENT_NAME" -->[/color]：输出当前文档的名称（更多变量请参考下面）。

[color=blue]exec[/color]:将cgi或者外部程序的输出写入到页面中，这个指令很方便使用，但是存在安全风险。
[color=blue]<!--#exec cgi=""-->[/color]:将cgi的输出写入到页面中。
[color=blue]<!--#exec cmd=""-->[/color]：将外部程序的输出写入到页面中

[color=blue]fsize[/color]:文件的大小，输出的格式由sizefmt定义，必须在sizefmt后使用。
[color=blue]<!--#fsize file="head.html"-->[/color]：显示head.html的大小。

[color=blue]flastmod[/color]:文件的最后修改时间，时间的输出格式由datefmt定义，必须在datefmt后使用。
[color=blue]<!--#flastmod file="head.html"-->[/color]：显示head.html的最新更新时间。

[color=green]以下命令属于XSSI命令（Extended SSI）[/color]

[color=blue]printenv[/color]:显示当前存在WEB服务器环境中所有的环境变量。
[color=blue]<!--#printenv-->[/color]

[color=blue]set[/color]:给变量赋值。
[color=blue]<!--#set var="变量名" value="变量值"-->[/color]

[color=blue]if...elif...else...endif[/color]:执行if,else if else判断。
[color=blue]<!--#if expr="$变量名=\"变量值\""-->[/color]
[color=blue]<!--#elif expr="$变量名=\"变量值\""-->[/color]

SSI内置的变量(蓝色表示JBoss 5.1下[color=blue]<!--#printenv-->[/color]输出变量，其他变量是否支持还有待验证)：

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

SSI中日期格式的定义：

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