🌟 Laravel 自定义验证规则：依赖注入与条件分支的艺术 🚀

大家好！欢迎来到今天的 Laravel 技术讲座。今天我们要聊一聊 Laravel 中自定义验证规则的那些事儿，特别是 依赖注入 和 条件分支方法 的使用技巧。如果你对 Laravel 验证已经很熟悉了，那今天我们来一起深入挖掘一下它的“隐藏技能”吧！🎉

---

🔍 开场白：为什么要自定义验证规则？

Laravel 的内置验证规则（如 required、email、min 等）虽然强大，但总有那么一些场景需要我们“另辟蹊径”。比如：

• 验证某个字段是否符合特定的业务逻辑。
• 验证字段之间的复杂关系。
• 动态生成验证规则。

这时候，自定义验证规则就派上用场了！✨

---

💡 依赖注入：让验证规则更灵活

在 Laravel 中，自定义验证规则可以通过多种方式实现，例如使用闭包、扩展 Validator 类，或者创建独立的 Rule 对象。但无论哪种方式，依赖注入 都能让我们的代码更加优雅和可测试。

场景：动态获取配置值

假设我们需要验证一个字段是否符合某种动态生成的规则（例如从数据库中读取）。我们可以利用依赖注入将服务或配置注入到验证规则中。

方法 1：使用闭包

use IlluminateSupportFacadesValidator;

Validator::extend('custom_rule', function ($attribute, $value, $parameters, $validator) {
    // 通过 app() 获取依赖
    $configService = app('ConfigService');
    return $configService->isValid($value);
});

在这里，app() 是 Laravel 的服务容器，它允许我们在闭包中轻松获取任何绑定的服务。

方法 2：使用 Rule 对象

Rule 对象是 Laravel 提供的一种更结构化的方式来定义验证规则。以下是一个示例：

use IlluminateContractsValidationRule;
use AppServicesConfigService;

class CustomRule implements Rule
{
    protected $configService;

    public function __construct(ConfigService $configService)
    {
        $this->configService = $configService;
    }

    public function passes($attribute, $value)
    {
        // 使用依赖进行验证
        return $this->configService->isValid($value);
    }

    public function message()
    {
        return 'The :attribute is invalid.';
    }
}

在这个例子中，ConfigService 被注入到了 CustomRule 中，使得我们可以轻松地调用它的方法。

方法 3：结合 Form Request

如果你正在使用 Form Request，也可以通过构造函数注入依赖：

use AppHttpRequestsCustomFormRequest;
use AppServicesConfigService;

class CustomFormRequest extends FormRequest
{
    protected $configService;

    public function __construct(ConfigService $configService)
    {
        $this->configService = $configService;
    }

    public function rules()
    {
        return [
            'field' => ['required', new CustomRule($this->configService)],
        ];
    }
}

---

🌈 条件分支方法：让验证更智能

有时候，验证规则需要根据上下文动态变化。例如，某些字段只有在其他字段满足特定条件时才需要验证。这时候，条件分支方法就显得尤为重要。

场景：根据字段值动态验证

假设我们有一个表单，用户可以选择“付款方式”，如果选择了“信用卡”，则需要验证信用卡号是否有效。

方法 1：使用 sometimes 方法

Laravel 的 Validator 类提供了 sometimes 方法，可以根据条件动态添加验证规则。

$validator = Validator::make($request->all(), [
    'payment_method' => 'required|in:cash,credit_card',
]);

if ($validator->passes()) {
    if ($request->input('payment_method') === 'credit_card') {
        $validator->sometimes('card_number', 'required|credit_card', function ($input) {
            return $input->payment_method === 'credit_card';
        });
    }
}

if ($validator->fails()) {
    // 处理错误
}

方法 2：使用条件规则数组

在 Laravel 5.5+ 中，可以使用匿名函数直接定义条件规则：

return [
    'payment_method' => 'required|in:cash,credit_card',
    'card_number' => function ($attribute, $value, $fail) use ($request) {
        if ($request->input('payment_method') === 'credit_card' && empty($value)) {
            $fail('The card number is required when using credit card.');
        }
    },
];

方法 3：结合 Rule 对象

我们还可以将条件分支封装到 Rule 对象中：

use IlluminateContractsValidationRule;

class CardNumberRule implements Rule
{
    protected $paymentMethod;

    public function __construct($paymentMethod)
    {
        $this->paymentMethod = $paymentMethod;
    }

    public function passes($attribute, $value)
    {
        if ($this->paymentMethod === 'credit_card') {
            return !empty($value); // 或者更复杂的验证逻辑
        }

        return true; // 如果不是信用卡支付，则忽略验证
    }

    public function message()
    {
        return 'The card number is required when using credit card.';
    }
}

然后在验证规则中使用：

return [
    'payment_method' => 'required|in:cash,credit_card',
    'card_number' => [new CardNumberRule($request->input('payment_method'))],
];

---

📊 总结对比

为了让大家更直观地理解，我们用表格总结一下不同方法的特点：

方法	优点	缺点
闭包	快速简单，适合小规模验证	可维护性较差，不适合复杂逻辑
Rule 对象	结构清晰，易于测试和复用	需要额外定义类文件
Form Request	集成验证、授权等功能，适合大型项目	增加了请求类的数量
sometimes 方法	动态添加规则，灵活性高	代码稍显冗长
条件规则数组	简洁明了，适合简单条件分支	不适合复杂逻辑

---

🎉 最后的小彩蛋

国外技术文档中提到，Laravel 的验证系统设计灵感来源于 Ruby on Rails 的 ActiveModel。如果你对 Rails 的验证机制感兴趣，可以参考其官方文档（当然，这里不提供链接啦~ 😄）。

希望今天的分享能帮助你更好地掌握 Laravel 自定义验证规则的精髓！如果有任何问题或想法，请随时留言交流。🌟