Laravel数组字段验证怎么写-Laravel-PHP中文网

数组字段验证必须以array规则打底，否则required|array|min:1等组合无效；正确写法是先array再约束内容，如tags需为1–5个2–20字符的非空字符串，嵌套数组须逐层声明array规则，空数组需用min:1拦截，复杂校验推荐rule::foreach()。

laravel数组字段验证怎么写

数组字段验证必须用 `array` 规则打底

不加 array 直接写 required|array|min:1 是无效的——Laravel 会把空字符串、null 或非数组值直接判为失败，但不会阻止后续规则执行；而如果你漏了 array，像 required|size:3 这类规则会在非数组上抛出 InvalidArgumentException（“The size rule requires an array or countable”）。

正确写法是：先确保是数组，再约束内容。例如验证一个标签列表：

public function rules()
{
    return [
        'tags' => ['required', 'array', 'min:1', 'max:5'],
        'tags.*' => ['required', 'string', 'min:2', 'max:20'],
    ];
}

tags 本身必须是非空数组，长度 1–5
tags.* 对每个元素单独校验：不能是空、必须是字符串、长度 2–20
如果传入 "tags": "foo"（字符串），array 规则立刻失败，后续规则不执行
如果传入 "tags": [null, "bar"]，tags.0 会因 required 失败

`required_without` 和 `required_if` 在数组字段上容易误判

这类条件规则对数组字段的行为和普通字段不同：它们检查的是「字段是否存在且非空数组」，而不是「数组是否含元素」。比如 required_without:category 判断 tags 是否存在且不是空数组（[] 被视为「存在但为空」，不触发 required）。

常见陷阱：

Laravel 13.2.0

Laravel 13.2.0 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

传 "tags": [] → required_without 不生效，即使你期望它被当作「未提供」
传 "tags": null 或完全不传 → 才算「字段不存在」，此时条件规则才起作用
想让空数组也触发 required？得手动补逻辑：'tags' => 'required_without:category|array|min:1'，靠 min:1 拦截空数组

嵌套数组（如多维表单）要用 `array` + `..` 层层展开

比如上传多个文件并带元数据：files.0.name、files.0.size、files.1.name……验证时不能只写 files.*，否则 Laravel 不知道 files.0 本身也要是数组。

正确结构：

'files' => 'required|array|min:1',
'files.*' => 'required|array', // 每个 item 必须是数组
'files.*.name' => 'required|string|max:100',
'files.*.size' => 'required|integer|min:1',
'files.*.type' => 'required|string|in:pdf,docx'

缺 files.* => array，当某项是字符串（如 "files": [{"name":"a"}, "oops"]）时，files.1.name 会报错「Cannot use object of type string as array」
files.* 的规则必须显式声明，不能省略——它不是自动继承 files 的 array
深层嵌套（如 files.*.metadata.*.key）同理，每层中间节点都要有 array 规则兜底

自定义数组元素验证（比如唯一性去重）得用 `Rule::forEach()`

Laravel 9+ 提供 Rule::forEach() 来对每个数组项动态生成规则，解决「数组内元素互斥」「跨字段组合校验」等场景。例如禁止重复邮箱：

'emails' => ['required', 'array', 'min:1'],
'emails.*' => ['required', 'email', Rule::forEach(function ($value, $attribute) {
    return Rule::unique('users', 'email')->whereNotIn('id', request('exclude_ids', []));
})],