PHP表格数据导入导出教程详解

PHP 处理 CSV 数据高效且实用。导出步骤包括设置响应头、使用 fputcsv 输出数据、添加 BOM 解决编码问题；导入则通过 fgetcsv 读取并清洗数据后插入数据库；常见问题如乱码加 BOM、字段含逗号用引号包裹、大数据量分批处理、表头不固定动态读取或规范模板。

CSV 文件因为结构简单、通用性强，经常被用来做数据导入导出。PHP 作为常见的后端语言，在处理这类表格数据时非常实用。下面我们就来聊聊在 PHP 中如何高效地处理 CSV 数据。

如何用 PHP 导出数据为 CSV 文件？

导出功能常用于后台管理系统或数据分析平台，把数据库中的数据生成 CSV 文件供用户下载。

基本步骤如下：

• 设置响应头，告诉浏览器这是一个 CSV 文件，并指定下载文件名
• 使用 fputcsv() 函数格式化输出每一行数据
• 注意字段编码问题，避免 Excel 打开乱码（可以加 BOM 头）

header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename=data.csv');

$output = fopen('php://output', 'w');

// 可选：添加 BOM 避免中文乱码
fwrite($output, "\xEF\xBB\xBF");

// 输出表头
fputcsv($output, ['姓名', '年龄', '城市']);

// 假设从数据库取出的数据是 $data
foreach ($data as $row) {
    fputcsv($output, $row);
}

fclose($output);

小提示：如果数据量特别大，建议分批次读取和输出，避免内存占用过高。

如何用 PHP 导入 CSV 文件到数据库？

有时候我们需要让用户上传一个 CSV 文件，然后把里面的数据存进数据库，比如批量导入会员信息、商品列表等。

操作流程大致如下：

1. 接收上传的 CSV 文件
2. 用 fgetcsv() 按行读取内容
3. 清洗数据并插入数据库

if ($_FILES['csv_file']['error'] === UPLOAD_ERR_OK) {
    $file = fopen($_FILES['csv_file']['tmp_name'], 'r');

    // 跳过第一行表头
    fgetcsv($file);

    while (($row = fgetcsv($file)) !== false) {
        list($name, $age, $city) = $row;
        // 插入数据库逻辑
        // mysqli_query($conn, "INSERT INTO users ...");
    }

    fclose($file);
}

注意事项：

• 确保上传的文件确实是 CSV 格式，防止恶意文件上传
• 如果字段中包含逗号或者换行符，要用双引号包裹
• 最好加上字段校验和错误日志记录机制

导入导出常见问题及处理建议

1. 编码问题导致乱码？

• 导出时加入 UTF-8 BOM 头 \xEF\xBB\xBF
• 或者在 Excel 中手动选择正确的编码打开

2. 字段中有逗号怎么办？

• 用双引号包裹该字段内容，例如 "New York, USA"，fputcsv 会自动处理这个逻辑

3. 数据量太大卡顿？

• 分批处理，每次读取一定数量再执行插入
• 可以考虑使用队列任务异步处理

4. 表头不固定怎么处理？

• 动态读取第一行，映射字段名称到数据库字段
• 或者要求用户按照固定模板上传

基本上就这些。CSV 的导入导出虽然看起来简单，但在实际开发中还是有不少细节需要注意，特别是数据格式、编码、安全等方面。只要掌握好 PHP 提供的内置函数，配合一些小技巧，就能轻松应对大多数场景。