PHP 8.4尚未发布，当前array_flatten仅支持指定深度；需递归扁平化时，推荐用array_walk_recursive提取标量值，或自定义函数保留键名，也可封装适配未来-1深度语义。
PHP 8.4 尚未正式发布（截至 2024 年中），官方仍无 array_flatten 函数的原生递归增强版本；当前稳定版（如 PHP 8.3）的 array_flatten 仅支持指定深度（默认为 1），无法全自动处理未知嵌套层数。若需真正“递归扁平化任意深度多维数组”，需自行实现或借助可靠封装。
使用 array_walk_recursive 安全提取叶节点值
这是最简洁、健壮的内置方案，自动跳过非数组/非标量键，只收集最终的标量值（string/int/float/bool/null）：
function flatten_recursive($array) {
$result = [];
array_walk_recursive($array, function($value) use (&$result) {
$result[] = $value;
});
return $result;
}
// 示例
$data = [1, [2, [3, 4]], 5, ['a' => 'x', 'b' => ['y', 'z']]];
var_dump(flatten_recursive($data));
// 输出: [1, 2, 3, 4, 5, 'x', 'y', 'z']
⚠️ 注意：该方法丢失原始键名，且不保留非标量结构（如子数组、对象）。适合纯数据提取场景。
手动递归 + 键名保留（支持关联键与数字键）
若需维持键路径（如转为点号分隔键：'user.profile.name'）或区分键类型，推荐自定义递归函数：
立即学习“PHP免费学习笔记（深入）”；
function flatten_with_keys($array, $prefix = '') {
$result = [];
foreach ($array as $key => $value) {
$new_key = $prefix === '' ? $key : $prefix . '.' . $key;
if (is_array($value)) {
$result += flatten_with_keys($value, $new_key);
} else {
$result[$new_key] = $value;
}
}
return $result;
}
// 示例
$data = ['a' => 1, 'b' => ['c' => 2, 'd' => [3, 4]]];
var_dump(flatten_with_keys($data));
// 输出: ['a' => 1, 'b.c' => 2, 'b.d.0' => 3, 'b.d.1' => 4]
兼容 PHP 8.4 可能引入的 depth = -1 语义（前瞻性写法）
虽然 PHP 8.4 仍未实装，但社区已讨论将 array_flatten($arr, -1) 视为“无限深度”。可提前封装一层适配逻辑，便于未来升级：
function safe_flatten($array, $depth = -1) {
// 若未来 PHP 原生支持 depth = -1，优先用原生
if ($depth === -1 && function_exists('array_flatten') && version_compare(PHP_VERSION, '8.4.0', '>=')) {
return array_flatten($array, $depth);
}
// 回退到 array_walk_recursive（无键）
if ($depth === -1) {
return array_values(array_walk_recursive($array, function($v) use (&$r) { $r[] = $v; }));
}
// 否则用原生（PHP 8.3+）
return array_flatten($array, $depth);
}
避免常见陷阱
- 不要用 implode + explode 模拟扁平化——会破坏字符串中的分隔符，且无法处理 null/布尔值
- 慎用 eval 或序列化反序列化——安全风险高，性能差，且对 Closure/Resource 等不可序列化类型失败
-
注意引用循环：若数组含自我引用（如
$arr[0] = &$arr），递归函数需加 visited 标记，否则栈溢出 - JSON 编码解码不是扁平化：只是字符串转换，不能替代结构重组
