Nginx rewrite配置规则

rewrite语法

1
2
3
server {
rewrite {规则} {定向路径} {重写类型} ;
}

1、规则:可以是字符串或者正则来表示想匹配的目标url
2、定向路径:表示匹配到规则后要定向的路径,如果规则里有正则,则可以使用$index来表示正则里的捕获分组
3、重写类型:

  • last :相当于Apache里德(L)标记,表示完成rewrite,浏览器地址栏URL地址不变
  • break;本条规则匹配完成后,终止匹配,不再匹配后面的规则,浏览器地址栏URL地址不变
  • redirect:返回302临时重定向,浏览器地址会显示跳转后的URL地址
  • permanent:返回301永久重定向,浏览器地址栏会显示跳转后的URL地址

举例说明

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
server {
rewrite /last.html /index.html last;
# 访问 /last.html 的时候,页面内容重写到 /index.html 中

rewrite /break.html /index.html break;
# 访问 /break.html 的时候,页面内容重写到 /index.html 中,并停止后续的匹配

rewrite /redirect.html /index.html redirect;
# 访问 /redirect.html 的时候,页面直接302定向到 /index.html中

rewrite /permanent.html /index.html permanent;
# 访问 /permanent.html 的时候,页面直接301定向到 /index.html中

rewrite ^/html/(.+?).html$ /post/$1.html permanent;
# 把 /html/*.html => /post/*.html ,301定向

rewrite ^/search\/([^\/]+?)(\/|$) /search.html?keyword=$1 permanent;
# 把 /search/key => /search.html?keyword=key
}

last和break的区别:

  1. 因为301和302不能简单的只返回状态码,还必须有重定向的URL,这就是return指令无法返回301,302的原因了(return 只能返回除301、302之外的code)。
  2. last一般写在server和if中,而break一般使用在location中
  3. last不终止重写后的url匹配,即新的url会再从server走一遍匹配流程,而break终止重写后的匹配
  4. break和last都能组织继续执行后面的rewrite指令
  5. 在location里一旦返回break则直接生效并停止后续的匹配location
1
2
3
4
5
6
7
8
9
server {
location / {
rewrite /last/ /q.html last;
rewrite /break/ /q.html break;
}
location = /q.html {
return 400;
}
}

访问/last/时重写到/q.html,然后使用新的uri再匹配,正好匹配到locatoin = /q.html然后返回了400;
访问/break时重写到/q.html,由于返回了break,则直接停止了;

JouyPub wechat
欢迎订阅「K叔区块链」 - 专注于区块链技术学习