基于 Laravel 的嵌套 JSON 参数验证教程-php教程-PHP中文网

基于 Laravel 的嵌套 JSON 参数验证教程

花韻仙語

发布： 2025-07-29 17:26:01

原创

317人浏览过

基于 laravel 的嵌套 json 参数验证教程

本文旨在介绍如何在 Laravel 中验证嵌套的 JSON 对象，并向自定义验证器传递参数。通过动态构建验证规则，可以灵活地处理不同结构的 JSON 数据，确保数据的有效性和完整性。本文将提供详细的代码示例，帮助开发者理解并应用此方法。

在 Laravel 应用中，验证用户输入的数据至关重要，尤其是在处理包含嵌套结构的 JSON 数据时。如果自定义验证规则需要依赖同级字段的值，直接在 rules() 方法中定义静态规则可能无法满足需求。本文将介绍如何动态地为嵌套 JSON 对象构建验证规则，并将当前数组索引下的对象传递给自定义验证器。

动态构建验证规则

核心思路是：不再直接在 rules() 方法中定义所有规则，而是先定义一些基础规则，然后根据 seats 数组的长度动态地添加规则。

定义基础规则：

首先，在 rules() 方法中定义一些基本的验证规则，例如 company 和 seats 字段的验证。

<?php

namespace App\Http\Requests\App;

use App\Rules\SeatIsAvailable;
use Illuminate\Foundation\Http\FormRequest;

class CheckoutRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     *
     * @return bool
     */
    public function authorize()
    {
        return true;
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array
     */
    public function rules()
    {
        $rules = [
            'company' => 'required',
            'seats' => 'required|array',
        ];

        return array_merge($rules, $this->seatsRules());
    }

    // ...
}

登录后复制

创建动态规则生成方法：

创建一个名为 seatsRules() 的私有方法，该方法负责动态生成 seats 数组中每个元素的验证规则。

<?php

namespace App\Http\Requests\App;

use App\Rules\SeatIsAvailable;
use Illuminate\Foundation\Http\FormRequest;

class CheckoutRequest extends FormRequest
{
    /**
     * Determine if the user is authorized to make this request.
     *
     * @return bool
     */
    public function authorize()
    {
        return true;
    }

    /**
     * Get the validation rules that apply to the request.
     *
     * @return array
     */
    public function rules()
    {
        $rules = [
            'company' => 'required',
            'seats' => 'required|array',
        ];

        return array_merge($rules, $this->seatsRules());
    }

    private function seatsRules(): array
    {
        $rules = [];

        foreach ((array) $this->request->get('seats') as $key => $seat) {
            $rules["seats.$key.seat_no"] = ['required', new SeatIsAvailable($seat)];
            $rules["seats.$key.schedule_id"] = 'required|numeric';
            $rules["seats.$key.date"] = 'required|date';
        }

        return $rules;
    }
}

登录后复制

循环遍历 seats 数组：

在 seatsRules() 方法中，使用 foreach 循环遍历 seats 数组。对于每个 seat 对象，使用数组索引 $key 来构建动态的规则名称，例如 seats.0.seat_no、seats.1.seat_no 等。

传递参数给自定义验证器：

在构建规则时，将当前的 $seat 对象作为参数传递给自定义验证器 SeatIsAvailable 的构造函数。这样，验证器内部就可以访问 $seat 对象的所有属性，例如 schedule_id 和 date。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

合并规则：

使用 array_merge() 函数将基础规则和动态生成的规则合并，并返回最终的规则数组。

自定义验证器 (SeatIsAvailable)

确保你的自定义验证器能够接收并使用传递的参数。

<?php

namespace App\Rules;

use Illuminate\Contracts\Validation\Rule;

class SeatIsAvailable implements Rule
{
    protected $seat;

    public function __construct($seat)
    {
        $this->seat = $seat;
    }

    public function passes($attribute, $value)
    {
        // 在这里可以使用 $this->seat 访问传递的 seat 对象
        $scheduleId = $this->seat['schedule_id'];
        $date = $this->seat['date'];

        // 执行你的验证逻辑，例如检查座位是否可用
        // ...

        return true; // 或者 false，取决于验证结果
    }

    public function message()
    {
        return 'The seat is not available.';
    }
}

登录后复制

注意事项