Laravel 中数组嵌套数据的高效验证指南

在现代 Web 开发中，应用程序经常需要处理复杂的数据结构，例如包含多个对象的数组。当接收到类似以下格式的 JSON 或表单数据时，如何有效地验证数组中每个对象的特定属性（如电子邮件地址和角色 ID）成为了一个常见需求：

[
  {
    "email": "user1@example.com",
    "role_id": 2
  },
  {
    "email": "user2@example.com",
    "role_id": 3
  }
]

Laravel 提供了强大而灵活的验证系统，能够轻松应对这类嵌套数组的验证场景。

Laravel 数组验证核心：点式表示法

Laravel 的验证器支持使用点式表示法（.*）来指定数组内部元素的验证规则。这里的 * 是一个通配符，它表示数组中的每一个元素。

假设您的请求数据中，上述数组的键名为 members，那么验证规则将针对 members 数组中的每个对象进行。

在表单请求 (Form Request) 中实现验证

推荐的做法是使用 Laravel 的表单请求（Form Request）类来封装验证逻辑。这有助于保持控制器代码的整洁，并集中管理复杂的验证规则。

首先，您可以使用 Artisan 命令创建一个新的表单请求：

php artisan make:request StoreMembersRequest

然后，在生成的 app/Http/Requests/StoreMembersRequest.php 文件中，您需要在 rules() 方法中定义验证规则。

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

class StoreMembersRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     */
    public function authorize(): bool
    {
        // 根据您的业务逻辑，确定用户是否有权限执行此请求
        return true;
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
     */
    public function rules(): array
    {
        return [
            // 1. 验证 'members' 字段本身必须存在且是一个数组
            'members' => ['required', 'array'],

            // 2. 验证 'members' 数组中的每一个元素 (即每个对象)
            //    'members.*' 表示数组中的每一个索引
            //    'members.*.email' 表示数组中每个元素的 'email' 属性
            'members.*.email' => ['required', 'email'], // 必须存在且是有效的电子邮件格式

            // 3. 验证 'members' 数组中每个元素的 'role_id' 属性
            'members.*.role_id' => ['required', 'integer'], // 必须存在且是整数
        ];
    }
}

规则解析：

怪兽AI数字人

数字人短视频创作，数字人直播，实时驱动数字人

44

查看详情

• 'members' => ['required', 'array']: 这条规则确保请求中必须包含一个名为 members 的字段，并且它的值必须是一个数组。这是对整个数组结构的基本验证。
• 'members.*.email' => ['required', 'email']: 这是核心规则。members.* 指代 members 数组中的每一个元素。因此，members.*.email 意味着对 members 数组中每个对象的 email 属性应用 required（必需）和 email（有效电子邮件格式）规则。
• 'members.*.role_id' => ['required', 'integer']: 类似地，这条规则对 members 数组中每个对象的 role_id 属性应用 required（必需）和 integer（整数）规则。

在控制器中直接使用验证

如果您不想创建独立的表单请求类，也可以在控制器的方法中直接使用 validate() 方法来应用这些规则。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class MemberController extends Controller
{
    public function store(Request $request)
    {
        $validatedData = $request->validate([
            'members' => ['required', 'array'],
            'members.*.email' => ['required', 'email'],
            'members.*.role_id' => ['required', 'integer'],
        ]);

        // 验证通过，可以安全地处理 $validatedData
        // 例如：
        foreach ($validatedData['members'] as $member) {
            // 创建或更新成员记录
            // Member::create($member);
            echo "Processing member: " . $member['email'] . " with role_id: " . $member['role_id'] . "\n";
        }

        return response()->json(['message' => 'Members processed successfully.']);
    }
}

注意事项与进阶

1. 数组名称匹配：请确保验证规则中的 members 键与您实际接收到的数组数据的键名一致。如果您的数据是 data，则规则应为 'data' => ['required', 'array'], 'data.*.email' => ...。

2. role_id 的进阶验证：

   • 存在性验证：如果 role_id 必须是数据库中 roles 表的有效 ID，可以使用 exists 规则： 'members.*.role_id' => ['required', 'integer', 'exists:roles,id']
   • 枚举值验证：如果 role_id 只能是预定义的一些值（例如 1, 2, 3），可以使用 in 规则： 'members.*.role_id' => ['required', 'integer', 'in:1,2,3']

3. 自定义错误消息：为了提供更友好的用户体验，您可以为数组验证定义自定义错误消息。在表单请求中，您可以重写 messages() 方法：

   public function messages(): array
   {
       return [
           'members.required' => '成员列表不能为空。',
           'members.array' => '成员列表格式不正确。',
           'members.*.email.required' => '每个成员的电子邮件地址不能为空。',
           'members.*.email.email' => '每个成员的电子邮件地址格式不正确。',
           'members.*.role_id.required' => '每个成员的角色ID不能为空。',
           'members.*.role_id.integer' => '每个成员的角色ID必须是整数。',
           // 'members.*.role_id.exists' => '角色ID :input 无效。', // 如果使用了 exists 规则
       ];
   }

   登录后复制

   请注意，对于数组中的每个元素，您可以使用 :attribute 占位符来引用当前正在验证的属性名（例如 members.0.email），而 :input 则会显示实际输入的值。

总结

Laravel 强大的验证系统，特别是其对点式表示法（.* 通配符）的支持，使得验证复杂嵌套数组数据变得异常简单和高效。通过将验证逻辑封装在表单请求中，您可以保持代码的整洁和可维护性。结合自定义错误消息和进阶规则，您可以构建出既强大又用户友好的数据验证流程，确保应用程序接收到的数据始终符合预期。

以上就是Laravel 中数组嵌套数据的高效验证指南的详细内容，更多请关注php中文网其它相关文章！