JSON を PHP に

関連おすすめ

JSON to PHPクラスとPHPエンティティクラスモデリングについて

ユースケース

• Laravelバックエンド開発：APIインターフェースドキュメントのサンプルJSONを素早くEloquent Model / API Resourceクラスに変換し、Laravelの組み込みJsonable / Arrayableインターフェースと共にレスポンスを直接シリアライズ
• Symfony Serializer統合：サードパーティAPIが返すJSONをArrayObjectスタイルのPHPクラスに変換し、Symfony Serializerで詳細なオブジェクトマッピングとデータ検証を行う
• WordPress REST API：カスタムエンドポイントが返す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クラスを同時に取得して両端の型を一貫させる
• コードレビュー：APIレスポンスJSONを直接読みやすいPHPクラスに変換し、Code Review時のフィールド命名、プロパティ可視性の議論を容易に
• レガシープロジェクトのリファクタリング：配列連想配列による動的アクセスのコードをPHPクラスベースの強い型付けアクセスにリファクタリングし、PHPStan / Psalmで静的分析を実施
• PHPUnitデータプロバイダー：JSONテストデータをPHPクラスに変換してDataProvider経由でテストケースに注入、IDEがプロパティフィールドを自動提案
• snake_caseバックエンドAPI接続：バックエンドAPIがsnake_caseフィールドを返す場合、フロントエンドPHPシステムで「camelCaseに変換」+ ArrayObjectスタイルを有効にしてシームレスに接続
• PHPStan静的分析：生成されるクラスは当然型宣言を持ち、CIでphpstan analyse --level=8により型エラーを捕捉
• 教育とトレーニング：PHP教育シナリオでサンプルJSONをPHPクラスに変換し、オブジェクト指向モデリング、型システム、インターフェース実装をデモ
• API Gatewayゲートウェイ層：上流マイクロサービスが返すJSONをPHPクラスに変換してゲートウェイ層で集約し、下流のPHPサービスがクラスプロパティで強く型付けされたデータを消費
• メッセージキュー消費：RabbitMQ / Kafkaから消費したJSONメッセージボディをPHPクラスに変換して入库または転送、JSON_THROW_ON_ERRORで厳密な解析を実施
• EコマースSKU/SPUモデリング：商品JSON構造（マルチスペック/マルチ画像/マルチ属性）をPHPクラスに変換し、ArrayObjectスタイルと共にLaravelでN+1クエリ最適化を実施
• WebHookコールバック署名検証：決済ゲートウェイ、物流コールバックのJSON署名検証構造をPHPクラスに変換し、hash_hmac()で署名チェックを実施
• OpenAPIツールチェーン：OpenAPI 3.xのスキーマ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）；③ コード機能を選択（型付きプロパティ / Laravel統合 / Symfony Serializer）；④ フィールド命名戦略を選択（元のまま / camelCase / すべて小文字 / UPPER_SNAKE）
3. ツールは400ms以内に自動変換し、右側にすべての生成されたPHPクラスを表示（各クラスは独立したカード、タイトルバーに現在のスタイルバッジをリアルタイム表示）；JSON形式エラーがある場合は「JSONを修復」ボタンを表示
4. 生成されたクラス名、プロパティ名、インターフェースが期待通りか確認；調整が必要な場合はソースJSONのキー名を変更するかSettingsを再オープンしてオプションを変更
5. 満足したら、個々のクラスの「コピー」ボタンをクリックしてIDEに貼り付けるか、ツールバーの「Download ZIP」をクリックしてすべてのクラスをワンクリックでダウンロード（namespaceパスに従ってディレクトリ構造で整理）

特徴

• 2つのコードスタイルを自由に切り替え：ArrayObject（\ArrayObjectを継承、$obj['key']配列形式アクセスをサポート）/ stdClass（\stdClassを継承、$obj->keyオブジェクト形式アクセスをサポート）、Laravelシリアライゼーション、WordPress REST、Symfony Serializerなど様々なシナリオに対応
• 完全なPHPテンプレート：namespace宣言 + use文 + クラスヘッダーコメント（Copyright + 生成タイムスタンプ）+ クラス定義 + 型付きpublicプロパティ（PHP 7.4+）を自動生成、手動でボイラープレートを補うことなくComposerプロジェクトに直接require可能
• JsonSerializableインターフェースを自動実装：各クラスにpublic function jsonSerialize(): mixed { return [...] }を自動生成、json_encode()で直接JSONシリアライズ可能、追加のボイラープレートコードは不要
• PHP 8.1+ readonly classオプション：有効にすると生成されるクラスにfinal readonly classを追加、すべてのプロパティがreadonlyになり構築後に不変、APIレスポンスDTOの不変シナリオに最適
• スマートな型推論：string → string、integer → int、float → float、bool → bool、array → array、ネストされたオブジェクト → 独立したクラス、null → ?type（null許容プロパティ）、フィールド型を手動で指定する必要なし
• ネストされたクラスを自動分割：ネストされたオブジェクトはフィールド名の先頭を大文字にして独立したPHPクラスを生成（例：address → Address）、配列内のオブジェクトは「末尾のsを削除」ルールで命名（例：users → User）、すべてのネストされたクラスもJsonSerializableを実装
• 4つのフィールド命名戦略：元のまま / snake_caseからcamelCase（user_name → userName）/ すべて小文字 / UPPER_SNAKE定数スタイル、PSR-1 / Laravel / Symfonyのコード規約に対応
• Laravelワンクリック統合：チェックするとJsonable、Arrayableインターフェースを自動実装し、toArray() / toJson()メソッドを追加、Composerオートロードと共にEloquent API Resourceとして直接使用可能
• 単一クラスのコピー + ZIP複数ファイルダウンロード：各PHPクラスに独立した「コピー」ボタン、namespaceディレクトリ構造で整理されたZIPパッケージをワンクリックでダウンロード（例：App/Models/User.php）、解凍してすぐ使用可能
• ブラウザローカル実行 + 履歴：JSON解析、PHPクラス生成、ZIPパッケージングはすべてJavaScript（quicktype-core + JSZip）でブラウザ内で完了、データはサーバーにアップロードされません；最近の200件の入力をlocalStorageに履歴保存

コード例

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// 模拟从 API 接收到的 JSON 字符串
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","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;         // a****@***********
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);

Best Practices

よくある質問

トラブルシューティング

用語集

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統合スタイルはこのインターフェースを自動実装します。

Arrayable (Laravel)

Laravelフレームワークのコントラクトインターフェース。実装するとオブジェクトはtoArray()を呼び出して配列を出力できます。このツールのLaravel統合スタイルはこのインターフェースを自動実装します。

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の静的分析ツールで、コードの型チェック、エラー検出を行います。このツールが生成するクラスは型付きプロパティを持つため、PHPStanの--level=8モードでプロパティ型を完全に推論できます。

Psalm

Vimeoによってオープンソース化された別のPHP静的分析ツール。このツールが生成するクラスはPsalmのPropertyTypeProviderで強い型検証を実行できます。

Doctrine

PHPエコシステムのORMとDBALツールセット。このツールが生成するPHPクラスはDoctrine Entityのスケルトンとして使用でき、その後手動で#[ORM\Column]などのアノテーションを追加します。

php -l

PHPコマンドラインの構文チェック命令。このツールが生成するクラスは、プロジェクトにrequireする前にphp -l User.phpで構文検証を実行できます。

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 to 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公式ドキュメント - 型付きプロパティ（PHP 7.4+）
• PHP-FIGPSR-4オートロード規格
• LaravelLaravel公式ドキュメント - Eloquent: API Resources
• SymfonySymfony Serializerコンポーネントドキュメント
• ComposerComposer公式ドキュメント - PSR-4オートロード