location和rewrite介绍

Posted 2021-06-26 敲击岁月

location和rewrite

• location
• • 常用的Nginx 正则表达式
• rewrite
• • rewrite 执行顺序如下：
  • flag标记说明
  • rewrite 示例

location

从功能看 rewrite 和 location 似乎有点像，都能实现跳转，主要区别在于 rewrite 是在同一域名内更改获取资源的路径，而 location 是对一类路径做控制访问或反向代理，还可以proxy_pass 到其他机器。

location 大致可以分为三类：

精准匹配	location = / { }
一般匹配	location / { }
正则匹配	location ~ / { }

location 常用的匹配规则：

= ：进行普通字符精确匹配，也就是完全匹配。
^~ ：表示普通字符匹配。使用前缀匹配。如果匹配成功，则不再匹配其它 location。
~ ：区分大小写的匹配。
~* ：不区分大小写的匹配。
!~ ：区分大小写的匹配取非。
!~* ：不区分大小写的匹配取非。

location 优先级：

首先精确匹配 =
其次前缀匹配 ^~
其次是按文件中顺序的正则匹配 ~ 或 ~*
然后匹配不带任何修饰的前缀匹配
最后是交给 / 通用匹配

优先级总结：
(location =) > (location 完整路径) > (location ^~ 路径) > (location _,* 正则顺序) > (location 部分起始路径) > (location /)

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

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

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

第三个规则就是通用规则，比如用来转发带.php、.jsp后缀的动态请求到后端应用服务器
非静态文件请求就默认是动态请求
location / {
proxy_pass http://tomcat_server;
}

常用的Nginx 正则表达式

^	匹配输入字符串的起始位置
$	匹配输入字符串的结束位置
*	匹配前面的字符零次或多次
+	匹配前面的字符一次或多次
?	匹配前面的字符零次或一次
.	匹配除“\\n”之外的任何单个字符
\\	将后面接着的字符标记为一个特殊字符或一个原义字符或一个向后引用
\\d	匹配纯数字
{ n }	重复 n 次
{ n, }	重复 n 次或更多次
{n,m}	重复 n 到 m 次
[ ]	定义匹配的字符范围
[a-z]	匹配 a-z 小写字母的任意一个
[a-zA-Z0-9]	匹配所有大小写字母或数字
( )	表达式的开始和结束位置

rewrite

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

rewrite 执行顺序如下：

(1) 执行 server 块里面的 rewrite 指令。
(2) 执行 location 匹配。
(3) 执行选定的 location 中的 rewrite 指令。

语法rewrite regex replacement flag
regex ：表示正则匹配规则。
replacement ：表示跳转后的内容。
flag ：表示 rewrite 支持的 flag 标记。

flag标记说明

last	本条规则匹配完成后，继续向下匹配新的location URI规则，一般用在 server 和 if 中。
break	本条规则匹配完成即终止，不再匹配后面的任何规则，一般使用在 location 中
redirect	返回302临时重定向，浏览器地址会显示跳转后的URL地址
permanent	返回301永久重定向，浏览器地址栏会显示跳转后的URL地址。

rewrite 示例

1.基于域名的跳转
现在公司旧域名www.kgc.com有业务需求变更，需要使用新域名www.benet.com代替，但是旧域名不能废除，需要跳转到新域名上，而且后面的参数保持不变。

vim /usr/local/nginx/conf/nginx.conf
server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main; #日志修改
	location / {                                          #添加域名重定向
        if ($host = 'www.kgc.com'){#$host为rewrite全局变量，代表请求主机头字段或主机名
     rewrite ^/(.*)$ http://www.benet.com/$1 permanent;	#$1为正则匹配的内容，即域名后边的字符串	                                    
        }
        root   html;
        index  index.html index.htm;
    }
}

2.基于客户端 IP 访问跳转
今天公司业务新版本上线，要求所有 IP 访问任何内容都显示一个固定维护页面，只有公司 IP ：192.168.80.10访问正常。

server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;	#日志修改

	#设置是否合法的IP标记
      set $rewrite true;			#设置变量$rewrite，变量值为boole值true
    #判断是否为合法IP
	if ($remote_addr = "192.168.80.10"){		#当客户端IP为192.168.80.10时，将变量值设为false，不进行重写
        set $rewrite false;
    }
	#除了合法IP，其它都是非法IP，进行重写跳转维护页面
    if ($rewrite = true){						#当变量值为true时，进行重写
        rewrite (.+) /weihu.html;				#重写在访问IP后边插入/weihu.html，例如192.168.80.11/weihu.html
    }
    location = /weihu.html {
        root /var/www/html;	#网页返回/var/www/html/weihu.html的内容
    }
	
	location / {
        root   html;
        index  index.html index.htm;
    }
}

3.基于旧域名跳转到新域名后面加目录
现在访问的是 http://bbs.kgc.com，现在需要将这个域名下面的访问都跳转到http://www.kgc.com/bbs

server {
	listen       80;
	server_name  bbs.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;
	#添加
	location /post {
        rewrite (.+) http://www.kgc.com/bbs$1 permanent;        #这里的$1为位置变量，代表/post
    }
	
	location / {
        root   html;
        index  index.html index.htm;
    }
}

4.基于参数匹配的跳转
现在访问http://www.kgc.com/100-(100|200)-100.html 跳转到http://www.kgc.com页面。

server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log  main;
	
	if ($request_uri ~ ^/100-(100|200)-(\\d+).html$) {
        rewrite (.*) http://www.kgc.com permanent;
    }

	location / {
        root   html;
        index  index.html index.htm;
    }
}

5. 基于目录下所有 php 结尾的文件跳转

server {
	listen       80;
	server_name  www.kgc.com;		#域名修改	
	charset utf-8;
	access_log  /var/log/nginx/www.kgc.com-access.log
	
	location ~* /upload/.*\\.php$ {
        rewrite (.+) http://www.kgc.com permanent;
    }

	location / {
        root   html;
        index  index.html index.htm;
    }