Nginx rewrite 学习笔记

作者:阿圣(Sfan) 发布于:2015-1-16 23:18 Friday 分类:运维

  1. Nginx Rewrite 指令
    • set 
    • if
    • break 
    • return
    • rewrite
  2. Nginx rewrite 执行顺序
  3. Nginx rewrite 示例解析


 

Nginx Rewrite 指令 

 

set指令 

语法:set variable value; 

默认值:none 

作用域:server,location,if 

定义一个变量并赋值,值可以是文本,变量或者文本变量混合体。

 

 

if指令

语法:if(condition){...}

默认值:无

作用域:server,location

对给定的条件condition进行判断。如果为真,大括号内的rewrite指令将被执行。

if条件(conditon)可以是如下任何内容:

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

break指令

语法:break;

默认值:无

作用域:server,location,if

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

 

 

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临时重定向

permanent 返回301永久重定向

 

Nginx rewrite 执行顺序

1.执行server块的rewrite指令(这里的块指的是server关键字后{}包围的区域,其它xx块类似)

2.执行location匹配

3.执行选定的location中的rewrite指令

如果其中某步URI被重写,则重新循环执行1-3,直到找到真实存在的文件

 

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

评论(0) 引用(0) 浏览(19298)

Powered by emlog 湘ICP备08103487号