首先看几个例子!
例子1
Discuz(X2.5) URL 静态化(伪静态)
页面 标记 格式
1 门户专题页 {name} topic-{name}.html
2 门户文章页 {id}, {page} article-{id}-{page}.html
3 论坛主题列表页 {fid}, {page} forum-{fid}-{page}.html
4 论坛主题内容页 {tid}, {page}, {prevpage} thread-{tid}-{page}-{prevpage}.html
5 群组主题列表页 {fid}, {page} group-{fid}-{page}.html
6 用户个人主页 {user}, {value} space-{user}-{value}.html
7 用户日志内容页 {uid}, {blogid} blog-{uid}-{blogid}.html
Nginx Rewrite
rewrite ^/$ /forum.php last;
rewrite ^([^.]*)/topic-(.+).html$ $1/portal.php?mod=topic&topicid=$2 last;
rewrite ^([^.]*)/article-([0-9]+)-([0-9]+).html$ $1/portal.php?mod=view&aid=$2&page=$3 last;
rewrite ^([^.]*)/forum-(w+)-([0-9]+).html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;
rewrite ^([^.]*)/thread-([0-9]+)-([0-9]+)-([0-9]+).html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;
rewrite ^([^.]*)/group-([0-9]+)-([0-9]+).html$ $1/forum.php?mod=group&fid=$2&page=$3 last;
rewrite ^([^.]*)/space-(username|uid)-(.+).html$ $1/home.php?mod=space&$2=$3 last;
rewrite ^([^.]*)/blog-([0-9]+)-([0-9]+).html$ $1/home.php?mod=space&uid=$2&do=blog&id=$3 last;
if (!-e $request_filename) {
return 404;
}
Nginx Rewrite 过程
论坛主题列表页 {fid}, {page} forum-{fid}-{page}.html
browser
http://bbs.test.com/forum-2-1.html
|
nginx rewrite
rewrite ^([^.]*)/forum-(w+)-([0-9]+).html$ $1/forum.php?mod=forumdisplay&fid=$2&page=$3 last;
|
real url
http://bbs.test.com/forum.php?mod=forumdisplay&fid=2&page=1
论坛主题内容页 {tid}, {page}, {prevpage} thread-{tid}-{page}-{prevpage}.html
browser
http://bbs.test.com/thread-8-1-1.html
|
nginx rewrite
rewrite ^([^.]*)/thread-([0-9]+)-([0-9]+)-([0-9]+).html$ $1/forum.php?mod=viewthread&tid=$2&extra=page%3D$4&page=$3 last;
|
real url
http://bbs.test.com/forum.php?mod=viewthread&tid=8&extra=page%3D1&page=1
例子2
Wordpress(3.4.1) 固定链接设置(伪静态)
默认 http://blog.test.com/?p=123
月份和名称型 http://blog.test.com/index.php/2012/08/sample-post/
/index.php/%year%/%monthnum%/%postname%/
Nginx Rewrite 代码
if (-f $request_filename/index.html)
{
rewrite (.*) $1/index.php last;
}
if (-f $request_filename/index.php)
{
rewrite (.*) $1/index.php last;
}
if (!-f $request_filename)
{
rewrite (.*) /index.php last;
}
Nginx Rewrite 过程
browser
http://blog.test.com/index.php/2012/08/vc-load/v9-1/
|
nginx rewrite
rewrite (.*) /index.php last;
|
real url
http://blog.test.com/?attachment_id=149
例子3
rewrite ^/bus/index.php /bus/bus_city.php last;
rewrite ^/bus/$ /bus/bus_city.php last;
if ($host ~* ^bus.domain.com$)
{
rewrite ^/$ /bus/index.php last;
}
if ($var_pay_public ~ '1')
{
rewrite ^(.*)$ /pay/index.php last;
}
if ($host ~* ^www(.*?) )
{
rewrite ^/xiaoqu(.*)$ /xiaoqu_2_404/;
}
例子4http://abc.com/products.php?id=39-0-0-10
重写为
http://abc.com/products/39-0-0-10.html
Nginx Rewrite 代码
rewrite ^/products/(*).html$ /products/products.php?id=$1 last;
URL重写模块
1 URL重写模块
这个模块允许使用正则表达式重写URI(需PCRE库),并且可以根据相关变量重定向和选择不同的配置。
如果这个指令在server字段中指定,那么将在被请求的location确定之前执行,如果在指令执行后所选择的location中有其他的重写规则,那么它们也被执行。
如果在location中执行这个指令产生了新的URI,那么location又一次确定了新的URI,这样的循环可以最多执行10次,超过以后nginx将返回500错误。
2 指令
2.1 break
语法:break
默认值:none
使用字段:server, location, if
完成当前设置的规则,停止执行其他的重写指令。
示例:
if ($slow) {
limit_rate 10k;
break;
}
2.2 return语法:return code
默认值:none
使用字段:server, location, if
这个指令结束执行配置语句并为客户端返回状态代码,可以使用下列的值:204,400,402-406,408,410, 411, 413, 416与500-504。
此外,非标准代码444将关闭连接并且不发送任何的头部。
2.3 set语法:set variable value
默认值:none
使用字段:server, location, if
指令设置一个变量并为其赋值,其值可以是文本,变量和它们的组合。
你可以使用set定义一个新的变量,但是不能使用set设置$http_xxx头部变量的值
示例:
if ($request_uri ~* ".*.(js|ico|gif|jpg|png|css)$")
{
set $var_public '0';
}
if ($var_public ~ '0')
{
rewrite ^(.*)$ /static/$1 last;
}
2.4 if语法:if (condition) { … }
默认值:none
使用字段:server, location
注意:在使用if指令之前请查看if is evil page并且尽量考虑用try_files代替。
判断一个条件,如果条件成立,则后面的大括号内的语句将执行,相关配置从上级继承。
可以在判断语句中指定下列值:
1 一个变量的名称;不成立的值为:空字符传”“或者一些用“0”开始的字符串。#
2 一个使用=或者!=运算符的比较语句。
3 使用符号~*和~模式匹配的正则表达式:
~为区分大小写的匹配。
~*不区分大小写的匹配(firefox匹配FireFox)。
!~和!~*意为“不匹配的”。
4 使用-f和!-f检查一个文件是否存在。
5 使用-d和!-d检查一个目录是否存在。
6 使用-e和!-e检查一个文件,目录或者软链接是否存在。
7 使用-x和!-x检查一个文件是否为可执行文件。
正则表达式的一部分可以用圆括号,方便之后按照顺序用$1-$9来引用。
示例:
if ($slow) {
limit_rate 10k;
}
if ($request_method = POST ) {
return 405;
}
if ($http_user_agent ~ MSIE) {
rewrite ^(.*)$ /msie/$1 break;
}
if ($http_cookie ~* "id=([^;] +)(?:;|$)" ) {
set $id $1;
}
if ($args !~ "post=140"){
rewrite ^ http://example.com/ permanent;
}
if (!-f $request_filename) {
break;
proxy_pass http://127.0.0.1;
}
if ($invalid_referer) {
return 403;
}
注意:红色字符
注意:内置变量$invalid_referer用指令valid_referers指定。
2.5 rewrite
语法:rewrite regex replacement flag
默认值:none
使用字段:server, location, if
按照相关的正则表达式与字符串修改URI,指令按照在配置文件中出现的顺序执行。
可以在重写指令后面添加标记。
如果替换的字符串以http://开头,请求将被重定向,并且不再执行多余的rewrite指令。
尾部的标记(flag)可以是以下的值:
1 last - 完成重写指令,之后搜索相应的URI或location。
2 break - 完成重写指令,之后停止搜索
3 redirect - 返回302临时重定向,如果替换字段用http://开头则被使用。
4 permanent - 返回301永久重定向。
注意:如果一个重定向是相对的(没有主机名部分),nginx将在重定向的过程中使用匹配server_name指令的“Host”头或者server_name指令指定的第一个名称,如果头不匹配或不存在,如果没有设置server_name,将使用本地主机名,如果你总是想让nginx使用“Host”头,可以在server_name使用“*”通配符(查看http核心模块中的server_name)。例如:
rewrite ^(/download/.*)/media/(.*)..*$ $1/mp3/$2.mp3 last;
rewrite ^(/download/.*)/audio/(.*)..*$ $1/mp3/$2.ra last;
return 403;
但是如果我们将其放入一个名为/download/的location中,则需要将last标记改为break,否则nginx将执行10次循环并返回500错误。
location /download/ {
rewrite ^(/download/.*)/media/(.*)..*$ $1/mp3/$2.mp3 break;
rewrite ^(/download/.*)/audio/(.*)..*$ $1/mp3/$2.ra break;
return 403;
}
//last 与 break 用来实现URI重写,浏览器地址栏URL地址不变,但是在服务器端访问的路径已经发生了变化。
//redirect 与 permanent 用来实现URL跳转,浏览器地址栏会显示跳转后URL地址。
//last 与 break 是有区别的,last标记 在匹配后继续搜索,而break 标记在匹配后则停止搜索。
//因此,一般在根location中 (location /),或者直接写在server 标签中的rewrite 规则请使用last标记,而在非根location中 (location /bbs/)请使用break标记。
如果替换字段中包含参数,那么其余的请求参数将附加到后面,为了防止附加,可以在最后一个字符后面跟一个问号:
rewrite ^/users/(.*)$ /show?user=$1? last;
注意:大括号({和}),可以同时用在正则表达式和配置块中,为了防止冲突,正则表达式使用大括号需要用双引号(或者单引号)。例如要重写以下的URL:
/photos/123456
为:
/path/to/photos/12/1234/123456.png
则使用以下正则表达式(注意引号):
rewrite "/photos/([0-9]{2})([0-9]{2})([0-9]{2})" /path/to/photos/$1/$1$2/$1$2$3.png last;
如果指定一个“?”在重写的结尾,Nginx将丢弃请求中的参数,即变量$args,当使用$request_uri或$uri&$args时可以在rewrite结尾使用“?”以避免nginx处理两次参数串。在rewrite中使用$request_uri将www.example.com重写到example.com:
server {
server_name www.example.com;
rewrite ^ http://example.com$request_uri? permanent;
}
同样,重写只对路径进行操作,而不是参数,如果要重写一个带参数的URL,可以使用以下代替:if ($args ^~ post=100){
rewrite ^ http://example.com/new-address.html? permanent;
}
注意$args变量不会被编译,与location过程中的URI不同(参考http核心模块中的location)。参考
URL重写模块(Rewrite)
结束