当前位置：首页 > 文章列表 > 文章 > php教程 > PHP如何实现数据导出Excel？PHPExcel库应用

PHP如何实现数据导出Excel？PHPExcel库应用

2025-10-17 13:39:13 0浏览收藏

推广推荐

支持 PC / 移动端，安全直达

大家好，今天本人给大家带来文章《PHP如何实现数据导出Excel？PHPExcel库应用》，文中内容主要涉及到，如果你对文章方面的知识点感兴趣，那就请各位朋友继续看下去吧~希望能真正帮到你们，谢谢！

PHPExcel在处理大型数据导出时主要面临内存溢出和执行超时的性能瓶颈，原因是其将所有数据和样式加载到内存中处理；应对方案包括分批处理数据、增加PHP内存限制和执行时间、简化样式设置，或迁移到支持流式写入的PhpSpreadsheet以优化性能；对于复杂样式，可通过合并单元格、设置列宽行高、字体样式、背景填充、边框、数据格式化及插入图片等方式实现；编码问题主要表现为中文内容或文件名乱码，解决方案是确保PHP文件、数据库连接及数据源统一使用UTF-8编码，并对导出文件名根据浏览器类型进行URL编码或Base64编码以实现多浏览器兼容。

PHP如何实现数据导出Excel？PHPExcel库应用

PHP要实现数据导出Excel，最直接且高效的方法就是借助成熟的第三方库，其中PHPExcel（虽然现在更推荐其继任者PhpSpreadsheet）曾经是，现在依然被许多老项目使用的强大工具。它允许你直接在服务器端生成符合Excel标准的.xlsx或.xls文件，而无需依赖客户端的任何Excel软件。简单来说，就是通过代码构建Excel的结构、填充数据、设置样式，然后让浏览器下载这个文件。

解决方案

实现PHP导出Excel的核心步骤，我通常会这样操作：

首先，确保你的项目里安装了PHPExcel。虽然它现在不再维护，但通过Composer安装依然可行：

composer require phpoffice/phpexcel

然后，在你的PHP脚本中，你需要引入必要的类，创建一个新的Excel对象，填充数据，最后设置HTTP头信息让浏览器识别并下载文件。

<?php
// 引入Composer的自动加载文件
require_once 'vendor/autoload.php';

use PHPExcel;
use PHPExcel_IOFactory;
use PHPExcel_Style_Alignment;
use PHPExcel_Style_Border;
use PHPExcel_Style_Fill;

// 假设这是你要导出的数据，通常来自数据库查询
$data = [
    ['ID', '姓名', '年龄', '城市'],
    [1, '张三', 30, '北京'],
    [2, '李四', 25, '上海'],
    [3, '王五', 35, '广州'],
    [4, '赵六', 28, '深圳'],
];

// 创建一个新的PHPExcel对象
$objPHPExcel = new PHPExcel();

// 设置文档属性
$objPHPExcel->getProperties()->setCreator("你的名字")
                             ->setLastModifiedBy("你的名字")
                             ->setTitle("用户数据导出")
                             ->setSubject("用户数据")
                             ->setDescription("这份Excel包含了系统中的用户数据。")
                             ->setKeywords("excel php 用户 数据")
                             ->setCategory("报告");

// 获取当前活动的工作表，默认是第一个
$objPHPExcel->setActiveSheetIndex(0);
$activeSheet = $objPHPExcel->getActiveSheet();

// 填充数据到工作表
// 我个人习惯用循环来处理数据，这样比较灵活
$rowNum = 1; // 从第一行开始
foreach ($data as $rowData) {
    $colNum = 'A'; // 从A列开始
    foreach ($rowData as $cellData) {
        $activeSheet->setCellValue($colNum . $rowNum, $cellData);
        $colNum++; // 移动到下一列
    }
    $rowNum++; // 移动到下一行
}

// 示例：设置表头样式 (第一行)
$activeSheet->getStyle('A1:D1')->applyFromArray(
    array(
        'font' => array(
            'bold' => true, // 粗体
            'color' => array('rgb' => 'FFFFFF'), // 白色字体
        ),
        'fill' => array(
            'type' => PHPExcel_Style_Fill::FILL_SOLID,
            'color' => array('rgb' => '4F81BD') // 蓝色背景
        ),
        'alignment' => array(
            'horizontal' => PHPExcel_Style_Alignment::HORIZONTAL_CENTER, // 水平居中
        ),
        'borders' => array(
            'allborders' => array(
                'style' => PHPExcel_Style_Border::BORDER_THIN, // 细边框
                'color' => array('rgb' => 'DDDDDD')
            )
        )
    )
);

// 自动调整列宽，让内容显示更完整
foreach(range('A','D') as $columnID) {
    $activeSheet->getColumnDimension($columnID)->setAutoSize(true);
}


// 设置文件名和HTTP头信息
$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'); // 不缓存

// 写入文件到输出流
$objWriter = PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel2007'); // 指定生成xlsx格式
$objWriter->save('php://output'); // 直接输出到浏览器

// 销毁对象，释放内存
$objPHPExcel->disconnectWorksheets();
unset($objPHPExcel);

exit; // 确保脚本在此处停止执行，避免输出其他内容干扰Excel文件
?>

PHPExcel在大型数据导出时会遇到哪些性能瓶颈？

说实话，PHPExcel在处理海量数据时，确实会暴露出一些性能问题，这是它设计上的一个局限性。我遇到过最常见的就是内存溢出（Allowed memory size of X bytes exhausted）和执行超时。

这主要是因为PHPExcel在生成Excel文件时，会将所有数据和样式信息全部加载到内存中进行处理。当你的数据集达到几十万甚至上百万行时，内存消耗会急剧增加。此外，复杂的样式、合并单元格等操作也会进一步加剧内存和CPU的负担。

要应对这些问题，我通常会考虑几个方案：

分批处理（Chunking）：这是最直接的办法。如果你的数据量非常大，可以考虑分批从数据库读取数据，然后分批写入Excel。虽然PHPExcel本身没有内置的“流式写入”功能（像PhpSpreadsheet那样），但你可以在每次循环写入一部分数据后，考虑是否需要优化内存使用。不过，对于PHPExcel来说，最有效的“分批”往往意味着生成多个小文件，或者干脆换用更现代的库。
增加PHP内存限制和执行时间：这是治标不治本的方法，但对于中等规模的数据量（比如几万到十几万行），临时调高php.ini中的memory_limit和max_execution_time确实能解决燃眉之急。例如：
```
ini_set('memory_limit', '512M'); // 提高到512MB，甚至更高
set_time_limit(0); // 设置不限制执行时间
```
但请注意，这可能会对服务器资源造成压力。
简化样式：样式越复杂，内存消耗越大。如果对Excel的格式要求不是特别高，尽量减少不必要的样式设置，只保留核心的数据展示。
考虑使用PhpSpreadsheet：这是PHPExcel的官方继任者，从设计之初就考虑了大型数据处理的优化。它支持“写入器模式”（Writer Mode），可以流式写入数据，大大降低内存占用。如果你的项目允许，我强烈建议切换到PhpSpreadsheet，这能从根本上解决大部分性能问题。

除了基础数据，如何实现更复杂的Excel样式和格式化？

PHPExcel提供了非常丰富的API来控制Excel的样式和格式。我个人在做报表导出时，经常会用到以下一些高级功能：

单元格合并（Merge Cells）：这在制作标题行或汇总行时非常有用。

$activeSheet->mergeCells('A1:D1'); // 合并A1到D1的单元格
$activeSheet->setCellValue('A1', '这是一个合并的标题');

设置列宽和行高：虽然setAutoSize(true)很方便，但有时候我们需要固定列宽或行高。

$activeSheet->getColumnDimension('A')->setWidth(20); // 设置A列宽度为20
$activeSheet->getRowDimension(1)->setRowHeight(30); // 设置第一行行高为30

字体样式（Font Styles）：改变字体、大小、颜色、粗体、斜体、下划线等。

$activeSheet->getStyle('A1')->getFont()->setBold(true); // 粗体
$activeSheet->getStyle('A1')->getFont()->setSize(14);   // 字号
$activeSheet->getStyle('A1')->getFont()->setColor(new PHPExcel_Style_Color(PHPExcel_Style_Color::COLOR_RED)); // 红色字体

背景填充（Fill Color）：给单元格或区域设置背景色。

$activeSheet->getStyle('A2:D2')->getFill()->setFillType(PHPExcel_Style_Fill::FILL_SOLID);
$activeSheet->getStyle('A2:D2')->getFill()->getStartColor()->setARGB('FFE0E0E0'); // 浅灰色背景

边框（Borders）：为单元格添加各种边框，比如实线、虚线、粗线等。

$styleArray = array(
    'borders' => array(
        'outline' => array( // 外边框
            'style' => PHPExcel_Style_Border::BORDER_THICK,
            'color' => array('argb' => 'FF000000'),
        ),
        'inside' => array( // 内部边框
            'style' => PHPExcel_Style_Border::BORDER_DOTTED,
            'color' => array('argb' => 'FF808080'),
        ),
    ),
);
$activeSheet->getStyle('A1:D5')->applyFromArray($styleArray);

数据格式（Number Format）：将数字显示为货币、百分比、日期等特定格式。

// 设置A列为货币格式
$activeSheet->getStyle('A')->getNumberFormat()->setFormatCode(PHPExcel_Style_NumberFormat::FORMAT_CURRENCY_USD_SIMPLE);
// 设置B列为日期格式
$activeSheet->getStyle('B')->getNumberFormat()->setFormatCode(PHPExcel_Style_NumberFormat::FORMAT_DATE_YYYYMMDD);

图片插入：虽然不常用，但PHPExcel也能在工作表中插入图片。

$gdImage = imagecreatefromjpeg('path/to/your/image.jpg'); // 需要GD库支持
$objDrawing = new PHPExcel_Worksheet_MemoryDrawing();
$objDrawing->setName('Logo');
$objDrawing->setDescription('Logo');
$objDrawing->setImageResource($gdImage);
$objDrawing->setRenderingFunction(PHPExcel_Worksheet_MemoryDrawing::RENDERING_JPEG);
$objDrawing->setMimeType(PHPExcel_Worksheet_MemoryDrawing::MIMETYPE_JPEG);
$objDrawing->setHeight(36); // 设置高度
$objDrawing->setCoordinates('E1'); // 放置在E1单元格
$objDrawing->setWorksheet($activeSheet);

这些功能的组合使用，可以让你导出的Excel文件看起来非常专业和规范。

导出Excel时常见的编码问题及解决方案是什么？

编码问题在PHP导出Excel时确实是老生常谈了，我遇到过不少次，尤其是在处理中文数据时。主要表现就是导出的Excel文件打开后，中文乱码或者文件名乱码。

文件内容乱码（特别是中文）：
- 原因分析：最常见的原因是你的PHP脚本、数据库连接或者数据源本身的编码不是UTF-8，或者在传递给PHPExcel之前没有正确转换为UTF-8。Excel（特别是新版本）对UTF-8编码支持良好，但如果数据源是GBK或其他编码，而你直接传给PHPExcel，就可能出现问题。
- 解决方案：
  - 统一编码：确保你的PHP文件本身保存为UTF-8编码（不带BOM）。
  - 数据库连接编码：如果你从数据库读取数据，确保数据库连接的编码设置为UTF-8。例如，对于MySQL，可以在连接后执行mysqli_set_charset($conn, 'utf8mb4');或SET NAMES utf8mb4;。
  - 数据转码：如果你的数据源（比如一个外部API返回的字符串）不是UTF-8，你需要在使用前将其转换为UTF-8。iconv()或mb_convert_encoding()函数是你的好帮手。
```
// 假设 $str 是GBK编码的字符串
$str = mb_convert_encoding($str, 'UTF-8', 'GBK');
```
  - PHPExcel内部处理：PHPExcel本身是支持UTF-8的，只要你传入的数据是正确的UTF-8，它就能正确处理。

导出文件名乱码：

原因分析：这通常发生在下载文件时，HTTP头中的Content-Disposition字段的filename参数没有正确编码。不同的浏览器对这个参数的编码解析方式可能不同，尤其是在处理非ASCII字符（如中文）时。

解决方案：

URL编码：最保险的做法是对文件名进行URL编码。但是，有些浏览器可能不完全支持RFC 2231（用于处理非ASCII字符的filename*参数）。

// 简单粗暴但有时有效的处理方式
$filename = urlencode('用户数据_' . date('YmdHis') . '.xlsx');
header('Content-Disposition: attachment;filename="' . $filename . '"');

多浏览器兼容处理：为了更好的兼容性，我通常会根据用户代理（User-Agent）来判断浏览器类型，然后采用不同的编码策略。

$filename = '用户数据_' . date('YmdHis') . '.xlsx';
$encoded_filename = urlencode($filename); // 默认URL编码

// 针对不同浏览器进行编码处理
$ua = $_SERVER["HTTP_USER_AGENT"];
if (preg_match("/MSIE/", $ua)) {
    // IE浏览器
    $encoded_filename = urlencode($filename);
} else if (preg_match("/Firefox/", $ua)) {
    // Firefox浏览器
    $encoded_filename = "=UTF-8?B?".base64_encode($filename)."?=";
} else {
    // 其他浏览器，如Chrome, Safari
    $encoded_filename = urlencode($filename);
}

header('Content-Disposition: attachment;filename="' . $encoded_filename . '"');

这种方式虽然看起来有点复杂，但在实际项目中能大大减少文件名乱码的投诉。

总的来说，处理编码问题，核心思想就是确保从数据源到PHP处理，再到最终输出的整个链路上，编码始终保持一致且正确，尤其要关注UTF-8。

理论要掌握，实操不能落！以上关于《PHP如何实现数据导出Excel？PHPExcel库应用》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！

php Excel导出