Laravel 中使用 FormRequest 访问路由参数和自定义验证错误处理

本文深入探讨了 Laravel 中 FormRequest 的使用，重点解决如何在控制器中使用 FormRequest 进行请求验证时访问路由参数，以及如何自定义验证失败时的错误处理逻辑。通过示例代码和详细说明，帮助开发者更有效地利用 FormRequest 实现请求数据的验证和处理。

在使用 Laravel 的 FormRequest 进行请求验证时，可能会遇到一些关于访问路由参数和自定义验证错误处理的问题。本文将详细介绍如何解决这些问题，并提供实际示例代码。

访问路由参数

当你在控制器中使用 FormRequest 进行请求验证时，可能会遇到需要访问路由参数的情况。例如，你有一个路由定义如下：

Route::put('user/{name}', 'UserController@show');

并且你已经在 UserController 中使用了 ShowRequest 进行验证：

class UserController {
  public function show(ShowRequest $request)
  {
     // 如何访问 'name' 参数？
    ...
  }
}

有以下两种方法可以访问路由参数 name：

方法一：在控制器方法中同时注入 FormRequest 和路由参数 (推荐)

这是最直接和推荐的方法。Laravel 会自动解析路由参数并将其传递给控制器方法。

class UserController {
    public function show(ShowRequest $request, $name)
    {
        // 现在可以直接使用 $name
        // ...
    }
}

方法二：通过 request 对象访问

你可以通过 request 对象的 input() 方法来访问路由参数。

class UserController {
    public function show(ShowRequest $request)
    {
        $name = $request->input('name');
        // ...
    }
}

自定义验证错误处理

Laravel 默认的验证错误处理通常已经足够使用，但有时你可能需要自定义验证失败时的行为。

自定义错误消息

你可以通过在 FormRequest 类中定义 messages() 方法来定制验证错误消息。

class ShowRequest extends FormRequest
{
    /**
     * @return array
     */
    public function messages()
    {
        return [
            'name.required' => '名称是必需的',
            'name.numeric' => '名称必须是数字',
            //...
        ];
    }
}

使用 Validator 实例进行更细粒度的控制

如果你需要更细粒度的控制，比如在验证失败时执行特定的逻辑，你可以重写 failedValidation 方法。

use Illuminate\Contracts\Validation\Validator;
use Illuminate\Http\Exceptions\HttpResponseException;

class ShowRequest extends FormRequest
{
    /**
     * Handle a failed validation attempt.
     *
     * @param  \Illuminate\Contracts\Validation\Validator  $validator
     * @return void
     *
     * @throws \Illuminate\Validation\ValidationException
     */
    protected function failedValidation(Validator $validator)
    {
        $errors = $validator->errors();
        throw new HttpResponseException(response()->json([
            'errors' => $errors
        ], 422));

        // 或者执行其他自定义逻辑
    }
}

在这个例子中，我们重写了 failedValidation 方法，并抛出了一个包含错误信息的 JSON 响应。你可以根据你的需求自定义这个方法的行为。例如，你可以记录错误日志、发送通知等等。

注意事项

• 请确保在 authorize() 方法中正确设置授权逻辑。
• 在 rules() 方法中定义清晰的验证规则。
• 根据需要自定义错误消息和验证失败处理逻辑。

总结

FormRequest 是 Laravel 中一个强大的工具，可以帮助你轻松地验证请求数据。通过理解如何访问路由参数和自定义验证错误处理，你可以更好地利用 FormRequest 来构建健壮的应用程序。通过以上示例和说明，相信你已经掌握了在 Laravel 中使用 FormRequest 的基本技巧。记住，理解其工作原理并根据实际需求进行定制是关键。