Nginx地址重写(rewrite)配置规则与实例[伪静态]

UrlRewrite并非Nginx容器独有,访问地址重写又称为伪静态,主要用于重写用户访问的URL,以达到访问地址美观、不暴露访问参数的目的,再配合应用程序可以实现很多特殊的场景

Nginx地址重写(rewrite)配置规则与实例[伪静态]

所属分类: 运维
专题标签: Nginx URL 规则

关于rewrite

rewrite的主要功能是实现RUL地址的重定向。
Nginx的rewrite通过perl兼容正则表达式语句进行规则匹配的。
默认配置下,Nginx会支持rewrite的模块。

rewrite的作用

通过下方案例便能轻松理解rewrite的作用。

  1. # 原本访问文章的URL
  2. http://www.mebugs.com/post.php?url=java
  3. # URL太不美观、暴露了我的后端请求地址、暴露了请求参数
  4. # 通过rewrite可以实现如下地址访问,等同于上方地址
  5. http://www.mebugs.com/post_java.html
  6. # 配置规则
  7. # 访问post_开头.html结果地址,重写到post.php?url=中间匹配的字符
  8. rewrite ^/post_(.*).html$ /post.php?url=$1 break;

理解作用后,我们可以看下rewrite的语法。

rewrite的语法

rewrite的语法很简单,分为四部分。

  1. rewrite <regex> <replacement> [flag];
  2. #关键字 正则 替代内容 标记
  • 关键字:关键字不能改变
  • 正则:perl兼容正则表达式语句进行规则匹配
  • 替代内容:将正则匹配的内容替换成replacement
  • 标记:rewrite支持的flag标记

正则<regex>

关于正则的规则不需要多说,这一段内容主要用于匹配访问的URL。
rewrite中常见的正则规则:

  • :标记后续字符串为特殊字符串或原义字符或一个向后引用,如“ ”匹配一个换行符,而“$”则匹配“$”
  • ^:匹配起始位置
  • $:匹配结束位置
  • .:匹配除“ ”之外的任何单个字符
  • :匹配前面的字符零次或多次,如x能匹配x、xx、xxx,.*则表示通配
  • +:匹配前面的字符一次或多次
  • ?:匹配前面的字符零次或一次,”?”等效于”{0,1}”
  • (pattern):非常重要!!!匹配括号内pattern并可以在后面获取对应的匹配,常用$1…$9属性获取小括号中的匹配内容

rewrite中的正则还受其所在的location影响,因为外部location也是可以正则的。
注意:rewrite可以不配置在location下表示全局生效

  1. # 基本规则(所有的URL都会接受rewrite)
  2. location / {
  3. rewrite ^/post_(.*).html$ /post.php?url=$1 break;
  4. }
  5. # location有规则(只有URL以.html结尾的请求才会进来)
  6. location ~ .*.(html)?$ {
  7. rewrite ^/post_(.*).html$ /post.php?url=$1 break;
  8. }
  9. # 这是一个错误的规则(不会生效)
  10. # 外部定义了只有/open开始的URL进来,内部定义了匹配/post,所以规则不会生效
  11. location /open {
  12. rewrite ^/post_(.*).html$ /post.php?url=$1 break;
  13. }

替代内容<replacement>

替代内容实际上就是将前面匹配到的URL转换成实际URL。
需要注意的是,<replacement>里面是可以接受参数的,接受的内容为正则<regex>中圆括号包裹的内容。

  1. # 还是上文的例子
  2. # $1取得是前面规则中(.*)匹配的字符串,比如:/post_java.html时$1就是java
  3. rewrite ^/post_(.*).html$ /post.php?url=$1 break;
  4. # 多参数的写法
  5. # /page_new_1_.html => /page.php?type=new&current=1
  6. rewrite ^/page_([a-z]+)_(d+)_.html$ /page.php?type=$1&current=$2 break;

标记[flag]

这是一个可选项,不写默认似乎是last。

  • last:本条规则匹配完成后,继续向下匹配新的location URI规则
  • break:本条规则匹配完成即终止,不再匹配后面的任何规则
  • redirect:返回302临时重定向,浏览器地址会显示跳转后的URL地址
  • permanent:返回301永久重定向,浏览器地址栏会显示跳转后的URL地址

我们看到redirect和permanent会发生重定向。
而last和break用来实现URL重写,浏览器地址栏URL地址不变

其他注意点

正则匹配传参部分才需要圆括号

正则<regex>中如果只是匹配但不需要传参,则无需用圆括号包裹。

  1. rewrite ^/c_[0-9]+/(.*)$ /comm/$1 break;
  2. # 上方规则仅仅对第二部分进行传参匹配
  3. # 比如:/c_1/go =>/comm/go /c_1/xx/mo =>/comm/xx/mo

引入规则配置文件

rewrite不一定需要完全在配置文件中配置,可以单独引入。

  1. # REWRITE-START URL重写规则引用,修改后将导致面板设置的伪静态规则失效
  2. include /www/server/rewrite/mebugs.conf;
  3. # REWRITE-END
  4. # 配置文件不一定要.conf,.htaccess 也是可以的

活用一些全局变量

配置rewrite规则时可以引入一些Nginx的全局变量,甚至增加if条件判断,可以实现更为复杂的规则配置。

  1. # 如果访问的是mebugs.com的任意子域名才生效如下规则
  2. if ($host ~* (.*)/.mebugs/.com) {
  3. rewrite ^/page_([a-z]+)_(d+)_.html$ /page.php?type=$1&current=$2 last;
  4. }
  5. # 特定子域名访问子目录
  6. if ($http_host ~ me/.mebugs/.com$) {
  7. rewrite ^(.*) /me/$1 break;
  8. }

相关文章