0

0

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

星夢妙者

星夢妙者

发布时间:2025-08-05 17:56:01

|

747人浏览过

|

来源于php中文网

原创

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

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

PHP要实现数据导出Excel,最直接且高效的方法就是借助成熟的第三方库,其中PHPExcel(虽然现在更推荐其继任者PhpSpreadsheet)曾经是,现在依然被许多老项目使用的强大工具。它允许你直接在服务器端生成符合Excel标准的

.xlsx
.xls
文件,而无需依赖客户端的任何Excel软件。简单来说,就是通过代码构建Excel的结构、填充数据、设置样式,然后让浏览器下载这个文件。

解决方案

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

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

立即学习PHP免费学习笔记(深入)”;

composer require phpoffice/phpexcel

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

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的负担。

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

  1. 分批处理(Chunking):这是最直接的办法。如果你的数据量非常大,可以考虑分批从数据库读取数据,然后分批写入Excel。虽然PHPExcel本身没有内置的“流式写入”功能(像PhpSpreadsheet那样),但你可以在每次循环写入一部分数据后,考虑是否需要优化内存使用。不过,对于PHPExcel来说,最有效的“分批”往往意味着生成多个小文件,或者干脆换用更现代的库。
  2. 增加PHP内存限制和执行时间:这是治标不治本的方法,但对于中等规模的数据量(比如几万到十几万行),临时调高
    php.ini
    中的
    memory_limit
    max_execution_time
    确实能解决燃眉之急。例如:
    ini_set('memory_limit', '512M'); // 提高到512MB,甚至更高
    set_time_limit(0); // 设置不限制执行时间

    但请注意,这可能会对服务器资源造成压力。

  3. 简化样式:样式越复杂,内存消耗越大。如果对Excel的格式要求不是特别高,尽量减少不必要的样式设置,只保留核心的数据展示。
  4. 考虑使用PhpSpreadsheet:这是PHPExcel的官方继任者,从设计之初就考虑了大型数据处理的优化。它支持“写入器模式”(Writer Mode),可以流式写入数据,大大降低内存占用。如果你的项目允许,我强烈建议切换到PhpSpreadsheet,这能从根本上解决大部分性能问题。

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

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

狼群淘客 免费开源淘宝客程序
狼群淘客 免费开源淘宝客程序

狼群淘客系统基于canphp框架进行开发,MVC结构、数据库碎片式缓存机制,使网站支持更大的负载量,结合淘宝开放平台API实现的一个淘宝客购物导航系统采用php+mysql实现,任何人都可以免费下载使用 。狼群淘客的任何代码都是不加密的,你不用担心会有任何写死的PID,不用担心你的劳动成果被窃取。

下载
  • 单元格合并(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文件打开后,中文乱码或者文件名乱码。

  1. 文件内容乱码(特别是中文)

    • 原因分析:最常见的原因是你的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,它就能正确处理。
  2. 导出文件名乱码

    • 原因分析:这通常发生在下载文件时,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文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2687

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1663

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1524

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

953

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1420

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1508

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Java JVM 原理与性能调优实战
Java JVM 原理与性能调优实战

本专题系统讲解 Java 虚拟机(JVM)的核心工作原理与性能调优方法,包括 JVM 内存结构、对象创建与回收流程、垃圾回收器(Serial、CMS、G1、ZGC)对比分析、常见内存泄漏与性能瓶颈排查,以及 JVM 参数调优与监控工具(jstat、jmap、jvisualvm)的实战使用。通过真实案例,帮助学习者掌握 Java 应用在生产环境中的性能分析与优化能力。

0

2026.01.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 8.5万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号