当前位置： 移动技术网 > 网络运营>服务器>Linux > 服务器端包含、嵌入技术SSI（Server SideInc lude)详解

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

2019年05月01日  | 移动技术网网络运营  | 我要评论

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的主要环境变量如下：

name description type
document_name 当前文档名 ssi
document_uri 当前文档虚拟路径 ssi
query_string_unescaped 未经转义处理的由客户端发送的查询字串，所有的特殊字符前面都有转义符”\” ssi
date_local 服务器设定时区的日期和时间 ssi
date_gmt 功能与date_local一样，但返回的是以格林尼治标准时间为基准的日期 ssi
last_modified 当前文档的最后更新时间 ssi
server_software 服务器软件的名称和版本 cgi
server_name 服务器的主机名称，dns别名或ip地址 cgi
server_protocol 客户端请求所使用的协议名称和版本 cgi
server_port 服务器的响应端口 cgi
remote_host 发出请求信息的客户端主机名称 cgi
remote_addr 发出请求信息的客户端ip地址 cgi
auth_type 用户身份的验证方法 cgi
remote_user 访问受保护页面的用户所使用的帐号名称 cgi

更多的环境变量可使用printenv命令查看 printenv命令 显示所有环境变量

fsize命令

显示指定文件的大小，可结合config sizefmt指定输出格式。

复制代码 代码如下:

<!--输出当前文档大小-->
<!--#fsize file="$document_name"-->
<!--#fsize virtual="$document_uri"-->

flastmod命令

显示指定文件的最后更新日期，可结合config sizefmt指定输出格式。

复制代码 代码如下:

<!--输出当前文档大小-->
<!--#flastmod file="$document_name"-->
<!--#flastmod virtual="$document_uri"-->

exec命令

exec 命令可以执行 cgi 脚本或者 shell 命令。使用方法如下：

1.cmd：使用 /bin/sh 执行指定的字串。如果 ssi 使用了 includesnoexec 选项，则该命令将被屏蔽

2.cgi：可以用来执行 cgi 脚本

if…语句

ssi中也可以是用条件判断语句if，语法如下：

复制代码 代码如下:
<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->

示例：
复制代码 代码如下:

<!--#if expr="$document_name=index.shtml"-->
<p>这是通过if判断当前文档名为"index.shtml"后显示</p>
<!--#elif expr="$document_name="-->
<p>这是通过if判断当前文档名为""后显示</p>
<!--#else -->
<p>既不是"index.shtml"，也不是""</p>
<!--#endif -->
demo

您可能感兴趣的文章:

如对本文有疑问， 点击进行留言回复！！

相关文章:

验证码：
最近更新的文章
大家感兴趣的文章
移动技术网