PHPでネストされたJSONオブジェクトを作成する方法

PHPでは、ネストされた連想配列を作成し、json_encode()関数に渡すことで、階層構造を持つJSONオブジェクトを簡単に生成できます。以下のコード例をご覧ください。

$json = json_encode(array(
    "client" => array(
        "build" => "1.0",
        "name" => "xxxx",
        "version" => "1.0"
    ),
    "protocolVersion" => 4,
    "data" => array(
        "distributorId" => "xxxx",
        "distributorPin" => "xxxx",
        "locale" => "en-US"
    )
));

コードの解説

このコードでは、「client」「protocolVersion」「data」という3つのキーを持つ連想配列を定義しています。「client」と「data」の値はさらに連想配列（ネストされた配列）になっており、これがJSONの階層構造にそのまま対応します。

json_encode()関数は、このPHPの配列をJSON形式の文字列に変換します。実行結果は以下のようになります。

{
    "client": {
        "build": "1.0",
        "name": "xxxx",
        "version": "1.0"
    },
    "protocolVersion": 4,
    "data": {
        "distributorId": "xxxx",
        "distributorPin": "xxxx",
        "locale": "en-US"
    }
}

見やすい出力にするには

第2引数にJSON_PRETTY_PRINTオプションを指定すると、インデント付きの整形されたJSON文字列を取得できます。デバッグやログ出力の際に便利です。

$json = json_encode($array, JSON_PRETTY_PRINT);

日本語を扱う場合の注意点

json_encode()はデフォルトでマルチバイト文字をUnicodeエスケープ（\uXXXX形式）に変換します。日本語をそのまま出力したい場合は、JSON_UNESCAPED_UNICODEオプションを併用してください。

$json = json_encode($array, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

このように、PHPの配列構造をそのままJSONの階層にマッピングできるため、複雑なデータ構造でも直感的にJSONを生成できます。