【Nginx07】Nginx学习:HTTP核心模块(四)错误页面与跳转

Nginx学习:HTTP核心模块(四)错误页面与跳转

最最核心的部分学习完了,但其实还有更多的内容要等待着我们探索。今天我们先来看到的就是关于错误页面的设置以及 301、302 跳转相关的内容。这两块内容都有一个特点,那就是页面或明显地,或不明显地产生了跳转变化,显示的都不是本来我们应该要得到的那个链接的页面。

error_page

这个指令应该是比较常见了吧,为指定错误定义显示的URI。

error_page code ... [=[response]] uri;

当前配置级别没有 error_page 指令时,将从上层配置继承, URI 可以包含变量。一般对于错误页面,我们想要友好提示,都会准备一些静态或动态页面,比如说网上有包含很多设计元素的 404 页面模板。code 可以设置多个,=response 可以修改返回的响应码,最后的 uri 就是我们要最终显示哪个 uri 页面。先来看看默认的 Nginx 错误页面的配置是啥样的吧。

#error_page  404              /404.html;error_page   500 502 503 504  /50x.html;
location = /50x.html {root   html;
}

刚安装完的自带的 Server 中,默认的 error_page 就是这两个配置,404 是被注释起来的。而 500 提供了一个 50x.html 在默认的 html 目录下。我们直接来访问试下,先访问一个不存在的静态页面。

d0a47f681f16326dfc39cf4aa1945ad2.png

然后再访问一个会报 500 错误的 php 页面。这个 PHP 代码就不粘出来了,就是 thorw new Exception(); 抛出了一个异常。

f1971e8561312c71e8b4157d486d3ed9.png

需要注意的是一点是,在访问 php 页面时,需要配置 php 中的参数,保证 fastcgi_intercept_errors是 on 的,否则 Nginx 不会处理 php 的错误信息。

location ~ \.php$ {root html;fastcgi_pass unix:/var/sock/php-fpm/www.sock;fastcgi_index  index.php;fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;include        fastcgi_params;fastcgi_intercept_errors on;  # 需要这个保持 on 状态
}

看出来了吧,默认情况下 404 确实是没有页面的,而 500 页面也走的是 html 目录下的那个 50x.html 。现在我们来配置几个页面。

// 404.html
this is 404 page.// 404.php
<?php
echo "php 404";// 50x.php
<?php
echo "php 50x";

普通配置

默认全局的 404 我们就直接打开原始配置中的 404 注释的部分就好了。现在访问之前的那个不存在的 URL 就会看到已经走到我们新建的那个 404.html 页面了。

d1f95f4833a980786057c8774e9d20c9.png

error_page 是有层级的,前面已经说过了,现在我们在一个 location 中配置一个 404 的 error_page ,那么访问这个 location 就会走这里的 error_page 设置。

location /errtest1/ {error_page 404 /404.php;
}

上面的配置可以让 /errortest1 这个路径的访问返回的是 404.php 的错误展示页面。

e30cd8bad4873a6253d0494387a02bb4.png

跳转配置

跳转配置指的是可以跳转到指定的页面,在这里我们会用到 =response 参数。

location /errtest2/ {error_page 404 @notfound;
}location /errtest3/ {error_page 404 =301 http://www.baidu.com;
}location @notfound {return 301 /index.html;
}

访问 /errtest2/ 会打开首页,这里还使用到了 location 的命名路径功能。另外一个 /errtest3/ 则会直接 301 跳转到百度的首页。这两个就不截图了,大家可以自己试下哦。

PHP配置

对于 PHP 来说,其实也就是在 location 中配置 error_page 的效果,在这里我们将 500 系列的指向了 50x.php 文件,404 指向了 404.php 文件。特别注意的就是 fastcgi_intercept_errors 需要开启,这个前面已经说过了。

location ~ \.php$ {root html;error_page 500 501 502 503 /50x.php;error_page 404 =200 /404.php;fastcgi_pass unix:/var/sock/php-fpm/www.sock;fastcgi_index  index.php;fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;include        fastcgi_params;fastcgi_intercept_errors on;
}

另外,只要 location 中有一个 error_page 了,那么外层的 error_page 就不管用了。什么意思呢?把上面 404 的注释掉,然后再次访问一个不存在的 php 页面,得到的结果是这样的。

5ac474ecc31c0d84d169b39019bd8bdc.png

这是由 fastcgi 接管的 404 报错页面,会显示 File not found. (如果没有开启 fastcgi_intercept_errors 的话,也会一直显示这个)

连续报错测试

连续报错是指假设我们指定的报错 URI 也不存在,会产生什么效果呢?这时,Nginx 会以最后获得的状态码为准。还是拿 404 来测试。

error_page  404              /404444.html;

我们将全局的 404 报错页面修改为一个不存在的文件,那么最后返回的错误页面又会变成最前面我们看到的那个 Nginx 默认的 404 页面。

76eea3a2cf8a4545dc12c7094c9fe5f4.png

如果不修改全局的,只是修改 /errtest1/ 的配置,那么最终也会显示这个 Nginx 默认的 404 错误页面,这个大家可以自己尝试一下哦。

跳转重定向

这里所说的跳转,主要指的就是 301 或者 302 的跳转。HTTP 的基础就不多说了,这个 301、302 也不算特别偏门的知识,这里的配置主要影响的就是在 301 或者 302 时返回的响应头中,Location 的变化情况。跳转相关的配置项都可以用于 http、server、location 各个模块中。

absolute_redirect

第一个配置指令。

absolute_redirect on | off;

它可以作用于 http,server,location 模块, 默认值是 on ,如果禁用的话,Nginx 发出的重定向将是相对的。这是啥意思呢?其实就是相对路径和绝对路径的问题。我们先随便设置一个 301 跳转的路径。

// nginx.conf http..server...
location /t {return 301 /index.html;
}

上面的配置是在默认的那个 server 下面添加的一个 location ,然后直接 return 返回一个 301 跳转页面,其实就是直接又跳回首页了。现在我们可以使用浏览器或者 Postman 进行测试,主要就是看访问这个 /t 路径时,返回的响应头中的 Location 属性。默认情况,它是这样的。

// 访问 http://192.168.56.88/t
Location: http://192.168.56.88/index.html

没啥问题吧,接下来将 absolute_redirect 修改成 off 。

// nginx.conf http
absolute_redirect off;

我们直接在 http 下面配置指这个令,然后 reload 重载配置,之后再次去访问 /t 路径。

// 访问 http://192.168.56.88/t
Location: /index.html

看出来不同了吧,现在 Location 返回的结果没有了前面的 Host 信息,就是我们在 return 中定义的那个相对路径了。

这个指令出现在 1.11.8 版本,和它一起打配合的还有后面两个指令,另外还需要注意的一点是,如果我们重定向本身就是带有 Host 信息的,比如:

return 301 http://192.168.56.88/index.html

那么这几个配置指令就没啥效果了,因为我们已经写死了固定的跳转绝对路径。

server_name_in_redirect

这个配置指令是用于确定要不要用 server_name 来做为跳转时的 Host 部分。

server_name_in_redirect on | off;

啥意思呢?首先,默认值是 off ,在默认的情况下,Nginx 会以请求头中的 Host 字段为基础,其实就是我们访问 URL 的 HOST 部分啦。这样在跳转链接的时候,如果 absolute_redirect 是 on,并且  return中也不是绝对路径的话,就会自动将 HOST 添加上,组成完整的 URL 。

如果将它配置成 on ,那么就会忽略请求头中的 Host ,而是直接使用当前 server 下面的 server_name 这个配置属性。

// nginx.conf http...server...
server_name  localhost;

在测试环境中,默认的那个 server 配置的 server_name 的值是 localhost 。然后,我们将 server_name_in_redirect 设置为 on ,接下来 reload 配置再次进行测试。

// 访问 http://192.168.56.88/t
Location: http://localhost/index.html

看出来效果了吧,不管你请求是 IP ,还是指定一个域名或者怎么样,它始终会返回 server_name 定义的内容,那么如果有多个 server_name 呢?

// nginx.conf http...server...
server_name  core.nginx.test localhost// 访问 http://192.168.56.88/t
Location: http://core.nginx.test/index.html

它返回的是第一个 server_name 的值。

port_in_redirect

从名字就能看出,这个配置应该是和端口有关系,它是控制重定向跳转时带不带上原来的端口。

port_in_redirect on | off;

默认值是 on ,表示请求过来的是哪个端口,跳转时也带上哪个端口。在测试时,我们先给 server 添加一个监听的端口,比如加一个 8080 ,然后正常访问 8080 端口的链接。(默认 80 端口的看不出效果,因为 80 端口会直接省略掉)

// 访问 http://192.168.56.88:8080/t
Location: http://192.168.56.88:8080/index.html

然后,我们将这个配置项设置成 off 。再次请求。

// 访问 http://192.168.56.88:8080/t
Location: http://192.168.56.88/index.html

看出来效果了吧,这回转发就没有带上端口了,直接走默认的 80 端口了。

总结

今天的内容不难,也不复杂,和前面两篇比起来简直太轻松了吧。而且,error_page 和 return 跳转这种操作也是非常基本的操作。不少的同学也早就已经用过了,而且可能比我知道的还要更多。因此,也就不多献丑了,先了解,再深入,更多好玩的用法和配置还等着我们继续学习呢!

参考文档:

http://nginx.org/en/docs/http/ngx_http_core_module.html

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.hqwc.cn/news/20178.html

如若内容造成侵权/违法违规/事实不符,请联系编程知识网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

LeetCode·每日一题·931. 下降路径最小和·记忆化搜索

作者&#xff1a;小迅 链接&#xff1a;https://leetcode.cn/problems/minimum-falling-path-sum/solutions/2341965/ji-yi-hua-sou-suo-zhu-shi-chao-ji-xiang-3n58v/ 来源&#xff1a;力扣&#xff08;LeetCode&#xff09; 著作权归作者所有。商业转载请联系作者获得授权&am…

既好用还不贵!云服务器选型六大理由 ,最后两条直击用户内心

“预算不够&#xff0c;腾讯云、百度云、阿里云&#xff0c;到底购买哪个更划算?”这个问题&#xff0c;很多朋友都跟我提过&#xff0c;选择最适合的云服务提供商并不是一件轻松的任务&#xff0c;因为每家公司都有各自的优势和限制。 **拿我接触的一个例子说一说&#xff…

【MQTT】Esp32数据上传采集:最新mqtt插件(支持掉线、真机调试错误等问题)

前言 这是我在Dcloud发布的插件-最完整Mqtt示例代码&#xff08;解决掉线、真机调试错误等问题&#xff09;&#xff0c;经过整改优化和替换Mqtt的js文件使一些市场上出现的问题得以解决&#xff0c;至于跨端出问题&#xff0c;可能原因有很多&#xff0c;例如&#xff0c;合法…

Linux slab 分配器源码解析

文章目录 前言一、slab分配器1.1 简介1.2 高速缓存描述符1.3 架构图 二、相关结构体2.1 struct array_cache2.2 struct kmem_list32.3 struct slab2.3.1 简介2.3.2 OFF_SLAB 三、创建和释放slab3.1 创建slab3.1.1 kmem_getpages3.1.2 alloc_slabmgmt3.1.3 slab_map_pages 3.2 释…

MySQL之DML和DDL

1、显示所有职工的基本信息&#xff1a; 2、查询所有职工所属部门的部门号&#xff0c;不显示重复的部门号。 3、求出所有职工的人数。 4、列出最高工和最低工资。 5、列出职工的平均工资和总工资。 6、创建一个只有职工号、姓名和参加工作的新表&#xff0c;名为工作日期表。 …

套接字属性

一、选项的级别 1. 基本概念 设置套接字的选项对套接字进行控制 除了设置选项外&#xff0c;还可以获取选项 选项的概念相当于属性&#xff0c;所以套接字选项也可说是套接字属性 有些选项&#xff08;属性&#xff09;只可获取&#xff0c;不可设置&#xff1b; 有些选项既可…

AtcoderABC258场

A - When? A - When? 题目大意 给定一个整数K&#xff0c;表示从日本标准时间21:00开始经过的分钟数。要求将该时间转换为24小时制的时间&#xff08;HH:MM格式&#xff09;。 思路分析 可直接分时间打印。关于格式&#xff0c;填充0&#xff0c;打印时间&#xff0c;题解…

git学习笔记

up:b站迷斯特航 两个版本的项目版本控制&#xff1a; 分支操作&#xff1a; 基本操作&#xff1a; 克隆远程项目到本地&#xff1a; git clone https://github.com/zhoeujei/rknn-coal-ai.git 修改提交到本地仓库&#xff1a;git add rknn_yolov5_demo/CMakeLists.txt&#…

使用C语言连接MySQL

目录 一、引入库 1.1 下载库文件 1.2 在项目中引入库 二、使用库 2.1 连接数据库 2.2 SQL请求 2.3 获取查询结果 2.4 使用案例 一、引入库 1.1 下载库文件 要使用C语言连接MySQL&#xff0c;需使用MySQL官网提供的库 MySQL :: Download Connector/Chttps://dev.mysq…

unbuntu 22.04 安装和卸载企业微信

every blog every motto: You can do more than you think. https://blog.csdn.net/weixin_39190382?typeblog 0. 前言 记录有关在ubuntu22.04上安装和卸载企业微信 以及企业微信无法打开问题处理 1. 正文 1.1 安装 下载wine环境 http://archive.ubuntukylin.com/softwar…

【动手学习深度学习--逐行代码解析合集】15卷积神经网络(LeNet)

【动手学习深度学习】逐行代码解析合集 15卷积神经网络&#xff08;LeNet&#xff09; 视频链接&#xff1a;动手学习深度学习–卷积神经网络&#xff08;LeNet&#xff09; 课程主页&#xff1a;https://courses.d2l.ai/zh-v2/ 教材&#xff1a;https://zh-v2.d2l.ai/ 1、LeN…