array_walk_recursive() 不够用，因其仅传递最内层键值，丢失层级路径与父级键名，无法拼接键路径、处理同名子键、保留数值索引顺序，也不支持提前终止或引用修改；需手写递归或 array_reduce 配合匿名函数实现可控扁平化。
直接用 array_walk_recursive() 无法保留键名，也不适合需要层级信息或自定义键路径的扁平化需求——它只适合纯值提取场景。
为什么 array_walk_recursive() 不够用
这个函数会递归遍历所有叶子节点，但会丢弃中间键名和层级结构。比如 ['user' => ['profile' => ['name' => 'Alice']]] 经过它处理后只剩 ['name' => 'Alice']，完全丢失了 user.profile. 这层上下文。
常见错误现象：array_walk_recursive() 回调里试图修改键名、拼接路径、或区分同名子键（如多个 id）时，根本拿不到父级键信息。
- 它不传入当前键路径，只传
$value和$key（且该$key是最内层键） - 遇到数值索引数组时，相同数字键会被后续覆盖（例如两个
[0] => 'a'和[0] => 'b'，后者覆盖前者） - 无法跳过某些层级、无法提前终止、不支持引用传递修改原数组
手写递归函数：保留完整键路径
真正可控的扁平化需要自己遍历，并累积键路径。核心是用一个引用变量收集结果，每次递归时拼接当前键。
立即学习“PHP免费学习笔记（深入）”；
示例（支持字符串/数字键，用点号连接）：
function flatten_array($arr, $prefix = '', &$result = []) {
foreach ($arr as $key => $value) {
$new_key = $prefix === '' ? (string)$key : $prefix . '.' . $key;
if (is_array($value)) {
flatten_array($value, $new_key, $result);
} else {
$result[$new_key] = $value;
}
}
return $result;
}
使用场景：
-
配置文件解析（如
database.connections.mysql.host） - 表单嵌套数据提交后校验（
address.street,address.city） - 生成键值对用于 Redis 存储或日志打点
用 array_reduce() + 匿名递归（PHP 7.4+）
如果想函数式一点，又不想定义命名函数，可以用 array_reduce() 配合匿名函数递归。注意 PHP 7.4 才支持在匿名函数里用 $fn = $fn ?? fn() => ... 实现自引用。
关键点：
- 必须显式传递当前路径前缀，不能依赖闭包外部变量（否则多层嵌套会错乱）
-
array_reduce()默认从左到右，但数组键顺序不一定保持，如需严格顺序请先ksort()或用foreach - 性能略低于纯
foreach递归，但可读性对熟悉 FP 的人更高
注意键名冲突和类型转换
扁平化后键名变成字符串，原本的数字键（如 [0]）和字符串键（如 ['0']）会合并为同一个 '0'，导致数据丢失。
解决办法：
- 统一强制转为字符串再拼接，但要意识到这是设计取舍
- 若需区分，改用更明确的分隔符，比如
user|profile|name或加类型标记user.array.profile.array.name.string - 遇到
null、object、resource等非标类型，提前判断并决定是跳过、序列化还是抛异常
最易被忽略的是：原始二维数组里如果有引用（&$var），扁平化后默认是值拷贝，不会保留引用关系——真有这需求得额外处理。