phpの配列とjsonフォーマットの振り回し

PHP言語でJSONを使う
作者:チェン一峰
日付:2011年1月14日
現在、JSONは最も流行しているデータ交換フォーマットの一つとなっており、各サイトのAPIはほとんどサポートされている.
私は「データ型とJSONフォーマット」を書いて、その設計思想を検討したことがある.今日は、インターネットアプリケーションの開発(特にAPIの作成)に必要な知識であるPHP言語のサポートをまとめたいと思います.
5.2バージョンから、PHPはjsonをオリジナルで提供しています.encode()とjson_decode()関数で、前者は符号化に用いられ、後者は復号に用いられる.
一、json_encode()
この関数は主に配列とオブジェクトをjsonフォーマットに変換するために使用されます.まず、配列変換の例を見てみましょう.

　　$arr = array ('a'=>1,'b'=>2,'c'=>3,'d'=>4,'e'=>5);　　
　　echo json_encode($arr);　　

結果は

　　{"a":1,"b":2,"c":3,"d":4,"e":5}　　

オブジェクト変換の例を見てみましょう.

　　$obj->body           = 'another post';　　
　　$obj->id             = 21;　　
　　$obj->approved       = true;　　
　　$obj->favorite_count = 1;　　
　　$obj->status         = NULL;　　
　　echo json_encode($obj);　　

結果は

　　{　　　　"body":"another post",　　
　　　　"id":21,　　
　　　　"approved":true,　　
　　　　"favorite_count":1,　　
　　　　"status":null　　} 　　

jsonはutf-8符号化文字のみを受け入れるためjson_Encode()のパラメータはutf-8符号化でなければなりません.そうしないと、空の文字またはnullが得られます.中国語でGB 2312コードを使用する場合、または外国語でISO-8859-1コードを使用する場合、この点に特に注意してください.
二、インデックス配列と関連配列
PHPは、「値」(value)のみを保存するインデックス配列(indexed array)と、「名前値ペア」(name/value)を保存する関連配列(associative array)の2つの配列をサポートします.
Javascriptは関連配列をサポートしていないためjson_Encode()はインデックス配列(indexed array)のみを配列フォーマットに変換し、関連配列(associative array)をオブジェクトフォーマットに変換します.
たとえば、インデックス配列が

　　$arr = Array('one', 'two', 'three');　　
　　echo json_encode($arr);　　

結果:

　　["one","two","three"] 　　

関連配列に変更すると、次のようになります.

　　$arr = Array('1'=>'one', '2'=>'two', '3'=>'three');
 　　
　　echo json_encode($arr);　　　　

結果は変わりました

　　{"1":"one","2":"two","3":"three"} 　　

なお、データフォーマットは[](配列)から「{}」(オブジェクト)に変わります.
インデックス配列を強制的にオブジェクトに変換する必要がある場合は、

　　json_encode( (object)$arr );　　

または

　　json_encode ( $arr, JSON_FORCE_OBJECT );　　

三、クラスの変換
次はPHPのクラスです.

　　class Foo {　　
　　　　const     ERROR_CODE = '404';　　
　　　　public    $public_ex = 'this is public';　　
　　　　private   $private_ex = 'this is private!';　　
　　　　protected $protected_ex = 'this should be protected'; 
 　　
　　　　public function getErrorCode() {　　
　　　　　　return self::ERROR_CODE;　　
　　　　}　　
　　}　　

次に、このクラスのインスタンスをjson変換します.

　　$foo = new Foo;　　
　　$foo_json = json_encode($foo);　　
　　echo $foo_json;　　

出力結果は

　　{"public_ex":"this is public"} 　　

公開変数(public)を除いて、他のもの(定数、プライベート変数、方法など)が失われていることがわかります.
四、json_decode()
この関数は、jsonテキストを対応するPHPデータ構造に変換するために使用されます.次に例を示します.

　　$json = '{"foo": 12345}';
 　　
　　$obj = json_decode($json);　　
　　print $obj->{'foo'}; // 12345　　

通常、json_decode()は、配列ではなくPHPオブジェクトを常に返します.例:

　　$json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';
 　　
　　var_dump(json_decode($json));　　

その結果、PHPオブジェクトが生成されます.

　　object(stdClass)#1 (5) {　　
　　　　["a"] => int(1)　　　　["b"] => int(2)　　　　["c"] => int(3)　　　　["d"] => int(4)　　　　["e"] => int(5)　　
　　}　　

PHP関連配列を強制的に生成する場合、json_decode()にはパラメータtrueを追加する必要があります.

　　$json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';
 　　
　　var_dump(json_decode($json,true));　　

結果として、関連配列が生成されます.

　　array(5) {　　
　　 　　["a"] => int(1)　　 　　["b"] => int(2)　　 　　["c"] => int(3)　　 　　["d"] => int(4)　　 　　["e"] => int(5)　　
　　}　　

五、json_decode()の一般的なエラー
次の3つのjsonの書き方はすべて間違っていますが、間違いがどこにあるか見てもらえますか?

　　$bad_json = "{ 'bar': 'baz' }";　　
　　$bad_json = '{ bar: "baz" }';　　
　　$bad_json = '{ "bar": "baz", }';　　

この3つの文字列に対してjson_を実行します.decode()はnullを返し、エラーを報告します.
1つ目のエラーは、jsonの区切り記号(delimiter)は二重引用符のみを使用でき、単一引用符は使用できません.2つ目のエラーは、json名の値ペアの「名」(コロンの左側の部分)であり、いずれの場合も二重引用符を使用する必要があります.3つ目のエラーは、最後の値の後にカンマ(trailing comma)を追加できないことです.また、jsonは、文字列または数値にjson_を使用する場合、オブジェクト(object)および配列(array)を表すためにのみ使用できます.decode()はnullを返します.

　　var_dump(json_decode("Hello World")); //null　　

六、参考材料
　　[1] PHP Manual
　　[2] Ed Finkler, JSON is Everybody's Friend
(完)