Nginx的URL Rewrite基本指令

1、Nginx Rewrite规则相关指令：

功能：实现URL的重写，通过Rewrite规则，可以实现规范的URL，根据变量来做URL转向及选择配置。

作用范围：server{},location{},if{}

优先级：

执行server块的rewrite指令 > 执行location匹配 >执行选定的location中的rewrite指令。

Nginx Rewrite规则相关指令有if、rewrite、set、return、break等，其中Rewrite是最关键的指令。

1.1）break指令

语法：break

默认值：none

使用环境：server，location，if

作用：break 终止匹配, 不再匹配后面的规则

eg:

if (slow) {
limit_rate 20k;
break;
}

1.2）if指令

语法：if（condition）{...}

默认值：none

使用环境：server，location

作用：该指令用于检测一个条件是否符合，如果条件符合，则执行大括号内的语句。if指令不支持嵌套，不支持多个条件&&和||处理。

以下信息可以被指定为条件：

（1）变量名，错误的值包括：空字符串“”，或者任何以0开始的字符串。

（2）变量比较可以使用“=”和“！=”（等于和不等于）运算符

（3）正则表达式模式匹配可以使用“~”和“~*”符号

（4）~  为区分大小写匹配 

（5）~* 为不区分大小写匹配 

（6）!~和!~*分别为区分大小写不匹配及不区分大小写不匹配

（7）-f和!-f用来判断是否存在文件 

（8）-d和!-d用来判断是否存在目录 

（9）-e和!-e用来判断是否存在文件或目录 

（10）-x和!-x用来判断文件是否可执行

1.3）return指定：

语法：return code

默认值：none

使用环境：server，location，if

作用：该指令用于结束规则的执行并返回状态码给客户端。状态码可以使用这些值：204、400、402-406、408、410、411、413、416、500-504.此外，非标准状态码444将以不发送任何Header头的方式结束连接：

eg：访问URL以.sh和。bash结束，返回状态码403.

location `.*\.(sh|bash)?$
{
return 403;
}

1.4)rewrite指令：

语法: rewrite regex replacement flag

默认值：none

使用环境：server，location，if

作用：该指令根据变大时来重定向URL，或者修改字符串，指令根据配置文件中的顺序来执行。

Rewrite指令的最后一下参数为flag标记，支持的flag标记有：

last 相当于Apache里的[L]标记，表示完成rewrite

break 本条规则匹配完成之后，终止匹配，不再匹配后面的规则。

redirect 返回302临时重定向 地址栏会显示跳转后的地址

permanent 返回301永久重定向 地址栏会显示跳转后的地址

1.5）set指令：

语法：set variable value

默认值：none

使用环境：server，location，if

作用：该指令用于定义一个变量，并给变量赋值，变量的值可以为文本，变量及文本变量的联合。

eg：set $varname 'hello'

1.6） uninitalized_variable_warn指令：

语法：unitialized_variable_warn onloff

默认值：unitialized_variable_warn on

使用环境：http、server、location、if

作用：该指令用于开启或者关闭未初始化变量的警告信息，默认值为开启。

1.7）Nginx Rewrite可以用到的全局变量：

$args ： #这个变量等于请求行中的参数，同$query_string

$content_length ： 请求头中的Content-length字段。

$content_type ： 请求头中的Content-Type字段。

$document_root ： 当前请求在root指令中指定的值。

$host ： 请求主机头字段，否则为服务器名称。

$http_user_agent ： 客户端agent信息

$http_cookie ： 客户端cookie信息

$limit_rate ： 这个变量可以限制连接速率。

$request_method ： 客户端请求的动作，通常为GET或POST。

$remote_addr ： 客户端的IP地址。

$remote_port ： 客户端的端口。

$remote_user ： 已经经过Auth Basic Module验证的用户名。

$request_filename ： 当前请求的文件路径，由root或alias指令与URI请求生成。

$scheme ： HTTP方法（如http，https）。

$server_protocol ： 请求使用的协议，通常是HTTP/1.0或HTTP/1.1。

$server_addr ： 服务器地址，在完成一次系统调用后可以确定这个值。

$server_name ： 服务器名称。

$server_port ： 请求到达服务器的端口号。

$request_uri ： 包含请求参数的原始URI，不包含主机名，如：”/foo/bar.php?arg=baz”。

$uri ： 不带请求参数的当前URI，$uri不包含主机名，如”/foo/bar.html”。

$document_uri ： 与$uri相同。