Nginx HTTP模块篇 rewrite模块 (十一)

最新推荐文章于 2024-09-22 13:52:01 发布
最新推荐文章于 2024-09-22 13:52:01 发布
阅读量205 收藏
点赞数
分类专栏： nginx入门系列 文章标签： nginx
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jqsfjqsf/article/details/113831357
版权
本文详细介绍了Nginx中return指令的返回内容和重定向功能，error_page指令处理错误状态码的策略，以及rewrite模块的正则表达式重写、flag选项和实际应用场景。通过实例演示了不同场景下的工作原理和优先级规则。
摘要由CSDN通过智能技术生成
本系列文章目录
展开/收起

rewrite 模块

 

return 指令
该指令用于返回内容或者重定向
该指令有3种格式

return 状态码 [内容];    # 返回内容
return 状态码 URL;     # 用于重定向
return URL;             # 用于重定向，默认使用302临时重定向

上下文：server,location,if

 

error_page 指令
该指令用于当遇到404,500这样的状态码时进行重定向。

格式：
error_page code [=[response]] uri;

上下文：http,server,location,if in location

 

示例：

error_page 404 /404.html;   # 找不到页面时跳转到404.html

error_page 500 502 503 504 /50x.html  # 添加了多个状态码，跳转到50x.html

error_page 404 =200 /empty.gif #跳转到一张图片，并修改状态码为200

error_page 404 = /404.php    # 跳转到404.php，状态码改为200

error_page 404 =301 http://abc.com/notfound.html #表示找不到时就永久重定向为abc.com/notfound.html

# 跳转到上游服务
location / {
  error_page 404 = @notfound;
}
location @notfound {
  proxy_pass http://notfound;
}

 

注意，error_page最后接的是uri地址而不是文件路径。

假如设置了
server_name zbpblog.com;
root /var/www;

error_page 404 /404.html;

当出现404时会跳转到 http://zbpblog.com/404.html，映射到的是/var/www/404.html这个文件

如果写成 error_page 404 404.html
当访问 http://zbpblog.com/sss/ddd 出现404时，他会跳到 http://www.abc.com/sss/ddd/404.html

如果error_page指令失效请试试设置：
proxy_intercept_errors on;
fastcgi_intercept_errors on;


小实验：

server {
  listen    8080;
  server_name return.zbpblog.com;
  root /var/www/html;
 
  access_log logs/access.log main;
  error_page 404 /404.html;

  #return 405;
  location / {
    return 404 "Not Found";
  }
  
}

/var/www/html目录中放置了3个文件 index.html/test.html/404.html，里面内容分别为 “index”、“测试内容”、“找不到页面”

测试结果如下：

访问 http://return.zbpblog.com:8080/test.html
Not Found

访问 http://return.zbpblog.com:8080/
Not Found

访问 http://return.zbpblog.com:8080/sss
Not Found

说明走的是 location / {return 404 "Not Found";}，而不是error_page;
就算找得到的页面也会返回Not Found

将return 404 "Not Found";注释

server {
  listen    8080;
  server_name return.zbpblog.com;
  root /var/www/html;
 
  access_log logs/access.log main;
  error_page 404 /404.html;

  #return 405;
  location / {
    #return 404 "Not Found";
  }
  
}

访问 http://return.zbpblog.com:8080/test.html
“测试内容”

访问 http://return.zbpblog.com:8080/
“index”

访问 http://return.zbpblog.com:8080/sss
“找不到页面”
说明跳转到404.html

将return 405和return 404 "Not Found"注释打开:

server {
  listen    8080;
  server_name return.zbpblog.com;
  root /var/www/html;
 
  access_log logs/access.log main;
  error_page 404 /404.html;

  return 405;
  location / {
    return 404 "Not Found";
  }
  
}

无论访问什么都返回405，因为先执行了server的return，之后的代码就都不会执行了。

 

rewrite 指令
格式  rewrite regex replacement [flag];

上下文：server,location,if

当replacement以http://或https://或者$schema开头，会直接返回302重定向

4种flag：
last:用replacement这个URI进行新的location匹配并停止继续处理当前区块所有接下来的语句。重写得到的新URL会重新匹配所有location语句，以进行进一步处理。
break:用replacement这个URI进行新的location匹配并停止继续处理当前区块所有接下来的语句。重写得到的新URL不会重新匹配location语句。
redirect:返回302临时重定向。
permanent:返回301永久重定向。

小实验：
/var/www/html目录结构如下：
    |-index.html
    |-first
        |-1.txt     # "txt1"
    |-second
        |-2.txt     # "txt2"
    |-third
        |-3.txt     # "txt3"
        

server {
    listen       8080;
    server_name  return.zbpblog.com;
    root /var/www/html; 
    
    access_log  logs/access.log  main;
    error_page 404 /404.html;
    
    autoindex on;   # 开启浏览目录的功能
  
    # 
    # 不同的location
    #     
}

 

情景1：

### 处写法1：
location /first { 
    rewrite /first(.*) /second$1 redirect;
}

location /second {
    rewrite /second(.*) /third$1  redirect;
}

访问 http://return.zbpblog.com:8080/first
浏览器url栏最终url为third
F12查看一共3条请求，文件名和状态码为first 301,second 302,third 200

最终显示的是third目录的目录结构。

 

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏最终url为third/3.txt
F12查看一共3条请求，文件名和状态码为first/3.txt 302,second/3.txt 302,third/3.txt 200

最终显示的是/third/3.txt的内容

 

情景2：

### 处写法2：
location /first { 
    rewrite /first(.*) /second$1 permanent;
}

location /second {
    rewrite /second(.*) /third$1  permanent;
}

访问 http://return.zbpblog.com:8080/first
浏览器url栏最终url为third
F12查看一共3条请求，状态码全为301,301,200

最终显示的是third目录的目录结构

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏最终url为third/3.txt
F12查看一共3条请求，文件名和状态码为first/3.txt 301,second/3.txt 301,third/3.txt 200

最终显示的是/third/3.txt的内容

 

情景3：

### 处写法3：
location /first { 
    rewrite /first(.*) /second$1;
}

location /second {
    rewrite /second(.*) /third$1;
}

访问 http://return.zbpblog.com:8080/first
浏览器url栏不变
F12查看一共1条请求，first 200

但是已经重定向到third目录

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏不变
F12查看一共1条请求，first/3.txt 200
但实际上显示的是third/3.txt的内容。

 

情景4：

location /first { 
    rewrite /first(.*) /second$1 break; 
    return 200 "xxx1";
} 

location /second {
    rewrite /second(.*) /third$1;
}

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏不变
F12查看一共1条请求，first/3.txt 404
first/3.txt会跳到second/3.txt 但由于break，/second/3.txt不会重新匹配location /second，所以不会跳到/third/3.txt。second没有3.txt所以404

 

情景5：

### 处写法5：
location /first { 
    rewrite /first(.*) /second$1 last;
    return 200 "xxx1";    
} 

location /second {
    rewrite /second(.*) /third$1;
}

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏不变
F12查看一共1条请求，first/3.txt 200
first/3.txt会跳到second/3.txt 再跳到third/3.txt。

last和break会停止运行当前块中之后代码的运行（如return 200 "xxx1"），但last会在跳转后重新匹配所有的location，而break不会。

如果rewrite不加flag，那么会运行完该区块下所有的指令后，再对跳转后新的url重新匹配所有的location。

使用last和break和不加flag，虽然跳转了，但浏览器上显示的url不变。permanent和redirect会变。

 

情景6：

### 写法6：
location /first { 
    rewrite /first(.*) /second$1 last; 
    return 200 "first";
} 

location /second {
    rewrite /second(.*) /third$1 break;
    return 200 "second";
}  

location /third {
    return 200 "third";
}

访问 http://return.zbpblog.com:8080/first/3.txt
浏览器url栏不变
F12查看一共1条请求，first/3.txt 200
first/3.txt会跳到second/3.txt 再跳到third/3.txt

过程为： location /first匹配到，跳转到second/3.txt,由于last所以return 200 "first"不执行并且对second/3.txt重新匹配一次全部location；
location /second块匹配到，跳转到third/3.txt,由于break所以return 200 "second"不执行并且不会对second/3.txt重新匹配一次全部location；
所以location /third块中的return 200 "third"也不会执行。

 

if 指令
该if指令是专门用来判断变量的。

PS if和()间有空格，没有会报错。

格式 if (condition){...}

上下文：server,location

if指令的表达式：
1.检查变量是否为空或者是否为0
2.将变量与字符串做匹配，使用=或!=
3.将变量和正则做匹配，使用~表示匹配，!~不匹配；~*忽略大小写匹配，!~*忽略大小不匹配
4.检查文件是否存在，使用-f或!-f
5.检查目录是否存在,-d或!-d
6.检查文件、目录、软链接是否存在，-e或!-e
7.检查是否为可执行文件，使用-x或者!-x

示例：

if($http_user_agent ~ MSIE){    #使用正则匹配，如果变量中有MSIE这个字符串，即浏览器是IE，就做重定向。
    rewrite ^(.*?)$ /msie/$1 break;
}

if($http_cookie ~* "id=([^;]+)") { # 如果匹配到$http_cookie中含有id=xxx的内容，就定义一个变量$id为分组匹配内的内容
    set $id $1;
}

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

if($slow){
    limit_rate 10k;
}

if($invalid_referer){   #用于防盗链
    return 403;
}

 

location 指令

格式：location [=|~|~*|^~] uri {...}

上下文：server,location
所以 location可以嵌套location

location匹配规则：

常规匹配：又叫做前缀匹配，如 location /test {...} 可以匹配/test,/test/a,/test/1.html等，只要URI中是以/test开头的都能匹配到。

= ：精确匹配 location /test {...}    只能匹配 /test
^~：前缀匹配上后就不再进行正则匹配。就当他是一个前缀匹配即可。
~和~*：对URI正则匹配
@：用于内部跳转的命名location


示例：

# 1
location ~ /Test1/$ {
  return 200 "first regular expressions mathc!";
}

# 2
location ~* /Test1/(\w+)$ {
  return 200 "longest regular expressions match!";
}

# 3
location ^~ /Test1/ {
  return 200 "stop regular expression match!";
}

# 4
location /Test1/Test2 {
  return 200 "longest prefix string match!";
}

# 5
location /Test1 {
  return 200 "prefix string match";
}

# 6
location = /Test1 {
  return 200 "exact match!";
}

有以下url：
/Test1      # 匹配5,6
/Test1/     # 匹配1,3,5
/Test1/Test2    # 匹配2,3,4,5
/Test1/Test2/   # 匹配3,4,5
/test1/Test2    # 匹配2

上面除了/test1/Test2这个url是明确只匹配2号location的，其他都匹配多个。那么它是有优先级的，而且不是单纯的按顺序来决定优先级的。

优先级规则：
^~和常规匹配都属于前缀匹配。

=精确匹配最先进行，前缀匹配次之，正则匹配最后。但是精确匹配成功则不会再往下匹配前缀或者正则；但前缀匹配成功后会再进行正则匹配（^~匹配成功则不会再进行正则匹配），如果正则匹配成功则使用正则匹配的location而不使用前缀匹配的location，如果没有正则匹配成功则使用最长的前缀匹配。

如果多个前缀匹配都符合，则长的优先级更高。

如果多个正则匹配都符合，则最先出现的正则优先级更高。


根据以上则：
/Test1 匹配6，精确匹配

/Test1/ 匹配3，过程：先进行前缀匹配（3,5），3比5长，所以3匹配成功，由于3使用^~，所以1正则就不再去匹配。

/Test1/Test2 匹配2，过程：先进行前缀匹配(3,4,5)，4最长，再进行正则匹配，2匹配成功，所以不使用前缀匹配4而使用2

/Test1/Test2/ 匹配4，过程：先进行前缀匹配(3,4,5)，4最长，再进行正则匹配，没有正则能匹配的上。

/test1/Test2    # 匹配2，只有2是大小写都匹配

本文转载自： 张柏沛IT技术博客 > Nginx HTTP模块篇 rewrite模块 (十一)
张柏沛
关注
专栏目录
nginx http模块
H291850336的专栏
04-23 2590
官方文档http://nginx.org/en/docs/http/ngx_http_core_module.html、 中文文档http://www.nginx.cn/doc/standard/httpcore.html 翻译比较详细中文文档http://shouce.jb51.net/nginx/left.html 建议两个文档个都看看防止遗漏中文文档不全 Nginx的HTTP配...
nginx的http_rewrite模块的rewrite指令
chenxizhan1995的博客
06-07 388
nginx rewrite指令
Nginx之Rewrite功能配置
最新发布
weixin_55772633的博客
09-22 1074
Rewrite是Nginx服务器提供的一个重要基本功能，是Web服务器产品中几乎必备的功能。主要的作用是用来实现URL的重写。注意:Nginx服务器的Rewrite功能的实现依赖于PCRE的支持，因此在编译安装Nginx服务器之前，需要安装PCRE库。Nginx使用的是ngx_http_rewrite_module模块来解析和处理Rewrite功能的相关配置。
nginx 开发简单的http模块
mengzhengjie的专栏
05-15 267
https://blog.csdn.net/zhangxiao93/article/details/52836128 武侠世界的高手一般都是从扫地僧做起的，程序员学一门技术都是从hello world开始。 本文介绍开发一个简单的hello world模块。 （一）如何将自己的http模块编译进Nginx 首先创建源码目录： mkdir /home/zhangxiao/nginx/ngin...
Nginx之HTTP模块
janthinasnail的博客
04-05 914
配置的嵌套块格式 指令的合并 1、值指令：存储配置项的值 如：root、access_log、gzip 存储值的指令继承规则：向上覆盖，即：子配置不存在时，直接使用父配置块；子配置存在时，直接覆盖父配置块 2、动作类指令：指定行为 如：rewrite、proxy_pass 生效阶段：server_rewrite阶段、rewrite阶段、content阶段 listen指令(详见：h...
nginx学习笔记（http模块）
吴东方的博客
06-19 429
nginx http模块学习笔记
Nginx Rewrite模块应用的几种场景
09-29
**Nginx Rewrite模块应用详解** Nginx的Rewrite模块是其强大的URL重写工具，它可以基于HTTP请求的URL动态改变请求的目标，实现各种复杂的路由控制和URL美化功能。以下我们将详细介绍Nginx Rewrite模块在不同场景下...
Nginx URL重写rewrite机制原理及使用实例
01-20
默认参数编译nginx就会支持rewrite的模块，但是也必须要PCRE的支持 rewrite是实现URL重写的关键指令，根据regex（正则表达式）部分内容，重定向到replacement，结尾是flag标记。 rewrite语法格式及参数语法说明如下:...
Nginx Rewrite模块配置
繁星若渺的博客
12-02 613
目录一、Rewrite概述1.1、Rewrite跳转场景1.2、Rewrite跳转实现1.3、Rewrite实际场景1.4、Nginx正则表达式二、Rewrite命令2.1、Rewrite命令语法2.2、flag标记说明2.3、last和break比较三、location概述3.1、分类3.2、正则匹配的常用表达式3.3、location优先级3.4、比较rewrite和location3.5、location优先级规则四、配置实例安装Nginx服务4.1、基于域名的跳转实验4.2、修改默认站点配置文件4.
Nginx之HTTP模块详解
wyx的博客
06-14 1422
Nginx是模块化的代码架构，其代码由核心代码与功能模块代码构成。Nginx的主要功能模块是HTTP功能模块，HTTP功能模块在HTTP核心功能的基础上为Nginx对HTTP请求的处理流程提供了扩展功能，这些扩展功能可以让用户很方便地应对访问控制、数据处理、代理缓存等各种复杂的场景应用，同时也让有开发能力的用户能够积极参与，不断增强Nginx的功能。由于功能模块比较多，为了便于对各功能模块进行介绍，此处按照模块的功能进行如下分类：动态赋值：可根据HTTP请求的变化动态地进行变量赋值的功能模块。
Nginx配置详细解释：(3)http模块及server模块,location模块
2301_78327423的博客
06-05 2293
wget下载在/data/下，编译安装在/apps/nginx/下有两台机器，Node1(192.168.114.10)和Node2(192.168.114.20)，Node1做为nginx服务端，Node2作为客户端访问Node1测试使用。http模块中的全局模块是导入支持的文件类型，由于是编译安装，默认在指定的路径/apps/nginx/下的conf/mime.types。只要是在该路径下，那么访问链接就是下载。
深入理解nginx chap3 开发一个简单的HTTP模块
zhyh1435589631的专栏
06-21 5368
1. 如何调用HTTP模块本质：worker 进程会在一个for 循环里面反复调用事件模块检测网络事件。 2. 基本数据结构 命名规则： ngx_http_xxx_module.c 2.1 整形封装 ngx_int_t 封装了有符号整形， 而 ngx_uint_t 封装了无符号整形 2.2 ngx_str_t ngx_str_t 封装了字符串typedef struct { size_t
NGINX系列之HTTP模块开发
魔幻世界
07-28 1225
上文介绍nginx请求11个阶段处理，本文将动手实操开发并注册一个HTTP模块，在实现ngx_http_hello_world_module模块的过程中，详细介绍其实现步骤。 模块组成介绍 模块定义 模块名称 ngx_http_hello_world_module 模块功能 功能相对简单，从Hello World开始，通过实现扩展HTTP模块ngx_http_hello_wor...
nginx详解
akf_271的专栏
03-08 673
说明： 1. Nginx的HTTP核心模块只解析request的请求行和请求头，不会主动读取HTTP 请求body数据，但是提供了ngx_http_read_client_request_body方法，供各个filter模块处理。 2.ngx_http_wait_request_handler：等待read事件上来，并且等到HTTP的request数据 3. ngx_http_process
【深度】NGINX Rewrite 详解
Martian
01-12 2525
location
【重定向302】Redirect
秃头披风侠的博客
02-27 4761
介绍了重定向，如何使用HttpServletResponse进行重定向
Nginx模块之rewrite模块
rmh0713的博客
02-23 3642
rewrite功能就是，使用nginx提供的全局变量或自己设置的变量，使用nginx提供的全局变量或自己设置的变量，结合正则表达式和标记位实现URL重写以及重定向。更换域名后需要保持旧的域名能跳转到新的域名上、某网页发生改变需要跳转到新的页面、网站防盗链等等需求rewrite只能放在server{},location{},if{}中，并且默认只能对域名后边的除去传递的参数外的字符串起作用。
Nginx Rewrite模块的实用场景与迁移策略
- 在Nginx的server块中，使用Rewrite模块编写规则，例如`rewrite ^/(.*)$ http://www.kgc.com/$1 permanent;`，这将把所有对www.accp.com的请求重定向到新域名，并保留URL路径。 应用场景2可能涉及URL路径的重构、...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值