如何在 PHP 中基于 JSON Schema 动态验证表单数据-php教程-PHP中文网

如何在 PHP 中基于 JSON Schema 动态验证表单数据

本文介绍如何使用 php 对用户提交的 json 数据进行结构化校验，确保其字段名、类型与预定义的表单 schema 严格一致，防止非法键名或格式错误的数据写入数据库 json 字段。

本文介绍如何使用 php 对用户提交的 json 数据进行结构化校验，确保其字段名、类型与预定义的表单 schema 严格一致，防止非法键名或格式错误的数据写入数据库 json 字段。

在构建动态表单系统时，常需将用户输入以 JSON 格式（如 details 字段）持久化到数据库中。但若缺乏校验机制，用户可能提交任意键名（如 "age" 或 "email"），破坏 Schema 约束，导致后续解析异常或业务逻辑失效。因此，必须在服务端对提交数据执行键名合法性 + 类型一致性双重校验。

✅ 核心校验逻辑：键名匹配与结构合规

假设你已定义好表单 Schema（PHP 数组或 StdClass 对象数组）：

$formDefinition = [
    (object)['key' => 'name',        'datatype' => 'string'],
    (object)['key' => 'sex',         'datatype' => 'choice'],
    (object)['key' => 'occupation',  'datatype' => 'string'],
    (object)['key' => 'isRetired',   'datatype' => 'boolean']
];

而用户提交的 details 是一个 JSON 数组，每个元素为单字段对象（如 [{"name":"Alice"},{"sex":"female"}]）。校验目标是：所有提交对象的键必须全部存在于 $formDefinition 中，且不得遗漏或多余。

以下是一个健壮、可扩展的校验方法：

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

public function validateFormData(array $details, array $formDefinition): bool
{
    // 提取所有合法字段名，构建白名单集合
    $allowedKeys = array_column($formDefinition, 'key');

    foreach ($details as $item) {
        // 跳过非对象或空数组
        if (!is_object($item) && !is_array($item)) {
            throw new InvalidArgumentException('Each detail item must be an object or associative array.');
        }

        $keys = array_keys((array)$item);
        if (count($keys) !== 1) {
            throw new InvalidArgumentException('Each detail item must contain exactly one key-value pair.');
        }

        $submittedKey = $keys[0];
        if (!in_array($submittedKey, $allowedKeys, true)) {
            throw new InvalidArgumentException("Invalid key '{$submittedKey}' — not defined in form schema.");
        }
    }

    return true;
}

? 进阶建议：补充类型校验与完整性检查

仅校验键名还不够。实际场景中，你还应：

验证值类型是否匹配 datatype（如 "isRetired": "yes" 应拒绝，因期望布尔值）；
检查必填字段是否缺失（可扩展 formDefinition 加入 "required": true 字段）；
统一处理输入格式：将 details 解析为关联数组前，务必调用 json_decode($input, true) 并检查 json_last_error()。

示例类型校验片段：

$expectedType = $this->getDataTypeForKey($submittedKey, $formDefinition); // 自定义辅助方法
$value = $item[$submittedKey];

switch ($expectedType) {
    case 'boolean':
        if (!is_bool($value) && $value !== 'true' && $value !== 'false' && $value !== 1 && $value !== 0) {
            throw new InvalidArgumentException("Field '{$submittedKey}' must be boolean.");
        }
        break;
    case 'choice':
        $choices = ['male', 'female', 'other']; // 可从 DB 或配置读取
        if (!in_array($value, $choices, true)) {
            throw new InvalidArgumentException("Invalid choice for '{$submittedKey}'.");
        }
        break;
}

⚠️ 注意事项与最佳实践

避免直接遍历嵌套循环比对：原始代码中双重 foreach 效率低且逻辑易错；改用 array_column() + in_array() 或 array_flip() 构建哈希映射更高效。
始终验证 JSON 输入完整性：前端不可信，json_decode() 后必须检查 null（可能是解析失败或空字符串）。
数据库层面加固：MySQL 8.0+ 支持 JSON_VALID() 和 JSON_CONTAINS_PATH()，可在 INSERT/UPDATE 时添加 CHECK CONSTRAINT。
返回结构化错误：生产环境应抛出 ValidationException 并附带具体字段与原因，便于前端精准提示。

通过以上方案，你不仅能拦截非法键名，还能构建可维护、可扩展的动态表单验证体系，保障 JSON 字段数据的语义正确性与业务一致性。