#nginx配置location总结

1. 语法规则

location [=||*|^~] /uri/ { … }

模式

含义

location = /uri

= 表示精确匹配，只有完全匹配上才能生效

location ~ pattern

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

location ~* pattern

表示不区分大小写的正则匹配

location ^~ /uri

^~ 开头对URL路径进行前缀匹配，并且在正则之前，Nginx 不对 URL 做编码，因此请求为 /static/20%/aa，可以被 ^~ /static/ /aa 匹配到

location /uri

不带任何修饰符，也表示前缀匹配，但是在正则匹配之后

location /

通用匹配，任何未匹配到其它location的请求都会匹配到，相当于switch中的default

1.1 普通匹配(通用匹配)

遵循最长匹配规则，假设一个请求匹配到了两个普通规则，则选择匹配长度大的那个

location /{
    [matches]
  }
  
  location /test{
    [matches]
  }

1.2 精确匹配

= 表示精确匹配，只有完全匹配上才能生效

location = /{
    [matchtes]
  }
  location = /test{
    [matches]
  }

1.3 正则匹配

~ 区分大小写的匹配
  location ~ ^*.php${
    [matches]
  }
  
  ~* 不区分大小写的匹配
  location ~* ^*.php${
    [matches]
  }

1.4 前缀匹配

^~ 普通字符匹配，如果请求匹配此规则，则其他规则忽略，只匹配该规则

location ^~ /test{
    [matches]
  }

2. 匹配顺序

(location =) > (location 完整路径) > (location ^~ 路径) > (location ,* 正则顺序) > (location 部分起始路径) > (/)

  多个 location 配置的情况下匹配顺序为:

  • 首先精确匹配 =
  • location 完整路径
  • 其次前缀匹配 ^~
  • 其次是按文件中顺序的正则匹配
  • 然后匹配不带任何修饰的前缀匹配。
  • 最后是交给 / 通用匹配
  • 当有匹配成功时候，停止匹配，按当前匹配规则处理请求

  例子，有如下匹配规则：

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

  那么产生的效果如下：

  • 访问根目录 /， 比如 http://localhost/ 将匹配规则 A
  • 访问 http://localhost/login 将匹配规则 B，http://localhost/register 则匹配规则 F
  • 访问 http://localhost/static/a.html 将匹配规则 C
  • 访问 http://localhost/a.gif, http://localhost/b.jpg 将匹配规则 D 和规则 E，但是规则 D 顺序优先，规则 E 不起作用，而 http://localhost/static/c.png 则优先匹配到规则 C
  • 访问 http://localhost/a.PNG 则匹配规则 E，而不会匹配规则 D，因为规则 E 不区分大小写。
  • 访问 http://localhost/category/id/1111 则最终匹配到规则 F，因为以上规则都不匹配，这个时候应该是 nginx 转发请求给后端应用服务器，比如 FastCGI（php），tomcat（jsp），nginx 作为反向代理服务器存在。

3. 常用正则变量

. ： 匹配除换行符以外的任意字符
? ： 重复0次或1次
+ ： 重复1次或更多次
* ： 重复0次或更多次
\d ：匹配数字
^ ： 匹配字符串的开始
$ ： 匹配字符串的介绍
{n} ： 重复n次
{n,} ： 重复n次或更多次
[c] ： 匹配单个字符c
[a-z] ： 匹配a-z小写字母的任意一个

4. 常用的用法

# 直接匹配网站根，通过域名访问网站首页比较频繁，使用这个会加速处理，官网如是说。
# 这里是直接转发给后端应用服务器了，也可以是一个静态首页
# 第一个必选规则
location = / {
    proxy_pass http://tomcat:8080/index
}

# 第二个必选规则是处理静态文件请求，这是 nginx 作为 http 服务器的强项
# 有两种配置模式，目录匹配或后缀匹配，任选其一或搭配使用
location ^~ /static/ {
    root /webroot/static/;
}

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

# 第三个规则就是通用规则，用来转发动态请求到后端应用服务器
# 非静态文件请求就默认是动态请求，自己根据实际把握
# 毕竟目前的一些框架的流行，带.php、.jsp后缀的情况很少了
location / {
    proxy_pass http://tomcat:8080/
}

参考文章：

https://moonbingbing.gitbooks.io/openresty-best-practices/ngx/nginx_local_pcre.html