JSON 转 PHP

相关推荐

关于 JSON 转 PHP class 与 PHP 实体类建模

适用场景

• Laravel 后端开发：把 API 接口文档的示例 JSON 快速转为 Eloquent Model / API Resource 类，配合 Laravel 内置 Jsonable / Arrayable 接口直接序列化响应
• Symfony Serializer 集成：把第三方 API 返回的 JSON 转为 ArrayObject 风格 PHP 类，配合 Symfony Serializer 做深度的对象映射与数据校验
• WordPress REST API：把自定义 endpoint 返回的 JSON 结构转为 stdClass 风格 PHP 类，配合 wp_send_json() 直接输出，匹配 wp_json_encode() 默认行为
• PHP 8.1+ readonly DTO：把 JSON 转为 final readonly class 用于数据传输对象（DTO），构造期后不可变，避免业务逻辑误修改响应数据
• Composer 包开发：把 JSON Schema 转成 PHP 类后发布到 Packagist 作为 SDK 模型层，供其它 Composer 项目 require 复用
• 单元测试 fixture：把 JSON fixture 转成 PHP 类后用 json_decode + 反序列化做测试数据驱动，断言结构化字段
• 数据迁移脚本：把 JSON 配置文件转为 PHP 类后用于业务逻辑强类型访问，比数组访问更易 IDE 自动补全与类型检查
• 前端 Mock 对接：后端先把 JSON 模型转 PHP 类，前端同时拿到对应的 TypeScript interface / PHP class，保持两端类型一致
• 代码评审：把 API 返回 JSON 直接转成可读的 PHP 类，便于 Code Review 时讨论字段命名、属性可见性
• 老项目重构：把基于 array 关联数组动态访问的代码重构为基于 PHP class 的强类型访问，配合 PHPStan / Psalm 做静态分析
• PHPUnit 数据提供器：把 JSON 测试数据转为 PHP 类后通过 DataProvider 注入测试用例，IDE 自动提示属性字段
• snake_case 后端 API 接入：后端 API 返回 snake_case 字段，前端 PHP 系统启用「转 camelCase」+ ArrayObject 风格无缝接入
• PHPStan 静态分析：生成的类天然带类型声明，配合 phpstan analyse --level=8 在 CI 中拦截类型错误
• 教学与培训：PHP 教学场景中把示例 JSON 转 PHP 类演示面向对象建模、类型系统、接口实现
• API Gateway 网关层：把上游微服务返回的 JSON 转 PHP 类做网关层聚合，下游 PHP 服务按类属性强类型消费
• 消息队列消费：把 RabbitMQ / Kafka 消费到的 JSON 消息体转 PHP 类后入库或转发，配合 JSON_THROW_ON_ERROR 做严格解析
• 电商 SKU / SPU 建模：把商品 JSON 结构（多规格 / 多图片 / 多属性）转 PHP 类，配套 ArrayObject 风格在 Laravel 中做 N+1 查询优化
• WebHook 回调验签：把支付网关、物流回调的 JSON 验签结构转 PHP 类，配合 hash_hmac() 做签名校验
• OpenAPI 工具链：把 OpenAPI 3.x 的 schema JSON 转 PHP 类，对接 Swagger Codegen / Apifox 的 PHP 客户端生成流程
• 数据 ETL 管道：把上游数据源（MySQL JSON 字段 / MongoDB / Elasticsearch）的 JSON 转 PHP 类后做数据清洗与落库

使用方法

1. 在左侧编辑器粘贴 JSON 对象（推荐）或数组，或点击「Sample」加载中文示例（含嵌套 address / company / tags）
2. 点击工具栏「Settings」按钮，在弹窗中选择：① 设置根类名（如 User）和 namespace（如 App\Models）；② 选择代码风格（ArrayObject / stdClass / readonly class）；③ 选择代码风格（typed properties / Laravel 集成 / Symfony Serializer）；④ 选择字段命名策略（保持原样 / camelCase / 全小写 / UPPER_SNAKE）
3. 工具会在 400ms 内自动转换，右侧显示所有生成的 PHP 类（每个类一个独立卡片，标题栏实时显示当前风格徽章）；如 JSON 格式错误会显示「修复 JSON」按钮
4. 检查生成的类名、属性名和接口是否符合预期；如需调整可修改源 JSON 的 key 名或重新打开 Settings 修改选项
5. 满意后可点击单个类的「复制」按钮粘贴到 IDE，或点击工具栏「Download ZIP」一键下载所有类（按 namespace 路径组织目录结构）

功能特点

• 两种代码风格自由切换：ArrayObject（继承 \ArrayObject，支持 $obj['key'] 数组式访问）/ stdClass（继承 \stdClass，支持 $obj->key 对象式访问），适配 Laravel 序列化、WordPress REST、Symfony Serializer 等不同场景
• 完整 PHP 模板：自动生成 namespace 声明 + use 语句 + class 头注释（Copyright + 生成时间戳）+ class 定义 + typed public 属性（PHP 7.4+），可直接 require 进 Composer 项目，无需手动补样板
• JsonSerializable 接口自动实现：每个类自动生成 public function jsonSerialize(): mixed { return [...] }，配合 json_encode() 直接序列化 JSON，零额外样板代码
• PHP 8.1+ readonly class 可选：开启后生成的 class 加上 final readonly class，所有属性为 readonly，构造期后不可变，适合 API 响应 DTO 不可变场景
• 智能类型推断：string → string、integer → int、float → float、bool → bool、array → array、嵌套对象 → 独立 class、null → ?type（可空属性），无需手动指定字段类型
• 嵌套类自动拆分：嵌套对象按字段名首字母大写生成独立 PHP 类（如 address → Address），数组中的对象按「移除末尾 s」规则命名（如 users → User），所有嵌套类同样实现 JsonSerializable
• 4 种字段命名策略：保持原样 / snake_case 转 camelCase（user_name → userName）/ 全小写 / UPPER_SNAKE 常量风格，匹配 PSR-1 / Laravel / Symfony 不同代码规范
• Laravel 一键集成：勾选后自动 implements Jsonable、Arrayable 接口，添加 toArray() / toJson() 方法，可直接用作 Eloquent API Resource，配合 Composer 自动加载
• 复制单个类 + ZIP 多文件下载：每个 PHP 类独立「复制」按钮，可一键下载按 namespace 组织目录结构的 ZIP 包（如 App/Models/User.php），解压即用
• 本地浏览器运行 + 历史记录：JSON 解析、PHP 类生成、ZIP 打包都在浏览器内通过 JavaScript（quicktype-core + JSZip）完成，数据不上传任何服务器；内置 localStorage 历史记录最近 200 条输入

代码示例

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// 模拟从 API 接收到的 JSON 字符串
$jsonString = '{"id":1,"name":"Alice","email":"alice@example.com","isActive":true}';

// 1) 反序列化为本工具生成的类
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) 强类型访问字段（IDE 自动补全 + PHPStan 静态检查）
echo $user->name;          // Alice
echo $user->email;         // alice@example.com
echo $user->isActive ? '活跃' : '禁用'; // 活跃

// 3) json_encode() 自动调用 jsonSerialize()，无需任何额外代码
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com",
    "isActive": true
}
*/

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * GET /api/users/{id}
     */
    public function show(int $id): JsonResponse
    {
        // 1) 从数据库或外部 API 获取数据
        $userData = $this->fetchUserFromApi($id);

        // 2) 用本工具生成的 User 类包装
        $user = new User(
            $userData['id'],
            $userData['name'],
            $userData['email'],
            $userData['isActive']
        );

        // 3) 直接 return response()->json($user)
        //    Laravel 会自动调用 jsonSerialize()
        return response()->json($user);
    }

    /**
     * POST /api/users
     */
    public function store(Request $request): JsonResponse
    {
        // 4) 反向用法：把请求 JSON 反序列化为 User 类
        $user = User::fromArray($request->all());

        // 5) 用 toArray() 获取数组形式
        $payload = $user->toArray();

        // 6) 执行业务逻辑（如入库 / 调用第三方 API）
        $this->userService->create($payload);

        return response()->json([
            'message' => 'User created',
            'data' => $user,
        ], 201);
    }
}

/*
 * 对应 composer.json 依赖：
 * "require": {
 *     "php": "^8.1",
 *     "laravel/framework": "^11.0"
 * }
 */

<?php

namespace App\Service;

use App\Models\User;
use Symfony\Component\Serializer\SerializerInterface;
use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;

class UserSerializer
{
    private SerializerInterface $serializer;

    public function __construct(SerializerInterface $serializer)
    {
        // 使用 PropertyNormalizer 处理 public 属性
        $this->serializer = $serializer;
    }

    /**
     * 将 User 对象序列化为 JSON 字符串
     */
    public function toJson(User $user): string
    {
        return $this->serializer->serialize($user, 'json');
    }

    /**
     * 将 JSON 字符串反序列化为 User 对象
     */
    public function fromJson(string $json): User
    {
        return $this->serializer->deserialize($json, User::class, 'json');
    }

    /**
     * 批量反序列化（如从 MongoDB 导出的 JSON 数组）
     */
    public function fromJsonArray(string $jsonArray): array
    {
        $users = [];
        $data = json_decode($jsonArray, true);

        foreach ($data as $item) {
            $users[] = User::fromArray($item);
        }

        return $users;
    }
}

// 使用示例
$serializer = new UserSerializer($serializerService);

$json = '{"id":1,"name":"Alice","address":{"city":"Beijing","zip":"100000"},"tags":["php","symfony"]}';

// 反序列化为本工具生成的 User 对象
$user = $serializer->fromJson($json);
echo $user->name;                  // Alice
echo $user->address->city;         // Beijing (强类型访问)
print_r($user->tags);              // ['php', 'symfony']

// 序列化回 JSON
$jsonOutput = $serializer->toJson($user);

最佳实践

常见问题

故障排查

术语表

namespace

PHP 5.3+ 引入的命名空间机制，避免类名冲突。本工具根据用户设置的 namespace 自动生成，并在 ZIP 中按 App/Models/ 目录组织。

class

PHP 中定义对象的模板。本工具生成的即为标准 PHP class，可直接 new User(...) 实例化。

ArrayObject

PHP SPL 标准库中的类，实现 ArrayAccess 等接口。本工具 ArrayObject 风格生成的类即继承自 \ArrayObject，支持数组式与对象式双重访问。

stdClass

PHP 内置的通用对象类，json_decode($json, false) 默认返回此类型。本工具 stdClass 风格生成的类即继承自 \stdClass，仅支持对象式访问。

typed properties

PHP 7.4+ 引入的属性类型声明（如 public int $id）。本工具生成的属性默认带类型声明，IDE 与静态分析工具可直接做类型检查。

readonly class

PHP 8.1+ 引入的只读类，类内所有属性自动为 readonly，构造期后不可修改。本工具 readonly 风格生成 final readonly class，适合 DTO 不可变场景。

JsonSerializable

PHP 5.4+ 引入的接口，实现该接口的对象在被 json_encode() 时会自动调用 jsonSerialize() 方法。本工具所有类都自动实现该接口。

Jsonable (Laravel)

Laravel 框架的契约接口，实现后对象可调用 toJson() 输出 JSON。本工具 Laravel 集成风格会自动 implements 该接口。

Arrayable (Laravel)

Laravel 框架的契约接口，实现后对象可调用 toArray() 输出数组。本工具 Laravel 集成风格会自动 implements 该接口。

Composer

PHP 官方的依赖管理工具。使用本工具生成的代码时，需要在 composer.json 中配置 PSR-4 自动加载（如 App\\: src/）。

PSR-4

PHP-FIG 制定的自动加载规范，按命名空间到目录的映射加载类文件。本工具生成的 ZIP 包按 namespace 路径组织，符合 PSR-4 规范。

Symfony Serializer

Symfony 组件的序列化框架。本工具 ArrayObject 风格生成的类可配合 Symfony Serializer 的 PropertyNormalizer 做深度序列化与反序列化。

Eloquent API Resource

Laravel Eloquent 的 API 资源类，用于格式化 API 响应。本工具 Laravel 集成风格生成的类可直接作为 API Resource 基类使用。

composer.json

Composer 项目的配置文件。本工具生成的代码放入 src 目录后，需要在 composer.json 中配置 autoload 段并执行 composer dump-autoload。

json_encode / json_decode

PHP 内置的 JSON 序列化与反序列化函数。本工具生成的类实现 JsonSerializable 后，json_encode() 会自动调用 jsonSerialize() 方法。

PHPUnit DataProvider

PHPUnit 测试框架的数据提供器机制。本工具生成的 PHP 类可作为 DataProvider 注入测试用例，配合 IDE 自动补全提升测试编写效率。

PHPStan

PHP 静态分析工具，可对代码做类型检查、错误检测。本工具生成的类因带 typed properties，能被 PHPStan 在 --level=8 模式下完整推断属性类型。

Psalm

另一款 PHP 静态分析工具，由 Vimeo 开源。本工具生成的类配合 Psalm 的 PropertyTypeProvider 可做强类型校验。

Doctrine

PHP 生态的 ORM 与 DBAL 工具集。本工具生成的 PHP 类可作为 Doctrine Entity 的骨架，再手动添加 #[ORM\Column] 等注解。

php -l

PHP 命令行语法检查指令。本工具生成的类可先运行 php -l User.php 做语法验证，再 require 进项目。

Composer dump-autoload

Composer 重新生成自动加载索引的命令。本工具生成的类放入 src 目录后，必须执行 composer dump-autoload 才能被 PSR-4 自动加载识别。

JSON_THROW_ON_ERROR

PHP 7.3+ 的 json_decode() 错误处理标志，开启后 JSON 解析失败会抛出 JsonException 异常。本工具 Laravel 示例使用了严格解析。

Hash (PHP)

PHP 内置的哈希函数，常用于 WebHook 验签。本工具生成的 WebHook 回调类配合 hash_hmac() 做签名校验。

JSON 类型到 PHP 类型映射速查表

工具自动推断的 JSON 数据类型与对应的 PHP 类型对照：

PHP 4 种代码风格对比表

工具支持的 4 种 PHP 类代码风格，根据项目需求选择：

Privacy & Security

本 JSON 转 PHP 工具所有 JSON 解析、PHP 类生成、ZIP 打包操作完全在你的浏览器本地通过 JavaScript（quicktype-core + JSZip）完成，输入的 JSON 数据和生成的 PHP 代码都不会被上传到任何服务器，也不会被记录、缓存或存储到云端。包含内部接口字段、未上线业务结构、未公开 API 响应的敏感 JSON 都可以放心使用，关闭页面即清除全部数据。本工具不使用任何 Cookie 进行用户追踪，不收集邮箱或账号信息，不嵌入任何第三方统计脚本，所有计算都在当前设备的浏览器进程中完成。即使处于离线环境（如断网或内网隔离环境），只要页面已经加载过一次资源即可正常使用。

Authoritative References

• PHP.netPHP 官方文档 - 类与对象
• PHP.netPHP 官方文档 - JsonSerializable 接口
• PHP.netPHP 官方文档 - Readonly 修饰符（PHP 8.1+）
• PHP.netPHP 官方文档 - Typed Properties（PHP 7.4+）
• PHP-FIGPSR-4 自动加载规范
• LaravelLaravel 官方文档 - Eloquent: API Resources
• SymfonySymfony Serializer 组件文档
• ComposerComposer 官方文档 - PSR-4 自动加载