php 框架提供四种处理表单验证错误的方法：错误消息存储库（如 laravel 的 validator->errors()）会话（如 symfony 的 session 对象）中间件（如 laravel 的 handleformvalidationerrors）自定义异常（如 symfony 的 formvalidationexception）

如何优雅地处理 PHP 框架中的表单验证错误

简介

表单验证是 Web 应用程序中的关键步骤，可确保用户输入有效且完整。PHP 框架提供了丰富的功能来简化表单验证，并优雅地处理错误。本文将探讨操作 PHP 框架表单验证错误的几种方法。

立即学习“PHP免费学习笔记（深入）”；

方法 1：错误消息存储库

大多数框架提供错误消息存储库，用于存储与表单元素或键关联的错误消息。例如，使用 Laravel，可以在控制器方法中使用 validator->errors() 方法检索错误消息：

$validator = Validator::make($request->all(), $rules);

if ($validator->fails()) {
    return redirect()->back()
        ->withErrors($validator->errors()) // 存储错误消息
        ->withInput();
}

方法 2：使用会话

另一种方法是使用 Session 对象存储错误消息。这允许在多个页面或请求中保存错误。例如，使用 Symfony，可以在控制器方法中使用 $this->get('session') 服务来访问 Session 对象：

$validator = $this->get('validator')->validate($request->all(), $constraints);

if ($validator->getInvalidFields()) {
    $this->get('session')->getFlashBag()->add('error', $validator->getInvalidFields()->getMessageBag());
    return $this->redirectToRoute('form'); // 重定向到表单页面
}

方法 3：中间件

中间件可以用于在处理请求之前或之后执行自定义操作。这非常适合在请求中检查表单验证错误，并在必要时将用户重定向回表单页面。例如，使用 Laravel 的中间件如下：

class HandleFormValidationErrors implements Middleware
{
    public function handle($request, Closure $next)
    {
        $response = $next($request);

        if ($response->exception instanceOf ValidationException) {
            return redirect()->back()
                ->withErrors($response->errors())
                ->withInput();
        }

        return $response;
    }
}

方法 4：自定义异常

某些框架允许您定义自定义表单验证异常。这提供了灵活性和对错误处理过程的更多控制。例如，使用 Symfony，您可以在 Validator 接口中创建自定义异常：

class FormValidationException extends Exception
{
    public function getInvalidFields(): InvalidFields
    {
        return $this->invalidFields;
    }

    // ... 其他方法
}

实战示例

假设我们有一个具有以下表单验证规则的注册表单：

$rules = [
    'name'      => 'required|min:3',
    'email'     => 'required|email',
    'password'  => 'required|min:8',
    'password_confirmation' => 'required|same:password',
];

当用户提交不正确的表单数据时，使用 Laravel 中的方法 1 保存错误消息并重定向回表单页面：

public function store(Request $request)
{
    $validator = Validator::make($request->all(), $rules);

    if ($validator->fails()) {
        return redirect()->back()
            ->withErrors($validator->errors())
            ->withInput();
    }

    // 成功，创建用户...
}

结论

PHP 框架提供了多种方法来优雅地处理表单验证错误。通过使用错误消息存储库、会话、中间件或自定义异常，您可以创建用户友好的表单体验，并确保错误以一致且信息丰富的方式处理。