PHP处理JSON编码解码方法详解
大家好，我们又见面了啊~本文《PHP处理JSON编码与解码的基础方法》的内容中将会涉及到等等。如果你正在学习文章相关知识，欢迎关注我，以后会给大家带来更多文章相关文章，希望我们能一起进步！下面就开始本文的正式内容~
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 数据时，主要依赖其内置的 json_encode() 和 json_decode() 这两个核心函数。它们分别负责将 PHP 数组或对象转换为 JSON 格式的字符串，以及将 JSON 字符串解析回 PHP 数组或对象，是实现数据序列化与反序列化的基础工具。
解决方案
PHP 处理 JSON 数据的编码与解码，核心在于理解并运用 json_encode() 和 json_decode()。
编码：将 PHP 数据转换为 JSON 字符串 (json_encode())
当你需要将 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 语言实现的，效率很高。然而，在处理超大规模数据或者高并发请求时，性能和内存占用就可能成为瓶颈，需要一些优化策略。
性能优化：
避免不必要的重复操作： 这是最基本的优化原则。如果你在一个循环内部反复对相同的数据进行
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() 的基本功能可能就不够了。这时，一些进阶技巧就显得尤为重要。
1. 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,json_encode,json_decode,编码与解码的内容请关注golang学习网公众号！
GolangTCP吞吐优化：窗口与Nagle设置全解析
- 上一篇
- GolangTCP吞吐优化：窗口与Nagle设置全解析
- 下一篇
- Win8无法开机修复方法大全
-
- 文章 · php教程 | 5分钟前 |
- 作者元数据CSS控制方法详解
- 498浏览 收藏
-
- 文章 · php教程 | 10分钟前 | php.ini session_start() PHPSession session.save_path session.cookie_lifetime
- PHP开启Session的配置步骤
- 122浏览 收藏
-
- 文章 · php教程 | 16分钟前 |
- PHP自定义函数创建与参数返回教程
- 126浏览 收藏
-
- 文章 · php教程 | 17分钟前 |
- PHP生成中文验证码的简单方法
- 468浏览 收藏
-
- 文章 · php教程 | 23分钟前 |
- PHP解析Mach-O文件的实用方法分享
- 283浏览 收藏
-
- 文章 · php教程 | 29分钟前 |
- PHP数组合并：相同键保留第一个元素
- 248浏览 收藏
-
- 文章 · php教程 | 42分钟前 |
- PHP税号验证方法及校验位解析
- 279浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
- 542次学习
-
- GO语言核心编程课程
- 本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
- 511次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
- 498次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
- 484次学习
-
- 千音漫语
- 千音漫语，北京熠声科技倾力打造的智能声音创作助手，提供AI配音、音视频翻译、语音识别、声音克隆等强大功能，助力有声书制作、视频创作、教育培训等领域，官网：https://qianyin123.com
- 96次使用
-
- MiniWork
- MiniWork是一款智能高效的AI工具平台，专为提升工作与学习效率而设计。整合文本处理、图像生成、营销策划及运营管理等多元AI工具，提供精准智能解决方案，让复杂工作简单高效。
- 89次使用
-
- NoCode
- NoCode (nocode.cn)是领先的无代码开发平台，通过拖放、AI对话等简单操作，助您快速创建各类应用、网站与管理系统。无需编程知识，轻松实现个人生活、商业经营、企业管理多场景需求，大幅降低开发门槛，高效低成本。
- 107次使用
-
- 达医智影
- 达医智影，阿里巴巴达摩院医疗AI创新力作。全球率先利用平扫CT实现“一扫多筛”，仅一次CT扫描即可高效识别多种癌症、急症及慢病，为疾病早期发现提供智能、精准的AI影像早筛解决方案。
- 98次使用
-
- 智慧芽Eureka
- 智慧芽Eureka，专为技术创新打造的AI Agent平台。深度理解专利、研发、生物医药、材料、科创等复杂场景，通过专家级AI Agent精准执行任务，智能化工作流解放70%生产力，让您专注核心创新。
- 98次使用
-
- PHP技术的高薪回报与发展前景
- 2023-10-08 501浏览
-
- 基于 PHP 的商场优惠券系统开发中的常见问题解决方案
- 2023-10-05 501浏览
-
- 如何使用PHP开发简单的在线支付功能
- 2023-09-27 501浏览
-
- PHP消息队列开发指南：实现分布式缓存刷新器
- 2023-09-30 501浏览
-
- 如何在PHP微服务中实现分布式任务分配和调度
- 2023-10-04 501浏览
