PHP 数组替换键名：从关联数组转索引数组的方法

背景与目标

在使用 Yii 等框架进行数据库操作时，查询结果默认返回带有数据库字段名作为键名的关联数组。这种数据结构虽然语义清晰，但在某些特定场景下（如将数据批量写入固定列宽的 Excel 表格、解析 CSV 文件或非结构化存储）并不适用。我们需要一种方法来：

1. 去除字符串键名：将每一行数据转换为以数字 0, 1, 2... 为键名的索引数组。
2. 提取标准表头：单独保留第一行的键名，用于生成输出文件的表头。

核心操作步骤

第一步：理解数据现状与转换需求

假设我们有一个简单的二维关联数组 $data，其结构如下：

$data = [
    ['id' => 1, 'name' => '张三', 'age' => 25],
    ['id' => 2, 'name' => '李四', 'age' => 30],
];
// 期望输出结构：
// title: ['id', 'name', 'age']
// cells: [[1, '张三', 25], [2, '李四', 30]]

第二步：处理数据体 - 移除键名

对于数据中的每一行，我们需要获取所有的“值”并重新排列。在 PHP 中，可以使用内置函数 array_values()。该函数的作用是接收一个数组，并返回一个新的数组，其中所有的键名被重置为从 0 开始的数字索引。

• 功能：忽略原有键名，仅保留值并按顺序重组。
• 入口：遍历原数据数组的每一个子数组。

第三步：提取表头 - 获取旧键名

为了保持数据的可读性，通常需要单独保存原始的字段的键名（即 Excel 的列名）。我们可以直接读取数组中第一行的所有键名。

• 功能：返回数组的所有键名组成的新数组。
• 入口：array_keys($data[0])。

第四步：组合封装为标准结构

将上述两步的结果整合为一个返回数组。以下代码展示了针对此类场景优化的处理方法：

<?php
/**
 * @param array $data 二维关联数组（通常来自数据库查询）
 * @return array 包含表头(excel_title)和数据体(excel_cells)的结构化数组
 */
public function excelDataFormat($data)
{
    // 1. 初始化存储容器
    $new_arr = [];
    
    // 2. 遍历所有数据行，将关联键名转换为数字索引
    if (!empty($data)) {
        foreach ($data as $row) {
            // array_values 移除键名，返回纯值列表
            $new_arr[] = array_values($row);
        }
        
        // 3. 提取第一行的键名作为表头
        // 确保至少有一行数据以防止报错
        $title = array_keys($data[0]);
    } else {
        $title = [];
    }
    
    // 4. 返回规范化后的结构
    return [
        'excel_title' => $title,
        'excel_cells' => $new_arr
    ];
}
?>

完成判断与注意事项

• 空数据安全：在实际工程中，需对空数组或非标准二维结构做防御性编程（如上面代码所示的判断），避免因读取不存在的索引而引发 Notice 错误。
• 性能考量：如果数据量极大，上述基于 PHP `foreach` 循环的处理方式效率较高且内存占用可控。若依赖框架 ORM 层输出，建议在模型层级统一处理，而非每次查询后手动过滤。
• 扩展应用：此方法不仅适用于 Excel 导出，也适用于需要纯数值输入的前端表单提交或 API 接口对接。

以上就是PHP数组替换键名的详细内容，更多关于PHP数组处理和Excel数据导出的资料请关注本站其它相关文章！