服务器端包含、嵌入技术SSI(Server SideInc lude)详解

2019-10-14 13:51:10王振洲

SSI简介

SSI在静态文件中非常有用,能分离一些可变的模块,如每日排行榜等。其主要作用有:

1.显示服务器端环境变量<#echo>
2.将文本内容直接插入到文档中<#include>
3.显示WEB文档相关信息<#flastmod #fsize> (如文件制作日期/大小等)
4.直接执行服务器上的各种程序<#exec>(如CGI或其他可执行程序)
5.设置SSI信息显示格式<#config>(如文件制作日期/大小显示方式)
6.高级SSI<XSSI>可设置变量使用if条件语句。 apache、nginx等都支持SSI命令,配置下就可以,Nginx的配置可以参考:

http://wiki.nginx.org/HttpSsiModuleChs

SSI 的默认扩展名是 .stm、.shtm 和 .shtml

SSI语法

示例:

<!--#command param="value"-->

SSI的语法非常简单,但使用中需注意以下几点:

1.<!–与#之间无空格
2.SSI大小写敏感
3.所有value需写在引号中

SSI命令

config命令

config命令主要用于修改SSI的默认设置,诸如时间格式,默认错误信息,文件大小单位。

设置默认错误信息:errmsg
<!--#config errmsg="Error,please contact webmaster@mail.com"-->
定义日期和时间格式:timefmt
<!--#config timefmt="%A, %B %d, %Y"-->
定义文件大小单位
<!--#config sizefmt="bytes"-->
config命令只对其后使用的命令生效。同时,后定义的设置具有更高的优先级,会覆盖之前的设置。

include命令

include命名可能是SSI中使用最多的命令,也是SSI最主要的功能体现;
Include命令可以把其它文档中的文字或图片插入到当前被解析的文档中,通过Include命令只需要改动一个文件就可以瞬间更新整个站点!
<!--#include virtual="/inc/header.inc"-->
<!--#include file="inc/desc.inc"-->
include命令支持通过虚拟路径引入文件(virtual),以及相对路径引入文件(file),引用的文件类型不限。

set命令

可以使用set进行变量的定义:
<!--#set var="blog" value="//www.jb51.net"-->
变量定义后便可以使用了:
<!--#echo var="blog"-->
定义变量时使用环境变量:
<!--#set var="fname" value="${DOCUMENT_NAME}${DOCUMENT_URI}"-->
如果是单个环境变量可以不使用{}分割:
<!--#set var="fname" value="$DOCUMENT_NAME"-->
环境变量的引用都需要使用$前缀,如果$仅作为字符使用,通过$转义即可。

echo命令

echo显示变量值,包括自定义变量、环境变量
<!–#echo var=”DOCUMENT_NAME”–>
注意:echo命令中使用的环境变量不需要使用$前缀。 SSI的主要环境变量如下: