🎤 Laravel 自定义验证规则的依赖注入与条件分支策略：一场轻松诙谐的技术讲座
大家好！👋 欢迎来到今天的 Laravel 技术讲座。今天我们要聊一聊一个非常有趣的话题——如何在 Laravel 中自定义验证规则，并优雅地使用依赖注入和条件分支策略。如果你是一个喜欢用代码解决问题的人，那么这篇文章会让你大呼过瘾！🎉
📝 讲座大纲
- Laravel 验证规则的基础回顾
- 自定义验证规则的创建与注册
- 依赖注入在验证规则中的应用
- 条件分支策略的设计与实现
- 实战演练：一个完整的例子
- 总结与 Q&A
1. Laravel 验证规则的基础回顾
在 Laravel 中，验证是开发者每天都要打交道的事情之一。默认情况下，Laravel 提供了丰富的内置验证规则（如 required、email、min 等），但有时候这些规则并不能完全满足我们的需求。
举个例子，假设我们有一个用户注册表单，需要验证用户名是否符合以下规则：
- 必须包含至少一个字母。
- 不允许包含特殊字符（除了下划线）。
这种情况下，内置规则就显得有些力不从心了。别担心，Laravel 提供了强大的自定义验证规则功能，让我们可以轻松应对这种情况。
2. 自定义验证规则的创建与注册
Laravel 提供了两种方式来创建自定义验证规则：
方法 1：使用闭包
Validator::extend('custom_rule', function ($attribute, $value, $parameters, $validator) {
return preg_match('/^[a-zA-Z0-9_]+$/', $value);
});方法 2：创建独立的规则类
我们可以使用 Artisan 命令生成一个规则类：
php artisan make:rule CustomRule这会生成一个类似以下结构的类：
namespace AppRules;
use IlluminateContractsValidationRule;
class CustomRule implements Rule
{
public function passes($attribute, $value)
{
// 验证逻辑
return preg_match('/^[a-zA-Z0-9_]+$/', $value);
}
public function message()
{
return 'The :attribute must only contain letters, numbers, and underscores.';
}
}然后在控制器或 FormRequest 中使用它：
use AppRulesCustomRule;
$request->validate([
'username' => ['required', new CustomRule],
]);3. 依赖注入在验证规则中的应用
依赖注入是 Laravel 的一大特色，但在验证规则中，我们该如何优雅地使用它呢？
场景描述
假设我们需要在验证时调用一个外部服务（例如 Redis 或数据库）来检查某个值是否存在。这时候，依赖注入就派上用场了。
实现步骤
- 在规则类的构造函数中注入所需的依赖。
- 使用该依赖完成验证逻辑。
示例代码如下：
namespace AppRules;
use IlluminateContractsValidationRule;
use IlluminateSupportFacadesCache;
class UniqueUsername implements Rule
{
protected $cacheKey;
public function __construct(string $cacheKey)
{
$this->cacheKey = $cacheKey;
}
public function passes($attribute, $value)
{
// 检查缓存中是否存在该用户名
return !Cache::has($this->cacheKey . '.' . $value);
}
public function message()
{
return 'The :attribute has already been taken.';
}
}使用时可以通过以下方式传递依赖：
use AppRulesUniqueUsername;
$request->validate([
'username' => ['required', new UniqueUsername('usernames')],
]);小贴士：如果依赖项较多，可以考虑将规则类改为服务类，并通过容器解析依赖。
4. 条件分支策略的设计与实现
在实际开发中，我们经常会遇到需要根据某些条件动态调整验证规则的情况。Laravel 提供了几种方法来实现这一点。
方法 1：使用 sometimes 方法
sometimes 方法可以根据条件动态添加规则。例如：
$validator = Validator::make($request->all(), [
'email' => 'required|email',
]);
if ($request->input('subscribe') === 'true') {
$validator->sometimes('subscription_plan', 'required', function ($input) {
return $input->subscribe === 'true';
});
}方法 2：使用 when 方法
when 方法更简洁，适合简单的条件判断：
$request->validate([
'email' => 'required|email',
'subscription_plan' => Rule::when($request->input('subscribe') === 'true', 'required'),
]);方法 3：自定义条件分支逻辑
如果条件较为复杂，可以封装为一个独立的方法或服务。例如：
public function getValidationRules(Request $request)
{
$rules = [
'email' => 'required|email',
];
if ($request->input('subscribe') === 'true') {
$rules['subscription_plan'] = 'required';
}
return $rules;
}然后在控制器中调用：
$request->validate($this->getValidationRules($request));5. 实战演练：一个完整的例子
假设我们正在开发一个博客系统，需要实现以下功能：
- 用户提交文章时，标题必须唯一。
- 如果用户选择了“发布”选项，则内容不能为空。
步骤 1：创建规则类
php artisan make:rule UniqueTitle编辑生成的 UniqueTitle 类：
namespace AppRules;
use IlluminateContractsValidationRule;
use AppModelsPost;
class UniqueTitle implements Rule
{
public function passes($attribute, $value)
{
return !Post::where('title', $value)->exists();
}
public function message()
{
return 'The :attribute must be unique.';
}
}步骤 2：编写验证逻辑
use AppRulesUniqueTitle;
public function store(Request $request)
{
$request->validate([
'title' => ['required', new UniqueTitle],
'content' => Rule::when($request->input('publish') === 'true', 'required'),
]);
// 处理业务逻辑
}6. 总结与 Q&A
通过今天的讲座，我们学习了如何在 Laravel 中创建自定义验证规则，并结合依赖注入和条件分支策略来提升代码的灵活性和可维护性。👏
Q&A 时间
Q1: 如果规则类中有多个依赖，如何优雅地解决？
A: 可以将规则类改为服务类，并通过容器解析依赖。
Q2: 如何调试复杂的验证规则？
A: 使用 dd() 或日志记录工具打印中间结果，逐步排查问题。
希望今天的分享对你有所帮助！如果还有任何疑问，欢迎留言交流~ 😊
