Laravel 如何设置全局404 错误页面？使用场景是什么？底层原理是什么？

快点好好学习吧

于 2024-10-17 02:23:06 发布

阅读量478

点赞数 4

CC 4.0 BY-SA版权

分类专栏： PHP 文章标签： laravel android php

本文链接：https://blog.csdn.net/qq_36777143/article/details/142995230

PHP 专栏收录该内容

3374 篇文章

订阅专栏

在 Laravel 中设置全局 404 错误页面是一个常见的需求，尤其是在构建 Web 应用程序时。当用户访问一个不存在的路由或资源时，Laravel 会自动返回一个 404 HTTP 状态码，并显示默认的错误页面。你可以自定义这个 404 页面，以提供更好的用户体验和一致的品牌风格。

设置全局 404 错误页面

创建自定义视图：

首先，在 resources/views 目录下创建一个自定义的 404 错误页面视图文件，例如 errors/404.blade.php。

<!-- resources/views/errors/404.blade.php -->
<!DOCTYPE html>
<html>
<head>
    <title>Page Not Found</title>
</head>
<body>
    <h1>404 - Page Not Found</h1>
    <p>The page you are looking for does not exist.</p>
    <a href="/">Go back to the homepage</a>
</body>
</html>

注册异常处理：

在 Laravel 中，可以通过 App\Exceptions\Handler 类来处理未捕获的异常和 HTTP 错误。你需要在这个类中定义如何处理 404 错误。
打开 app/Exceptions/Handler.php 文件，找到 render 方法。在这个方法中，你可以检查响应的状态码并返回自定义的视图。

// app/Exceptions/Handler.php
namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Illuminate\Http\Request;
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
use Throwable;

class Handler extends ExceptionHandler
{
    /**
     * Render an exception into an HTTP response.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \Throwable  $exception
     * @return \Symfony\Component\HttpFoundation\Response
     */
    public function render($request, Throwable $exception)
    {
        if ($exception instanceof NotFoundHttpException) {
            return response()->view('errors.404', [], 404);
        }

        return parent::render($request, $exception);
    }
}

配置异常处理（可选）：
- 如果你希望更细粒度地控制错误页面，可以在 config/app.php 中配置异常处理器。
- 通常情况下，默认的 App\Exceptions\Handler 已经足够使用。

使用场景

用户体验：当用户访问不存在的页面时，显示一个友好且专业的 404 错误页面，可以提升用户体验。
品牌一致性：通过自定义 404 页面，你可以保持网站的一致性，使其符合你的品牌形象。
SEO 优化：搜索引擎爬虫可能会遇到 404 错误，一个良好的 404 页面可以帮助搜索引擎更好地理解你的网站结构。
导航帮助：在 404 页面上提供导航链接或搜索框，可以帮助用户快速找到他们需要的内容。

底层原理

异常处理：
- 当 Laravel 处理请求时，如果找不到匹配的路由或资源，会抛出一个 Symfony\Component\HttpKernel\Exception\NotFoundHttpException 异常。
- 这个异常会被 App\Exceptions\Handler 类捕获。
渲染响应：
- Handler 类中的 render 方法负责将异常转换为 HTTP 响应。
- 在 render 方法中，你可以检查异常类型，并根据需要返回不同的视图。
状态码：
- 返回的响应对象可以设置 HTTP 状态码。对于 404 错误，状态码应设置为 404。
- 通过 response()->view('errors.404', [], 404)，你可以返回一个带有 404 状态码的视图。
中间件：
- 在某些情况下，你也可以使用中间件来处理 404 错误。例如，你可以创建一个中间件来检查路由是否存在，并在不存在时重定向到自定义的 404 页面。
配置文件：
- Laravel 的错误处理行为可以通过 config/app.php 中的 debug 选项进行控制。在生产环境中，debug 选项通常设置为 false，这样 Laravel 会显示自定义的错误页面而不是详细的错误信息。