Laravel 中使用 Rule::in 进行数组值校验的实践指南

33次阅读

Laravel 中使用 Rule::in 进行数组值校验的实践指南

本教程详细介绍了在 Laravel 中如何利用 Rule::in 验证请求值是否包含在指定数组中。文章首先阐释了 Rule::in 的基本用法,随后深入探讨了如何处理复杂数组结构(如对象数组或嵌套关联数组),通过 array_map 或循环提取目标值列表,确保验证的准确性和灵活性。

1. 理解 Laravel 的 Rule::in 验证规则

laravel 中,当我们需要验证一个输入值是否在某个预定义的值集合中时,in 验证规则是理想的选择。然而,直接在验证字符串中使用 in:value1,value2 适用于简单的硬编码列表。对于动态生成的数组,尤其是需要从数据库或会话中获取的数组,我们应使用 illuminatevalidationrule 类提供的 rule::in() 方法。

Rule::in() 方法接收一个数组作为参数,该数组包含了所有允许的有效值。如果请求中的字段值与该数组中的任何一个元素匹配,则验证通过。

基本用法示例:

use IlluminateValidationRule; use IlluminateHttpRequest;  // 假设我们有一个允许的颜色列表 $allowedColors = ['red', 'green', 'blue'];  // 在控制器或表单请求中进行验证 public function store(Request $request) {     $request->validate([         'color' => [             'required', // 字段必须存在且不为空             Rule::in($allowedColors), // 字段值必须在 $allowedColors 数组中         ],     ]);      // 验证通过,继续处理业务逻辑     // ... }

2. 处理复杂数据源:从对象数组中提取验证列表

实际应用中,我们用于验证的列表往往不是简单的字符串数组,而是从数据库查询或会话中获取的包含对象或关联数组的集合。例如,从会话中获取的 agency_names 可能是一个包含 AgencyID、AgencyName 等字段的对象数组:

// 假设从 Session 中获取的数据结构如下: $agencies = [     (object)['AgencyID' => 'A1169', 'AgencyName' => '19 London', 'AgencyType' => 'Agency Plus'],     (object)['AgencyID' => 'A1095', 'AgencyName' => 'Abbeville Nannies', 'AgencyType' => 'Affiliate'],     // ...更多代理数据 ];

在这种情况下,直接将 $agencies 传递给 Rule::in() 是无效的,因为 Rule::in() 期望的是一个包含待匹配值的简单数组(例如,只包含 AgencyName 的数组)。我们需要先将这个复杂数组转换为一个只包含 AgencyName 字符串的数组。

我们可以使用 PHP 的 array_map 函数结合箭头函数(PHP 7.4+)或匿名函数来高效地完成这一转换:

use IlluminateValidationRule; use IlluminateHttpRequest; use IlluminateSupportFacadesSession; // 假设数据存储在 Session 中  public function processAgency(Request $request) {     // 1. 从 Session 中获取原始代理数据     $agenciesData = Session::get('config.agency-names');      // 2. 使用 array_map 提取所有 AgencyName     // 注意:变量名建议更具描述性,例如 $agencies 或 $agencyList     $agencyNames = array_map(fn($agency_data): string => $agency_data->AgencyName, $agenciesData);      // 3. 执行验证     $request->validate([         'agency-name' => [             'required', // 代理名称必须提供             Rule::in($agencyNames), // 代理名称必须在提取出的列表中         ],     ]);      // 验证通过,继续处理     // ... }

注意事项:

  • 确保 array_map 回调函数中访问的属性或键是正确的。
  • 如果 $agenciesData 可能是空数组,array_map 也能正确处理,Rule::in 会检查空列表。

3. 应对嵌套关联数组的场景

有时,数据结构可能更为复杂,例如,代理列表可能嵌套在一个更大的关联数组中,如 [‘Agencies’ =youjiankuohaophpcn […]]。在这种情况下,我们需要更深入地访问数据。

假设从会话中获取的数据结构如下:

Laravel 中使用 Rule::in 进行数组值校验的实践指南

百度文心百中

百度大模型语义搜索体验中心

Laravel 中使用 Rule::in 进行数组值校验的实践指南22

查看详情 Laravel 中使用 Rule::in 进行数组值校验的实践指南

$agenciesContainer = [     'Agencies' => [         ['AgencyID' => 'A1169', 'AgencyName' => '19 London', 'AgencyType' => 'Agency Plus'],         ['AgencyID' => 'A1095', 'AgencyName' => 'Abbeville Nannies', 'AgencyType' => 'Affiliate'],         // ...更多代理数据     ] ];

在这种结构下,我们可以通过循环遍历或结合 array_column (如果数据是纯关联数组) 来提取所需的 AgencyName 列表。

使用循环提取示例:

use IlluminateValidationRule; use IlluminateHttpRequest; use IlluminateSupportFacadesSession;  public function submitReferral(Request $request) {     // 1. 获取包含嵌套代理数据的容器     $agenciesContainer = Session::get('config.agency-names');      $agencyNamesList = [];     // 2. 遍历嵌套数组以提取 AgencyName     // 确保 'Agencies' 键存在且是数组     if (isset($agenciesContainer['Agencies']) && is_array($agenciesContainer['Agencies'])) {         foreach ($agenciesContainer['Agencies'] as $agencyData) {             // 确保每个代理数据项中包含 'AgencyName' 键             if (isset($agencyData['AgencyName'])) {                 $agencyNamesList[] = $agencyData['AgencyName'];             }         }     }      // 3. 执行验证,这里还加入了 'required_if' 规则作为示例     $request->validate([         'agency-name' => [             'required_if:referral,no', // 当 'referral' 字段值为 'no' 时,'agency-name' 必须提供             Rule::in($agencyNamesList), // 代理名称必须在提取出的列表中         ],     ]);      // 验证通过,继续处理     // ... }

使用 array_column 提取示例 (适用于纯关联数组):

如果 agenciesContainer[‘Agencies’] 中的每个元素都是关联数组,且结构一致,array_column 是一个更简洁的选择:

// ... $agenciesContainer = Session::get('config.agency-names'); $agencyNamesList = [];  if (isset($agenciesContainer['Agencies']) && is_array($agenciesContainer['Agencies'])) {     $agencyNamesList = array_column($agenciesContainer['Agencies'], 'AgencyName'); }  $request->validate([     'agency-name' => [         'required_if:referral,no',         Rule::in($agencyNamesList),     ], ]); // ...

4. 总结

在 Laravel 中使用 Rule::in() 进行数组值校验是一个强大且灵活的功能。关键在于:

  1. 引入 IlluminateValidationRule 类。
  2. 准备正确的验证列表: Rule::in() 期望接收一个简单的一维数组,其中包含所有允许的字符串或数值。
  3. 数据转换: 如果你的原始数据源是对象数组、关联数组或嵌套结构,务必使用 array_map、array_column 或循环等方法将其转换为符合 Rule::in() 期望的简单列表。
  4. 清晰的验证规则定义: 将 Rule::in(…) 作为数组元素传递给 validate 方法,可以与其他规则(如 required、required_if)结合使用。

通过遵循这些实践,你可以有效地在 Laravel 应用中实现动态且健壮的数组值验证逻辑。

以上就是Laravel 中使用 Rule::in 进行数组值校验的实践指南的详细内容,更多请关注php laravel cad 编码 回调函数 session ai 字符串数组 red php laravel 关联数组 回调函数 字符串 循环 数据结构 对象 数据库

php laravel cad 编码 回调函数 session ai 字符串数组 red php laravel 关联数组 回调函数 字符串 循环 数据结构 对象 数据库

text=ZqhQzanResources