首页 > nginx > nginx rewrite 指令

nginx rewrite 指令

2012年9月21日 发表评论 阅读评论

nginx通过ngx_http_rewrite_module模块支持url重写、支持if条件判断,但不支持else。

该模块需要PCRE支持,应在编译nginx时指定PCRE源码目录, nginx安装方法

nginx rewrite指令执行顺序:

1.执行server块的rewrite指令(这里的块指的是server关键字后{}包围的区域,其它xx块类似)
2.执行location匹配
3.执行选定的location中的rewrite指令
如果其中某步URI被重写,则重新循环执行1-3,直到找到真实存在的文件

如果循环超过10次,则返回500 Internal Server Error错误

break指令

语法:break;
默认值:无
作用域:server,location,if

停止执行当前虚拟主机的后续rewrite指令集
break指令实例:

if指令

语法:if(condition){...}
默认值:无
作用域:server,location
对给定的条件condition进行判断。如果为真,大括号内的rewrite指令将被执行。
if条件(conditon)可以是如下任何内容:

  • 一个变量名;false如果这个变量是空字符串或者以0开始的字符串;
  • 使用= ,!= 比较的一个变量和字符串
  • 是用~, ~*与正则表达式匹配的变量,如果这个正则表达式中包含},;则整个表达式需要用" 或' 包围
  • 使用-f ,!-f 检查一个文件是否存在
  • 使用-d, !-d 检查一个目录是否存在
  • 使用-e ,!-e 检查一个文件、目录、符号链接是否存在
  • 使用-x , !-x 检查一个文件是否可执行

if指令实例

return指令

语法:return code;

return code URL;

return URL;
默认值:无
作用域:server,location,if

停止处理并返回指定状态码(code)给客户端。
非标准状态码444表示关闭连接且不给客户端发响应头。
从0.8.42版本起,return 支持响应URL重定向(对于301,302,303,307),或者文本响应(对于其他状态码).
对于文本或者URL重定向可以包含变量

rewrite指令

语法:rewrite regex replacement [flag];
默认值:无
作用域:server,location,if
如果一个URI匹配指定的正则表达式regex,URI就按照replacement重写。
rewrite按配置文件中出现的顺序执行。flags标志可以停止继续处理。
如果replacement以"http://"或"https://"开始,将不再继续处理,这个重定向将返回给客户端。
flag可以是如下参数
last 停止处理后续rewrite指令集,然后对当前重写的新URI在rewrite指令集上重新查找。
break 停止处理后续rewrite指令集,并不在重新查找,但是当前location内剩余非rewrite语句和location外的的非rewrite语句可以执行。
redirect 如果replacement不是以http:// 或https://开始,返回302临时重定向
permant 返回301永久重定向
最终完整的重定向URL包括请求scheme(http://,https://等),请求的server_name_in_redirect和 port_in_redirec三部分 ,说白了也就是http协议 域名 端口三部分组成。

rewrite实例

如果这些rewrite放到 “/download/” location如下所示, 那么应使用break而不是last , 使用last将循环10次匹配,然后返回 500错误:

对于重写后的URL(replacement)包含原请求的请求参数,原URL的?后的内容。如果不想带原请求的参数 ,可以在replacement后加一个问号。如下,我们加了一个自定义的参数user=$1,然后在结尾处放了一个问号?,把原请的参数去掉。

如果正则表达regex式中包含 “}” 或 “;”, 那么整个表达式需要用双引号或单引号包围.

rewrite_log指令


语法:rewrite_log on|off;
默认值:rewrite_log off;
作用域:http,server,location,if
开启或关闭以notice级别打印rewrite处理日志到error log文件。

nginx打开rewrite log例子

rewrite_log on;
error_log logs/xxx.error.log notice;

1.打开rewrite on
2.把error log的级别调整到 notice

set指令


语法:set variable value;
默认值:none
作用域:server,location,if
定义一个变量并赋值,值可以是文本,变量或者文本变量混合体。

uninitialized_variable_warn指令


语法:uninitialized_variable_warn on | off;
默认值:uninitialized_variable_warn on
作用域:http,server,location,if

控制是否输出为初始化的变量到日志

分类: nginx 标签: , , ,
  1. 2016年6月6日13:48 | #1

    nginx经过rewrite后,是否注入remote_addr之类变量会被重新插值?

  2. 2015年11月19日15:01 | #2

    学习了,看到博主的博客收获很大,我是一个对nginx源码十分感兴趣的服务端开发,这是我博客中对 nginx 源码的一些总结:http://techlog.cn/article/list/10182612
    不知道是否可以加个友链,交个朋友,有问题互相交流学习,谢谢

  3. 2014年11月22日16:41 | #3

    在学习。rewrite学着很辛苦啊。如何测试呢。

  4. nginx的困惑
    2012年12月11日14:10 | #4

    nginx遇到url中特殊字符时的问题.我有这样一段配置 ,正则表达式是用来匹配http://hostname/ep,/originalserver/img/1k.jpg这样的url。$1对应上面的 ep, (有个逗号),且$1的内容是动态增长的。 $2对应上面的originalserver/img/1k.jpg.配置如下:location ~* ^/(.*[,]+)/(.*)$ { if ($request_uri ~ ^/(.*[,]+)/(.*)$ ){ set $route_information $1; set_unescape_uri $squid_url $2; # echo $squid_url; rewrite ^(.*)$ /$squid_url? break; } }nginx处理正常的url上面的配置都没有问题.但是当nginx处理的url 中含有特殊的字符的时候,会对url进行解码.比如url:http://hostname/ep,/originalserver/img/good%2Ftt.jpg.在rewrite 的上面echo $squid_url; 我输出的url特殊字符都是正常的没有变化 good%2Ftt.jpg.但是rewrite到后台的url却变成了good%252Ftt.jpg

    • 2012年12月14日17:02 | #5

      url是不能含有%好的,如果有百分号都会被转义成%25

  1. 2014年4月11日17:39 | #1
  2. 2014年4月22日16:42 | #2
  3. 2014年5月25日18:07 | #3
  4. 2015年4月9日21:26 | #4
  5. 2015年6月17日17:33 | #5
  6. 2015年6月20日20:06 | #6
  7. 2015年6月30日16:26 | #7
  8. 2015年6月30日17:27 | #8
  9. 2015年10月18日20:33 | #9
  10. 2016年1月23日17:27 | #10
  11. 2016年3月7日15:08 | #11
  12. 2016年4月18日23:01 | #12
  13. 2016年4月22日12:20 | #13
  14. 2016年5月6日02:04 | #14
  15. 2016年6月27日14:34 | #15
  16. 2016年7月13日09:36 | #16
  17. 2016年8月15日16:58 | #17
  18. 2016年8月17日18:06 | #18
  19. 2016年9月5日14:23 | #19
  20. 2016年11月6日10:53 | #20
  21. 2016年11月23日00:49 | #21
  22. 2017年1月3日17:29 | #22
  23. 2017年1月19日19:40 | #23
  24. 2017年3月30日16:57 | #24
  25. 2017年8月4日23:46 | #25
  26. 2017年9月18日18:52 | #26
  27. 2017年11月2日14:28 | #27
  28. 2018年2月3日13:38 | #28
  29. 2018年6月23日06:51 | #29
  30. 2019年2月8日01:00 | #30
  31. 2019年2月8日01:28 | #31
  32. 2019年2月8日21:28 | #32
  33. 2019年3月12日12:43 | #33
  34. 2019年4月17日10:54 | #34
  35. 2019年5月25日22:54 | #35
  36. 2019年5月26日02:42 | #36
  37. 2019年6月13日10:58 | #37
  38. 2019年8月17日15:58 | #38
  39. 2020年5月1日11:09 | #39
  40. 2020年6月20日22:45 | #40
  41. 2020年10月28日19:37 | #41