php可用原生json_decode配合递归函数实现json扁平化，规则为点号连接路径、数字索引转字符串、保留null/空数组、统一转array处理对象，支持深度限制防循环引用。
直接把嵌套的 JSON 数组转成一层结构，关键不是“递归深度”，而是字段路径的可追溯性和键名冲突的预防。PHP 原生函数 json_decode + 递归遍历就能搞定，不需要额外扩展。
明确扁平化规则：用点号分隔路径，避免键名覆盖
比如 {"user": {"profile": {"name": "Alice", "age": 30}, "tags": ["vip", "active"]}}，不能简单展开成 ["Alice", 30, "vip", "active"]——会丢失结构信息。正确做法是把层级路径转为键名：user.profile.name、user.profile.age、user.tags.0、user.tags.1。遇到数组索引时统一用数字字符串（如 "0"），避免和对象键混淆。
- 对象键和数组索引都转为字符串，统一处理
- 空数组或 null 值保留，不跳过（便于后续校验）
- 重复路径（如多个同名子对象）天然靠路径区分，不会覆盖
写一个健壮的递归扁平化函数
用引用传参减少内存复制，每层递归拼接当前路径，遇到叶子节点（字符串/数字/bool/null）就写入结果数组：
function flattenJson($data, $prefix = '', &$result = []) {
if (!is_array($data) && !is_object($data)) {
$result[$prefix] = $data;
return;
}
$data = (array)$data; // 统一转为数组，兼容 stdClass
foreach ($data as $key => $value) {
$newKey = $prefix === '' ? (string)$key : $prefix . '.' . (string)$key;
flattenJson($value, $newKey, $result);
}
}
- 开头强制转 array，能同时处理关联数组、索引数组、stdClass 对象
- 所有 key 强制转 string，防止数字键被隐式转换导致路径错误
- 不依赖外部类或 Composer 包，纯函数式，易测试易复用
处理边界情况：空值、循环引用、超深嵌套
真实数据中常有 null 字段、空对象、甚至意外的循环引用（虽少见）。基础版函数对前两者天然兼容；对循环引用需加深度限制防爆栈：
- 加第四个参数
$depth = 0和最大深度检查（如 20 层），超限抛异常或截断 - 空数组
[]会展开为空路径集合（如foo.0不存在），若需保留空数组标记，可设$result[$prefix] = '[]' - 布尔值和浮点数保持原类型，不转字符串——PHP 数组支持混合类型值
使用示例：解码后直接扁平，再按需过滤或导出
常见场景是解析 API 返回的复杂 JSON，然后取其中几个字段做数据库插入或 CSV 导出：
$json = '{"order":{"id":1001,"items":[{"sku":"A1","qty":2},{"sku":"B2","qty":1}],"customer":{"name":"Tom","contact":{"email":"t@x.com"}}}}';
$data = json_decode($json, true);
$flat = [];
flattenJson($data, '', $flat);
// 得到：
// [
// 'order.id' => 1001,
// 'order.items.0.sku' => 'A1',
// 'order.items.0.qty' => 2,
// 'order.items.1.sku' => 'B2',
// 'order.items.1.qty' => 1,
// 'order.customer.name' => 'Tom',
// 'order.customer.contact.email' => 't@x.com'
// ]
- 用
array_key_exists('order.items.0.sku', $flat)快速判断字段是否存在 - 用
array_filter($flat, fn($k) => str_starts_with($k, 'order.items.'), ARRAY_FILTER_USE_KEY)提取某一段 - 导出 CSV 时，字段顺序由 key 排序控制，无需硬编码列名
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
