在 PHP 中使用 JSON

本教程將會教我們如何使用 PHP 編程語言編碼和解碼 JSON 對象。讓我們先來準備環境以便針對 JSON 進行 PHP 編程。

環境

從 PHP 5.2.0 開始默認捆綁了 JSON 擴展并被編譯到 PHP 中。

JSON 函數

使用 PHP 編碼 JSON（json_encode）

PHP 的 json_encode() 函數用于在 PHP 中編碼 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 組成的位掩碼。

示例：

下面的例子展示了如何使用 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', strtotime("8/5/1974 12:20:03"));

    echo json_encode($e);
?>

執行時會生成如下所示結果：

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

使用 PHP 解碼 JSON（json_decode）

PHP 的 json-decode() 函數用于在 PHP 中解碼 JSON。這個函數返回從 JSON 解碼到適當 PHP 類型的值。

語法：

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

參數：

• __json_string:__ 編碼的字符串，必須是 UTF-8 編碼的數據。
• assoc: 它是一個布爾類型的參數，當設置為 TRUE 時，返回的對象將會被轉換為關聯數組。
• depth: 它是一個整型參數，用于指定遞歸深度。
• options: 它是一個 JSON 解碼的整型位掩碼。支持 JSON_BIGINT_AS_STRING。

示例：

下面例子展示了如何使用 PHP 解碼 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)
}