首页
所有分类
TAGS
文字工具 EMOJI BIBLE
服务器 Servers

nginx rewrite功能使用场景分析

Posted in Servers onMay 30, 2022

前言

大家在浏览某些网站的时候，有没有发现，当输入：www.abc.com或者www.abcd.com的时候，页面均能正常显示www.abc.com的主页内容。这就是nginx rewrite的一个使用场景。

rewrite简介

rewrite是Nginx服务器提供的一个重要基本功能，主要作用用来实现URL地址重写

rewrite功能实现依赖于pcre的支持，因此在编译安装Nginx服务器之前，需安装pcre库(nginx使用ngx_http_rewrite_module模块来解析和处理Rewrite功能的相关配置)

在真正了解rewrite的使用之前，有必要全面系统学习下rewrite相关的指令和语法使用，下面来逐一了解下吧

Rewrite规则与指令

set指令

该指令用来设置一个新的变量。

nginx rewrite功能使用场景分析

  • variable，变量名，该变量名要用"$"作为变量的第一个字符，且不能与Nginx服务器预设的全局变量同名；
  • value:变量值，可以是字符串、其他变量或者变量的组合等；

一个简单的案例

server {
    listen 8081;
    server_name localhsot;
    location /server {
            set $name zhangsan;
            set $age 19;
            default_type text/plain;
            return 200 $name=$age;
    }
}

重启nginx服务，然后浏览器访问观察下效果

nginx rewrite功能使用场景分析

下面列举了Rewrite常用全局变量

这些变量可以在使用过程中结合自身的业务灵活选择使用

变量 说明
$args 变量中存放了请求URL中的请求指令。如http://IP:8080?arg1=value1&args2=value2中 的"arg1=value1&arg2=value2"，功能和$query_string一样
$http_user_agent 变量存储了用户访问服务的代理信息(如果通过浏览器访问，记录的是浏览器的相关版本信息)
$host 变量存储的是访问服务器的server_name值
$document_uri 变量存储了当前访问地址的URI。比如http://IP/server?id=10&name=zhangsan中的"/server"，功能和$uri一样
$document_root 变量存储的是当前请求对应location的root值，如果未设置，默认指向Nginx自带html目录所在位置
$content_length 变量存储的是请求头中的Content-Length的值
$content_type 变量存储的是请求头中的Content-Type的值
$http_cookie 变量存储的是客户端的cookie信息，可以通过add_header Set-Cookie’cookieName=cookieValue’来添加cookie数 据
$limit_rate 变量中存储的是Nginx服务器对网络连接速率的限制，也就是Nginx配置中对limit_rate指令设置的值，默认是0，不限制
$remote_addr 变量中存储的是客户端的IP地址
$remote_port 变量中存储了客户端与服务端建立连接的端口号
$remote_user 变量中存储了客户端的用户名，需要有认证模块才能获取
$scheme 变量中存储了访问协议
$server_addr 变量中存储了服务端的地址
$server_name 变量中存储了客户端请求到达的服务器的名称
$server_port 变量中存储了客户端请求到达服务器的端口号
$server_protocol 变量中存储了客户端请求协议的版本，比如"HTTP/1.1"
$request_body_file 变量中存储了发给后端服务器的本地文件资源的名称
$request_method 变量中存储了客户端的请求方式，比如"GET","POST"等
$request_filename 变量中存储了当前请求的资源文件的路径名
$request_uri 变量中存储了当前请求的URI，并且携带请求参数，比如http://IP/server?id=10&name=zhangsan中的"/server?id=10&name=zhangsan名

我们来随机测试下几个指令的使用吧

$args

server {
    listen 8081;
    server_name localhsot;
    location /server {
            set $name zhangsan;
            set $age 19;
            default_type text/plain;
            return 200 $name=$age=$args;
    }
}

nginx rewrite功能使用场景分析

$http_user_agent

nginx rewrite功能使用场景分析

nginx rewrite功能使用场景分析

其他的指令有兴趣的同学可以自行尝试，下面使用这些指令完成一个需求

自定义日志输出格式，将请求的日志输出到自定义的日志中

具体配置如下：

log_format main '$remote_addr - $request - $status - $request_uri - $http_user_agent';
   server {
        listen 8081;
        server_name localhsot;
        location /server {
                access_log logs/access-server.log main;
                set $name zhangsan;
                set $age 19;
                default_type text/plain;
                return 200 $name=$age=$args=$http_user_agent;
        }
    }

通过这种方式，就可以实现自定义请求的相关参数输出到自定义的日志文件中

nginx rewrite功能使用场景分析

if指令

该指令用来支持条件判断，并根据条件判断结果选择不同的Nginx配置

nginx rewrite功能使用场景分析

condition为判定条件，可以支持以下写法：

1）变量名称，如果变量名对应的值为空或者是0，if都判断为false,其他条件为true

if ($param) { 

}
location /testif {
                set $username 'zhangsan';
                default_type text/plain;
                if ($username){
                        return 200 success;
                }
                return 200 'params is empty';
}

nginx rewrite功能使用场景分析

2） 使用"=“和”!="比较变量和字符串是否相等，满足为true，不满足为false

if ($request_method = POST) { 
 return 405; 3
}

注意：此处和Java不一样的是字符串不需加引号

3）使用正则表达式对变量匹配

  • 匹配成功返回true，否则返回false；
  • 变量与正则表达式之间使用"“,”“,”!“,”!"来连接；
  • “~” 代表匹配正则表达式过程中区分大小写；
  • "~*"代表匹配正则表达式过程中不区分大小写；
  • "!“和”!*"刚好和上面取相反值，如果匹配上返回false,匹配不上返回true；
if ($http_user_agent ~ MSIE) {
    #$http_user_agent的值中是否包含MSIE字符串，如果包含返回 true 
}

注意：正则表达式字符串一般不需要加引号，但是如果字符串中包含"}“或者是”;"等字符时，就需要把引号加上

if ($http_user_agent ~ Safari){
                        return 200 Chrome;
  }

nginx rewrite功能使用场景分析

4）判断请求文件是否存在使用"-f"和"!-f"

  • 当使用"-f"时，如果请求的文件存在返回true，不存在返回false；
  • 当使用"!f"时，如果请求文件不存在，但该文件所在目录存在返回true,文件和目录都不存在返回false,如果文件存在返回false；
if (-f $request_filename){
    #判断请求的文件是否存在
}

if (!-f $request_filename){
    #判断请求的文件是否不存在
}

案例展示

location /file {
                root html;
                default_type text/html;
                if (!-f $request_filename){
                        return 200 '<h1>not find file</h1>';
                }
        }

当访问目录下不存在的文件时，将会看到如下的异常返回

nginx rewrite功能使用场景分析

5） 判断请求的目录是否存在使用"-d"和"!-d"

  • 当使用"-d"时，如果请求的目录存在，if返回true，如果目录不存在则返回false；
  • 当使用"!-d"时，如果请求的目录不存在但该目录的上级目录存在则返回true，该目录和它上级目录都不存在则返回false,如果请求目录存在也返回false；

6） 判断请求的目录或者文件是否存在使用"-e"和"!-e"

  • 当使用"-e",如果请求的目录或者文件存在时，if返回true,否则返回false；
  • 当使用"!-e",如果请求的文件和文件所在路径上的目录都不存在返回true,否则返回false；

7） 判断请求的文件是否可执行使用"-x"和"!-x"

  • 当使用"-x",如果请求的文件可执行，if返回true,否则返回false；
  • 当使用"!-x",如果请求文件不可执行，返回true,否则返回false； break指令

该指令用于中断当前相同作用域中的其他Nginx配置。与该指令处于同一作用域的Nginx配置中，位于它前面的指令配置生效，位于后面的指令配置无效

nginx rewrite功能使用场景分析

location /{
    if ($param){

        set $id $1;
        break;
        limit_rate 10k;
    }
}

案例演示

location /break {
                default_type text/plain;
                set $username MIKE;
                if ($args){
                        set $username JIM;
                        break;
                        set $username JODAN;
                }
                return 200 $username;
        }

nginx rewrite功能使用场景分析

return指令

该指令用于完成对请求的处理，直接向客户端返回响应状态代码。在return后的所有Nginx配置都是无效的

nginx rewrite功能使用场景分析

  • code，为返回给客户端的HTTP状态代理。可以返回的状态代码为0~999的任意HTTP状态代理；
  • text:为返回给客户端的响应体内容，支持变量的使用；
  • URL:为返回给客户端的URL地址；
location /return {
                default_type application/json;
                return 200 '{id:1,name:jike}';
        }

nginx rewrite功能使用场景分析

rewrite指令

该指令通过正则表达式的使用来改变URI。可以同时存在一个或者多个指令，按照顺序依次对URL进行匹配和处理

URL和URI的区别

  • URI:统一资源标识符
  • URL:统一资源定位符

nginx rewrite功能使用场景分析

  • regex，用来匹配URI的正则表达式；
  • replacement:匹配成功后，用于替换URI中被截取内容的字符串。如果该字符串是以"http://"或者"https://"开头的，则不会继续向下对URI进行其他处理，而是直接返回重写后的URI给客户端；
  • flag:用来设置rewrite对URI的处理行为，可选值有如下

last break redirect permanent

last : 终止继续在本location中处理接收到的URI，并将此处重写的URI作为一个新的URI，使用各location块进行处理。该标志将重写的URI重写在server块中执行，为重写后的URI提供了转入到其他location块的机会；

break ： 将此处重写的URI作为一个新的URI，在本块中继续处理，该标志重写后的地址在当前的location块中执行，不会将新的URI转向其他的location块；

redirect ： 将重写后的URI返回给客户端，状态码为302，指明是临时重定向URI,主要用在replacement变量不是以 “http://”或“https://”开头的情况；

redirect ： 将重写后的URI返回给客户端，状态码为302，指明是临时重定向URI,主要用在replacement变量不是以 “http://”或“https://”开头的情况；

permanent ： 将重写后的URI返回给客户端，状态码为301，指明是临时重定向URI,主要用在replacement变量不是以 “http://”或“https://”开头的情况；

示例1

location /rewirte {
                rewrite ^/rewrite/url\w*$ https://www.baidu.com;
                rewrite ^/rewrite/(test)/\w*$ /$1;
                rewrite ^/rewrite/(hello)/\w*$ /$1;
        }
        location /test {
                default_type text/plain;
                return 200 "hello success";
        }

示例2

location /rewirte {
                rewrite ^/rewrite/url\w*$ https://www.baidu.com;
                rewrite ^/rewrite/(test)/\w*$ /$1 last;
                rewrite ^/rewrite/(hello)/\w*$ /$1 last;
        }
        location /test {
                default_type text/plain;
                return 200 "hello success";
        }

rewrite_log指令

该指令配置是否开启URL重写日志的输出功能

nginx rewrite功能使用场景分析

开启后，URL重写的相关日志将以notice级别输出到error_log指令配置的日志文件汇总

location /rewirte {
				rewrite_log on;
				error_log logs/error.log notice;
                rewrite ^/rewrite/url\w*$ https://www.baidu.com;
                rewrite ^/rewrite/(test)/\w*$ /$1 last;
                rewrite ^/rewrite/(hello)/\w*$ /$1 last;
        }

一、rewrite配置域名跳转

有很多大型网站，在起步的时候，比如域名为 ： www.haoyijia.com，但是域名太长所带来的问题就是不方便记忆，于是后面改成 www.hyj.com，问题是，一些老用户之前一直习惯了那个长域名，如何在老用户输入长域名的时候仍然可以跳转到新的短域名上呢？就可以考虑使用rewrite的功能；下面在本地做一下模拟。

配置步骤：

1、准备两个域名

这里我直接在本地模拟2个域名，通过在本地的hosts文件配置下就可以了

nginx rewrite功能使用场景分析

2、配置nginx.conf文件

server {

		listen 80;
		server_name www.zcy.com www.zhangcongyi.com;
		rewrite ^/ http://www.jd.com permanent;
	}

重启nginx服务，浏览器访问：www.zcy.com 或者www.zhangcongyi.com，观察效果

nginx rewrite功能使用场景分析

nginx rewrite功能使用场景分析

nginx rewrite功能使用场景分析

nginx rewrite功能使用场景分析

二、rewrite配置独立域名

一个完整的项目包含多个模块，比如购物网站有商品商品搜索模块、商品详情模块、购物车模块等，那么我们如何为每一个模块设置独立的域名。

server{
		listen 80;
		server_name search.hm.com;
		rewrite ^(.*) http://www.hm.com/bbs$1 last;
	}
	server{
		listen 81;
		server_name item.hm.com;
		rewrite ^(.*) http://www.hm.com/item$1 last;
	}
	server{
		listen 82;
		server_name cart.hm.com;
		rewrite ^(.*) http://www.hm.com/cart$1 last;
	}

本地的hosts文件添加如下配置

nginx rewrite功能使用场景分析

重启nginx服务，可以在浏览器访问下观察效果如何

nginx rewrite功能使用场景分析

三、rewrite配置目录合并

搜索引擎优化(SEO)是一种利用搜索引擎的搜索规则，来提供目的网站的有关搜索引擎内排名的方式；

我们在创建自己的站点时，可以通过很多种方式有效提供搜索引擎优化的程度，其中有一项就包含URL的目录层级一般不要超过三层，否则的话不利于搜索引擎的搜索也给客户端的输入带来了负担；

但是将所有的文件放在一个目录下又会导致文件资源管理混乱，并且访问文件的速度也会随着文件增多而慢下来，这两个问题是相互矛盾的，使用rewrite就可以解决上述问题；

举例，网站中有一个资源文件的访问路径时，比如访问：/server/11/22/33/44/20.html，也就是说20.html存在于第5级目录下，如果想要访问该资源文件，客户端的URL地址就要写成http://www.web.name/server/11/22/33/44/20.html；

server {
	listen 80;
	server_name www.web.com;
	location /server{
		root html;
	}
}

nginx rewrite功能使用场景分析

nginx rewrite功能使用场景分析

但是这个是非常不利于SEO搜索引擎优化的，同时客户端也不好记，使用rewrite我们可以进行如下配置:

server {
	listen 80;
	server_name www.web.com;
	location /server{
		rewrite ^/server-([0-9]+)-([0-9]+)-([0-9]+)- ([0-9]+)\.html$ /server/$1/$2/$3/$4/$5.html last;
	}
}

到此这篇关于nginx rewrite功能使用的文章就介绍到这了！

nginx rewrite功能使用场景分析

- Author -

小码农叔叔

- Original Sources -

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

Tags in this post...

nginx(76) Rewrite(4)
Servers 相关文章推荐
阿里云Nginx配置https实现域名访问项目(图文教程)
Mar 31 Servers
Nginx如何配置Http、Https、WS、WSS的方法步骤
May 11 Servers
Apache Hudi数据布局黑科技降低一半查询时间
Mar 31 Servers
为Centos安装指定版本的Docker
Apr 01 Servers
Apache Hudi 加速传统的批处理模式
Apr 24 Servers
在容器中使用nginx搭建上传下载服务器
May 11 Servers
阿里云服务器Ubuntu 20.04上安装Odoo 15
May 20 Servers
阿里云服务器部署RabbitMQ集群的详细教程
Jun 01 Servers
基于docker安装zabbix的详细教程
Jun 05 Servers
windows系统搭建WEB服务器详细教程
Aug 05 Servers
ubuntu端向日葵键盘输入卡顿问题及解决
Dec 24 Servers
Nginx静态压缩和代码压缩提高访问速度详解
May 30 #Servers
Nginx 配置 HTTPS的详细过程
May 30 #Servers
关于windows server 2012 DC 环境 重启后蓝屏代码:0xc00002e2的问题
May 25 #Servers
聊聊配置 Nginx 访问与错误日志的问题
May 25 #Servers
利用nginx搭建RTMP视频点播、直播、HLS服务器
详解Nginx的超时keeplive_timeout配置步骤
May 25 #Servers
nginx 配置指令之location使用详解
May 25 #Servers
shell(3) 默认端口(3) reload(1) 生成缩略图(1) 防盗链(1) 反向代理(2) 前后端分离(1) 动静分离(1) 二级域名(1) 负载均衡(6)
You might like
第二节--PHP5 的对象模型
2006/11/16 PHP
用PHP实现将GB编码转换为UTF8
2006/11/25 PHP
PHP小技巧搜集,每个PHPer都来露一手
2007/01/02 PHP
如何突破PHP程序员的技术瓶颈分析
2011/07/17 PHP
php strnatcmp()函数的用法总结
2013/11/27 PHP
Smarty保留变量用法分析
2016/05/23 PHP
php实现用户登陆简单实例
2017/04/04 PHP
PHP中PCRE正则解析代码详解
2019/04/26 PHP
jQuery学习笔记之jQuery选择器的使用
2010/12/22 Javascript
JavaScript EasyPager 分页函数
2011/05/25 Javascript
javascript自动给文本url地址增加链接的方法分享
2014/01/20 Javascript
浅析javascript函数表达式
2016/02/10 Javascript
JS中script标签defer和async属性的区别详解
2016/08/12 Javascript
自己封装的一个简单的倒计时功能实例
2016/11/23 Javascript
详解angularjs中如何实现控制器和指令之间交互
2017/05/31 Javascript
vue移动端实现下拉刷新
2018/04/22 Javascript
jQuery length 和 size()区别总结
2018/04/26 jQuery
解决Vue使用swiper动态加载数据,动态轮播数据显示白屏的问题
2018/09/27 Javascript
[39:07]LGD vs VP 2018国际邀请赛淘汰赛BO3 第二场 8.21
2018/08/22 DOTA
[00:59]DOTA2英雄背景故事——上古巨神
2020/06/28 DOTA
Python学习笔记之os模块使用总结
2014/11/03 Python
python使用正则表达式匹配字符串开头并打印示例
2017/01/11 Python
python实现树形打印目录结构
2018/03/29 Python
python 获取list特定元素下标的实例讲解
2018/04/09 Python
Python两个字典键同值相加的几种方法
2019/03/05 Python
python词云库wordcloud的使用方法与实例详解
2020/02/17 Python
Python爬虫破解登陆哔哩哔哩的方法
2020/11/17 Python
python 30行代码实现蚂蚁森林自动偷能量
2021/02/08 Python
白俄罗斯在线大型超市：e-dostavka.by
2019/07/25 全球购物
最常使用的求职信
2014/05/25 职场文书
第二批党的群众路线教育实践活动个人整改方案
2014/10/31 职场文书
2015年司机年终工作总结
2015/05/14 职场文书
致接力运动员加油稿
2015/07/21 职场文书
Python OpenCV实现图形检测示例详解
2022/04/08 Python
Hive HQL支持2种查询语句风格
2022/06/25 数据库
vue本地构建热更新卡顿的问题“75 advanced module optimization”完美解决方案
2022/08/05 Vue.js