PHP语言怎样处理 JSON 数据的编码与解码 PHP语言 JSON 数据处理的基础操作方法-php教程-PHP中文网

php处理json数据的核心是json_encode()和json_decode()函数。1. json_encode()将php数组或对象转换为json字符串，可使用json_unescaped_unicode保留中文字符，json_pretty_print格式化输出；2. json_decode()将json字符串解析为php数组或对象，第二个参数设为true返回关联数组，false返回对象；3. 常见问题包括字符编码非utf-8导致编码失败、不可序列化类型（如资源、闭包）引发错误、无效json字符串导致返回null，需用json_last_error()和json_last_error_msg()诊断；4. 大整数可能溢出，应使用json_bigint_as_string选项以字符串形式处理；5. 性能优化需避免循环内重复编解码，及时释放大对象内存，减少冗余数据；6. 复杂场景可通过实现jsonserializable接口自定义对象序列化，使用array_filter过滤空值，结合类型检查和第三方库验证数据结构，确保数据可靠。这些方法共同构成了php高效、安全处理json数据的完整方案。

PHP语言怎样处理 JSON 数据的编码与解码 PHP语言 JSON 数据处理的基础操作方法

PHP 语言在处理 JSON 数据时，主要依赖其内置的

json_encode()

登录后复制

和

json_decode()

登录后复制

这两个核心函数。它们分别负责将 PHP 数组或对象转换为 JSON 格式的字符串，以及将 JSON 字符串解析回 PHP 数组或对象，是实现数据序列化与反序列化的基础工具。

解决方案

PHP 处理 JSON 数据的编码与解码，核心在于理解并运用

json_encode()

登录后复制

和

json_decode()

登录后复制

。

编码：将 PHP 数据转换为 JSON 字符串 (

json_encode()

登录后复制

)

立即学习“PHP免费学习笔记（深入）”；

当你需要将 PHP 中的数据结构（比如一个数组或者一个对象）发送给前端 JavaScript、存储到数据库的文本字段，或者通过 API 接口传输时，通常会将其转换为 JSON 字符串。

json_encode()

登录后复制

函数就是为此而生。

它的基本用法很简单：

<?php
$data = [
    'name' => '张三',
    'age' => 30,
    'isStudent' => false,
    'hobbies' => ['reading', 'coding', 'travel'],
    'address' => [
        'city' => '北京',
        'zip' => '100000'
    ]
];

$jsonString = json_encode($data);
echo $jsonString;
// 输出: {"name":"\u5f20\u4e09","age":30,"isStudent":false,"hobbies":["reading","coding","travel"],"address":{"city":"\u5317\u4eac","zip":"100000"}}
?>

登录后复制

你可能注意到中文被编码成了

\uXXXX

登录后复制

形式。这在 JSON 标准中是完全合法的，但有时候为了可读性或某些特殊需求，我们希望中文直接显示。这时，可以传入

JSON_UNESCAPED_UNICODE

登录后复制

选项：

<?php
$jsonStringPretty = json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonStringPretty;
/*
输出:
{
    "name": "张三",
    "age": 30,
    "isStudent": false,
    "hobbies": [
        "reading",
        "coding",
        "travel"
    ],
    "address": {
        "city": "北京",
        "zip": "100000"
    }
}
*/
?>

登录后复制

JSON_PRETTY_PRINT

登录后复制

则让输出的 JSON 字符串带有缩进和换行，更易于人类阅读和调试。

解码：将 JSON 字符串解析为 PHP 数据 (

json_decode()

登录后复制

)

当你从外部接收到一个 JSON 格式的字符串（例如，从一个 API 响应、前端请求体中），你需要将其转换回 PHP 可以操作的数组或对象。

json_decode()

登录后复制

函数承担这项任务。

它的第一个参数是待解码的 JSON 字符串。第二个参数是一个布尔值，如果设置为

true

登录后复制

，则返回关联数组；如果为

false

登录后复制

（默认值），则返回对象。

<?php
$jsonStringReceived = '{"name":"李四","age":25,"city":"上海"}';

// 解码为对象
$obj = json_decode($jsonStringReceived);
echo $obj->name; // 输出: 李四

// 解码为关联数组
$arr = json_decode($jsonStringReceived, true);
echo $arr['name']; // 输出: 李四

// 如果 JSON 字符串是数组形式
$jsonArrayString = '[{"id":1,"name":"A"},{"id":2,"name":"B"}]';
$arrayResult = json_decode($jsonArrayString, true);
print_r($arrayResult);
/*
输出:
Array
(
    [0] => Array
        (
            [id] => 1
            [name] => A
        )

    [1] => Array
        (
            [id] => 2
            [name] => B
        )

)
*/
?>

登录后复制

我个人习惯在大多数场景下使用

json_decode($jsonString, true)

登录后复制

，因为处理关联数组在 PHP 中通常更灵活和方便，尤其是在不确定 JSON 结构是否会变动的情况下。当然，如果你更倾向于面向对象的方式，使用默认的对象模式也完全没问题。

处理JSON数据时常见的编码陷阱和解码错误有哪些？

在实际开发中，JSON 编码和解码并非总是那么一帆风顺，总会遇到一些让人头疼的“坑”。

一个常见的问题是字符编码。如果你的 PHP 脚本文件、数据库连接或者输入源的字符编码不是 UTF-8，而你的数据中包含非 ASCII 字符（比如中文），那么

json_encode()

登录后复制

可能会返回

null

登录后复制

或者产生乱码。PHP 的

json_encode()

登录后复制

期望输入是 UTF-8 编码的。我曾经就遇到过从一个老旧系统导出的数据，因为不是 UTF-8 导致 JSON 编码失败，排查了半天才发现是编码问题。确保你的 PHP 环境、数据库、以及所有文本输入都是 UTF-8 是解决这类问题的根本。

另一个编码陷阱是不可序列化的数据类型。

json_encode()

登录后复制

只能处理基本数据类型（字符串、数字、布尔值、null）、索引数组和关联数组（对象）。资源类型（如数据库连接、文件句柄）、闭包（匿名函数）以及一些特殊的对象（例如，带有

private

登录后复制

或

protected

登录后复制

属性但未实现

JsonSerializable

登录后复制

接口的对象）是不能直接被

json_encode()

登录后复制

转换的，它们会导致编码失败或被忽略。当遇到这种情况，你需要手动处理，比如将资源转换为其 ID 或路径，或者为你的自定义类实现

JsonSerializable

登录后复制

接口。

至于解码错误，最常见的就是无效的 JSON 字符串。如果输入的 JSON 字符串格式不正确，比如缺少引号、多余的逗号、括号不匹配等，

json_decode()

登录后复制

会返回

null

登录后复制

。这时候，光知道返回

null

登录后复制

是不够的，你需要知道具体是什么错误。PHP 提供了

json_last_error()

登录后复制

和

json_last_error_msg()

登录后复制

这两个函数来帮助你诊断问题：

<?php
$invalidJson = '{"name": "张三", "age": 30, }'; // 多余的逗号

$data = json_decode($invalidJson);

if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
    echo "JSON 解码失败: " . json_last_error_msg();
    // 可能会输出: JSON 解码失败: Syntax error
}

$anotherInvalidJson = '{"id":1,"name":"测试"'; // 缺少右大括号
$data2 = json_decode($anotherInvalidJson);
if ($data2 === null && json_last_error() !== JSON_ERROR_NONE) {
    echo "\nJSON 解码失败: " . json_last_error_msg();
    // 可能会输出: JSON 解码失败: Syntax error
}
?>

登录后复制

这简直是调试 JSON 问题的利器，每次遇到

json_decode

登录后复制

null

登录后复制

我都会下意识地去检查这两个函数的结果。

还有一种不那么常见但可能很麻烦的错误是大整数溢出。如果 JSON 字符串中包含非常大的整数（超过 PHP 32 位或 64 位整数的最大值），

json_decode()

登录后复制

可能会将其转换为浮点数，从而导致精度丢失。为了避免这种情况，你可以使用

JSON_BIGINT_AS_STRING

登录后复制

选项，让

json_decode()

登录后复制

将这些大整数作为字符串来处理：

<?php
$jsonWithBigInt = '{"id": 9223372036854775807, "value": 12345678901234567890}'; // 922... 是 64 位 PHP int 的最大值

// 默认解码
$objDefault = json_decode($jsonWithBigInt);
var_dump($objDefault->value); // 可能会是 float(1.2345678901235E+19) 或其他不精确的值

// 使用 JSON_BIGINT_AS_STRING
$objString = json_decode($jsonWithBigInt, false, 512, JSON_BIGINT_AS_STRING);
var_dump($objString->value); // 字符串 "12345678901234567890"
?>

登录后复制

这对于处理一些金融交易 ID 或者分布式系统中的雪花 ID 等场景非常重要，因为哪怕一点点精度丢失都可能导致严重问题。

如何优化PHP的JSON处理性能和内存占用？

对于大多数常规应用场景，PHP 内置的

json_encode()

登录后复制

和

json_decode()

登录后复制

函数性能已经相当不错，足以应对。它们底层是用 C 语言实现的，效率很高。然而，在处理超大规模数据或者高并发请求时，性能和内存占用就可能成为瓶颈，需要一些优化策略。

性能优化：

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

避免不必要的重复操作： 这是最基本的优化原则。如果你在一个循环内部反复对相同的数据进行

json_encode()

登录后复制

或

json_decode()

登录后复制

，那无疑是在浪费资源。将这些操作移到循环外部，只执行一次。

// ❌ 不好的例子
// foreach ($items as $item) {
//     $jsonItem = json_encode($item); // 每次循环都编码
//     // ...
// }

// ✅ 好的例子
// $encodedItems = [];
// foreach ($items as $item) {
//     $encodedItems[] = $item; // 收集数据
// }
// $finalJson = json_encode($encodedItems); // 一次性编码

登录后复制

选择合适的解码方式： 如果你明确知道只需要 JSON 字符串中的某个特定字段，并且这个 JSON 字符串非常大，那么使用
```
json_decode($jsonString, true)
```
登录后复制
（解码为关联数组）通常会比解码为对象稍微快一点点，因为关联数组的访问开销可能略低。当然，这种差异在大多数情况下微乎其微，不值得为了这点性能牺牲代码的可读性和维护性。我的经验是，除非有明确的性能瓶颈，否则选择你最熟悉和最舒服的风格。
针对特定场景考虑第三方库（极少）： 只有在极端情况下，例如你需要处理流式 JSON（JSON Lines），或者有非常特殊的解析需求，PHP 的内置函数无法满足，才可能会考虑使用一些第三方库。但对于标准的 JSON 编码和解码，PHP 的内置函数是首选，因为它们经过高度优化且稳定。

内存占用优化：

内存占用通常是比 CPU 性能更需要关注的问题，尤其是在处理大型 JSON 数据时。

分批处理（Chunking）： 如果你从文件或网络流中读取一个巨大的 JSON 数组，并且这个数组的每个元素都是独立的，那么可以考虑不一次性将整个 JSON 字符串加载到内存并解码。而是将其拆分成更小的块进行处理。这通常需要自定义的流解析器或者使用像
```
JSON_UNESCAPED_SLASHES
```
登录后复制
这样的标志来避免不必要的转义，从而减少字符串大小。不过，PHP 内置的
```
json_decode
```
登录后复制
无法直接支持流式解析，这意味着你需要先读取整个 JSON 字符串。对于非常大的 JSON 文件，你可能需要考虑逐行读取（如果文件是 JSON Lines 格式）或使用更底层的字节流处理。
及时释放内存： 当你解码了一个非常大的 JSON 字符串到 PHP 数组或对象后，如果这些数据不再需要，务必使用
```
unset()
```
登录后复制
函数及时释放它们占用的内存。这对于长运行的脚本（如守护进程、CLI 工具）或处理大量请求的 Web 应用尤其重要。
```
<?php
$largeJsonData = json_decode(file_get_contents('large_data.json'), true);

// ... 对 $largeJsonData 进行处理 ...

// 处理完毕，不再需要时立即释放内存
unset($largeJsonData);
?>
```
登录后复制
避免生成冗余数据： 在编码 JSON 时，只包含你真正需要的数据。不必要的字段、空值或者可以推断出的默认值都应该被过滤掉，以减小生成的 JSON 字符串大小，从而减少传输和解析的开销。例如，如果某个字段的值在大部分情况下都是
```
null
```
登录后复制
，你可以选择在值为
```
null
```
登录后复制
时不将其包含在 JSON 中，而不是发送一个
```
null
```
登录后复制
字符串。

总的来说，对于大多数 PHP 应用，内置的 JSON 函数已经足够高效。优化往往更多地体现在良好的编程习惯上：避免重复操作、及时释放内存、以及合理设计数据结构。

除了基础操作，PHP在处理复杂JSON结构时有哪些进阶技巧？

当 JSON 结构变得复杂，或者你的业务逻辑对数据序列化有特殊要求时，仅仅使用

json_encode()

登录后复制

和

json_decode()

登录后复制

的基本功能可能就不够了。这时，一些进阶技巧就显得尤为重要。

JsonSerializable

登录后复制

接口：定制对象的 JSON 序列化行为

默认情况下，

json_encode()

登录后复制

在序列化对象时，只会包含对象的公共属性。如果你想控制哪些属性被序列化、如何序列化，或者在序列化时执行一些额外的逻辑，可以实现

JsonSerializable

登录后复制

接口。这个接口只有一个方法：

jsonSerialize()

登录后复制

。该方法的返回值就是该对象在 JSON 中最终呈现的形式。

<?php
class Product implements JsonSerializable {
    private $id;
    public $name;
    protected $price;
    public $description;
    public $createdAt; // DateTime object

    public function __construct($id, $name, $price, $description) {
        $this->id = $id;
        $this->name = $name;
        $this->price = $price;
        $this->description = $description;
        $this->createdAt = new DateTime();
    }

    // 实现 JsonSerializable 接口
    public function jsonSerialize(): mixed {
        // 只暴露 id, name, price (四舍五入到两位小数), description
        // 并将 createdAt 格式化为字符串
        return [
            'product_id' => $this->id,
            'product_name' => $this->name,
            'price_usd' => round($this->price, 2),
            'short_desc' => substr($this->description, 0, 50) . '...',
            'created_at_iso' => $this->createdAt->format(DateTime::ISO8601),
            // 假设我们不想暴露原始的 description 或者 private/protected 属性
        ];
    }
}

$product = new Product(101, '超薄笔记本电脑', 1299.998, '这是一款性能卓越、设计轻薄的笔记本电脑，非常适合商务人士和学生使用。');
$jsonProduct = json_encode($product, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
echo $jsonProduct;
/*
输出:
{
    "product_id": 101,
    "product_name": "超薄笔记本电脑",
    "price_usd": 1300,
    "short_desc": "这是一款性能卓越、设计轻薄的笔记本电脑，...",
    "created_at_iso": "2023-10-27T10:00:00+0800" // 时间会根据实际生成
}
*/
?>

登录后复制

通过实现这个接口，你可以灵活地控制 JSON 输出的结构和内容，包括重命名键、格式化值、甚至添加或删除属性，这对于构建清晰且符合 API 规范的响应非常有用。

2. 处理空值和默认值：

JSON_FORCE_OBJECT

登录后复制

与数据过滤

当编码包含空数组或空值的 PHP 结构时，有时你可能希望它们在 JSON 中表现为对象

{}

登录后复制

而不是数组

[]

登录后复制

，或者完全忽略它们。

JSON_FORCE_OBJECT

登录后复制

标志可以将空数组

[]

登录后复制

强制编码为

{}

登录后复制

。这在某些特定场景下有用，比如前端框架期望某个字段始终是对象类型，即使它现在是空的。

<?php
$dataWithEmptyArray = ['items' => []];
echo json_encode($dataWithEmptyArray); // {"items":[]}
echo "\n";
echo json_encode($dataWithEmptyArray, JSON_FORCE_OBJECT); // {"items":{}}
?>

登录后复制

对于空值（

null

登录后复制

）或空字符串，

json_encode()

登录后复制

会保留它们。如果你希望在编码时移除这些空字段，通常需要在编码前手动过滤数据：

<?php
$profile = [
    'name' => '王五',
    'email' => 'wangwu@example.com',
    'phone' => null, // 空值
    'address' => '', // 空字符串
    'tags' => [] // 空数组
];

// 过滤掉 null 和空字符串的辅助函数
$filteredProfile = array_filter($profile, function($value) {
    return $value !== null && $value !== '';
});

// 如果也想过滤空数组，可以进一步处理
$filteredProfile = array_filter($filteredProfile, function($value) {
    return !is_array($value) || !empty($value);
});

echo json_encode($filteredProfile, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
/*
输出:
{
    "name": "王五",
    "email": "wangwu@example.com"
}
*/
?>

登录后复制

这种数据过滤是业务逻辑层面的优化，能有效减小 JSON 有效载荷，尤其是在数据量大时，对网络传输和前端解析都有好处。

3. 数据验证与类型检查：确保解码后的数据可靠

从外部接收到的 JSON 数据，即使成功解码，也可能不符合你的预期结构或包含不正确的数据类型。仅仅解码成功是不够的，你还需要对其进行严格的验证。

虽然 PHP 没有内置的 JSON Schema 验证器，但你可以使用第三方库（如

justinrainbow/json-schema

登录后复制

）来进行复杂的结构验证。对于简单的场景，手动进行类型检查和字段存在性检查是必不可少的：

<?php
$apiResponse = '{"user_id": 123, "username": "test_user", "is_active": "true"}'; // 注意 is_active 是字符串

$data = json_decode($apiResponse, true);

// 检查是否解码成功且不是 null
if ($data === null) {
    echo "JSON 解码失败或为空。\n";
    // 检查 json_last_error()
    exit;
}

// 验证关键字段是否存在
if (!isset($data['user_id']) || !isset($data['username'])) {
    echo "缺少必要字段。\n";
    exit;
}

// 验证字段类型
if (!is_int($data['user_id'])) {
    // 尝试转换为整数，或报错
    $data['user_id'] = (int)$data['user_id'];
    echo "user_id 类型不正确，已尝试转换。\n";
}

// 验证布尔值
if (isset($data['is

登录后复制

以上就是PHP语言怎样处理 JSON 数据的编码与解码 PHP语言 JSON 数据处理的基础操作方法的详细内容，更多请关注php中文网其它相关文章！