PHP读取CSV数据并转换为多维数组的方法

Ruby

发布时间：2026-10-15| 6人浏览过

原创

CSV是常用的Excel格式替代方案，常用于数据导出场景。在处理这类数据时，通常需要将其转换为PHP数组以便进行逻辑操作。本文通过一个具体的类实现，展示如何安全、灵活地读取CSV文件并将其映射为带有键名的二维数组。

实现目标与准备

本方案旨在解决将逗号或分号分隔的文本文件直接导入内存数组的需求。相比简单的字符串分割，该方法能够自动识别第一行作为字段名称（Key），并根据指定条件对结果进行排序，适合处理学生信息、库存列表等结构化数据。

第1步：定义CSV解析类

创建一个名为 csvtoarray 的静态类，包含三个核心方法：

open(): 入口函数，调用解析与排序方法。
csvarray(): 核心解析逻辑，使用 fgetcsv 读取每一行。
ordenamultiarray(): 对解析后的多维数组进行重新排序。

核心代码实现

以下是完整的PHP代码实现。注意代码中使用了 final 关键字防止继承，且内部方法声明为 private 以封装细节。

final class csvtoarray{

    /**
     * 把csv文件解析为一个数组返回
     *
     * @param string $file 要解析的csv文件路径
     * @param char $delimiter csv文件里的内容分隔符 默认为;
     * @return array
     */
    public static function open($file, $delimiter = ';') {
        return self::ordenamultiarray(self::csvarray($file, $delimiter), 1);
    }

    private function csvarray($file, $delimiter) 
    {
        $result = array();
        $size = filesize($file) + 1; // 动态计算缓冲区大小
        $file = fopen($file, 'r');
        $keys = fgetcsv($file, $size, $delimiter); // 读取表头
        fseek($file,0); // 重置指针到文件开头，确保第一行被完整读取进入循环
        while ($row = fgetcsv($file, $size, $delimiter))
        {
            for($i = 0; $i < count($row); $i++)
            {
                if(array_key_exists($i, $keys))
                {
                    $row[$keys[$i]] = $row[$i]; // 添加关联索引，例如 row['学号'] = value
                }
            }
            $result[] = $row;
        }
        fclose($file);
        return $result;
    }
    private function ordenamultiarray($multiarray, $secondindex) 
    {
        while (list($firstindex, ) = each($multiarray))
            $indexmap[$firstindex] = $multiarray[$firstindex][$secondindex];
        asort($indexmap);
        while (list($firstindex, ) = each($indexmap))
        if (is_numeric($firstindex))
            $sortedarray[] = $multiarray[$firstindex];
        else $sortedarray[$firstindex] = $multiarray[$firstindex];
        return $sortedarray;
    }
}

调用与使用示例

假设文件中存储了学生的基本信息，我们可以这样调用上述类：

$info=csvtoarray::open('teste.csv'); 
//echo '';
//print_r($info);
//echo '';
foreach ($info as $c) 
{
    echo '学号：'.$c[0];
    echo '姓名：'.$c[1];
    echo '年龄：'.$c[2];
    echo '身高：'.$c[3].'
';
}