PHP JSON

この章では、PHP 言語を使用して JSON オブジェクトをエンコードおよびデコードする方法を紹介します。

環境設定

php5.2.0 以降のバージョンには JSON 拡張機能が組み込まれています。

JSON 関数

関数説明
json_encode 変数を JSON エンコードする
json_decodeJSON 形式の文字列をデコードして、PHP 変数に変換する
json_last_error最後に発生したエラーを返す

json_encode

PHP の json_encode() は変数を JSON エンコードするために使用します。この関数は実行が成功した場合は JSON データを返し、失敗した場合は FALSE を返します。

構文

string json_encode ( $value [, $options = 0 ] )

パラメータ

  • value: エンコードする値。この関数は UTF-8 エンコードのデータに対してのみ有効です。

  • options: 以下の定数からなるバイナリマスク: JSON_HEX_QUOT, JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS, JSON_NUMERIC_CHECK, JSON_PRETTY_PRINT, JSON_UNESCAPED_SLASHES, JSON_FORCE_OBJECT, JSON_PRESERVE_ZERO_FRACTION, JSON_UNESCAPED_UNICODE, JSON_PARTIAL_OUTPUT_ON_ERROR。

    注意すべき点は JSON_UNESCAPED_UNICODE オプションです。中国語をエンコードしたくない場合は、このオプションを追加できます。

例

以下の例は、PHP 配列を JSON 形式のデータに変換する方法を示しています。

<?php
   $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}

以下の例は、PHP オブジェクトを JSON 形式のデータに変換する方法を示しています。

例

<?php
   class Emp {
       public $name = "";
       public $hobbies  = "";
       public $birthdate = "";
   }
   $e = new Emp();
   $e->name = "sachin";
   $e->hobbies  = "sports";
   $e->birthdate = date('m/d/Y h:i:s a', "8/5/1974 12:20:03 p");
   $e->birthdate = date('m/d/Y h:i:s a', strtotime("8/5/1974 12:20:03"));

   echo json_encode($e);
?>

上記のコードの実行結果は次のとおりです。

{"name":"sachin","hobbies":"sports","birthdate":"08\/05\/1974 12:20:03 pm"}

JSON_UNESCAPED_UNICODE オプションを使用する

<?php
   $arr = array('サンプル' => 'サンプル', 'taobao' => '淘宝网');
   echo json_encode($arr); //中国語をエンコード
   echo PHP_EOL;  //改行文字
   echo json_encode($arr, JSON_UNESCAPED_UNICODE);  //中国語をエンコードしない
?>

上記のコードの実行結果は次のとおりです。

{"サンプル":"\u83dc\u9e1f\u6559\u7a0b","taobao":"\u6dd8\u5b9d\u7f51"}
{"サンプル":"サンプル","taobao":"淘宝网"}

json_decode

PHP の json_decode() 関数は JSON 形式の文字列をデコードし、PHP 変数に変換するために使用します。

構文

mixed json_decode ($json_string [,$assoc = false [, $depth = 512 [, $options = 0 ]]])

パラメータ

  • json_string: デコードする JSON 文字列。UTF-8 エンコードのデータである必要があります。

  • assoc: このパラメータが TRUE の場合は配列が返され、FALSE の場合はオブジェクトが返されます。

  • depth: 再帰の深さを指定する整数型のパラメータ。

  • options: バイナリマスク。現在は JSON_BIGINT_AS_STRING のみサポートされています。

例

以下の例は、JSON データをデコードする方法を示しています。

例

<?php
   $json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';

   var_dump(json_decode($json));
   var_dump(json_decode($json, true));
?>

上記のコードの実行結果は次のとおりです。

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

array(5) {
    ["a"] => int(1)
    ["b"] => int(2)
    ["c"] => int(3)
    ["d"] => int(4)
    ["e"] => int(5)
}
その他の拡張機能