[教程] 如何自定义 Laravel 的 404 页面
在本次教程中,我们将看到如何在 Laravel 中自定义 404 页面。
PHP 异常类似于其他编程语言中的异常,发生错误或未知事件时引发异常。 PHP 中所有异常都继承自基本的 Exception 类。
Laravel 提供了 app/Exceptions/Handler.php 类,用于检查应用程序中抛出的所有异常。基本上,应用程序中抛出的每个异常都可以配置在这个文件中,并且生成适当的响应。
在本次教程中,我们将看到如何在 Laravel 中自定义 404 页面。我们使用的版本是 Laravel 5.6 。默认情况下, Laravel 返回一个 Whoops 页面。我们将看到如何根据异常返回自定义页面,这将帮助你为每个 HTTP 异常返回自定义页面。
当有人点击不存在的路由时,你的站点会显示一个错误,它也会影响你的 SEO 。
所以,让我们看看如何在 Laravel 中如何管理 404 页面,HTTP 异常和自定义异常。
安装 Laravel 项目
让我们创建一个新的 Laravel 项目,运行以下命令来创建名为 errors 的一个新项目。
composer create-project --prefer-dist laravel/laravel errors
处理异常
所有与处理异常相关的更改都将在 app/Exceptions/Handler.php 中完成。当出现一个错误时,我们将返回一个 视图 。
自定义 404 页面
让我们在 Laravel 中创建一个自定义的 404 页面。在 app/Exceptions/Handler.php 文件中修改 render 方法。
/**
* 在 HTTP 响应中渲染异常
*
* @param \Illuminate\Http\Request $request
* @param \Exception $exception
* @return \Illuminate\Http\Response
*/
public function render($request, Exception $exception)
{
if ($this->isHttpException($exception)) {
if ($exception->getStatusCode() == 404) {
return response()->view('errors.' . '404', [], 404);
}
}
return parent::render($request, $exception);
}
在 render 方法中,我们检查异常是否是一个 HTTP 异常,这很重要,因为我们正在调用 getStatusCode() 方法,该方法只在 HTTP 异常中可用。如果状态码为 404 ,则返回一个视图 errors.404 以及一个状态码。如果需要你可以更改视图的名称。
我们必须为 404 页创建一个视图,所以,我们创建一个新的视图 errors/404.blade.php 。
<!DOCTYPE html>
<html>
<head>
<title>Page not found - 404</title>
</head>
<body>
The page your looking for is not available
</body>
</html>
如果你想要为其他 HTTP 异常创建一个自定义页面,只需添加一个新的 if 语句,并用新的状态码更改 404 。这是处理 404 和 500 状态码自定义页面的 render 方法。
public function render($request, Exception $exception)
{
if ($this->isHttpException($exception)) {
if ($exception->getStatusCode() == 404) {
return response()->view('errors.' . '404', [], 404);
}
if ($exception->getStatusCode() == 500) {
return response()->view('errors.' . '500', [], 500);
}
}
return parent::render($request, $exception);
}
这是我们应用程序的 404 响应。
自定义 HTTP 异常页面
我们也可以自动化这个过程,如果我们只需要为异常创建一个新的视图文件,那就太好了,对于每个 HTTP 异常都不再需要向 app/Exceptions/Handler.php 文件中添加代码。在 app/Exceptions/Handler.php 文件中修改 render 方法。
public function render($request, Exception $exception)
{
if ($this->isHttpException($exception)) {
if (view()->exists('errors.' . $exception->getStatusCode())) {
return response()->view('errors.' . $exception->getStatusCode(), [], $exception->getStatusCode());
}
}
return parent::render($request, $exception);
}
现在,你只需要创建一个带有异常 状态码 的 视图 。 render 方法将会检查 视图 是否与异常的状态码一同存在。如果视图存在,它将会简单的返回一个 HTTP 响应,其中包含该视图和 状态码 。
例如,我们为 404 错误页面创建 errors/404.blade.php ,为 500 错误页面创建 errors/500.blade.php 等等。
处理自定义异常
我们先创建一个 自定义异常 。运行以下代码来创建一个名为 TestingHttpException 的异常。
php artisan make:exception TestingHttpException
在 app/Exceptions/Handler.php 文件中,修改 render 方法。
public function render($request, Exception $exception)
{
if ($exception instanceof TestingHttpException) {
return response()->view('errors.testing');
}
return parent::render($request, $exception);
}
如果异常是 TestingHttpException 的实例,它将返回 errors.testing 视图。
你还可以使用带有 404 代码的 abort 方法,它将为 HTTP 响应提供自定义的 404 页面。
你还可以使用这些技术来处理所有类型的异常。
本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
这文章有点。。 :speak_no_evil: :speak_no_evil:
刚好需要找个,第一反应在 app.php 配置文件中找了,原来找个需要自己写。
执行:
php artisan vendor:publish --tag=laravel-errors
然后去编辑
resources\views\errors
中相应的视图即可。