1 Location语法规则

1.1 Location规则

语法规则: location [=|~|~*|^~] /uri/ {… }

首先匹配 =,其次匹配^~,其次是按文件中顺序的正则匹配,最后是交给 /通用匹配。当有匹配成功时候,停止匹配,按当前匹配规则处理请求。

符号

含义

=

= 开头表示精确匹配

^~

^~开头表示uri以某个常规字符串开头,理解为匹配 url路径即可。nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格)

~

~ 开头表示区分大小写的正则匹配

~*

~* 开头表示不区分大小写的正则匹配

!~和!~*

!~和!~*分别为区分大小写不匹配及不区分大小写不匹配的正则

/

用户所使用的代理(一般为浏览器)

$http_x_forwarded_for

可以记录客户端IP,通过代理服务器来记录客户端的ip地址

$http_referer

可以记录用户是从哪个链接访问过来的

 

  匹配规则示例:


[plain]  view plain  copy



    1. location = / {  
    2.     #规则A  
    3. }  
    4. location = /login {  
    5.     #规则B  
    6. }  
    7. location ^~ /static/ {  
    8.     #规则C  
    9. }  
    10. location ~ \.(gif|jpg|png|js|css)$ {  
    11.     #规则D  
    12. }  
    13. location ~* \.png$ {  
    14.     #规则E  
    15. }  
    16. location !~ \.xhtml$ {  
    17.     #规则F  
    18. }  
    19. location !~* \.xhtml$ {  
    20.     #规则G  
    21. }  
    22. location / {  
    23.     #规则H  
    24. }



    那么产生的效果如下:

    1. 访问根目录/,比如http://localhost/将匹配规则A

    2. 访问 http://localhost/login 将匹配规则B,http://localhost/register则匹配规则H

    3. 访问 http://localhost/static/a.html 将匹配规则C

    4. 访问 http://localhost/a.gif,http://localhost/b.jpg 将匹配规则D和规则E,但是规则D顺序优先,规则E不起作用,而http://localhost/static/c.png则优先匹配到规则C

    5. 访问 http://localhost/a.PNG 则匹配规则E,而不会匹配规则D,因为规则E不区分大小写。

    6. 访问 http://localhost/a.xhtml 不会匹配规则F和规则G,http://localhost/a.XHTML不会匹配规则G,因为不区分大小写。规则F,规则G属于排除法,符合匹配规则但是不会匹配到,所以想想看实际应用中哪里会用到。

    7. 访问 http://localhost/category/id/1111 则最终匹配到规则H,因为以上规则都不匹配,这个时候应该是nginx转发请求给后端应用服务器,比如FastCGI(php),tomcat(jsp),nginx作为方向代理服务器存在。

     

    1.2 实际常用规则

    #直接匹配网站根,通过域名访问网站首页比较频繁,使用这个会加速处理。

    #这里是直接转发给后端应用服务器了,也可以是一个静态首页

    # 第一个必选规则


    [plain]  view plain  copy


    # 第二个必选规则是处理静态文件请求,这是nginx作为http服务器的强项

    1. location = / {  
    2.    proxy_passhttp://tomcat:8080/index  
    3. }

    # 有两种配置模式,目录匹配或后缀匹配,任选其一或搭配使用


    [plain]  view plain  copy



      1.     location ^~ /static/ {  
      2.        # 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt  
      3.        root /webroot/res/;  
      4.     }  
      5.   
      6.     location ~* \.(gif|jpg|jpeg|png|css|js|ico)${  
      7.        root /webroot/res/;  
      8.     }


      #第三个规则就是通用规则,用来转发动态请求到后端应用服务器

      #非静态文件请求就默认是动态请求,自己根据实际把握

      #毕竟目前的一些框架的流行,带.php,.jsp后缀的情况很少了



      [plain]  view plain  copy


      1. location / {  
      2.    proxy_pass http://tomcat:8080/  
      3. }

      1.3 Location解析过程

      nginx rewrite get变成了post nginx rewrite location_html

      总结:

      1、    先判断精准命中,如果命中,立即返回结果并结束解析过程。

      2、    判断普通命中,如果有多个命中,“记录”下来“最长”的命中结果(记录但不结束,最长的为准)。

      3、    继续判断正则表达式的解析结果,按配置里的正则表达式顺序为准,由上至下开始匹配,一旦匹配成功1个,立即返回结果,并结束解析过程。

      4、    普通命中顺序无所谓,是因为按命中的长短来确定。正则命中,顺序有所谓,因为是从前入往后命中的。

       

      2 ReWrite语法

      Nginx提供的全局变量或自己设置的变量,结合正则表达式和标志位实现url重写以及重定向。rewrite只能放在server{},location{},if{}中,并且只能对域名后边的除去传递的参数外的字符串起作用。

      Rewrite主要的功能就是实现URL的重写,Nginx的Rewrite规则采用Pcre,perl兼容正则表达式的语法规则匹配,如果需要Nginx的Rewrite功能,在编译Nginx之前,需要编译安装PCRE库。

      通过Rewrite规则,可以实现规范的URL、根据变量来做URL转向及选择配置。

       

      2.1 ReWrite相关指令

      指令

      默认值

      使用范围

      作用

      break

      none

      if,server,location

      完成当前的规则集,不再处理rewrite指令,需要和last加以区分

      if ( condition )

      { ... }

      none

      server,location

      用于检测一个条件是否符合,符合则执行大括号内的语句。不支持嵌套,不支持多个条件&&或||处理

      return

      none

      server,if,location

      用于结束规则的执行和返回状态码给客户端。状态码的值可以是:204,400,402~406,408,410,411,413,416以及500~504,另外非标准状态码444,表示以不发送任何的Header头来结束连接。

      rewrite regex replacement flag

       

      server,location,if

      该指令根据表达式来重定向URI,或者修改字符串。指令根据配置文件中的顺序来执行。注意重写表达式只对相对路径有效。

      uninitialized_variable_warn on|off

      on

      http,server,location,if

      该指令用于开启和关闭未初始化变量的警告信息,默认值为开启。

      set  variable  value

      none

       

      该指令用于定义一个变量,并且给变量进行赋值。变量的值可以是文本、一个变量或者变量和文本的联合,文本需要用引号引起来。

       

       

      2.2 Rewrite全局变量

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

       

      2.3 Rewrite语法规则

      操作符

      含义

      = ,!=

      比较的一个变量和字符串。

      ~, ~*

      与正则表达式匹配的变量,如果这个正则表达式中包含},;则整个表达式需要用"或'包围。

      -f,!-f

      检查一个文件是否存在。

      -d, !-d

      检查一个目录是否存在。

      -e,!-e

      检查一个文件、目录、符号链接是否存在。

      -x, !-x

      检查一个文件是否可执行。

       

      2.4 if指令


      [plain]  view plain  copy



      1.     if  语法格式  
      2.      if 空格 (条件) {  
      3.         重写模式  
      4.      }  
      5.   
      6.         # 限制浏览器访问  
      7.     if ($http_user_agent ~ Firefox) {   
      8.       rewrite ^(.*)$ /firefox/$1 break;   
      9.     }      
      10.   
      11.     if ($http_user_agent ~ MSIE) {   
      12.         rewrite ^(.*)$ /msie/$1 break;   
      13.     }      
      14.   
      15.     if ($http_user_agent ~ Chrome) {   
      16.         rewrite ^(.*)$ /chrome/$1 break;   
      17.     }


      2.5 return指令


      [plain]  view plain  copy



        1. # 限制IP访问  
        2. if  ($remote_addr = 192.168.197.142) {  
        3.    return 403;  
        4. }


        2.6 rewrite指令

        #判断目录是否存在

        #服务器内部的rewrite和302跳转不一样.跳转的话URL都变了,变成重新http请求index.html,而内部rewrite,上下文没变。


        [plain]  view plain  copy



          1. if (!-e $document_root$fastcgi_script_name) {  
          2.     rewrite ^.*$ /index.html break;  
          3. }


          2.7 set指令

          # set指令是设置变量用的,可以用来达到多条件判断时作标志用

          #判断IE并重写,且不用break;我们用set变量来达到目的


          [plain]  view plain  copy


          1.     if ($http_user_agent ~* msie) {  
          2.         set $isie 1;  
          3.     }  
          4.   
          5.     if ($fastcgi_script_name = ie.html) {  
          6.         set $isie 0;  
          7.     }  
          8.   
          9.     if ($isie 1) {  
          10.         rewrite ^.*$ ie.html;  
          11.     }