Nginx SSI 设置

什么是SSI

Server Side Include，通常称为服务器端嵌入，是一种类似于ASP的基于服务器的网页制作技术。大多数（尤其是基于Unix平台）的WEB服务器如Netscape Enterprise Server等均支持SSI命令。

为什么要用SSI

用个例子来说明，一个静态化的页面中，需要嵌入一小块实时变化的内容，。例如首页，大部分的页面内容需要缓存但是用户登录后的个人信息是动态信息，不能缓存。那么如何解决这个”页面部分缓存”问题，利用SSI就可以解决，在首页的静态页面中嵌入个人信息的动态页，由于是服务器端的嵌入，所以用户浏览的时候都是一个嵌入后的页面。

nginx配置SSI

主要是三个参数，ssi，ssi_silent_errors和ssi_types，均可以放在http,server和location的作用域下。

ssi on
开启ssi支持，默认是off

ssi_silent_errors on
默认值是off，开启后在处理SSI文件出错时不输出错误提示:”[an error occurred while processing the directive] ”

ssi_types
默认是ssi_types text/html，所以如果需要htm和html支持，则不需要设置这句，如果需要shtml支持，则需要设置：ssi_types text/shtml

 

将下面的3行代码添加到 nginx.conf 文件的 http{} 段中，以开启 SSI 模块的支持：

ssi on;
ssi_silent_errors on;
ssi_types text/shtml;

放第一个server段的前面

也可以直接在server段里加上
location ~ .*\.(shtm|shtml)?$ {
ssi on;
ssi_silent_errors on;
ssi_types text/shtml;
}

 

需要注意：
<!–#include file=”文件名称”–> 
<!–#include virtual=”文件名称”–>
file 文件名是一个相对路径，该路径相对于使用 #include 指令的文档所在的目录。被包含文件可以在同一级目录或其子目录中，但不能在上一级目录中。如表示当前目录下的的nav_head.htm文档，则为 file=”nav_head.htm”。
virtual 文件名是 Web 站点上的虚拟目录的完整路径。如表示相对于服务器文档根目录下hoyi目录下的nav_head.htm文件；则为virtual=”/hoyi/nav_head.htm”