linghaiyan 发表于 2018-11-8 07:42:07

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里的标记,表示完成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相同。


页: [1]
查看完整版本: Nginx的URL Rewrite基本指令