PHP8.4 多维数组扁平化，array_flatten 递归拆解多层数组实现方案-php教程-PHP中文网

php 8.4尚未发布，当前array_flatten仅支持指定深度；需递归扁平化时，推荐用array_walk_recursive提取标量值，或自定义函数保留键名，也可封装适配未来-1深度语义。

php8.4 多维数组扁平化，array_flatten 递归拆解多层数组实现方案

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']

⚠️ 注意：该方法丢失原始键名，且不保留非标量结构（如子数组、对象）。适合纯数据提取场景。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

手动递归 + 键名保留（支持关联键与数字键）

若需维持键路径（如转为点号分隔键：'user.profile.name'）或区分键类型，推荐自定义递归函数：

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);
}