本文介绍如何使用 Laravel 的表单验证机制，对多层嵌套数组（如 groups.*.qualities.*）进行精准、可扩展的字段校验，包括通配符规则定义、动态条件验证及自定义逻辑实现。

本文介绍如何使用 laravel 的表单验证机制，对多层嵌套数组（如 `groups.*.qualities.*`）进行精准、可扩展的字段校验，包括通配符规则定义、动态条件验证及自定义逻辑实现。

在 Laravel 中处理类似 groups → [group] → qualities → [quality] 这类深度嵌套的请求数据时，标准的 required|string 等基础规则不足以表达业务约束（例如：当 group.type = 'human' 时，qualities.*.type 必须为 'hair' 或 'height'；而 group.type = 'cat' 时仅允许 'hair'）。此时需结合 Laravel 的通配符验证语法与条件式规则（Conditional Rules） 实现灵活校验。

✅ 基础嵌套数组验证（通配符用法）

Laravel 支持使用 * 作为数组通配符，匹配任意层级索引。针对示例 payload，可先定义结构完整性校验：

$request->validate([
    'groups' => 'required|array|min:1',
    'groups.*.type' => 'required|string|in:human,cat',
    'groups.*.qualities' => 'required|array|min:1',
    'groups.*.qualities.*' => 'required|array',
    'groups.*.qualities.*.type' => 'required|string',
    'groups.*.qualities.*.value' => 'required|string',
]);

⚠️ 注意：groups.*.qualities.* 表示“每个 group 下 qualities 数组中任意索引的元素”，而非 groups.*.qualities.*.* —— 因为 qualities 本身是索引数组，其子项是关联数组（含 type/value 键），无需再加一层 *。

? 基于 group.type 的动态质量类型校验

若需实现“不同 group 类型限制不同 quality 类型”，推荐两种方式：

方式一：使用 Rule::when() + 自定义闭包（Laravel 9+）

use Illuminate\Validation\Rule;

$rules = [
    'groups' => 'required|array|min:1',
];

foreach (range(0, $request->input('groups', [])->count() - 1) as $i) {
    $groupType = $request->input("groups.{$i}.type");

    $allowedTypes = match($groupType) {
        'human' => ['hair', 'height'],
        'cat'   => ['hair'],
        default => []
    };

    $rules["groups.{$i}.type"] = ['required', 'string', Rule::in(['human', 'cat'])];
    $rules["groups.{$i}.qualities"] = 'required|array|min:1';

    // 动态为每个 quality 子项设置 type 白名单
    $qualities = $request->input("groups.{$i}.qualities", []);
    foreach (range(0, count($qualities) - 1) as $j) {
        $rules["groups.{$i}.qualities.{$j}.type"] = [
            'required',
            'string',
            Rule::in($allowedTypes)
        ];
        $rules["groups.{$i}.qualities.{$j}.value"] = 'required|string';
    }
}

$request->validate($rules);

方式二：封装为自定义验证规则（更可复用）

创建规则类：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

php artisan make:rule ValidGroupQualities

在 app/Rules/ValidGroupQualities.php 中实现：

public function passes($attribute, $value)
{
    foreach ($value as $index => $group) {
        $groupType = $group['type'] ?? null;
        $qualities = $group['qualities'] ?? [];

        if (!is_array($qualities)) {
            return false;
        }

        $allowed = match($groupType) {
            'human' => ['hair', 'height'],
            'cat'   => ['hair'],
            default => []
        };

        foreach ($qualities as $q) {
            if (!is_array($q) || !in_array($q['type'] ?? '', $allowed)) {
                return false;
            }
        }
    }
    return true;
}

然后在控制器中使用：

$request->validate([
    'groups' => ['required', 'array', new ValidGroupQualities],
]);

✅ 最佳实践建议

• 始终先校验结构，再校验语义：先用 required|array 确保嵌套存在，再对具体字段做业务校验。
• *避免过度依赖 `深度嵌套**：groups..qualities..type虽简洁，但无法做跨层级条件判断（如根据groups..type控制qualities..type`），此时需显式循环或自定义规则。
• 配合 withValidator 进行后置增强（适用于复杂逻辑）：

  $request->withValidator(function ($validator) {
      $validator->after(function ($validator) use ($request) {
          // 手动遍历并添加错误信息
      });
  });

通过合理组合通配符、条件规则与自定义验证器，你可以在 Laravel 中稳健地处理任意复杂度的嵌套数组验证需求，兼顾可读性、可维护性与业务准确性。