将嵌套关联数组按索引“转置”为结构化记录数组-php教程-PHP中文网

将嵌套关联数组按索引“转置”为结构化记录数组

本文介绍如何将键为字段名、值为同长度数值数组的嵌套关联数组，高效转换为以索引为行、字段为键的结构化二维数组（即“列转行”），适用于表单提交、csv导入等场景。

本文介绍如何将键为字段名、值为同长度数值数组的嵌套关联数组，高效转换为以索引为行、字段为键的结构化二维数组（即“列转行”），适用于表单提交、csv导入等场景。

在 PHP 开发中，我们常遇到类似表单批量提交或 Excel 导入后生成的「列式结构」数组：每个键（如 id、qty）对应一个一维数值数组，且所有子数组长度一致。但业务逻辑通常需要「行式结构」——即每个元素是一个完整记录（如第 0 行代表 id=1, qty=1, price=364.41...）。这种转换本质上是数组的按索引转置（transpose by index），而非简单的扁平化。

以下是一种清晰、健壮且无需依赖外部函数的实现方式：

<?php // 原始嵌套关联数组（列式）
$mainArray = [
    'id'     => [1, 2],
    'qty'    => [1, 1],
    'price'  => [364.41, 300],
    'amount' => [364.41, 300]
];

// 初始化结果数组
$collection = [];

// 利用任意一个字段数组（如 'id'）作为主索引遍历
foreach ($mainArray['id'] as $index => $idValue) {
    // 为当前索引创建新记录
    $collection[$index] = ['id' => $idValue];

    // 遍历所有字段名（'id', 'qty', 'price', 'amount'）
    foreach (array_keys($mainArray) as $field) {
        // 跳过已显式设置的 'id'（避免重复赋值），其余字段直接按索引取值
        if ($field !== 'id') {
            $collection[$index][$field] = $mainArray[$field][$index];
        }
    }
}

print_r($collection);
?>

✅ 输出结果：

Array
(
    [0] => Array
        (
            [id] => 1
            [qty] => 1
            [price] => 364.41
            [amount] => 364.41
        )
    [1] => Array
        (
            [id] => 2
            [qty] => 1
            [price] => 300
            [amount] => 300
        )
)

⚠️ 注意事项与最佳实践：

前提条件：所有子数组必须长度一致，否则会触发 Notice: Undefined offset。建议在循环前校验：

$length = count($mainArray['id']);
foreach ($mainArray as $values) {
    if (count($values) !== $length) {
        throw new InvalidArgumentException('All sub-arrays must have the same length.');
    }
}

更通用写法（推荐）：若字段名不确定或需动态处理，可先获取首个有效键（非空数组）作为基准：

$firstKey = key($mainArray);
$length = count($mainArray[$firstKey]);
for ($i = 0; $i  $values) {
        $collection[$i][$field] = $values[$i] ?? null;
    }
}