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": "a****@***********",
    "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 自動載入