🎤 Laravel 自定义验证规则的条件验证与验证逻辑的动态加载：一场技术讲座

大家好！欢迎来到今天的 Laravel 技术讲座！今天我们将一起探讨一个非常有趣的话题——自定义验证规则的条件验证与验证逻辑的动态加载。如果你曾经在 Laravel 的表单验证中遇到过“复杂场景”或者“动态需求”，那么这场讲座绝对适合你！准备好了吗？让我们开始吧！✨

🌟 开场白：为什么需要自定义验证？

在 Laravel 中，内置的验证规则（如 required、email、min 等）已经非常强大了，但现实世界中的业务需求往往比这些规则更加复杂。比如：

用户注册时，密码必须包含大写字母、小写字母和数字。
某个字段只有在另一个字段满足特定条件时才需要验证。
验证逻辑可能需要根据数据库中的数据动态调整。

这些问题都可以通过 自定义验证规则 来解决！接下来，我们就来一步步拆解这个过程。

📝 第一部分：自定义验证规则的基础

Laravel 提供了两种创建自定义验证规则的方式：闭包（Closure） 和 类（Class）。我们先来看一下它们的基本用法。

1. 使用闭包创建自定义规则

闭包方式非常适合简单的自定义验证逻辑。例如，我们想验证一个字符串是否以大写字母开头：

use IlluminateSupportFacadesValidator;

$validator = Validator::make($request->all(), [
    'name' => [
        'required',
        function ($attribute, $value, $fail) {
            if (!preg_match('/^[A-Z]/', $value)) {
                $fail($attribute . ' 必须以大写字母开头！');
            }
        },
    ],
]);

💡 注意：闭包方式虽然简单，但对于复杂的逻辑可能会显得不够优雅。

2. 使用类创建自定义规则

如果验证逻辑较为复杂，推荐使用类的方式。我们可以创建一个独立的验证规则类，然后在验证器中使用它。

创建规则类

php artisan make:rule UppercaseStart

这会生成一个名为 UppercaseStart.php 的文件，位于 AppRules 目录下。

实现逻辑

打开 UppercaseStart.php 文件，实现 passes 和 message 方法：

namespace AppRules;

use IlluminateContractsValidationRule;

class UppercaseStart implements Rule
{
    public function passes($attribute, $value)
    {
        return preg_match('/^[A-Z]/', $value);
    }

    public function message()
    {
        return ':attribute 必须以大写字母开头！';
    }
}

在验证器中使用

use AppRulesUppercaseStart;
use IlluminateSupportFacadesValidator;

$validator = Validator::make($request->all(), [
    'name' => ['required', new UppercaseStart()],
]);

🚀 第二部分：条件验证的艺术

有时候，我们需要根据其他字段的值来决定某个字段是否需要验证。这就是所谓的 条件验证。Laravel 提供了几种实现方式：

1. 使用 `sometimes` 方法

sometimes 方法允许我们根据条件动态添加验证规则。例如：

$validator = Validator::make($request->all(), [
    'email' => 'required|email',
]);

if ($request->input('subscribe')) {
    $validator->sometimes('subscription_plan', 'required', function ($input) {
        return $input->subscribe == 'yes';
    });
}

在这个例子中，subscription_plan 字段只有在 subscribe 字段为 'yes' 时才需要验证。

2. 使用 `required_if` 规则

required_if 是一种更简洁的方式，可以直接在规则中指定条件。例如：

Validator::make($request->all(), [
    'email' => 'required|email',
    'subscription_plan' => 'required_if:subscribe,yes',
]);

这里的 required_if:subscribe,yes 表示：当 subscribe 字段的值为 'yes' 时，subscription_plan 字段才需要验证。

🔍 第三部分：动态加载验证逻辑

在某些情况下，验证逻辑可能需要从外部来源动态加载，比如从数据库或配置文件中读取规则。下面我们来看一个实际的例子。

场景描述

假设我们有一个表单，其中的验证规则存储在数据库中。我们需要根据这些规则动态生成验证器。

数据库结构

id	field_name	rules
1	name	required	string	max:255
2	age	nullable	integer	min:18

动态加载逻辑

use IlluminateSupportFacadesValidator;
use AppModelsFormRule; // 假设这是存储验证规则的模型

$formRules = FormRule::pluck('rules', 'field_name')->toArray();

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

if ($validator->fails()) {
    return response()->json(['errors' => $validator->errors()], 422);
}

在这个例子中，我们从数据库中读取了验证规则，并将其直接传递给 Validator::make 方法。

🛠️ 第四部分：最佳实践与技巧

保持规则清晰：尽量将复杂的验证逻辑封装到独立的类中，避免代码过于冗长。
善用翻译文件：通过 lang/validation.php 文件定义错误消息，使国际化更方便。
测试先行：为自定义规则编写单元测试，确保其行为符合预期。

🎉 总结

今天的讲座就到这里啦！我们学习了如何在 Laravel 中创建自定义验证规则，掌握了条件验证的多种实现方式，并探讨了如何动态加载验证逻辑。希望这些内容能帮助你在实际项目中更高效地处理复杂的验证需求！

最后，送给大家一句话：Validation is not just about catching errors; it’s about guiding users to success. 😊

谢谢大家的聆听！如果有任何问题，欢迎在评论区提问！💬