27 自定义验证规则

在上一篇中，我们探讨了如何在Laravel中进行表单验证，通过使用系统提供的验证器轻松处理用户输入。今天，我们将深入探讨如何在Laravel中创建自定义验证规则，以满足特定的业务需求。这可以使您的验证逻辑更加灵活和可扩展。

什么是自定义验证规则？

在Laravel中，验证规则可以是内置的（例如 required, email, max 等），但有时这些内置规则无法完全满足我们的需求。在这种情况下，创建自定义验证规则便显得尤为重要。

自定义验证规则的好处在于，您可以按照特定的逻辑来验证用户输入，而且可以将逻辑封装在一个单独的类中，从而保持代码的整洁性和可重用性。

创建自定义验证规则

在Laravel中，您可以通过 Artisan 命令来创建自定义验证规则。

php artisan make:rule UniqueUsername

上述命令将创建一个名为 UniqueUsername 的验证规则类。您可以在 app/Rules 目录中找到这个文件。

编写自定义验证规则

接下来，我们要在 UniqueUsername 中添加验证逻辑，确保用户提交的用户名在数据库中是唯一的。

编辑 app/Rules/UniqueUsername.php，代码如下：

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;
use App\Models\User;

class UniqueUsername implements Rule
{
    public function passes($attribute, $value)
    {
        // 查询用户名是否已存在
        return !User::where('username', $value)->exists();
    }

    public function message()
    {
        return '用户名已被使用，请选择其他用户名。';
    }
}

这里我们实现了 passes 方法，在该方法中，我们查询 User 模型，判断给定的用户名是否已经存在于数据库中。如果存在，返回 false，表示验证失败；如果不存在，返回 true。

使用自定义验证规则

在创建了自定义验证规则后，您可以在您的控制器中使用它。在表单请求处理器或者控制器中添加验证逻辑。

假设我们有一个控制器 UserController，负责处理用户注册逻辑。在 register 方法中，您可以使用自定义验证规则如下：

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use App\Models\User;
use App\Rules\UniqueUsername;

class UserController extends Controller
{
    public function register(Request $request)
    {
        $validatedData = $request->validate([
            'username' => ['required', 'string', 'max:255', new UniqueUsername()],
            'email' => ['required', 'email', 'max:255', 'unique:users'],
            'password' => ['required', 'string', 'min:8', 'confirmed'],
        ]);

        // 创建用户逻辑
        User::create($validatedData);

        return redirect()->route('home')->with('success', '注册成功！');
    }
}

在 validate 方法中，我们添加了我们的自定义验证规则 new UniqueUsername()，这将使得在表单提交时，它会检查用户名是否唯一。

总结

通过上述步骤，我们成功实现了一个自定义验证规则，从而在使用 Laravel 进行表单处理和验证时提高了灵活性与可扩展性。您可以根据特定需求创建更多的自定义验证规则，以适应各种业务场景。

在下篇教程中，我们将探讨如何使用 Laravel 发送文本邮件。在邮件发送中，您可能会使用到表单中的用户数据，而这些数据则依赖于我们在本篇教程中创建的验证规则来确保它们的有效性和准确性。继续关注，让我们一起深入学习更多Laravel的强大功能！