「PHP系列」PHP JSON详解

文章目录

• 一、JSON简介及运用
• • 1. `json_encode()`
  • 2. `json_decode()`
  • 3. 错误处理
  • 4. 注意事项
• 二、创建/解析JSON
• • 1. 创建JSON字符串
  • 2. 解析JSON字符串
• 三、JSON常见问题
• • 1. JSON格式错误
  • 2. 编码问题
  • 3. 处理特殊字符
  • 4. 使用try-catch处理异常
• 四、相关链接

一、JSON简介及运用

PHP 支持 JSON（JavaScript Object Notation）的编码和解码。JSON 是一种轻量级的数据交换格式，它基于 JavaScript 的一个子集，易于人阅读和编写，同时也易于机器解析和生成。在 PHP 中，你可以使用 json_encode() 函数将 PHP 数组或对象转换为 JSON 格式的字符串，使用 json_decode() 函数将 JSON 格式的字符串转换为 PHP 数组或对象。

1. json_encode()

json_encode() 函数用于将 PHP 值转换为 JSON 格式的字符串。

示例：

<?php
$data = array(
    'name' => 'John Doe',
    'age' => 30,
    'email' => 'johndoe@example.com'
);

$json = json_encode($data);
echo $json;
?>

输出：

{"name":"John Doe","age":30,"email":"johndoe@example.com"}

2. json_decode()

json_decode() 函数用于将 JSON 格式的字符串转换为 PHP 数组或对象。

示例：

<?php
$json = '{"name":"John Doe","age":30,"email":"johndoe@example.com"}';

$data = json_decode($json);

echo $data->name; // 输出：John Doe
echo $data->age;  // 输出：30
echo $data->email; // 输出：johndoe@example.com
?>

如果你希望将 JSON 字符串解码为数组而不是对象，你可以为 json_decode() 函数的第二个参数传递 true。

示例：

<?php
$json = '{"name":"John Doe","age":30,"email":"johndoe@example.com"}';

$data = json_decode($json, true);

echo $data['name']; // 输出：John Doe
echo $data['age'];  // 输出：30
echo $data['email']; // 输出：johndoe@example.com
?>

3. 错误处理

在使用 json_encode() 和 json_decode() 时，如果出现错误，它们会返回 false。你可以使用 json_last_error() 函数来获取最后一次 JSON 编码或解码操作的错误代码，并使用 json_last_error_msg() 函数来获取相应的错误消息。

示例：

<?php
$data = new stdClass(); // 一个未定义属性的对象

$json = json_encode($data);
if ($json === false) {
    echo 'JSON 编码错误：' . json_last_error_msg();
} else {
    echo $json;
}
?>

4. 注意事项

• 不是所有的 PHP 数据类型都可以被转换为 JSON 格式。例如，资源（resource）和循环引用（circular references）就不能被编码。
• 在解码 JSON 字符串时，如果 JSON 字符串中包含非 UTF-8 字符，可能会导致解码失败或产生意外的结果。确保你的 JSON 字符串是有效的 UTF-8 编码。
• 对于大型 JSON 数据，使用 json_encode() 和 json_decode() 可能会消耗较多的内存和处理时间。在这种情况下，你可能需要考虑使用流式解析或分块处理的方法。

二、创建/解析JSON

在PHP中创建和解析JSON字符串是相对简单的任务，主要通过使用json_encode()和json_decode()这两个内置函数来实现。下面是如何使用这两个函数的详细步骤：

1. 创建JSON字符串

使用json_encode()函数可以将PHP数组或对象转换为JSON格式的字符串。

示例：

<?php
// 创建一个PHP数组
$data = array(
    'name' => 'John Doe',
    'age' => 30,
    'email' => 'johndoe@example.com',
    'is_student' => false
);

// 将PHP数组转换为JSON字符串
$jsonString = json_encode($data);

// 输出JSON字符串
echo $jsonString;
?>

输出：

{"name":"John Doe","age":30,"email":"johndoe@example.com","is_student":false}

在这个例子中，我们创建了一个包含姓名、年龄、电子邮件和是否为学生标志的数组。然后，我们使用json_encode()函数将这个数组转换为一个JSON格式的字符串。

2. 解析JSON字符串

使用json_decode()函数可以将JSON格式的字符串解析为PHP数组或对象。

示例：

<?php
// JSON字符串
$jsonString = '{"name":"John Doe","age":30,"email":"johndoe@example.com","is_student":false}';

// 将JSON字符串解析为PHP对象
$dataObject = json_decode($jsonString);

// 访问对象属性
echo $dataObject->name; // 输出：John Doe
echo $dataObject->age;  // 输出：30
echo $dataObject->email; // 输出：johndoe@example.com
echo $dataObject->is_student ? 'Yes' : 'No'; // 输出：No

// 或者将JSON字符串解析为PHP数组
$dataArray = json_decode($jsonString, true);

// 访问数组元素
echo $dataArray['name']; // 输出：John Doe
echo $dataArray['age'];  // 输出：30
echo $dataArray['email']; // 输出：johndoe@example.com
echo $dataArray['is_student'] ? 'Yes' : 'No'; // 输出：No
?>

在这个例子中，我们首先有一个JSON格式的字符串。然后，我们使用json_decode()函数将其解析为一个PHP对象。通过访问对象的属性，我们可以获取JSON字符串中的数据。另外，通过将json_decode()的第二个参数设置为true，我们可以将JSON字符串解析为一个PHP数组，并通过访问数组元素来获取数据。

三、JSON常见问题

1. JSON格式错误

$json_data = '{name: "John", age: 30}'; // 缺少引号
$data = json_decode($json_data);
if (json_last_error() !== JSON_ERROR_NONE) {
    echo "JSON格式错误：" . json_last_error_msg();
}

2. 编码问题

$json_data = iconv('ISO-8859-1', 'UTF-8', $some_data); // 假设$some_data是ISO-8859-1编码
$data = json_decode($json_data);
if ($data === null) {
    echo "JSON解析错误";
}

3. 处理特殊字符

$json_data = '{"message": "Hello, \\nWorld!"}'; // 使用转义字符
$data = json_decode($json_data);
echo $data->message; // 输出：Hello, \nWorld!

4. 使用try-catch处理异常

try {
    $json_data = '{"name": "John", "age": "thirty"}'; // 年龄应该是数字
    $data = json_decode($json_data, true);
    if (!is_array($data) || !isset($data['age']) || !is_numeric($data['age'])) {
        throw new Exception('JSON数据无效');
    }
    echo $data['name'] . ' is ' . $data['age'] . ' years old.';
} catch (Exception $e) {
    echo 'JSON解析错误：' . $e->getMessage();
}

四、相关链接

1. php官网
2. php_Github
3. PHP实现Token
4. 「PHP系列」PHP简介与起步
5. 「PHP系列」PHP语法介绍
6. 「PHP系列」PHP变量
7. 「PHP系列」PHP echo/print语句、数据类型详解
8. 「PHP系列」PHP 常量/字符串、类型比较
9. 「PHP系列」PHP 运算符详解
10. 「PHP系列」If…Else语句/switch语句
11. 「PHP系列」数组详解
12. 「PHP系列」PHP数组排序及运用场景