Location配置与ReWrite语法 - leftrk/dotfile GitHub Wiki

Location语法规则

Location规则

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

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

符号 含义
= = 开头表示精确匹配
^~ ^~开头表示uri以某个常规字符串开头,理解为匹配url路径即可。nginx不对url做编码,因此请求为/static/20%/aa,可以被规则^~ /static/ /aa匹配到(注意是空格)
~ ~ 开头表示区分大小写的正则匹配
~* ~* 开头表示不区分大小写的正则匹配
!~!~* !~!~*分别为区分大小写不匹配及不区分大小写不匹配的正则
/ 用户所使用的代理(一般为浏览器)
$http_x_forwarded_for 可以记录客户端IP,通过代理服务器来记录客户端的ip地址
$http_referer 可以记录用户是从哪个链接访问过来的

规则示例

location = / {
    # 规则A
    # 访问根目录/,比如http://localhost/将匹配规则A
}
location = /login {
    # 规则B
    # 访问 http://localhost/login 将匹配规则B
}
location ^~ /static/ {
    # 规则C
    # 访问 http://localhost/static/a.html 将匹配规则C
    # http://localhost/static/c.png则优先匹配到规则C
}
location ~ \.(gif|jpg|png|js|css)$ {
    # 规则D
    # 访问 http://localhost/a.gif, http://localhost/b.jpg 将匹配规则D和规则E,但是规则D顺序优先,规则E不起作用
}
location ~* \.png$ {
    # 规则E
    # 访问 http://localhost/a.PNG 则匹配规则E,而不会匹配规则D,因为规则E不区分大小写
}
location !~ \.xhtml$ {
    # 规则F
}
location !~* \.xhtml$ {
    # 规则G
}
location / {
    #规则H
    # 访问 http://localhost/register则匹配规则H
    # 访问 http://localhost/category/id/1111 则最终匹配到规则H,因为以上规则都不匹配,这个时候应该是nginx转发请求给后端应用服务器,比如FastCGI(PHP),tomcat(jsp),nginx作为方向代理服务器存在
}

实际常用规则

第一个必选规则直接匹配网站根

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

第二个必选规则是处理静态文件请求

  • 目录匹配
location ^~ /static/ {
   # 请求/static/a.txt 将被映射到实际目录文件:/webroot/res/static/a.txt
   root /webroot/res/;
}
  • 后缀匹配
location ~* \.(gif|jpg|jpeg|png|css|js|ico)${
   root /webroot/res/;
}

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

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

Location解析过程

iJudX9.png

  1. 先判断精准命中,如果命中,立即返回结果并结束解析过程。
  2. 判断普通命中,如果有多个命中,记录下来最长的命中结果(记录但不结束,最长的为准)。
  3. 继续判断正则表达式的解析结果,按配置里的正则表达式顺序为准,由上至下开始匹配,一旦匹配成功1个,立即返回结果,并结束解析过程。
  4. 普通命中顺序无所谓,是因为按命中的长短来确定。正则命中,顺序有所谓,因为是从前入往后命中的。

ReWrite语法

Nginx提供的全局变量或自己设置的变量,结合正则表达式和标志位实现url重写以及重定向。

rewrite只能放在server{},location{},if{},并且只能对域名后边的除去传递的参数外的字符串起作用。

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

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