🌟 Laravel 自定义验证规则的依赖注入策略与条件分支方法：一场轻松愉快的技术讲座 🎤

大家好！欢迎来到今天的 Laravel 技术讲座，我是你们的讲师小助手 🚀。今天我们要聊的是一个非常有趣的话题：Laravel 自定义验证规则的依赖注入策略与验证逻辑的条件分支方法。听起来是不是有点复杂？别担心，我会用轻松诙谐的语言和通俗易懂的例子带你一步步理解这个主题。

准备好了吗？我们开始吧！💡

---

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

在 Laravel 中，验证是非常重要的一部分。默认情况下，Laravel 提供了很多内置的验证规则（比如 required、email、min 等）。但有时候，这些规则并不能满足我们的需求，这时就需要我们自己动手，创建 自定义验证规则。

✨ 创建自定义验证规则的方式

Laravel 提供了两种主要方式来创建自定义验证规则：

1. 使用闭包函数
   这是最简单的方式，适合简单的场景。

   Validator::make($request->all(), [
      'field' => function ($attribute, $value, $fail) {
          if ($value !== 'expected_value') {
              $fail('The :attribute is invalid.');
          }
      },
   ]);

2. 创建独立的规则类
   这种方式更适合复杂的验证逻辑，并且可以复用。

   php artisan make:rule CustomRule

   生成的类会位于 AppRules 目录下，结构如下：

   namespace AppRules;
   
   use IlluminateContractsValidationRule;
   
   class CustomRule implements Rule
   {
      public function passes($attribute, $value)
      {
          // 验证逻辑
          return $value === 'expected_value';
      }
   
      public function message()
      {
          return 'The :attribute must be "expected_value".';
      }
   }

---

🔧 第二部分：依赖注入策略

当我们需要在自定义验证规则中使用其他服务或类时，依赖注入就显得尤为重要。Laravel 的容器（Container）可以帮助我们优雅地实现这一点。

🌈 为什么需要依赖注入？

假设我们有一个场景：需要在验证规则中调用外部 API 来检查某个字段是否有效。如果直接在规则类中写死 API 调用代码，会导致代码耦合度高、难以测试等问题。而通过依赖注入，我们可以将 API 客户端作为参数传入规则类，从而提高代码的灵活性和可维护性。

🛠 实现依赖注入的步骤

1. 修改构造函数以接收依赖

   在规则类中，可以通过构造函数注入所需的依赖。

   namespace AppRules;
   
   use IlluminateContractsValidationRule;
   use AppServicesExternalApiService;
   
   class CustomRule implements Rule
   {
      protected $apiService;
   
      public function __construct(ExternalApiService $apiService)
      {
          $this->apiService = $apiService;
      }
   
      public function passes($attribute, $value)
      {
          // 使用注入的服务进行验证
          return $this->apiService->isValid($value);
      }
   
      public function message()
      {
          return 'The :attribute is not valid according to the external API.';
      }
   }

2. 在控制器中使用规则类

   当我们在控制器中使用规则类时，Laravel 的容器会自动解析依赖。

   use AppRulesCustomRule;
   
   public function store(Request $request)
   {
      $validatedData = $request->validate([
          'field' => ['required', new CustomRule()],
      ]);
   
      // 继续处理...
   }

3. 测试依赖注入

   在测试中，我们可以通过 Mock 或 Stub 替换真实的依赖，确保测试的独立性和准确性。

   use AppServicesExternalApiService;
   use AppRulesCustomRule;
   
   $mockApi = Mockery::mock(ExternalApiService::class);
   $mockApi->shouldReceive('isValid')->with('test_value')->andReturn(true);
   
   $rule = new CustomRule($mockApi);
   $this->assertTrue($rule->passes('field', 'test_value'));

---

🌲 第三部分：验证逻辑的条件分支方法

有时候，我们的验证逻辑并不是单一的，而是需要根据不同的条件执行不同的分支。例如，某个字段在用户为管理员时必须填写，但在普通用户时是可选的。

🍂 使用条件分支的场景

假设我们有一个表单字段 admin_code，其验证规则如下：

• 如果用户是管理员，则 admin_code 是必填项。
• 如果用户不是管理员，则 admin_code 是可选项。

🛠 实现条件分支的方法

1. 使用 sometimes 方法

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

   $validator = Validator::make($request->all(), [
      'user_role' => 'required|in:user,admin',
   ]);
   
   if ($validator->passes()) {
      if ($request->input('user_role') === 'admin') {
          $validator->sometimes('admin_code', 'required|min:6');
      }
   }
   
   if ($validator->fails()) {
      return redirect()->back()->withErrors($validator);
   }

2. 在规则类中实现条件分支

   我们也可以在自定义规则类中实现条件分支逻辑。

   namespace AppRules;
   
   use IlluminateContractsValidationRule;
   
   class ConditionalRule implements Rule
   {
      protected $isAdmin;
   
      public function __construct(bool $isAdmin)
      {
          $this->isAdmin = $isAdmin;
      }
   
      public function passes($attribute, $value)
      {
          if ($this->isAdmin) {
              return !empty($value) && strlen($value) >= 6;
          }
   
          return true; // 非管理员时不做任何限制
      }
   
      public function message()
      {
          return 'The :attribute is required and must be at least 6 characters for admins.';
      }
   }

3. 在控制器中使用

   use AppRulesConditionalRule;
   
   public function store(Request $request)
   {
      $isAdmin = $request->input('user_role') === 'admin';
   
      $validatedData = $request->validate([
          'admin_code' => ['sometimes', new ConditionalRule($isAdmin)],
      ]);
   
      // 继续处理...
   }

---

📋 总结

通过今天的讲座，我们学习了以下内容：

• 如何创建自定义验证规则（闭包方式 vs 独立规则类）。
• 如何通过依赖注入让规则类更加灵活和可测试。
• 如何在验证逻辑中实现条件分支，适应复杂的业务需求。

希望这篇文章能帮助你更好地理解和使用 Laravel 的验证功能。如果你有任何问题或想法，欢迎在评论区留言 😊。

最后，记得给这篇文章点个赞哦！🌟