Laravel 5.5 中使用 Route::fallback 方法来处理 404 响应

file

Laravel 5.5.10 附带了两种有用的路由方法，可以帮助我们为用户提供更好的 404 页面体验。目前，当抛出 404 异常时，Laravel 会呈现一个优美的 404.blade.php 视图文件，你可以为终端用户呈现个性的显示样式，但在视图内部，你无法访问 sessions，cookies，auth，...，等信息。

在 Laravel 5.5.10 可以使用新的 Route::fallback() 方法，当没有其他路由与当前请求匹配时，它可以自定义一个 Laravel 备选路由。

Route::fallback(function(){
    return 'Sorry '. auth()->user()->name . '! This page does not exist.';
});

因此，我们现在可以替换简单的 404 视图，使用可以显示正常的带有页面头部和尾部的登录区域布局以及一条呈现于用户的友好消息。

Route::fallback(function(){
    return response()->view('notFound', [], 404);
});

@extends('layout.app')

@section('content')
    <h3>Sorry! this page doesn't exist.</h3>
@stop

当 Laravel 呈现这条备选路由时，它将运行所有分配到的中间件，因此如果你在 web.php 中定义了备选路由，那么 web 中间件组下的所有中间件都会用到，并且我们可以访问到 sessions。

关于 API 路由需要注意的一点

现在无论你访问 /non-existing-page 还是 /api/non-existing-endpoint，你都将会看到由备用路由所展示的视图文件，然而后者并不是你想要的，因为 API 备用路由应该返回 JSON 数据，所以我们需要在 api.php 路由文件里定义另外一个备用路由：

Route::fallback(function(){
    return response()->json(['message' => 'Not Found!'], 404);
});

加了之后，由于 API 中间件群组的功能，所有带着前缀 /api 的找不到路由将会调用 api.php 文件里的备用路由而不是 web.php 里指定的那一个。

使用 abort(404) 和 ModelNotFound 异常

当我们使用 abort(404) 时，一个 NotFoundHttpException 异常会被抛出，处理程序会呈现 404.blade.php 普通视图，当一个 ModelNotFoundException 异常被抛出时同样如此。那么我们该如何呈现我们的备选路由而不是普通视图呢？

class Handler extends ExceptionHandler
{
    public function render($request, Exception $exception)
    {
        if ($exception instanceof NotFoundHttpException) {
            return Route::respondWithRoute('fallback');
        }

        if ($exception instanceof ModelNotFoundException) {
            return Route::respondWithRoute('fallback');
        }

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

Route::respondWithRoute('fallback') 快速运行名叫 fallback 的路由，我们可以顺便定义我们的备选路由：

Route::fallback(function(){
    return response()->view('notFound', [], 404);
})->name('fallback');

你可以进一步使用特定资源的备选路由：

if ($exception instanceof ModelNotFoundException) {
    return $exception->getModel() == Server::class
                ? Route::respondWithRoute('serverFallback')
                : Route::respondWithRoute('fallback');
}

并且我们在路由文件中这样定义：

Route::fallback(function(){
    return 'We could not find this server, there are other '. auth()->user()->servers()->count() . ' under your account ......';
})->name('serverFallback');