在 laravel 8 中，开发者常常希望能够集中管理和复用应用程序中的验证规则，以避免重复代码并提高可维护性。然而，直接尝试将包含复杂表达式（例如 `rule::in` 或其他动态生成规则）的验证规则数组定义为类的静态属性时，会遇到 php 的一个限制：静态属性只能使用字面量或常量进行初始化，不能包含在编译时无法求值的表达式。这导致诸如 `symfonycomponenterrorhandlererrorfatalerror: constant expression contains invalid operations` 这样的错误。为了解决这一问题，laravel 推荐采用 php trait 的方式来优雅地实现验证规则的全局化和复用。
理解 PHP 静态属性的限制
PHP 在 5.6 版本之前，静态属性和类常量只能用字面量或常量表达式初始化。即使在 PHP 5.6 及更高版本中，虽然允许有限的表达式，但这些表达式也必须能在编译时求值。像 Rule::in([‘on’, ‘off’]) 这样的表达式，其结果是在运行时通过对象实例化或方法调用产生的，因此不能直接用于静态属性的初始化。
// 错误的示例：尝试在静态属性中定义动态规则class GlobalRules{ public static $VALIDATION_RULES = [ 'signatures' => [ 'enabled' => ['required', IlluminateValidationRule::in(['on', 'off'])], // 错误：Rule::in 是运行时表达式 // ... 其他规则 ], ];}
上述代码会因为 Rule::in 的动态性质而抛出编译时错误。
使用 Trait 实现验证规则的复用
Laravel 框架鼓励使用 Form Request 来处理复杂的验证逻辑。结合 PHP Trait，我们可以将常用的验证规则封装起来，并在多个 Form Request 类中复用。这种方法既符合面向对象的设计原则，又能规避静态属性的限制，因为 Trait 中的方法是在运行时被调用的。
1. 创建一个验证 Trait
首先，创建一个 Trait 文件，例如 app/Http/Traits/UserValidationTrait.php。在这个 Trait 中，定义一个私有方法，该方法负责返回一组与特定业务逻辑相关的验证规则。
['required', 'string', 'max:100'], $prefix . 'last_name' => ['required', 'string', 'max:100'], $prefix . 'status' => ['required', Rule::in(['active', 'inactive'])], // 可以在这里使用Rule::in ]; } /** * 返回签名信息的验证规则。 * * @param string $prefix 规则字段前缀。 * @return array */ private function getSignatureRules(string $prefix = ''): array { return [ $prefix . 'signature_file' => ['required', 'mimes:png,jpeg,jpg', 'max:1024'], $prefix . 'operator_id' => ['required', 'numeric'], // ... 其他签名相关规则 ]; }}
在 getUserInfoRules 方法中，我们定义了 first_name 和 last_name 的验证规则。值得注意的是，我们还引入了 $prefix 参数。这个参数非常有用，当我们需要验证一个嵌套对象（例如一个包含多个用户对象的数组）时，可以通过添加前缀来指定具体的字段路径，例如 users.*.first_name。
2. 在 FormRequest 中使用 Trait
接下来，在你的 Form Request 类中引入并使用这个 Trait。在 Form Request 的 rules() 方法中，你可以调用 Trait 中定义的私有方法来获取验证规则，并将其与当前 Form Request 特有的规则合并。
['required', 'email', 'unique:users,email,' . $this->user->id], 'phone' => ['nullable', 'string', 'max:20'], ]; // 调用Trait方法获取复用规则 $userInfoValidation = $this->getUserInfoRules(); $signatureValidation = $this->getSignatureRules(); // 合并所有规则 return array_merge( $currentRequestRules, $userInfoValidation, $signatureValidation ); }}
3. 处理嵌套对象的验证
如前所述，$prefix 参数允许我们处理更复杂的验证场景，例如验证请求中包含的子对象或数组元素。
假设你的请求数据中有一个 users 数组，每个元素都是一个用户对象，你需要验证每个用户的 first_name 和 last_name。你可以在调用 Trait 方法时传递带有通配符的前缀：
['required', 'array'], 'users.*.id' => ['required', 'numeric', 'exists:users,id'], // 验证每个用户的ID ]; // 为嵌套的 'users' 数组中的每个元素添加用户信息验证规则 $nestedUserValidation = $this->getUserInfoRules('users.*.'); // 注意这里的 'users.*.' 前缀 return array_merge( $currentRequestRules, $nestedUserValidation ); }}
在这个例子中，’users.*.’ 前缀将确保 getUserInfoRules 返回的规则（例如 first_name）被正确地应用到 users 数组中的每个元素的 first_name 字段（即 users.0.first_name, users.1.first_name 等）。
总结与最佳实践
通过使用 Trait 封装验证逻辑，我们可以：
避免 PHP 静态属性的限制：Trait 中的方法在运行时执行，可以自由地包含 Rule::in 等动态表达式。提高代码复用性：将常用的验证规则集中管理，避免在多个 Form Request 中重复编写相同的逻辑。增强模块化：将验证逻辑与 Form Request 的特定规则分离，使代码结构更清晰。提升可维护性：当验证规则发生变化时，只需修改 Trait 中的方法，所有使用该 Trait 的 Form Request 都会自动更新。
这种方法是 Laravel 中实现全局化和复用验证规则的推荐实践，它兼顾了代码的简洁性、可读性以及面对复杂验证场景的灵活性。在设计应用程序时，应积极考虑将常用的验证逻辑抽象为 Trait，以构建更加健壮和易于维护的系统。
以上就是在 Laravel 8 中优雅地定义和复用全局验证规则的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1342605.html
微信扫一扫 
支付宝扫一扫 
