SSI指令教程

一：概述

SSI：服务器端嵌入或者叫服务器端包含，是Server Side Include的简写。SSI技术通过在文档中加入SSI指令，让服务器端在输出文档之前解析SSI指令，并把解析完的结果和文档一同输出给客户端。

SSI的指令格式为：

其中，directive是指令名，parameter指令参数，value指令参数值

可以看到，就是html注释，事实上，Web服务器开启了SSI，并且页面包含可以解析的指令，那么Web服务器就解析这个指令。没开启器SSI或者开启了SSI，但是不是可以解析的指令，那么都当做注释。

注意的是，“#”要和directive连在一起，中间不能含有空格

SSI包含的指令有

config：修改 SSI 的默认设置

echo：显示环境变量

exec：执行 CGI 脚本

flastmod ：显示指定文件的最后修改日期

fsize：显示指定文件的大小

include：把其它文档插入到当前被解析的文档中

二：准备工作

新建一个站点,站点路径为C:\inetpub\wwwroot\ssitutorial，网站名称为localhost8585，端口为8585

在站点目录放一个html文件，名为index.html，首先没开启SSI时，测试使用SSI指令是否有效果

html文件内容如下

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <title></title>
</head>
 
<body>
   <p>Date = <!--#echo var = "date_local" --></p>
</body>
 
</html>

使用了echo指令，显示当前时间

浏览http://localhost:8585/index.html，查看效果

可以看到”Date=“后面并没显示当前时间，说明没开启SSI，指令只是作为注释

下面，开启SSI

在IIS选中站点localhost8585，选择”处理程序映射“

进入”处理程序映射“后，选择操作中的”添加模块映射“

弹出”添加模块映射“窗口，在窗口指定解析html文件

点确定后，可以看到，在”处理程序映射“多了一项，同时，在站点目录下，也就是C:\inetpub\wwwroot\ssitutorial生成了一个web.config文件

”处理程序映射“

web.config文件

web.config的内容如下

设置后之后，测试下SSI是否成功，刷新http://localhost:8585/index.html，查看效果

可以看到，”Date=”后面显示日期，说明SSI指令生效了

三：SSI各个指令的用法

3.1 config：修改 SSI 的默认设置，参数：

errmsg：自定义的SSI执行错误信息；

timefmt：定义日期和时间的格式；

sizefmt：决定文件大小是以字节、千字节为单位表示

errmsg参数：自定义的SSI执行错误信息，必须放在其它指令前，才能显示自定义的错误信息

例如：

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
    <title></title>
</head>
 
<body>
 
<!-- #config errmsg="这是自定义错误信息"-->
<p>File Size = <!--#fsize file="filename.txt"--> bytes</p>
 
</body>
 
</html>

这里的filename.txt并不存在，所以执行会出错，那么就显示自定义错误信息了，如下图

timefmt参数：定义日期和时间的格式

<!-- #config timefmt="%y年%m月%d日"-->
<p>Date = <!--#echo var = "date_local" --></p>

sizefmt：决定文件大小是以字节（bytes）、千字节（abbrev）为单位表示

比如，有一个文件a.exe,大小为48,594,944字节，使用不同单位

<!--#config sizefmt="bytes"-->
<p><!--#fsize file="a.exe"--> bytes</p>
 
<!--#config sizefmt="abbrev"-->
<p><!--#fsize file="a.exe"--> kb</p>

显示如下

算一下，结果是正确的

3.2 echo：显示环境变量

<p>请求方式= <!-- #echo var = "HTTP_METHOD" --></p>

这里显示请求方式

完整的环境变量，可以在点这里查询

3.3 exec：执行 CGI 脚本

首先需要得到CGI程序，用控制台做一个CGI程序，名为CgiDemo

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading;
using System.Threading.Tasks;
 
namespace CgiDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.Write("Content-Type: text/html\n\n");
            Console.Write("<p>Path:" +System.Environment.GetEnvironmentVariable("PATH_TRANSLATED") +"</p>");
        }  // End of Main().
    }
}

输出CGI程序的服务器路径

然后，使用exec执行CGI

<pre><!--#exec cgi = "/cgi-bin/cgidemo.exe" --></pre>

接着访问上面html的地址http://localhost:8585/index.html，出现下面这种情况

说明服务器还要做一些配置。首先，在站点localhost8585—>处理程序映射—>添加模块映射

配置CGI模块

再然后，在 服务器（不是站点）下找到”ISAPI和CGI限制”

添加刚才那个CGI

再次访问http://localhost:8585/index.html，得到如下结果

说明成功执行CGI程序

3.4 flastmod ：显示指定文件的最后修改日期

<!-- #config timefmt="%y年%m月%d日"-->
<pre> <!-- #flastmod  file = "a.exe" --></pre>

得到如下结果

a.exe的信息如下

说明是正确的

3.5 fsize：显示指定文件的大小

<!--#config sizefmt="bytes"-->
<p><!--#fsize file="a.exe"--> bytes</p>

得到如下结果

a.exe大小信息如下

说明也是正确的

3.6 include：把其它文档插入到当前被解析的文档中

在index.html所在目录建一个inc.htm文件，文件内容如下

<h2>这是include文件内容</h2>

在index.html包含inc.html

<body>
 
<!--#include file="inc.htm"-->
 
</body>

访问http://localhost:8585/index.html，得到如下结果

可见，inc.htm里的内容被包含进来

另外，如果被包含文件中含有SSI指令，也会解析SSI指令