PHP项目怎么实现数据导出？

wen PHP项目 2026-06-11 9

本文目录导读：

PHP项目怎么实现数据导出？

方法一：导出为 CSV 文件（推荐，简单高效）
方法二：导出为 Excel (.xlsx) 文件
方法三：大数据量导出优化（防止内存溢出）
常见问题与解决方案
选择建议
安全注意事项

在PHP项目中实现数据导出，最常见的方式是导出为 CSV 和 Excel 文件，以下是几种主流且实用的实现方案,包含代码示例和关键注意事项。

核心思路

生成数据：从数据库或API获取需要导出的数据。
设置HTTP头：告诉浏览器下载文件,而不是直接显示。
输出文件内容：按格式（CSV/Excel）输出内容。
释放资源：关闭数据库连接、清理内存。

导出为 CSV 文件（推荐，简单高效）

CSV 是通用格式，几乎任何表格软件（Excel、WPS）都可打开，内存占用小,适合大数据量导出。

<?php
// 假设从数据库获取数据
function fetchData() {
    return [
        ['ID', '姓名', '邮箱', '注册时间'],
        [1, '张三', 'zhangsan@example.com', '2024-01-15'],
        [2, '李四', 'lisi@example.com', '2024-02-20'],
        [3, '王五', 'wangwu@example.com', '2024-03-10'],
    ];
}
// 导出 CSV
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="users_export_' . date('YmdHis') . '.csv"');
// 打开输出流（直接输出到浏览器）
$output = fopen('php://output', 'w');
// 写入 BOM 头（解决 Excel 打开UTF-8 CSV乱码问题）
fprintf($output, chr(0xEF) . chr(0xBB) . chr(0xBF));
$data = fetchData();
foreach ($data as $row) {
    fputcsv($output, $row);
}
fclose($output);
exit;
?>

优点：无需第三方库，内存占用低，适合百万级数据。
缺点：样式单一,不支持复杂格式。

导出为 Excel (.xlsx) 文件

推荐使用 PhpSpreadsheet（官方推荐取代废弃的 PHPExcel）。

安装 PhpSpreadsheet

composer require phpoffice/phpspreadsheet

导出代码示例

<?php
require 'vendor/autoload.php';
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
// 创建 Spreadsheet 对象
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
// 准备数据（假设来自数据库）
$headers = ['ID', '姓名', '邮箱', '注册时间'];
$data = [
    [1, '张三', 'zhangsan@example.com', '2024-01-15'],
    [2, '李四', 'lisi@example.com', '2024-02-20'],
    [3, '王五', 'wangwu@example.com', '2024-03-10'],
];
// 写入表头
$col = 1;
foreach ($headers as $header) {
    $sheet->setCellValueByColumnAndRow($col, 1, $header);
    $col++;
}
// 写入数据
$rowIndex = 2;
foreach ($data as $row) {
    $col = 1;
    foreach ($row as $value) {
        $sheet->setCellValueByColumnAndRow($col, $rowIndex, $value);
        $col++;
    }
    $rowIndex++;
}
// 设置 HTTP 头
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment; filename="users_export_' . date('YmdHis') . '.xlsx"');
header('Cache-Control: max-age=0');
// 写入输出
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;
?>

优点：支持样式、公式、多Sheet、图表。
缺点：大数据量下内存占用较高（可使用 Xlsx::setPreCalculateFormulas(false) 和分批次写入优化）。

大数据量导出优化（防止内存溢出）

当数据超过几万行时，以上直接读取全部数据到数组可能会撑爆内存，推荐使用 生成器 + 流式写入。

CSV 流式导出（百万级数据可用）

<?php
header('Content-Type: text/csv; charset=utf-8');
header('Content-Disposition: attachment; filename="large_export.csv"');
$output = fopen('php://output', 'w');
fprintf($output, chr(0xEF) . chr(0xBB) . chr(0xBF));
// 假设有一个数据库查询，使用游标/分页方式
$pdo = new PDO('mysql:host=localhost;dbname=test', 'root', '');
$stmt = $pdo->prepare('SELECT id, name, email, created_at FROM users');
$stmt->execute();
// 逐行写入，不一次性加载所有数据
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
    fputcsv($output, $row);
}
fclose($output);
exit;
?>

使用 PhpSpreadsheet 的 Xlsx 流式写入（需要自定义）

PhpSpreadsheet 官方不直接支持流式写入大数据，但可以通过 批量添加+清空单元格 或改用 CSV 解决，对于超大数据（10万行以上），建议优先用 CSV。

常见问题与解决方案

问题	原因	解决
Excel打开CSV乱码	UTF-8 无 BOM	输出前加 `fprintf($output, chr(0xEF) . chr(0xBB) . chr(0xBF));`
Excel显示科学计数法（长数字）	数字超过15位	输出时强制为字符串： . $value 或设列格式为文本
导出超时	数据量大	增加 `set_time_limit(0);`
内存耗尽	一次性加载所有数据	使用游标或分页逐行处理
PhpSpreadsheet内存占用高	缓存单元格对象	设置 `$spreadsheet->disconnectWorksheets();` 或改用 CSV