JSON Swiss 標誌

JSON Swiss

PHP → JSON Schema 產生器

PHP 程式碼 輸入

正在載入編輯器…

JSON Schema（輸出） 輸出

設定

選擇產生 Schema 時的 root class。

解析完全在瀏覽器內完成，你的程式碼不會離開此頁面。

貼上 PHP classes，立即產生 JSON Schema。

支援型別註記、陣列與巢狀物件。

如何將 PHP class 轉為 JSON Schema（步驟指南）

這個線上轉換器（PHP class → JSON Schema）可從真實模型（DTO、struct、class）產生 JSON Schema，方便驗證 payload、分享契約，並生成 mock JSON。

  1. 步驟 1：貼上 PHP 程式碼

    • 將要文件化的模型貼到左側編輯器。
    • 把被引用的型別也放在同一段程式碼中，便於產生 definitions。
    • 點擊 範例 載入範例，了解預期輸入格式。

  2. 步驟 2：選擇 根 class（如需要）

    • 若偵測到多個 definitions，選擇與你的 API payload 相符的 root 型別。
    • 輸出 Schema 會以選中的 root 為中心，並包含引用型別的額外 definitions。

  3. 步驟 3：檢視 JSON Schema 輸出

    • 重點檢查型別、必填/可選欄位，以及巢狀物件/陣列結構。
    • 當模型引用其他模型時，注意 definitions 以及 $ref 是否正確。
    • 複製或下載 Schema，用於驗證、文件或 schema-first 開發。

  4. 步驟 4：驗證或產生 mock JSON

    • 點擊 產生 Mock 資料 即可開啟已預載 Schema 的 Mock 產生器。
    • 用真實 payload 驗證 Schema，及早發現破壞性變更。
    • 若你依賴更進階的 schema 組合（例如 anyOf/oneOf/allOf），建議用 Ajv 等完整 validator 再驗證一次。

Schema keywords 支援說明

產生的 Schema 可能包含 $ref ，也可依需求補上 anyOf, oneOf, 或 allOf。當 Schema 更複雜時，建議使用完整的 JSON Schema validator；若要產生 mock，必要時可先 dereference 再生成。

相關工具

搭配這些工具一起使用：驗證 Schema、產生 mock payload、格式化 JSON 範例，並保持程式碼與契約一致。

JSON Schema Mock 產生器

由 Schema 產生範例 JSON，用於測試、fixtures 與文件。

JSON Schema 驗證器

使用常見 Schema keywords 驗證 JSON，快速定位不匹配。

JSON 轉 PHP 類別

由 JSON 範例產生 PHP 型別與模型。

JSON → JSON Schema 產生器

由代表性的 JSON 範例產生 Schema，補齊 model-first 的情境。

JSON Schema 資料庫

瀏覽物件、陣列、enum 與 constraints 的 Schema 範例與模式。

JSON 格式化

在驗證 Schema 或分享文件前，先清理並規範化 JSON 範例。

常見問題

支援哪些 PHP 程式碼？

支援具型別註記的 class properties、陣列與巢狀物件。可貼上多個相關 classes 以產生 definitions。

PHP 型別如何映射到 JSON Schema？

string/int/float/bool 等型別會映射到 JSON Schema 型別；陣列會成為 array/items；巢狀物件則成為 object/properties。

可以選擇 root class 嗎？

可以。若偵測到多個 definitions，可在設定中選擇哪個 class 作為 root。

如何由 Schema 產生 mock JSON？

產生 Schema 後，點擊「產生 Mock 資料」即可開啟已預載 Schema 的 Mock 產生器。

PHP → JSON Schema 產生器 | JSONSwiss