foreach是PHP中二维数组转一维最直接可控的方式:初始化空数组$flat=[],外层遍历子数组,内层用$flat[]=$item追加元素;避免循环内array_merge导致O(n²)性能问题,注意处理不规则结构与键名拼接。

foreach 二维数组转一维:最直接的写法
PHP 中没有内置函数能直接“降维”二维数组,foreach 是最可控、最易调试的方式。关键不是嵌套循环本身,而是你是否在每次内层遍历中把元素正确追加到目标一维数组里。
常见错误是用 = 覆盖而不是 => 追加,或误用 array_merge() 在循环内反复调用导致性能下降。
- 用空数组初始化结果:
$flat = []; - 外层
foreach ($arr as $sub)遍历每个子数组 - 内层
foreach ($sub as $item)取出每个值,直接$flat[] = $item; - 避免在内层用
$flat = array_merge($flat, $sub);—— 每次都复制整个数组,O(n²) 复杂度
保留键名?注意 foreach 的键值对处理
如果原始二维数组有有意义的键(比如 ['user' => ['id' => 1], 'profile' => ['name' => 'A']]),直接扁平会丢失上下文。这时候不能只取值,得构造新键名。
典型做法是拼接键路径,例如 user_id、profile_name。但要注意:原数组可能混合数字键和字符串键,is_string($key) 得先判断。
立即学习“PHP免费学习笔记(深入)”;
- 外层循环用
foreach ($arr as $outerKey => $sub) - 内层用
foreach ($sub as $innerKey => $value) - 拼键:
$flat[$outerKey . '_' . $innerKey] = $value; - 若某层是数字键(如
[0 => ['a'=>1]]),拼出来会是0_a,需按业务决定是否跳过或重命名
遇到 Notice: Array to string conversion 怎么办
这个错误几乎总是因为某个“二维数组”的“子项”其实还是数组(即实际是三维),而你在内层 foreach 里把它当标量用了,比如写了 echo $item; 或 $flat[] = $item . '';。
不是所有“二维”都干净。真实数据常有不规则结构:有的子项是数组,有的是字符串,有的是 null。
- 加类型判断:
if (is_array($item)) { /* 递归或跳过 */ } else { $flat[] = $item; } - 用
array_filter($sub, 'is_scalar')先清理子数组再遍历 - 调试时加
var_dump(gettype($item), $item);确认结构,别假设
性能敏感场景:别在 foreach 里做 array_merge
有人习惯这么写:$flat = array_merge($flat, $sub); 放在循环里。PHP 每次调用 array_merge 都要重新分配内存、拷贝全部已有元素,子数组越多越慢。
实测:1000 个子数组,每个 10 个元素,用 $flat[] = $item 耗时约 0.8ms;用循环内 array_merge 耗时超过 120ms。
- 坚持用
$flat[] = $value;—— 这是 PHP 数组追加的最优路径 - 如果必须用
array_merge,等所有子数组收集完再一次性合并:$flat = array_merge(...$allSubArrays);(PHP 5.6+) -
...$allSubArrays要求$allSubArrays是二维数组,且每个子项本身是一维
真正卡住人的往往不是语法,而是数据不规整——比如某条记录缺字段、某处多嵌了一层、null 混在中间。写之前先 print_r(array_slice($arr, 0, 3)); 看三行样本,比硬写逻辑更省时间。











