登录
首页 >  文章 >  php教程

PHP导出Excel详细步骤教程

时间：2025-09-24 10:46:45 400浏览 收藏

golang学习网今天将给大家带来《PHP导出Excel完整操作教程》，感兴趣的朋友请继续看下去吧！以下内容将会涉及到等等知识点，如果你是正在学习文章或者已经是大佬级别了，都非常欢迎也希望大家都能给我建议评论哈~希望能帮助到大家！

答案：使用PhpSpreadsheet是PHP导出Excel的首选方案，支持xlsx和csv格式，可通过Composer安装，结合数据库数据写入单元格，设置样式、处理数据类型，并通过header输出文件；对大数据量需采用分批处理、流式写入、异步导出等优化策略以避免内存溢出和超时。

PHP如何实现数据导出Excel_Excel文件导出完整步骤

PHP实现数据导出Excel，最直接且功能强大的方式是依赖成熟的第三方库，尤其是PhpSpreadsheet。它能让你灵活地将数据库数据、数组或其他结构化信息，以各种样式和格式输出为标准的Excel文件，无论是.xlsx还是.csv，都能得到很好的支持。如果你想高效、稳定地处理数据导出，这几乎是现代PHP开发中的首选方案。

解决方案

要实现PHP数据导出Excel，我们主要会用到PhpSpreadsheet这个库。它的安装和使用流程相对直观，即使是处理一些复杂的需求，也能找到对应的API。

首先，你需要通过Composer安装它： composer require phpoffice/phpspreadsheet

安装完成后，基本的导出流程通常包含以下几个步骤：

  1. 引入自动加载文件：

    require 'vendor/autoload.php';

  2. 创建Spreadsheet对象：这是整个Excel文件的容器。

    use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
use PhpOffice\PhpSpreadsheet\Writer\Csv; // 如果需要导出CSV

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();

  3. 写入数据：你可以逐个单元格写入，也可以一次性写入一个数组。

    // 设置表头
$sheet->setCellValue('A1', 'ID');
$sheet->setCellValue('B1', '姓名');
$sheet->setCellValue('C1', '邮箱');

// 假设这是从数据库查询出来的数据
$data = [
    ['id' => 1, 'name' => '张三', 'email' => 'zhangsan@example.com'],
    ['id' => 2, 'name' => '李四', 'email' => 'lisi@example.com'],
    ['id' => 3, 'name' => '王五', 'email' => 'wangwu@example.com'],
];

$row = 2; // 从第二行开始写入数据
foreach ($data as $item) {
    $sheet->setCellValue('A' . $row, $item['id']);
    $sheet->setCellValue('B' . $row, $item['name']);
    $sheet->setCellValue('C' . $row, $item['email']);
    $row++;
}

  4. 设置文件头，强制浏览器下载：这是让浏览器识别为文件下载的关键。

    $filename = '数据导出_' . date('YmdHis') . '.xlsx';
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="' . $filename . '"');
header('Cache-Control: max-age=0');
// 如果是IE浏览器，可能需要额外的头信息
header('Cache-Control: max-age=1');
header('Expires: Mon, 26 Jul 1997 05:00:00 GMT'); // Date in the past
header('Last-Modified: ' . gmdate('D, d M Y H:i:s') . ' GMT'); // always modified
header('Cache-Control: cache, must-revalidate'); // HTTP/1.1
header('Pragma: public'); // HTTP/1.0

  5. 创建写入器并保存/输出文件：

    $writer = new Xlsx($spreadsheet);
$writer->save('php://output'); // 直接输出到浏览器
// 或者 $writer->save('/path/to/your/files/' . $filename); // 保存到服务器
exit;

这个基础框架足以应对大多数数据导出需求。当然，PhpSpreadsheet还提供了丰富的API来处理单元格样式、合并单元格、图片插入、公式计算等，这些都可以根据实际需求进一步探索。

在选择PHP导出Excel库时，除了PhpSpreadsheet，还有哪些值得考虑的替代方案？它们各自的优缺点是什么？

在PHP生态中，除了PhpSpreadsheet，确实还有一些其他的选择，不过它们各自的定位和功能侧重有所不同。对我个人而言，选择一个库往往是权衡功能、性能、维护状态和社区支持的结果。

一个常见的“替代方案”是手动生成CSV文件。

  • 优点：
    • 极简：不需要任何第三方库，直接使用PHP的文件操作函数（fopen, fputcsv）就能实现。
    • 性能优异：对于海量数据，CSV的生成速度和内存占用通常是最低的，因为它只是纯文本写入，没有复杂的XML结构和样式解析。
    • 兼容性好：几乎所有表格软件都能打开CSV文件。
  • 缺点：
    • 功能受限：无法设置单元格样式、字体、颜色、合并单元格、插入图片等。
    • 编码问题：在不同操作系统或软件中打开时，可能会遇到编码识别问题（比如UTF-8的CSV在某些旧版Excel中打开会乱码）。
    • 数据类型不明确：所有数据都被视为文本，长数字可能会被自动转换成科学计数法。

另一个曾经非常流行的库是PHPExcel。

  • 优点：
    • 功能强大：在它的时代，PHPExcel几乎是PHP导出Excel的行业标准，功能非常全面。
  • 缺点：
    • 已停止维护：这是最致命的缺点。PHPExcel在2015年左右就停止了积极开发，不再兼容新的PHP版本（如PHP 7.x+），存在安全隐患和兼容性问题。PhpSpreadsheet正是它的官方继任者。
    • 性能瓶颈：在处理大数据量时，PHPExcel的内存占用和性能表现不如PhpSpreadsheet优化得好。

还有一些更小众的库，或者自行构建XML/HTML表格的方式。

  • 优点：
    • 高度定制：如果你对Excel的内部XML结构有深入了解，或者只需要导出非常简单的HTML表格让Excel打开，这种方式理论上可以实现高度定制。
  • 缺点：
    • 复杂性高：需要对Excel文件格式有非常深入的理解，开发和维护成本极高。
    • 兼容性风险：自行构建的XML/HTML可能在某些Excel版本中无法正确解析。

综合来看，如果只是导出纯数据且不关心样式，CSV是快速且内存友好的选择。但一旦涉及任何格式、样式或更复杂的数据类型处理，PhpSpreadsheet无疑是当前最稳健、功能最全面且持续维护的方案。我通常会建议直接使用PhpSpreadsheet，除非有非常明确的理由（比如极致的性能要求且数据无样式需求）才考虑CSV。

如何优化PHP导出Excel的性能，特别是在处理大量数据时，避免内存溢出和超时问题？

处理大数据量导出Excel是PHP开发中一个常见的痛点，内存溢出（Allowed memory size of X bytes exhausted）和执行超时（Maximum execution time of Y seconds exceeded）几乎是家常便饭。要优化这个问题，需要从多个层面入手，而不仅仅是简单地增加PHP配置限制。

  1. 分批处理与数据流式写入 (Streaming)：

    • PhpSpreadsheet在处理大量数据时，默认会将所有数据加载到内存中。对于百万级别的数据，这很快就会耗尽内存。
    • 一个有效的策略是分批从数据库读取数据，然后逐批写入到Excel中。结合PhpSpreadsheet的setUseDiskCaching(true)方法，可以将部分数据缓存到磁盘而非全部放在内存中。
    • 更高级的做法是利用Writer对象的流式写入能力，但这通常需要对PhpOffice\PhpSpreadsheet\Writer\Xlsx的内部机制有更深的理解。对于.csv格式，fputcsv本身就是流式写入，性能会好很多。
    // 示例：使用磁盘缓存
$writer = new Xlsx($spreadsheet);
$writer->setUseDiskCaching(true); // 开启磁盘缓存
$writer->setDiskCachingDirectory('/tmp'); // 设置缓存目录，确保可写
// ... 写入数据 ...
$writer->save('php://output');

  2. 减少不必要的样式和复杂操作：

    • 每个单元格的样式（字体、颜色、边框、对齐方式）都会增加Excel文件的大小和PhpSpreadsheet处理时的内存消耗。
    • 如果数据量巨大，尽量保持Excel的简洁性，只设置必要的样式，或者只对表头等少量单元格进行样式设置。
    • 合并单元格、插入图片、设置数据验证等操作也都是内存消耗大户，能省则省。

  3. 禁用自动计算和公式预处理：

    • 如果你的Excel中包含大量公式，PhpSpreadsheet默认会尝试预计算这些公式的值。这会消耗大量的CPU和内存。
    • 如果你不需要在导出时就计算出结果，或者希望Excel客户端自己计算，可以禁用此功能：
      $writer->setPreCalculateFormulas(false);

  4. 选择更高效的写入器：

    • 如果你只需要导出纯数据，且不需要任何样式，那么Csv写入器（new Csv($spreadsheet)）会比Xlsx写入器快得多，内存占用也小得多。
    • .xlsx文件本身是一个ZIP压缩包，内部包含复杂的XML结构，处理起来自然比纯文本的CSV更耗资源。

  5. 调整PHP配置限制（辅助手段）：

    • 虽然这不是根本解决方案，但在优化代码之后，适当增加php.ini中的memory_limit（例如512M或1G）和max_execution_time（例如300秒）是必要的。但这不应该成为你解决问题的首要手段，因为无限增加这些值只会掩盖更深层次的性能问题。

  6. 使用队列和异步处理：

    • 对于真正超大数据量的导出（比如数百万行），让用户直接在浏览器等待是不现实的。
    • 最佳实践是采用异步处理：当用户发起导出请求时，将导出任务放入消息队列（如Redis、RabbitMQ），然后由后台的Worker进程去执行导出操作。
    • 文件生成后，可以将下载链接通过邮件、站内信或API回调的方式通知用户。这能极大地提升用户体验，并避免前端超时。

在我看来，优化策略的关键在于“按需加载”和“减少不必要的开销”。对于大数据量，我倾向于先考虑流式写入和异步处理，其次才是精简样式和调整PHP配置。

在PHP导出Excel过程中，如何处理特殊字符、数据类型转换以及复杂表格样式（如合并单元格、图片）的需求？

在数据导出到Excel时，处理特殊字符、确保数据类型正确以及实现复杂的样式是提升用户体验和数据准确性的关键。这些需求PhpSpreadsheet都能很好地支持，但需要一些额外的代码和考量。

特殊字符处理： Excel文件，特别是.xlsx格式，是基于XML的，对UTF-8编码有很好的支持。

  • 核心是确保数据源、PHP脚本、数据库连接以及最终的Excel文件都使用UTF-8编码。 如果你的数据库连接不是UTF-8，或者PHP脚本文件保存为非UTF-8，就可能出现乱码。
  • PhpSpreadsheet通常能直接处理UTF-8编码的字符串，无需额外的iconv或mb_convert_encoding操作。如果你确实遇到乱码，首先检查你的数据源和整个处理链路的编码一致性。
  • 对于一些特殊的XML保留字符（如&, <, >），PhpSpreadsheet会自动进行XML实体编码，所以通常不需要手动处理。

数据类型转换： Excel对数据类型有严格的区分，例如数字、文本、日期等。

  • 长数字显示问题：数据库中的BIGINT或一些商品编码（如EAN码）在Excel中可能被自动转换为科学计数法或丢失精度。
    • 解决方案：将这类单元格的数据类型显式设置为文本。
      use PhpOffice\PhpSpreadsheet\Cell\DataType;
// ...
$sheet->setCellValueExplicit('A1', '1234567890123456', DataType::TYPE_STRING);
// 或者先写入，再设置格式
$sheet->setCellValue('A1', '1234567890123456');
$sheet->getStyle('A1')->getNumberFormat()->setFormatCode(
\PhpOffice\PhpSpreadsheet\Style\NumberFormat::FORMAT_TEXT
);
  • 日期和时间：PhpSpreadsheet可以处理PHP的DateTime对象或Unix时间戳。
    • 解决方案：
      // 将Unix时间戳转换为Excel日期格式
$timestamp = time(); // 例如 1678886400
$excelDate = \PhpOffice\PhpSpreadsheet\Shared\Date::PHPToExcel($timestamp);
$sheet->setCellValue('A1', $excelDate);
$sheet->getStyle('A1')->getNumberFormat()->setFormatCode(
\PhpOffice\PhpSpreadsheet\Style\NumberFormat::FORMAT_DATE_YYYYMMDD
);
// 或者直接写入日期字符串，然后设置格式
$sheet->setCellValue('A2', date('Y-m-d H:i:s'));
$sheet->getStyle('A2')->getNumberFormat()->setFormatCode(
\PhpOffice\PhpSpreadsheet\Style\NumberFormat::FORMAT_DATE_DATETIME
);

复杂表格样式： PhpSpreadsheet提供了丰富的API来控制单元格和区域的样式。

  • 合并单元格：

    $sheet->mergeCells('A1:C1'); // 合并A1到C1的单元格
$sheet->setCellValue('A1', '这是合并后的标题');

  • 设置字体、颜色、边框、对齐方式： 这些通常通过getStyle()方法获取单元格或区域的样式对象，然后应用applyFromArray()或链式调用设置。

    $sheet->getStyle('A1:C1')->applyFromArray([
    'font' => [
        'bold' => true,
        'size' => 14,
        'color' => ['argb' => 'FFFF0000'], // 红色字体
    ],
    'alignment' => [
        'horizontal' => \PhpOffice\PhpSpreadsheet\Style\Alignment::HORIZONTAL_CENTER,
        'vertical' => \PhpOffice\PhpSpreadsheet\Style\Alignment::VERTICAL_CENTER,
    ],
    'borders' => [
        'allBorders' => [
            'borderStyle' => \PhpOffice\PhpSpreadsheet\Style\Border::BORDER_THIN,
            'color' => ['argb' => 'FF000000'],
        ],
    ],
    'fill' => [
        'fillType' => \PhpOffice\PhpSpreadsheet\Style\Fill::FILL_SOLID,
        'startColor' => ['argb' => 'FFDDDDDD'], // 灰色背景
    ],
]);

  • 插入图片：

    $drawing = new \PhpOffice\PhpSpreadsheet\Drawing();
$drawing->setName('Logo');
$drawing->setDescription('Company Logo');
$drawing->setPath('./path/to/your/logo.png'); // 图片路径
$drawing->setHeight(36); // 图片高度
$drawing->setCoordinates('D1'); // 插入到D1单元格
$drawing->setOffsetX(10); // X轴偏移
$drawing->setOffsetY(10); // Y轴偏移
$drawing->setWorksheet($sheet);

  • 设置列宽和行高：

    $sheet->getColumnDimension('A')->setWidth(20); // 固定列宽
$sheet->getColumnDimension('B')->setAutoSize(true); // 自动列宽
$sheet->getRowDimension(1)->setRowHeight(30); // 固定行高

需要注意的是，所有这些样式和复杂操作都会增加PhpSpreadsheet处理时的内存和CPU消耗，以及最终文件的大小。在处理大数据量时，这需要特别权衡，尽量只对必要的区域应用样式，避免过度美化导致性能下降。

到这里，我们也就讲完了《PHP导出Excel详细步骤教程》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于PHP代码优化的知识点！

PHP代码优化
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>