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
?>