PHP JSON 解析

Created: October-16, 2018

在本教程中，你將學習如何在 PHP 中編碼和解碼 JSON 資料。

什麼是 JSON

JSON 代表 JAVA SCRIPT Object Notation。JSON 是一種標準的輕量級資料交換格式，可以快速輕鬆地解析和生成。

與 XML 一樣，JSON 是一種基於文字的格式，易於編寫且易於理解，但與 XML 不同，JSON 資料結構佔用的頻寬少於 XML 版本。JSON 基於兩個基本結構：

物件： 這被定義為鍵/值對的集合（即 key:value）。每個物件以左大括號 { 開頭，以右大括號 } 結束。多個鍵/值對由逗號 , 分隔。
陣列： 這被定義為有序的值列表。陣列以左括號 [ 開頭，以右括號 ] 結束。值以逗號 , 分隔。

在 JSON，鍵總是字串 string，而值可以是 number ， true， false 或者 null，甚至是 object 或者 array 。字串必須用雙引號 " 括起來，並且可以包含轉義字元，如 \n， \t 和 \。JSON 物件可能如下所示：

{
    "book": {
        "name": "Harry Potter and the Goblet of Fire",
        "author": "J. K. Rowling",
        "year": 2000,
        "genre": "Fantasy Fiction",
        "bestseller": true
    }
}

而 JSON 陣列的示例如下所示：

{
    "fruits": [
        "Apple",
        "Banana",
        "Strawberry",
        "Mango"
    ]
}

提示： 資料交換格式是一種文字格式，用於在不同平臺和作業系統之間交換或交換資料。JSON 是 Web 應用程式中最流行，最輕量級的資料交換格式。

PHP 解析 JSON

JSON 資料結構與 PHP 陣列非常相似。PHP 具有內建函式來編碼和解碼 JSON 資料。這些功能分別是 json_encode() 和 json_decode() 。這兩個函式僅適用於 UTF-8 編碼的字串資料。

PHP 中編碼 JSON 資料

在 PHP 中，json_encode() 函式用於將值編碼為 JSON 格式。被編碼的值可以是除資源之外的任何 PHP 資料型別，如資料庫或檔案控制代碼。下面的示例演示如何將 PHP 關聯陣列編碼為 JSON 物件：

<?php
// An associative array
$marks = array("Peter"=>65, "Harry"=>80, "John"=>78, "Clark"=>90);
 
echo json_encode($marks);
?>

上面示例的輸出如下所示：

{"Peter":65,"Harry":80,"John":78,"Clark":90}

同樣，你可以將 PHP 索引陣列編碼為 JSON 陣列，如下所示：

<?php
// An indexed array
$colors = array("Red", "Green", "Blue", "Orange", "Yellow");
 
echo json_encode($colors);
?>

上面示例的輸出如下所示：

["Red","Green","Blue","Orange","Yellow"]

你還可以強制 json_encode() 函式使用 JSON_FORCE_OBJECT 選項將 PHP 索引陣列作為 JSON 物件返回，如下例所示：

<?php
// An indexed array
$colors = array("Red", "Green", "Blue", "Orange");
 
echo json_encode($colors, JSON_FORCE_OBJECT);
?>

上面示例的輸出如下所示：

{"0":"Red","1":"Green","2":"Blue","3":"Orange"}

正如你在上面的示例中所看到的，非關聯陣列可以編碼為陣列或物件。但是，關聯陣列始終編碼為物件。

PHP 解碼 JSON 資料

解碼 JSON 資料就像編碼它一樣簡單。你可以使用 PHP json_decode() 函式將 JSON 編碼的字串轉換為適當的 PHP 資料型別。以下示例演示如何將 JSON 物件解碼或轉換為 PHP 物件。

<?php
// Store JSON data in a PHP variable
$json = '{"Peter":65,"Harry":80,"John":78,"Clark":90}';
 
var_dump(json_decode($json));
?>

上面示例的輸出將如下所示：

object(stdClass)#1 (4) { ["Peter"]=> int(65) ["Harry"]=> int(80) ["John"]=> int(78) ["Clark"]=> int(90) }

預設情況下，該 json_decode() 函式返回一個物件。但是，你可以選擇指定第二個引數 $assoc，該引數接受一個布林值，當設定為 true 時，JSON 物件被解碼為關聯陣列。它預設值為 false。這是一個例子：

<?php
// Store JSON data in a PHP variable
$json = '{"Peter":65,"Harry":80,"John":78,"Clark":90}';
 
var_dump(json_decode($json, true));
?>

上面示例的輸出將如下所示：

array(4) { ["Peter"]=> int(65) ["Harry"]=> int(80) ["John"]=> int(78) ["Clark"]=> int(90) }

現在讓我們看一個示例，它將向你展示如何解碼 JSON 資料並訪問 PHP 中 JSON 物件或陣列的各個元素。

<?php
// Assign JSON encoded string to a PHP variable
$json = '{"Peter":65,"Harry":80,"John":78,"Clark":90}';
 
// Decode JSON data to PHP associative array
$arr = json_decode($json, true);
// Access values from the associative array
echo $arr["Peter"];  // Output: 65
echo $arr["Harry"];  // Output: 80
echo $arr["John"];   // Output: 78
echo $arr["Clark"];  // Output: 90
 
// Decode JSON data to PHP object
$obj = json_decode($json);
// Access values from the returned object
echo $obj->Peter;   // Output: 65
echo $obj->Harry;   // Output: 80
echo $obj->John;    // Output: 78
echo $obj->Clark;   // Output: 90
?>

你還可以使用迴圈遍歷解碼資料，如下所示： foreach()

<?php
// Assign JSON encoded string to a PHP variable
$json = '{"Peter":65,"Harry":80,"John":78,"Clark":90}';
 
// Decode JSON data to PHP associative array
$arr = json_decode($json, true);
 
// Loop through the associative array
foreach($arr as $key=>$value){
    echo $key . "=>" . $value . "<br>";
}
echo "<hr>";
// Decode JSON data to PHP object
$obj = json_decode($json);
 
// Loop through the object
foreach($obj as $key=>$value){
    echo $key . "=>" . $value . "<br>";
}
?>

在 PHP 中從巢狀的 JSON 資料中提取值

JSON 物件和陣列也可以巢狀。JSON 物件可以任意包含其他 JSON 物件，陣列，巢狀陣列，JSON 物件陣列等。以下示例將向你展示如何解碼巢狀的 JSON 物件並在 PHP 中列印其所有值。

<?php
// Define recursive function to extract nested values
function printValues($arr) {
    global $count;
    global $values;
    
    // Check input is an array
    if(!is_array($arr)){
        die("ERROR: Input is not an array");
    }
    
    /*
    Loop through array, if value is itself an array recursively call the
    function else add the value found to the output items array,
    and increment counter by 1 for each value found
    */
    foreach($arr as $key=>$value){
        if(is_array($value)){
            printValues($value);
        } else{
            $values[] = $value;
            $count++;
        }
    }
    
    // Return total count and values found in array
    return array('total' => $count, 'values' => $values);
}
 
// Assign JSON encoded string to a PHP variable
$json = '{
    "book": {
        "name": "Harry Potter and the Goblet of Fire",
        "author": "J. K. Rowling",
        "year": 2000,
        "characters": ["Harry Potter", "Hermione Granger", "Ron Weasley"],
        "genre": "Fantasy Fiction",
        "price": {
            "paperback": "$10.40", "hardcover": "$20.32", "kindle": "4.11"
        }
    }
}';
// Decode JSON data into PHP associative array format
$arr = json_decode($json, true);
 
// Call the function and print all the values
$result = printValues($arr);
echo "<h3>" . $result["total"] . " value(s) found: </h3>";
echo implode("<br>", $result["values"]);
 
echo "<hr>";
 
// Print a single value
echo $arr["book"]["author"] . "<br>";  // Output: J. K. Rowling
echo $arr["book"]["characters"][0] . "<br>";  // Output: Harry Potter
echo $arr["book"]["price"]["hardcover"];  // Output: $20.32
?>