使用 Laravel 5.5+ 更好的来实现 404 响应

译文首发于 使用 Laravel 5.5+ 更好的来实现 404 响应，转载请注明出处！

Laravel 5.5.10 封装了两个有用的路由器方法，能够帮助咱们为用户提供更好的 404 页面。如今，当抛出 404 异常时，Laravel 会显示一个漂亮的 404.blade.php 视图文件，你能够自定义显示给用户 UI，但在该视图中，你无权访问 session，cookie，身份验证（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 渲染这个回退（fallback）路由时，会运行全部的中间件，所以当你在 web.php 路由文件中定义了回退路由时，全部处在 web 中间件组的中间件都会被执行，这样咱们就能够获取 session 数据了。

API 接口说明

如今当你点击 /non-existing-page 时，你会看到在回退路由中定义的视图，甚至当你点击 /api/non-existing-endpoint 时，若是你也不想提供这个接口，你能够到 api 回退路由中定义 JSON 响应，让咱们到 api.php 路由文件中定义另一个回退路由：

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

因为 api 中间件组带有 /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::responseWithRoute('fallback');
        }

        if ($exception instanceof ModelNotFoundException) {
            return Route::responseWithRoute('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');

原文

Better 404 responses using Laravel 5.5+