17370845950

PHP二维数组转一维不能仅用array_merge(...$arr)，因其仅扁平化一层、丢键名、遇非索引数组报错；推荐array_walk_recursive()提值，或手写递归拼键名，避免JSON+正则等不可靠方案。

PHP 二维数组转一维，不能只用 array_merge(...$arr) 硬展开——它对三层及以上直接失效，还会丢键名、报 Warning。

为什么 array_merge(...$arr) 在深层嵌套下会出错

这个写法本质是「扁平化一层」：它把数组的每个子项当作一个参数传给 array_merge，仅适用于「所有子项都是索引一维数组」的严格二维场景。

常见错误现象：

• 遇到 ['a' => ['x' => 1]]，array_merge(...$arr) 报 Warning: array_merge(): Argument #1 is not an array
• 遇到 [[1,2], [3, [4,5]]]，结果变成 [1,2,3,[4,5]]，第四层没动
• 键名丢失：['k' => [1,2]] 展开后变成 [0 => 1, 1 => 2]，原始 'k' 消失

用 array_walk_recursive() 最快降维（保留值，丢弃键路径）

这是 PHP 原生最轻量的递归展平方案，只提取叶子节点的值，不关心层级和键名。

实操建议：

• 适用场景：你只想要所有最终值（比如收集全部 ID、全部字符串），不关心它们原来在哪层、叫什么键
• 它自动跳过函数、对象、资源，安全；但也会跳过空数组（因为空数组没有“叶子”）
• 别试图用它保留键路径——它压根不提供父键信息

示例：

$arr = ['a' => [1, 'b' => [2, 3]], 'c' => [[4], 5]];
$result = [];
array_walk_recursive($arr, function($v) use (&$result) {
    $result[] = $v;
});
// $result === [1, 2, 3, 4, 5]

手写递归函数控制键名与结构（推荐用于 API 返回降维）

当你要把 ['user' => ['profile' => ['name' => 'A']]] 变成 ['user_profile_name' => 'A']，就必须自己遍历并拼键名。

关键点：

• 必须传引用参数保存结果，或 return 合并后的数组（避免反复 copy 大数组）
• 用 is_array() 判断是否继续递归，别用 isset($v['xxx']) 之类误判
• 键名拼接建议用 $prefix . '_' . $key，但注意空字符串前缀、数字键（如 0）要不要参与拼接
• 性能敏感时，避免在递归里做 array_merge()，改用 $result[$newKey] = $value 直接赋值

简短示例（下划线拼接，跳过数字键）：

function flattenWithKeys(array $arr, string $prefix = '', array &$result = []): array {
    foreach ($arr as $key => $value) {
        $newKey = $prefix === '' ? (is_string($key) ? $key : '') : $prefix . '_' . $key;
        if (is_array($value)) {
            flattenWithKeys($value, $newKey, $result);
        } else {
            if ($newKey !== '') $result[$newKey] = $value;
        }
    }
    return $result;
}

用 json_encode + 正则不是好主意

网上有「转 JSON → 正则匹配引号内值」的野路子，看似能绕过递归，实际问题一堆：

• 字符串里含双引号、反斜杠、Unicode 会破坏 JSON 结构，正则直接抓错
• 数字、null、布尔值会被当成字符串提取，类型丢失
• 无法区分同名键在不同层级（比如两个 "id"，你不知道哪个是用

  

  户 ID、哪个是订单 ID）
• 比原生递归慢至少 3 倍，且内存占用翻倍

除非你处理的是已知干净、无嵌套字符串的纯数字配置，否则别碰。

深层嵌套降维真正的难点不在“怎么写递归”，而在于明确你要保留什么：是只要值？要带路径的键？还是需要按某种规则过滤中间层？没想清这点，代码越写越像补丁。