使用 Laravel API 进行表单验证

Laravel 是一款流行的 PHP Web 框架，它提供了一套简单易用的表单验证机制，让我们可以很方便地验证用户提交的表单数据。本文将介绍如何使用 Laravel API 进行表单验证。

1. 前置条件

在开始使用 Laravel 进行表单验证之前，你需要先安装并配置好 Laravel 开发环境。如果你还没有安装 Laravel，可以先参考官方文档进行安装和配置。

2. 创建表单验证规则

在 Laravel 中，表单验证规则通常会存储在单独的验证类中，以便于组织和重用。我们可以使用 Artisan 命令来快速创建一个验证类：

php artisan make:request YourFormRequest

这个命令会在 app/Http/Requests 目录下创建一个名为 YourFormRequest 的验证类文件，并自动为该类添加一个 rules() 方法，用于定义表单验证规则。

比如，如果我们要验证一个登录表单，可以编写如下的表单验证规则：

public function rules()
{
    return [
        'username' => 'required',
        'password' => 'required',
    ];
}

上面的代码规定了 username 和 password 两个字段都是必填项。如果用户没有填写其中任何一个字段，那么在提交表单时就会触发验证失败，并将错误信息返回给客户端。

除了使用 required 规则来验证必填项之外，Laravel 支持许多其他的验证规则，比如 numeric（验证是否为数字）、email（验证是否为合法电子邮件地址）、unique（验证是否唯一）等等。具体的规则及其用法可以参考官方文档。

3. 在控制器中调用表单验证

在创建好表单验证规则之后，我们需要在控制器中调用这个验证规则。以登录表单为例，假设我们的表单是通过 POST 请求发送到 /login 接口，那么我们就可以在对应的控制器方法中进行表单验证：

use App\Http\Requests\YourFormRequest;

public function login(YourFormRequest $request)
{
    // 验证成功，继续执行后续逻辑
    // ...
}

上面的代码中，我们在登录方法中注入了 OurFormRequest 对象，并将其作为参数传递给该方法。Laravel 会自动调用这个对象的 authorize() 和 rules() 方法来完成表单验证。如果验证失败，Laravel 会自动将验证错误信息返回给客户端，并终止这个方法的执行。

4. 返回验证错误信息

如果表单验证失败，Laravel 会自动将错误信息返回给客户端。我们可以在视图页面中使用 $errors 变量来显示这些错误信息：

@if ($errors->any())
    <div class="alert alert-danger">
        <ul>
            @foreach ($errors->all() as $error)
                <li>{{ $error }}</li>
            @endforeach
        </ul>
    </div>
@endif

上面的视图代码会检测是否有任何验证错误，并将错误信息输出到页面中。

5. 自定义错误信息

默认情况下，Laravel 会使用内置的错误消息来提示用户验证失败，但是我们也可以根据需要自定义错误信息。具体做法是在 YourFormRequest 类中添加一个 messages() 方法，该方法返回一个关联数组，其中的键名为字段名，值为对应的错误消息。例如：

public function messages()
{
    return [
        'username.required' => '请填写用户名',
        'password.required' => '请填写密码',
    ];
}

上面的代码将我们之前定义的必填规则的错误信息全部替换为了自定义消息。

结语

通过使用 Laravel 的表单验证机制，我们可以在开发业务逻辑时更方便地管理表单验证规则，提高代码复用率和安全性。本文仅是一个简单的入门教程，更多关于 Laravel 表单验证的细节和高级用法，请参考官方文档或者深入学习 Laravel 框架。