Nginx配置SSI

 

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

工作原理：

将内容发送到浏览器之前,可以使用“服务器端包含 (SSI)”指令将文本、图形或应用程序信息包含到网页中。

 

二.使用场景：

1.嵌入静态页面

嵌入通用的页头，页尾文件，

可减小每个页面的大小，

更新页头页尾时只用更新相应文件

2.嵌入动态页面

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

 

三.配置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

SSI的格式：
< !--#include file="bottom.htm"-->
或
< !--#include virtual="/hx/bottom.htm"-->
路径是相对server中root根目录。

 

示例：

1.开启shtml后缀的文件名支持ssi
server{
    ......
    ssi on;
    ssi_silent_errors on;
    ssi_types text/shtml;
}

2.开启html后缀的文件名支持ssi
server{
    ......
    ssi on;
    ssi_silent_errors on;
}

3.在特定路径下开启html后缀的文件名支持ssi
server{
    ......
    location /hx/{
        ssi on;
        ssi_silent_errors on;
    }
}

 

让Nginx的SSI支持相对路径
http://happyqing.iteye.com/blog/2165665

 

nginx ssi 官方文档

http://nginx.org/en/docs/http/ngx_http_ssi_module.html

http://wiki.nginx.org/NginxChsHttpSsiModule