PHP利用fputcsv将MySQL数据导出为Excel文件

核心原理与准备条件

fputcsv 是PHP内置用于格式化字符串为CSV（逗号分隔值）文件的函数。由于Microsoft Excel原生支持打开CSV文件并将其识别为电子表格，我们只需正确设置HTTP响应头，即可将CSV内容作为Excel附件下载。为了应对大数据库表的导出需求，必须避免将 SELECT 结果一次性全部读入内存，而应采用游标或流式读取的方式，配合输出缓冲区的定期刷新来完成传输。

第1步：配置HTTP响应头

在开始写入之前，首先需要向浏览器发送标准的HTTP头部信息，告知其即将接收的是二进制文件下载，而非网页文本。

1. 内容类型：设置为 application/vnd.ms-excel，强制浏览器将其解析为Excel文档。
2. 内容处置：设置 attachment 模式并指定文件名，例如 user.csv，这将触发浏览器的“另存为”对话框。
3. 缓存控制：设置 Cache-Control: max-age=0，防止浏览器缓存该动态生成的文件，确保每次请求都获取最新数据。

// 设定文件下载头，文件名可根据实际需求修改
header('Content-Type: application/vnd.ms-excel');
header('Content-Disposition: attachment;filename="user.csv"');
header('Cache-Control: max-age=0');

第2步：建立数据库连接并执行查询

构建SQL查询语句并执行。关键在于不要使用会立即返回所有行的查询模式，而是保持资源句柄处于可逐行读取的状态。这里假设使用的是PDO或类似能返回Statement对象的数据库驱动。

$sql = 'SELECT name, gender, age, email, phone FROM users';
$stmt = $db->query($sql); // 此处应替换为你实际使用的数据库连接对象

第3步：初始化输出流与表头写入

打开 php://output 流，这是一个特殊的PHP封装协议，允许程序直接向Web服务器的输出缓冲区写入内容，从而绕过本地磁盘IO，提高传输效率。同时，需要定义好每一列对应的中文表头。

// 创建指向浏览器输出的文件句柄
$fp = fopen('php://output', 'a');

// 定义CSV列名表头
$head = array('姓名', '性别', '年龄', 'Email', '电话');

// 编码转换：CSV/Excel通常在GBK环境下表现最佳，需将UTF-8转为GBK
foreach ($head as $i => $v) {
    $head[$i] = iconv('UTF-8', 'GBK//IGNORE', $v);
}

// 写入第一行表头
fputcsv($fp, $head); 
flush();

第4步：流式读取并分批写入数据

这是节省内存的核心环节。遍历结果集，每处理一定数量的数据（如10万条），就强制清空输出缓冲区并刷新网络层。这样做可以防止因为单次输出数据过大而导致服务器超时或内存限制错误。

$limit = 100000; // 刷新频率，根据服务器性能调整
$cnt = 0;

while ($row = $stmt->fetch(PDO::FETCH_NUM)) { // 根据你的DB类调整fetch方法
    // 计数器归零判断
    if ($cnt > 0 && $cnt % $limit == 0) {
        ob_flush(); // 刷新PHP内部输出缓冲区
        flush();    // 刷新Web服务器输出缓冲区
    }
    
    // 同样需要对数据进行编码转换以防乱码
    foreach ($row as $i => $v) {
        $row[$i] = iconv('UTF-8', 'GBK//IGNORE', $v);
    }
    
    // 将当前行数据写入流
    fputcsv($fp, $row);
    $cnt++;
}

第5步：收尾清理

虽然 fputcsv 会自动添加换行符，但在循环结束后，最好再次调用 flush() 确保最后的数据包完全发送到客户端，然后关闭文件句柄释放资源。

// 确保最后部分数据已发送
ob_flush();
flush();
fclose($fp);

优势总结与注意事项

• 极低内存占用：此方法只维持当前一行数据的内存状态，即使导出千万级数据，内存消耗也几乎恒定不变。
• 无外部依赖：不依赖 Composer 包或庞大的类库，脚本轻量，部署简单。
• 编码兼容性：务必注意字符集转换。如果数据库是 UTF-8 而 Excel 在中国大陆环境默认使用 GBK，必须显式进行 iconv 转换，否则会出现乱码。

以上就是利用 PHP fputcsv 将 MySQL 数据导出为 Excel 文件的详细内容，更多关于 PHP 大数据量处理及数据库交互的资料请关注本站其它相关文章！