導入
PHPで外部APIから取得したJSONデータを処理する際、json_decode関数をデフォルト設定で使用すると、データはstdClassオブジェクトとして返されます。特に連想配列と数値添字配列が混在するJSONを扱う際、数値キーへのアクセスで「Syntax error」や意図しない挙動に遭遇したことはありませんか？本記事では、stdClassオブジェクトの特有の挙動を理解し、現場で最も安全かつ効率的にデータを扱うためのプラクティスを解説します。
基礎知識
PHPのjson_decode関数は、第2引数を省略するとJSONオブジェクトをstdClassのインスタンスとして変換します。ここで問題となるのが、数値のみのキーを持つデータへのアクセスです。
PHPのオブジェクトプロパティは、通常の変数名と同様に数字から始まる名称を直接記述できません（例: $obj->0 は構文エラー）。しかし、PHPの仕様として中括弧構文 { } を使用することで、動的にプロパティ名にアクセスすることが可能です。
実装/解決策
stdClassのプロパティ名が数字の場合、以下の2つのアプローチが考えられます。
1. 連想配列として扱う（推奨）: json_decodeの第2引数に true を指定することで、全てを配列として返却させます。これにより、数値キーであっても通常の配列アクセス（$data[0]）が可能になります。
2. 中括弧構文を使用する（限定的）: どうしてもオブジェクトのまま扱いたい場合、$obj->{‘0’} のように中括弧で囲むことでアクセス可能です。ただし、これはコードの可読性を下げ、バグの温床になりやすいため注意が必要です。
サンプルプログラム
/
$json = ‘{“sample”: {“color”: “red”}, “0”: {“color”: “green”}}’;
// 方法1: 連想配列としてデコード（実務での推奨）
$dataArray = json_decode($json, true);
echo “配列アクセス: ” . $dataArray[0][‘color’] . “\n”; // 結果: green
// 方法2: stdClassのまま中括弧構文でアクセス
$dataObj = json_decode($json);
// 数値キーへのアクセスには中括弧が必須
echo “オブジェクトアクセス: ” . $dataObj->{‘0’}->color . “\n”; // 結果: green
// JSON_FORCE_OBJECT を使ったエンコード時の注意点
$array = [‘a’, ‘b’, ‘c’];
$jsonForced = json_encode($array, JSON_FORCE_OBJECT);
$decoded = json_decode($jsonForced);
echo “強制オブジェクト化: ” . $decoded->{‘0’}; // 結果: a
?>
応用・注意点
現場での開発において陥りやすいポイントが「キーの型」です。
json_encodeする際、配列のキーが数字のみであれば、デコード後も数値として扱われますが、途中で文字列キーが混ざると、JSON変換の過程で数値キーも文字列として扱われる場合があります。
注意点:
- 型安全性: APIのレスポンス構造が不確定な場合は、json_decode後に必ずプロパティの存在チェック（property_exists）や、is_arrayによる型判定を行ってください。
- JSON_FORCE_OBJECT: 配列を常にオブジェクトに変換したい場合には便利ですが、数値キーがすべて文字列キー化されるため、後続の処理で配列としてループを回す際に意図しないエラーが発生することがあります。
結論として、特別な理由がない限りは json_decode($json, true) を使用して配列で処理し、データの型を統一することを強く推奨します。