如何在 firstOrFail Laravel 异常中返回自定义错误文本 - PHP

在 Laravel 中，我们经常使用 firstOrFail 方法来查找模型实例。当查询无结果时，该方法会抛出 ModelNotFoundException 异常。虽然这种异常提示无法找到特定的模型实例，但往往不包含特定的错误信息。因此，可以考虑自定义异常信息，以便更好地向用户解释错误的原因。

实现步骤

第一步：创建自定义异常

首先，我们需要定义一个自定义的异常类，它继承自 ModelNotFoundException。我们可以创建一个新的异常类 CustomModelNotFoundException，并覆盖异常消息的获取方法 getMessage。以下是代码片段：

use Illuminate\Database\Eloquent\ModelNotFoundException;

class CustomModelNotFoundException extends ModelNotFoundException
{
    public function getMessage()
    {
        return 'Custom Error Message';
    }
}

在上面的代码中，我们覆盖了 ModelNotFoundException 的 getMessage 方法，并返回了自定义异常信息 "Custom Error Message"。

第二步：修改查询语句

其次，我们需要将 Laravel 中的 firstOrFail() 方法替换为一个新的方法，这个方法可以根据具体情况将 ModelNotFoundException 替换为我们自定义的异常类 CustomModelNotFoundException。以下是修改查询语句的示例代码：

use App\Exceptions\CustomModelNotFoundException; // 引入自定义异常类

$model = Model::where('id', $id)->firstOr(function () use ($id) {
    throw new CustomModelNotFoundException(); // 抛出自定义异常
});

在上面的代码中，我们通过调用 firstOr 方法，再使用闭包来处理未找到模型的情况。如果发生未找到模型的异常，我们就抛出自定义的异常 CustomModelNotFoundException。

第三步：处理自定义异常

最后，我们需要为自定义的异常注册异常处理程序。在 Laravel 中，可以通过 App\Exceptions\Handler 类中的 render 方法处理异常。以下是示例代码：

public function render($request, Exception $exception)
{
    if ($exception instanceof CustomModelNotFoundException) {
        return response()->view('errors.custom', [], 404); // 返回自定义错误页面
    }

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

在上述代码中，我们检查异常是否是我们自定义的异常 CustomModelNotFoundException。如果是，我们就返回一个自定义的错误页面，其它异常则使用默认的异常处理程序。因为 Laravel 的异常处理机制非常灵活，我们可以根据需要处理各种异常。

结论

通过自定义异常信息，我们可以更好地向用户解释发生错误的原因。通过按照以上步骤实现，我们可以更加精确地处理 firstOrFail 方法中的异常，并且也可以为自己的程序增加更多的自定义错误信息和页面。