【PHP8.x】json_decode関数の使い方

Copy
1<?php
2
3/**
4 * json_decode のサンプルコード
5 */
6
7// JSON 文字列
8$json_string = '{"name": "太郎", "age": 30, "city": null}';
9
10// json_decode を使用して PHP の連想配列に変換
11$associative_array = json_decode($json_string, true);
12
13// 結果の確認
14if ($associative_array === null && json_last_error() !== JSON_ERROR_NONE) {
15    // JSON デコードエラーが発生した場合
16    echo 'JSON デコードエラー: ' . json_last_error_msg() . PHP_EOL;
17} else {
18    // デコード成功
19    echo "名前: " . $associative_array['name'] . PHP_EOL;
20    echo "年齢: " . $associative_array['age'] . PHP_EOL;
21    echo "都市: " . ($associative_array['city'] ?? 'N/A') . PHP_EOL; // null 合体演算子を使用
22}
23
24// オブジェクトとしてデコードする場合 (第2引数を省略または false にする)
25$object = json_decode($json_string);
26
27// オブジェクトの場合のプロパティへのアクセス
28if ($object !== null && json_last_error() === JSON_ERROR_NONE) {
29    echo "名前 (オブジェクト): " . $object->name . PHP_EOL;
30    echo "年齢 (オブジェクト): " . $object->age . PHP_EOL;
31    echo "都市 (オブジェクト): " . ($object->city ?? 'N/A') . PHP_EOL;
32}

PHPのjson_decode関数は、JSON形式の文字列をPHPの変数（連想配列またはオブジェクト）に変換するために使用します。

サンプルコードでは、まずJSON形式の文字列 $json_string を定義しています。json_decode($json_string, true) は、この文字列を連想配列に変換します。第2引数に true を指定することで、連想配列として結果を取得できます。省略した場合や false を指定した場合は、オブジェクトとしてデコードされます。

デコード後の $associative_array の要素には、キーを指定してアクセスできます。存在しないキーにアクセスした場合にエラーとならないよう、null合体演算子 ?? を使用して、null の場合に 'N/A' を表示するようにしています。

また、JSONデコードが失敗した場合（例えば、JSON文字列の形式が正しくない場合）は、json_decode は null を返します。json_last_error() 関数で最後に発生したJSONエラーの種類を確認し、エラーメッセージを表示することで、問題の原因を特定できます。

オブジェクトとしてデコードする場合は、プロパティに -> 演算子を使ってアクセスします。

Copy
1<?php
2
3// JSON文字列を配列に変換するサンプル
4$json_string = '{"name": "John Doe", "age": 30, "city": "New York"}';
5
6// json_decode関数を使ってJSON文字列を配列に変換
7$array_data = json_decode($json_string, true);
8
9// 結果を出力
10if ($array_data !== null) {
11    echo "Name: " . $array_data['name'] . PHP_EOL;
12    echo "Age: " . $array_data['age'] . PHP_EOL;
13    echo "City: " . $array_data['city'] . PHP_EOL;
14} else {
15    echo "JSONデコードに失敗しました。" . PHP_EOL;
16}
17
18// JSON文字列をオブジェクトに変換するサンプル（$associativeを省略した場合）
19$json_string = '{"name": "Jane Doe", "age": 25, "city": "Los Angeles"}';
20
21// json_decode関数を使ってJSON文字列をオブジェクトに変換
22$object_data = json_decode($json_string);
23
24// 結果を出力
25if ($object_data !== null) {
26    echo "Name: " . $object_data->name . PHP_EOL;
27    echo "Age: " . $object_data->age . PHP_EOL;
28    echo "City: " . $object_data->city . PHP_EOL;
29} else {
30    echo "JSONデコードに失敗しました。" . PHP_EOL;
31}

PHPのjson_decode関数は、JSON形式の文字列をPHPの変数（配列またはオブジェクト）に変換するために使用します。この関数は、システムエンジニアを目指す方がAPI連携やデータ処理を行う上で非常に重要な役割を果たします。

第一引数 $json には、デコードしたいJSON形式の文字列を渡します。第二引数 $associative はオプションで、true を指定すると連想配列として、false または省略した場合はオブジェクトとして結果を返します。サンプルコードでは、true を指定して配列に変換する例と、省略してオブジェクトに変換する例を示しています。

第三引数 $depth は、デコードするJSONの深さの最大値を指定します。デフォルト値は512です。第四引数 $flags は、JSONデコード時のオプションを指定します。

この関数は、成功した場合はデコードされたPHPの変数（配列またはオブジェクト）を、失敗した場合は null を返します。サンプルコードでは、戻り値が null でないかを確認することで、デコードが成功したかどうかをチェックしています。

配列としてデコードされた場合、$array_data['name'] のようにキーを指定して値にアクセスできます。オブジェクトとしてデコードされた場合は、$object_data->name のようにプロパティを指定して値にアクセスします。JSONの構造に合わせて適切な方法でデータにアクセスしてください。