JSONからPHP配列へ

例

入力：

{ "app": { "name": "Hyperion", "debug": true, "hosts": ["h1.example.com", "h2.example.com"] } }

出力（短い構文、シングルクォート）：

[
    'app' => [
        'name' => 'Hyperion',
        'debug' => true,
        'hosts' => [
            'h1.example.com',
            'h2.example.com',
        ],
    ],
]

型の対応

連想配列とインデックス配列の使い分け

PHPには両方の振る舞いを持つ単一の配列型があります。一方、JSONはオブジェクトと配列を明確に区別するため、対応は次のとおりです。

• {} → 連想配列（['key' => value]）。
• [] → インデックス配列（[value, value]）。

ジェネレーターは常にこの区別を保持します。PHPでは両者を混在させることも可能ですが、混乱を招きます。

PHP特有の落とし穴

• 数値文字列のキー。 PHPは配列内の"42"を整数キー42に変換します。JSONで数値文字列をキーとして使い、それを文字列のまま保持したい場合、array_combineによるラウンドトリップでは保持されません。
• 大きな整数。 JSONは32ビット環境のPHP_INT_MAXを超える整数を保持できます。その可能性がある場合、ジェネレーターは警告します。
• UTF-8。 PHPの文字列はバイト列であり、ジェネレーターはUTF-8をそのまま出力します。.phpファイルはBOMなしのUTF-8で保存してください。

使用例

• 設定ファイル：LaravelもSymfonyもPHP配列による設定を使います。ベンダー配布のJSON設定をそのまま取り込むのに適しています。
• テストフィクスチャ：PHPUnitのフィクスチャは、実行時に読み込むJSONファイルよりも配列のほうが扱いやすくなります。
• シーダー：Laravelのデータベースシーダーは、JSONダンプから始めてPHP配列に変換することがよくあります。

よくある間違い

• PHP配列をJSONに戻す。 json_encodeは連想配列をオブジェクトとして、インデックス配列を配列として扱います。両者を混在させる（['key' => 'val', 0 => 'x']）と、出力はオブジェクトになります。JSON形式の配列はJSON形式のまま保ちましょう。
• アポストロフィを含むダブルクォート。 シングルクォートのPHP文字列は\'をエスケープする必要があり、ダブルクォートの文字列は\\"をエスケープする必要があるうえ、注意しないと変数が意図せず展開されます。データにはシングルクォートを使いましょう。
• 末尾のカンマの付け忘れ。 PHPはPHP 7.3以降で末尾のカンマを許可しており、差分がきれいになります。ジェネレーターはデフォルトで付加します。