最近工作需要使用nginx的ssi (server side include)技术,在这里,将使用中的一点心得分享一下,也是一种备忘!
首先,nginx的ssi启用很简单,就只有三个最基本的指令:
ssi on; 默认是关闭的
ssi_silent_errors on; 默认是关闭的
ssi_types text/shtml; 默认是text/html
这三行的配置可以放在nginx的三个作用域下面(http, server, location)。nginx的基本概念可以自己去网上学习。
这里,重点介绍nginx ssi的include之virtual的使用!下一博文介绍include之file的使用。
其他不多说,直接上配置:
upstream wxcj-server {
server 10.90.7.1:8082;
server 10.90.7.2:8082;
ip_hash;
} server {
listen 82;
server_name localhost; ssi on;
ssi_silent_errors off;
ssi_types text/html; access_log logs/wxcj-test.log; #location ~ \.(shtm|shtml)$ {
# root /var/wxcj;
# index index.shtml;
#} location /tests {
rewrite /tests/(\w+)/(\w+).html /option/$1.html?product_id=$2;
set $product_id $arg_product_id;
} location /option {
root /var/wxcj/cms/;
#set $product_id $arg_product_id;
}
location /product {
root /var/wxcj/cms/;
#set $product_id $arg_product_id;
} location / {
proxy_pass http://wxcj-server;
proxy_redirect off;
proxy_set_header Host $host:$server_port;
proxy_set_header Remote_Addr $remote_addr;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; }
}
红色部分是这里要讲的重点内容。这里都是介绍静态文件的访问配置,至于动态的文件,是通过upstream以及proxy-pass部分实现的,不是这里介绍的内容,略去!
静态部分,有两个虚拟路径/option,一个是/product,这两个涉及到实际访问时url的一部分。另外的一个重点,是22-25行的配置,这里有rewrite以及set两个重要的指令。
1》 rewrite重写url,这里,将类似/tests/a/b.html的请求重写为/option/a.html?product_id=b这样子的url。此时,http请求将进入到/option/虚拟路径下面,注意,这里的/option以及/product这两个虚拟路径都是相对root配置的路径而言的,root路径是绝对的路径。本测试中的root路径和/option以及/product路径如下:
[root@localhost cms]# pwd
/var/wxcj/cms #本例中配置的root
[root@localhost cms]# ll
总计
drwxr-xr-x root root - : option #/option虚拟路径
drwxr-xr-x root root - : product #/product虚拟路径
2》 set指令,在这里也非常关键,是用来设置nginx的应用变量的。这个变量可以传递到ssi指令的解析过程中。 set $product_id $arg_product_id这个是将rewrite指令中?符号后面的变量的值通过$arg_product_id取到付给变量$product_id, 在nginx中取url中?后面的变量的值是通过$arg_作为前缀获取的。 例如/abc/123?name="9527", 那么,set $yourname $arg_name指令就可以将这个url中的name变量的值9527赋值给变量$yourname.
下面看看我的测试页面,我的url是http://10.90.7.1:82/tests/s1001/1000.html,nginx首先rewrite成为http://10.90.7.1:82/option/s1001.html?product_id=1000这个样子。先看看option下面的内容:
[root@localhost cms]# cd option/
[root@localhost option]# ll
总计
-rw-r--r-- root root - : s1001.html
-rw-r--r-- root root - : s1002.html
-rw-r--r-- root root - : s2001.html
-rw-r--r-- root root - : s2002.html
-rw-r--r-- root root - : s2003.html
再看看s1001.html的内容:
<div>
this is an option A
</div>
<!--# echo var="product_id" -->
<!--# include virtual="/product/$product_id.html" -->
另外动态参数product_id.html的内容,在这个例子里面,这个文件是1000.html,其内容如下:
<p> this is a title for product </p>
注意,上面的virtual等号右边的格式,是相对于root路径的一个绝对路径写法,也可以理解为虚拟路径。上面的echo指令后面的var等号右边,必须是变量的名字,不要带上$这个符号。还有一点就是ssi指令的语法,<!--#是一个整体,否则会造成ssi指令的内容解析不出来的问题。与后面的内容比如echo,include等指令之间有至少一个空格。后面的-->与前面的内容之间最好分开,不要连在一起,养成一个好的编码习惯。
最后浏览器打开后的效果如下: