Laravel 中如何验证嵌套数组结构的请求数据-php教程-PHP中文网

Laravel 中如何验证嵌套数组结构的请求数据

本文介绍在 Laravel 中验证多层嵌套数组（如 groups[].qualities[]）的实用方法，涵盖通配符规则、条件化验证逻辑及自定义验证器集成技巧，确保数据结构合规且语义准确。

本文介绍在 laravel 中验证多层嵌套数组（如 `groups[].qualities[]`）的实用方法，涵盖通配符规则、条件化验证逻辑及自定义验证器集成技巧，确保数据结构合规且语义准确。

在 Laravel 中处理类似 groups → [type, qualities → [{type, value}]] 的深层嵌套请求时，标准的点号（.）语法结合通配符 * 是实现灵活、可读性强验证的关键。Laravel 的验证器原生支持数组通配符，能自动遍历每一层级，无需手动循环或编写冗余规则。

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

以问题中的 $payload 结构为例，对应 Request 对象中实际字段为 groups.*（而非 payload.*），因此正确规则应基于真实键名：

$request->validate([
    'groups.*' => 'required|array',
    'groups.*.type' => 'required|string|in:human,cat', // 限定合法 group 类型
    'groups.*.qualities' => 'required|array|min:1',
    'groups.*.qualities.*' => 'required|array',
    'groups.*.qualities.*.type' => 'required|string',
    'groups.*.qualities.*.value' => 'required|string',
]);

⚠️ 注意：groups.*.qualities.* 表示“每个 group 下的每个 quality 子数组”，而 groups.*.qualities.*.type 则精准校验其内部字段 —— 这种链式通配符是 Laravel 验证器的核心能力。

? 条件化验证：按 group.type 动态约束 quality.type

若需实现「human 组只允许 hair/height，cat 组只允许 hair」等业务规则，单纯内置规则无法满足。此时应结合 required_if 或自定义验证器：

方案一：使用 `required_if` + `in` 组合（适用于简单枚举）

$rules = [
    'groups.*.type' => 'required|string|in:human,cat',
    'groups.*.qualities.*.type' => 'required|string',
];

// 动态追加条件规则（需在控制器中构建）
foreach (range(0, $request->input('groups', [])) as $i) {
    $groupType = $request->input("groups.{$i}.type");
    if ($groupType === 'human') {
        $rules["groups.{$i}.qualities.*.type"] = 'required|string|in:hair,height';
        $rules["groups.{$i}.qualities.*.value"] = 'required|string|regex:/^\d+cm$/|size:5';
    } elseif ($groupType === 'cat') {
        $rules["groups.{$i}.qualities.*.type"] = 'required|string|in:hair';
        $rules["groups.{$i}.qualities.*.value"] = 'required|string|in:yellow,black,white';
    }
}

$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'] ?? [];

        foreach ($qualities as $qIndex => $quality) {
            $qType = $quality['type'] ?? null;
            $validTypes = match($groupType) {
                'human' => ['hair', 'height'],
                'cat'   => ['hair'],
                default => [],
            };

            if (!in_array($qType, $validTypes)) {
                $this->message = "Quality type '{$qType}' is invalid for group type '{$groupType}'.";
                return false;
            }
        }
    }
    return true;
}

然后在控制器中使用：

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

? 注意事项与最佳实践

避免过度嵌套验证：若层级超过 3 层（如 a.*.b.*.c.*），建议提前 collect() 数据并用集合方法预处理，提升可读性与调试效率；
错误消息定位：Laravel 默认错误键如 groups.0.qualities.1.type 能精准反馈失败位置，前端可据此高亮对应表单项；
性能考虑：对超大数组（如 groups 含上百项），自定义规则中应避免 N+1 检查，优先使用 array_filter + array_keys 批量校验；
测试覆盖：务必为边界情况编写 PHPUnit 测试，例如空 qualities、缺失 type、非法枚举值等。