SSI指令教程

admin · 发表于 2024-4-12 14:26:12

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

787618-20151207184720043-119319007.png.jpg

在站点目录放一个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>

复制代码

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

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

787618-20151207184721558-1763331485.png.jpg

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

下面，开启SSI

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

787618-20151207184722855-2121212305.png.jpg

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

787618-20151207184726121-1527942500.png.jpg

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

787618-20151207184727340-825903535.png.jpg

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

”处理程序映射“

787618-20151207184728277-189201469.png.jpg

web.config文件

787618-20151207184731105-1452828562.png.jpg

web.config的内容如下

787618-20151207184732246-2107991870.png.jpg

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

787618-20151207184737105-1874512579.png.jpg

可以看到，”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>
File Size =  bytes
</body>
</html>

复制代码

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

787618-20151207184738277-829570732.png.jpg

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

Date =

复制代码

787618-20151207184739340-630023947.png.jpg

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

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

bytes
kb

复制代码

显示如下

787618-20151207184740043-485113881.png.jpg

算一下，结果是正确的

3.2 echo：显示环境变量

请求方式=

复制代码

这里显示请求方式

787618-20151207184741543-1691219937.png.jpg

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

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("Path:" +System.Environment.GetEnvironmentVariable("PATH_TRANSLATED") +"");
} // End of Main().
}
}