功能:实现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相同。
下面关于Nginx的文章您也可能喜欢,不妨参考下: