PHP 8.3 处理超大 JSON 应采用流式解析：首选 pcrov/jsonreader（需 intl 扩展），次选 cerbero/json-parser（零依赖），或手动逐行处理 NDJSON；严禁一次性加载全文。
PHP 8.3 处理超大 JSON 文档，核心是避免用 json_decode(file_get_contents(...)) 一次性加载整个文件——那基本等于主动触发 Allowed memory size exhausted。真正可行的方案是流式解析（Pull Parsing），即边读边解析、按需取值，内存占用稳定在 KB 级别。
优先用 pcrov/jsonreader（推荐）
这是目前最成熟、文档最清晰的流式 JSON 解析器，专为 PHP 7.3+（含 8.3）设计，底层基于 ICU 扩展，性能和稳定性经过大量生产验证。
- 安装：运行
composer require pcrov/jsonreader，确保已启用intl扩展 - 适用场景：标准 JSON 对象或数组（如
{"users":[{...},{...}]}），支持嵌套结构导航 - 基本用法：打开文件句柄后，用
while ($reader->read())循环推进指针，通过$reader->value、$reader->key、$reader->type获取当前节点信息 - 关键技巧：遇到目标数组项（如
"user"对象开始时），用$reader->skip()跳过整段子树，避免深度遍历不相关数据
备选方案：cerbero/json-parser（零依赖轻量）
如果你希望完全规避扩展依赖（比如无法启用 intl），这个库是极佳替代。它纯 PHP 实现，无外部要求，API 更简洁，适合只做扁平化逐条提取的场景（例如每行一个 JSON 对象的 NDJSON 格式）。
- 安装：
composer require cerbero/json-parser - 典型流程：创建
JsonParser::fromFile('data.json')，然后foreach ($parser as $key => $value)迭代——每次循环只加载当前键值对 - 注意：它不支持随机跳转或回溯，适合“从头到尾线性处理”的任务，比如导出 CSV、写入数据库批次插入
手动流式读取（仅限简单结构）
如果项目限制极严（不能用 Composer）、且 JSON 是“每行一个独立对象”格式（即 NDJSON），可用原生函数分段处理：
立即学习“PHP免费学习笔记（深入）”；
- 用
fopen($file, 'r')打开文件，配合fgets()逐行读取 - 对每一行调用
json_decode($line, true)，立即处理并 unset 变量释放内存 - 务必检查
json_last_error() === JSON_ERROR_NONE，跳过解析失败的脏数据行 - 不适用于标准多行缩进 JSON（如
{"items":[{...},{...}]}），因为单行读取会截断结构
必须避开的坑
有些做法看似“分块”，实则无效甚至更危险：
-
不要用
fread($fp, 8192)拼接字符串再json_decode—— JSON 不是文本流，随意切开会破坏括号配对，导致解析失败 -
不要盲目调高
memory_limit—— 数据持续增长时，这只是延迟崩溃，不是解决 -
不要用
stream_get_contents替代file_get_contents—— 它仍是把全部内容读进内存，只是底层缓冲策略不同，无法解决本质问题 - 留意
json_decode的深度限制（默认 512 层嵌套），若数据本身嵌套极深，需传入第四个参数JSON_PARSER_MAX_DEPTH显式扩大（但应优先推动上游优化结构）
