Nginx的URL Rewrite基本指令

linghaiyan

　　
　　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相同。