Nginx教程(四) Location配置与ReWrite语法

1 Location语法规则

1.1 Location规则

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

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


符号


含义


=


= 开头表示精确匹配


^~


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


~


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


~*


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


!~和!~*


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


/


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


$http_x_forwarded_for


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


$http_referer


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

匹配规则示例:

      location = / {
          #规则A
      }
      location = /login {
          #规则B
      }
      location ^~ /static/ {
          #规则C
      }
      location ~ \.(gif|jpg|png|js|css)$ {
          #规则D
      }
      location ~* \.png$ {
          #规则E
      }
      location !~ \.xhtml$ {
          #规则F
      }
      location !~* \.xhtml$ {
          #规则G
      }
      location / {
          #规则H
      }

那么产生的效果如下:

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 实际常用规则

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

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

# 第一个必选规则

    location = / {
       proxy_passhttp://tomcat:8080/index
    }

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

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

    location ^~ /static/ {
       # 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt
       root /webroot/res/;
    }

    location ~* \.(gif|jpg|jpeg|png|css|js|ico)${
       root /webroot/res/;
    }

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

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

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

    location / {
       proxy_pass http://tomcat:8080/
    }

1.3 Location解析过程

总结:

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指令

    if  语法格式
     if 空格 (条件) {
        重写模式
     }

        # 限制浏览器访问
    if ($http_user_agent ~ Firefox) {
      rewrite ^(.*)$ /firefox/$1 break;
    }      

    if ($http_user_agent ~ MSIE) {
        rewrite ^(.*)$ /msie/$1 break;
    }      

    if ($http_user_agent ~ Chrome) {
        rewrite ^(.*)$ /chrome/$1 break;
    }

2.5 return指令

    # 限制IP访问
    if  ($remote_addr = 192.168.197.142) {
       return 403;
    }

1.首先从日志查出ip

修改conf配置文件

重启配置文件访问发现

2.6 rewrite指令

#判断目录是否存在

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

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

2.7 set指令

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

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

    if ($http_user_agent ~* msie) {
        set $isie 1;
    }

    if ($fastcgi_script_name = ie.html) {
        set $isie 0;
    }

    if ($isie 1) {
        rewrite ^.*$ ie.html;
    }
时间: 2024-11-10 10:33:27

Nginx教程(四) Location配置与ReWrite语法的相关文章

Location配置与ReWrite语法(五)

原文链接:https://www.cnblogs.com/crazylqy/p/6892010.html location表示uri方式定位,基础语法有三种: location = pattern {} 精准匹配 location pattern {}  一般匹配 location ~ pattern {} 正则匹配 一.location语法规则 语法规则: location [=|~|~*|^~] /uri/ {… } 首先匹配 =,其次匹配^~,其次是按文件中顺序的正则匹配,最后是交给 /通

nginx+tomcat集群配置(4)--rewrite规则和多应用根目录设定思路

前言: nginx中有一块很重要的概念, 就是rewrite规则. 它会对URL进行修改, 然后进行内部的重定向. rewrite授予了nginx更多的自由, 使得后级服务的接入更加地方便. 本文将简单讲述nginx的rewrite规则和原理, 同时讲解下如何借助rewrite实现单tomcat实例/多Web App服务 对应的多域名根目录访问. 案列目标: 首先来谈一下之前对于多Web App服务对应多域名根目录访问的方案. 注: 一个域名对应一个tomcat实例, 一个tomcat实例只包含

转:Nginx 配置 location 总结及 rewrite 规则写法

转: http://www.linuxidc.com/Linux/2015-06/119398.htm 1. location正则写法 一个示例: location =/{ # 精确匹配 / ,主机名后面不能带任何字符串 [ configuration A ] } location /{ # 因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求 # 但是正则和最长字符串会优先匹配 [ configuration B ] } location /documents/{ # 匹配任何以 /do

nginx配置location总结及rewrite规则写法

https://segmentfault.com/a/1190000002797606 location正则写法 一个示例: location = / { # 精确匹配 / ,主机名后面不能带任何字符串 [ configuration A ] } location / { # 因为所有的地址都以 / 开头,所以这条规则将匹配到所有请求 # 但是正则和最长字符串会优先匹配 [ configuration B ] } location /documents/ { # 匹配任何以 /documents

nginx配置location总结及rewrite规则写法(2)

2. Rewrite规则 rewrite功能就是,使用nginx提供的全局变量或自己设置的变量,结合正则表达式和标志位实现url重写以及重定向.rewrite只能放在server{},location{},if{}中,并且只能对域名后边的除去传递的参数外的字符串起作用,例如http://sui.com/a/we/index.php?id=1&u=str 只对/a/we/index.php重写.语法rewrite regex replacement [flag]; 如果相对域名或参数字符串起作用,

nginx的location配置详解

语法规则: location [=|~|~*|^~] /uri/ { … } = 开头表示精确匹配 ^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可.nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格). ~ 开头表示区分大小写的正则匹配 ~*  开头表示不区分大小写的正则匹配 !~和!~*分别为区分大小写不匹配及不区分大小写不匹配 的正则 / 通用匹配,任何请求都会匹配到. 多个location配置

Nginx Location配置总结

http://blog.sina.com.cn/s/blog_97688f8e0100zws5.html 语法规则: location [=|~|~*|^~] /uri/ { … }= 开头表示精确匹配^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可.nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格).~ 开头表示区分大小写的正则匹配~*  开头表示不区分大小写的正则匹配!~和!~*分别为区分大小写

nginx之location配置

语法规则: location [=|~|~*|^~] /uri/ { … } = 开头表示精确匹配 ^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可.nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格). ~ 开头表示区分大小写的正则匹配 ~*开头表示不区分大小写的正则匹配 !~和!~*分别为区分大小写不匹配及不区分大小写不匹配 的正则 / 通用匹配,任何请求都会匹配到. 多个location配置的情

Nginx Location配置总结及基础最佳实践

参考来源: http://blog.zol.com.cn/1067/article_1066186.html,http://flandycheng.blog.51cto.com/855176/280121 语法规则: location [=|~|~*|^~] /uri/ { … } = 开头表示精确匹配 ^~ 开头表示uri以某个常规字符串开头,理解为匹配 url路径即可.nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空