简介PHPExcel-1.8.zip是一份面向PHP开发者的Excel处理组件完整源码包源于开源项目PHPExcel 1.8版本提供读写XLS、XLSX等常见格式的类库适用于数据导入导出、报表生成、批量格式化、公式运算等Web开发场景既适合刚接触PHPExcel的初学者学习核心API也能作为现有项目的集成参考。压缩包共581个文件约4.98MB以340个php核心类文件为主体同时包含81个xlsx示例工作簿、37个md说明文档、31个png示意图以及config、functions、txt、xls、doc、csv等配置与辅助文件覆盖源码、样例、文档和测试资源目录结构清晰。已有305人浏览学习。借助其中的类库与示例开发者可快速掌握创建工作簿、读取与写入单元格、设置字体边框样式、使用SUM/AVERAGE等公式以及生成图表的方法包内提供的示例代码和配置说明能帮助理解从简单导出到复杂报表的实现思路便于直接引用或二次开发。1. PHPExcel 1.8这包还能用但得按 2014 年的规矩用PHPExcel 1.8 是 PHP 读写 Excel 的老牌库PHPExcel-1.8.zip 这个文件名到今天还在下载站和搜索框里反复出现不是因为新项目选它而是大量遗留系统跑在 PHP 5.6 / 7.0 上导报表、读导入模板的代码全是PHPExcel_IOFactory::load()那一套。1.8 是这个系列最后的正式版本官方早已归档并把新开发迁到了 PhpSpreadsheet所以能跑和该不该继续用是两回事。这篇文章给两种情况都备好答案接手老项目的人需要知道这个 zip 解开后怎么加载、读写时哪些参数必须调、报错长什么样准备动手替换的人需要一份能对上号的迁移对照。适合维护导出功能、批量导入任务的 PHP 工程师也适合刚被安排去修一个报 read zip archive 错误的报表接口的人。2. 解开 PHPExcel-1.8.zip目录结构、PHP 版本与最小加载先把这个压缩包当成一个普通 PHP 依赖来看。它和 Composer 拉下来的包不一样没有vendor/autoload.php也没有命名空间所有类都是全局类名加载顺序错了就是Class not found。解开之后真正有用的只有Classes/目录官方示例和文档在Examples/、Documentation/里线上环境不需要引入。2.1 先确认 PHP 版本PHPExcel 1.8 只吃特定几口饭PHPExcel 1.8 官方要求 PHP 5.2.0 以上但那是 2014 年前后的说法放到现在的运行时环境里有明显边界。PHP 版本PHPExcel 1.8 实际表现建议5.3 ~ 5.6官方支持区间读写正常老系统可以继续用7.0 ~ 7.3基本可用部分场景有 notice临时过渡可用7.4大量 deprecated 告警功能仍在能跑但日志很难看8.0 及以上花括号字符串偏移语法被移除直接 fatal别用换 PhpSpreadsheetPHPExcel 1.8 源码里有$str{0}这种取字符串下标的写法PHP 7.4 开始废弃、PHP 8 直接移除所以装好了却打不开在 PHP 8 环境是必然结果。另外要注意这里说的 1.8 是 PHPExcel 的版本号和 JDK 1.8 没有任何关系别被版本号相同的巧合绕进去真正要查的是php -v和php -m | grep zip后者决定你能不能读 xlsx——xlsx 本质是 zip读写都依赖 ZipArchive 扩展扩展没装会直接抛异常。2.2 解压与校验别让 error read zip archive 卡住第一关下载回来的 PHPExcel-1.8.zip 第一件事不是解压是校验完整性unzip -t PHPExcel-1.8.zip-t是 test 模式只校验不落地。如果输出里有error read zip archive或者could not find EOCD说明压缩包在传输中被截断了——EOCD 是 zip 末尾的中心目录记录找不到它基本等于文件没下完。这种包强行解压会缺文件缺的往往是Classes/PHPExcel/子目录里的类文件运行时报错还特别隐蔽。用 7-Zip 打开看一眼目录树确认Classes/PHPExcel.php在再解压不迟。GitHub 上 PHPOffice/PHPExcel 仓库已经归档页面上的 Download ZIP 和流传的这个包内容一致zip 里没有.git只有源码快照所以升级只能靠换新包没有版本历史可以翻。解压时注意路径别带中文和空格PHP 的 require 拼接路径时这些字符容易出幺蛾子。2.3 最小加载代码三行让 IOFactory 跑起来?php // 假设解压后目录是 /data/lib/PHPExcel-1.8/ $base __DIR__ . /PHPExcel-1.8/Classes/; require_once $base . PHPExcel.php; require_once $base . PHPExcel/Autoloader.php; PHPExcel_Autoloader::Register(); // 冒烟测试能 new 出对象说明加载链路通了 $book new PHPExcel(); echo get_class($book), PHP_EOL; // PHPExcel先加载Classes/PHPExcel.php拿到核心类再加载Autoloader.php并注册后续PHPExcel_*开头的类会按需自动加载不用手写一堆 require。PHPExcel_Autoloader内部用的是spl_autoload_register它把PHPExcel_前缀映射到Classes/PHPExcel/目录这是 1.8 推荐的加载方式比把所有类文件一次性 require 进来省内存。如果项目本身用了 Composer更省事的做法是composer require phpoffice/phpexcel:1.8.*require vendor/autoload.php之后同样能用PHPExcel_IOFactoryComposer 的 autoload 机制兼容这种全局类名。装完先跑php -l检查语法再跑上面这段冒烟测试。常见误区是只 require 了PHPExcel.php就调PHPExcel_IOFactory结果报Class PHPExcel_IOFactory not found——IOFactory 不在核心类里必须走 autoload 或者单独 require。提示把Classes/目录放在 Web 可访问的目录之外避免别人直接通过 URL 拿到你的类文件。3. 用 PHPExcel 1.8 读 ExcelIOFactory、迭代器与日期序列号读取是这套库用得最多的场景。IOFactory 是统一入口它负责根据文件类型挑对应的 Reader 类Excel2007 的 Reader 内部用 ZipArchive 把 xlsx 解包然后解析xl/worksheets/sheet1.xml这些 XML 部件。理解这层关系后面排错会快很多。3.1 load 与 createReader 的几个必调参数?php $reader PHPExcel_IOFactory::createReader(Excel2007); $reader-setReadDataOnly(true); // 只取数据丢样式内存大降 $reader-setPreCalculateFormulas(false); // 先拿公式字符串不计算结果 $reader-setLoadSheetsOnly([Sheet1]); // 只加载指定工作表 $book $reader-load(/data/upload/report.xlsx);直接PHPExcel_IOFactory::load($file)也能用它会自己探测文件类型但少了中间的参数设置机会。createReader(Excel2007)是显式指定适合你知道上游文件格式固定是 xlsx 的场景。三个参数按需取舍别无脑全开。参数作用什么场景开setReadDataOnly(true)跳过样式、列宽、合并单元格等对象只做数据统计、入库时必开setPreCalculateFormulas(false)读入时不跑公式引擎大文件加速需要结果时再getCalculatedValue()setLoadSheetsOnly([Sheet1])只解析指定 sheet文件有多个 sheet 但只用其中一个setReadFilter($filter)按行/列范围过滤读取几十万行的大表见第 5 章setReadDataOnly(true)对大文件的收益最明显样式对象比数据本身占内存大得多。代价是后面拿不到单元格的字体、背景色这些信息做格式导出需求的不要开。3.2 遍历工作表行迭代器、列号换算与空单元格?php $sheet $book-getSheet(0); // 按索引取第一个工作表 foreach ($sheet-getRowIterator() as $row) { $rowIndex $row-getRowIndex(); $cellIterator $row-getCellIterator(); $cellIterator-setIterateOnlyExistingCells(true); // 跳过空单元格 foreach ($cellIterator as $cell) { $addr $cell-getCoordinate(); // 形如 B3 $value $cell-getValue(); echo $rowIndex, , $addr, , $value, PHP_EOL; } }getRowIterator()是 PHPExcel 1.8 提供的迭代器接口比手写双重 for 循环省内存因为它不会把整个工作表一次性物化。setIterateOnlyExistingCells(true)是关键默认迭代器会扫描整行范围内的每个格子大表里大量空单元格会白跑 CPU。需要按列名定位时用两个配套的换算方法?php $colIndex PHPExcel_Cell::columnIndexFromString(C); // 结果为 3 $colName PHPExcel_Cell::stringFromColumnIndex(3); // 结果为 C手写循环时一般这样用getHighestRow()拿最大行号getHighestColumn()拿最大列字母再用columnIndexFromString转成数字做边界。注意getHighestRow()返回的是有内容的行不是文件的总行数Excel 里有人误按过空格也会算进去判断数据边界时最好配合getCell()-getValue() ! null再过滤一次。3.3 日期序列号和格式化值的两个坑从 Excel 单元格拿日期getValue()返回的不会是2016-01-01这样的字符串而是一个浮点数——Excel 的日期序列号。直接拿这个数入库十有八九要在报表上赔笑脸。?php $cell $sheet-getCell(B2); $rawValue $cell-getValue(); // float(42370) $formatted $cell-getFormattedValue(); // 2016-01-01按单元格格式输出 $timestamp PHPExcel_Shared_Date::ExcelToPHP($rawValue); // PHP 时间戳 echo date(Y-m-d H:i:s, $timestamp), PHP_EOL;两个坑要记住。第一getValue()拿序列号getFormattedValue()拿展示文本后者依赖单元格的数字格式如果源文件里格式是yyyy-mm-dd拿到的才是2016-01-01如果源文件格式不规范getFormattedValue()返回的可能还是序列号。第二ExcelToPHP()把序列号转成 Unix 时间戳这个函数内部已经处理了 Excel 1900 日期系统里那个不存在的 1900-02-29 偏移直接用不用自己减天数但要注意它第二个参数可以传时区对象跨时区项目里别省。提示判断一个单元格是不是日期别依赖getValue()的类型要拿$cell-getStyle()-getNumberFormat()-getFormatCode()看格式串里有没有y、d这些字符再做转换分支。4. 用 PHPExcel 1.8 导出 xlsx写入参数、Writer 选择与下载响应头导出比读取更常用。PHPExcel 1.8 的写入流程是new 一个 PHPExcel 对象往里填单元格、样式最后交给 Writer 输出。这套 API 是老项目里最常见的一段代码很多新手的第一个坑是忘记setActiveSheetIndex导致数据写到了默认的第二个空 sheet 上。4.1 一段能直接用的写入代码?php $book new PHPExcel(); $book-getProperties() -setCreator(IT Ops) -setTitle(date(Ymd) . 报表); $sheet $book-setActiveSheetIndex(0); $sheet-setTitle(月度流水); // 表头 $headers [订单号, 金额, 下单时间]; foreach ($headers as $i $title) { $col PHPExcel_Cell::stringFromColumnIndex($i); $sheet-setCellValue($col . 1, $title); $style $sheet-getStyle($col . 1); $style-getFont()-setBold(true); $style-getAlignment()-setHorizontal( PHPExcel_Style_Alignment::HORIZONTAL_CENTER ); $sheet-getColumnDimension($col)-setWidth($i 1 ? 14 : 20); } // 数据区订单号必须按字符串写否则长数字变科学计数法 $sheet-setCellValueExplicit( A2, 202501150001234567, PHPExcel_Cell_DataType::TYPE_STRING ); $sheet-setCellValue(B2, 128.50); $sheet-setCellValue(C2, date(Y-m-d H:i:s)); // 公式和数字格式 $sheet-setCellValue(B3, SUM(B2:B100)); $sheet-getStyle(B2:B100) -getNumberFormat() -setFormatCode(#,##0.00); $sheet-getStyle(A1:C1) -getBorders() -getAllBorders() -setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);setCellValueExplicit强制指定数据类型是最容易被忽略的参数。订单号、身份证号这类超过 15 位的数字不指定TYPE_STRING会被当 float 处理导出的 Excel 里显示成1.23457E15这基本是导出功能被投诉的头号原因。样式层面的几个常量也值得记住对齐方式用PHPExcel_Style_Alignment::HORIZONTAL_CENTER边框用PHPExcel_Style_Border::BORDER_THIN字重用getFont()-setBold(true)这些都是 1.8 里最常用的样式参数。4.2 输出到浏览器Writer 选型与 zip 的关系?php header(Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); header(Content-Disposition: attachment; filenamereport.xlsx); header(Cache-Control: max-age0); $writer PHPExcel_IOFactory::createWriter($book, Excel2007); $writer-save(php://output);save(php://output)直接把文件流打到响应体不需要先生成临时文件。Content-Type 必须用 OOXML 的 MIME用application/octet-stream虽然能下载但文件名后缀经常被浏览器改掉。三个 header 之前不能有任何输出包括 BOM 和空行否则header()直接失败这个问题在 Windows 下用 UTF-8 编码保存 PHP 文件时尤其常见。Writer 类型输出格式行数上限依赖扩展使用场景Excel2007.xlsx1048576 行php_zip默认选择文件小兼容新 ExcelExcel5.xls65536 行php_xml老 ERP、银行系统只收 xlsCSV.csv无硬性限制无数据交换但丢样式和公式HTML.html无无快速预览Excel 能打开但不算真表格xlsx 本身就是 zip 容器里面是[Content_Types].xml、xl/workbook.xml这些 XML 部件所以不要再把生成的 xlsx 压一层 zip 发给用户双重后缀反而会让对方解压失败。反过来如果读取 xlsx 时报 read zip archive 类错误先怀疑这个 xlsx 是不是被改过扩展名的 HTML 文件——接口返回错误页面但保存成了 .xlsx这种事在对接第三方系统时很常见。4.3 大报表的内存参数单元格缓存与数据写入量PHPExcel 1.8 默认把每个单元格对象都放内存几万行的报表轻松吃掉几百 MB这是它最出名的问题。导出前可以改缓存策略?php PHPExcel_Settings::setCacheStorageMethod( PHPExcel_CachedObjectStorageFactory::cache_to_phpTemp, [memoryCacheSize 64MB] ); // 之后再创建 PHPExcel 对象 $book new PHPExcel();cache_to_phpTemp表示单元格对象在内存里攒够 64MB 就溢写到临时文件用磁盘换内存。cache_in_memory_serialized是序列化后驻内存速度比 phpTemp 快但省得有限cache_to_discISAM是纯磁盘缓存最慢但最省内存适合大批量后台导出。这个设置必须在new PHPExcel()之前调用而且对读取和写入都生效。5. PHPExcel 1.8 报错对照表以及分块读大表的 ReadFilter 技巧接手老项目时你面对的不是怎么用而是报错怎么解。把最常见的几类问题整理成对照表排错时先对着看能省大半时间。报错或症状根因处理方向Class ZipArchive not foundphp_zip 扩展未启用安装扩展并重启 PHP-FPM加载 xlsx 报read zip archive/could not find EOCD文件不是合法 zip多为 HTML 伪装的假 xlsx用file命令看文件头MAGIC 不是PK就找上游PHPExcel_Settings::setCacheStorageMethod无效设置放在了创建对象之后移到new PHPExcel()之前PHP 8 下直接Fatal error花括号字符串偏移语法被移除迁移 PhpSpreadsheet 或退回 PHP 7.4长数字列显示1.23457E15数字被识别为 float用setCellValueExplicit指定TYPE_STRING导出文件打不开提示格式错误save(php://output)前有 BOM 或空白检查 PHP 文件编码去掉输出前的一切字符这里要特别说明迁移的边界PHPExcel 1.8 和 PhpSpreadsheet 的类名、方法名基本一一对应PHPExcel_IOFactory对应PhpSpreadsheet\IOFactoryPHPExcel_Cell::columnIndexFromString对应Coordinate::columnIndexFromString但返回值类型更严格了很多老代码在 PHP 8 下跑不动不是库的错是返回值 null 判断没写。换库时先用静态分析工具扫一遍PHPExcel_前缀再按类逐个替换别指望一次性全量迁移。读大表时最值得留下的技巧是 ReadFilter 分块读取。PHPExcel 1.8 没有现成的只读第 N 到 M 行的参数但setReadFilter给了钩子自己实现一个行区间过滤器?php class ChunkReadFilter implements PHPExcel_Reader_IReadFilter { private $startRow 0; private $endRow 0; public function setRows($start, $end) { $this-startRow $start; $this-endRow $end; } public function readCell($column, $row, $worksheetName ) { // 表头行永远读其它行只读指定区间 return ($row 1) || ($row $this-startRow $row $this-endRow); } } $filter new ChunkReadFilter(); $reader PHPExcel_IOFactory::createReader(Excel2007); $reader-setReadDataOnly(true); $reader-setReadFilter($filter); // 假设有 20 万行每 5000 行一个分块 for ($start 2; $start 200000; $start 5000) { $filter-setRows($start, $start 5000); $book $reader-load($bigFile); $sheet $book-getSheet(0); // 在这里处理当前分块的数据比如拼 SQL 批量入库 $book-disconnectWorksheets(); // 断掉内部引用释放内存 unset($book); }disconnectWorksheets()是 1.8 提供的内存释放手段配合unset()才能让 PHP 的引用计数立刻回收否则分块循环里内存只增不减。这个方案也有代价每个分块都会重新解压整个 zip分块越小重复读取的开销越大所以 5000 行只是一个起点不是标准答案。上线前用memory_get_peak_usage(true)观察峰值从 5000 往 20000 试着调找到内存曲线开始快速爬升的那个分块大小就是你这台机器上的最优值。本文还有配套的精品资源点击获取
PHPExcel 1.8 老库运维：从加载、读写到PHP 8迁移指南
简介PHPExcel-1.8.zip是一份面向PHP开发者的Excel处理组件完整源码包源于开源项目PHPExcel 1.8版本提供读写XLS、XLSX等常见格式的类库适用于数据导入导出、报表生成、批量格式化、公式运算等Web开发场景既适合刚接触PHPExcel的初学者学习核心API也能作为现有项目的集成参考。压缩包共581个文件约4.98MB以340个php核心类文件为主体同时包含81个xlsx示例工作簿、37个md说明文档、31个png示意图以及config、functions、txt、xls、doc、csv等配置与辅助文件覆盖源码、样例、文档和测试资源目录结构清晰。已有305人浏览学习。借助其中的类库与示例开发者可快速掌握创建工作簿、读取与写入单元格、设置字体边框样式、使用SUM/AVERAGE等公式以及生成图表的方法包内提供的示例代码和配置说明能帮助理解从简单导出到复杂报表的实现思路便于直接引用或二次开发。1. PHPExcel 1.8这包还能用但得按 2014 年的规矩用PHPExcel 1.8 是 PHP 读写 Excel 的老牌库PHPExcel-1.8.zip 这个文件名到今天还在下载站和搜索框里反复出现不是因为新项目选它而是大量遗留系统跑在 PHP 5.6 / 7.0 上导报表、读导入模板的代码全是PHPExcel_IOFactory::load()那一套。1.8 是这个系列最后的正式版本官方早已归档并把新开发迁到了 PhpSpreadsheet所以能跑和该不该继续用是两回事。这篇文章给两种情况都备好答案接手老项目的人需要知道这个 zip 解开后怎么加载、读写时哪些参数必须调、报错长什么样准备动手替换的人需要一份能对上号的迁移对照。适合维护导出功能、批量导入任务的 PHP 工程师也适合刚被安排去修一个报 read zip archive 错误的报表接口的人。2. 解开 PHPExcel-1.8.zip目录结构、PHP 版本与最小加载先把这个压缩包当成一个普通 PHP 依赖来看。它和 Composer 拉下来的包不一样没有vendor/autoload.php也没有命名空间所有类都是全局类名加载顺序错了就是Class not found。解开之后真正有用的只有Classes/目录官方示例和文档在Examples/、Documentation/里线上环境不需要引入。2.1 先确认 PHP 版本PHPExcel 1.8 只吃特定几口饭PHPExcel 1.8 官方要求 PHP 5.2.0 以上但那是 2014 年前后的说法放到现在的运行时环境里有明显边界。PHP 版本PHPExcel 1.8 实际表现建议5.3 ~ 5.6官方支持区间读写正常老系统可以继续用7.0 ~ 7.3基本可用部分场景有 notice临时过渡可用7.4大量 deprecated 告警功能仍在能跑但日志很难看8.0 及以上花括号字符串偏移语法被移除直接 fatal别用换 PhpSpreadsheetPHPExcel 1.8 源码里有$str{0}这种取字符串下标的写法PHP 7.4 开始废弃、PHP 8 直接移除所以装好了却打不开在 PHP 8 环境是必然结果。另外要注意这里说的 1.8 是 PHPExcel 的版本号和 JDK 1.8 没有任何关系别被版本号相同的巧合绕进去真正要查的是php -v和php -m | grep zip后者决定你能不能读 xlsx——xlsx 本质是 zip读写都依赖 ZipArchive 扩展扩展没装会直接抛异常。2.2 解压与校验别让 error read zip archive 卡住第一关下载回来的 PHPExcel-1.8.zip 第一件事不是解压是校验完整性unzip -t PHPExcel-1.8.zip-t是 test 模式只校验不落地。如果输出里有error read zip archive或者could not find EOCD说明压缩包在传输中被截断了——EOCD 是 zip 末尾的中心目录记录找不到它基本等于文件没下完。这种包强行解压会缺文件缺的往往是Classes/PHPExcel/子目录里的类文件运行时报错还特别隐蔽。用 7-Zip 打开看一眼目录树确认Classes/PHPExcel.php在再解压不迟。GitHub 上 PHPOffice/PHPExcel 仓库已经归档页面上的 Download ZIP 和流传的这个包内容一致zip 里没有.git只有源码快照所以升级只能靠换新包没有版本历史可以翻。解压时注意路径别带中文和空格PHP 的 require 拼接路径时这些字符容易出幺蛾子。2.3 最小加载代码三行让 IOFactory 跑起来?php // 假设解压后目录是 /data/lib/PHPExcel-1.8/ $base __DIR__ . /PHPExcel-1.8/Classes/; require_once $base . PHPExcel.php; require_once $base . PHPExcel/Autoloader.php; PHPExcel_Autoloader::Register(); // 冒烟测试能 new 出对象说明加载链路通了 $book new PHPExcel(); echo get_class($book), PHP_EOL; // PHPExcel先加载Classes/PHPExcel.php拿到核心类再加载Autoloader.php并注册后续PHPExcel_*开头的类会按需自动加载不用手写一堆 require。PHPExcel_Autoloader内部用的是spl_autoload_register它把PHPExcel_前缀映射到Classes/PHPExcel/目录这是 1.8 推荐的加载方式比把所有类文件一次性 require 进来省内存。如果项目本身用了 Composer更省事的做法是composer require phpoffice/phpexcel:1.8.*require vendor/autoload.php之后同样能用PHPExcel_IOFactoryComposer 的 autoload 机制兼容这种全局类名。装完先跑php -l检查语法再跑上面这段冒烟测试。常见误区是只 require 了PHPExcel.php就调PHPExcel_IOFactory结果报Class PHPExcel_IOFactory not found——IOFactory 不在核心类里必须走 autoload 或者单独 require。提示把Classes/目录放在 Web 可访问的目录之外避免别人直接通过 URL 拿到你的类文件。3. 用 PHPExcel 1.8 读 ExcelIOFactory、迭代器与日期序列号读取是这套库用得最多的场景。IOFactory 是统一入口它负责根据文件类型挑对应的 Reader 类Excel2007 的 Reader 内部用 ZipArchive 把 xlsx 解包然后解析xl/worksheets/sheet1.xml这些 XML 部件。理解这层关系后面排错会快很多。3.1 load 与 createReader 的几个必调参数?php $reader PHPExcel_IOFactory::createReader(Excel2007); $reader-setReadDataOnly(true); // 只取数据丢样式内存大降 $reader-setPreCalculateFormulas(false); // 先拿公式字符串不计算结果 $reader-setLoadSheetsOnly([Sheet1]); // 只加载指定工作表 $book $reader-load(/data/upload/report.xlsx);直接PHPExcel_IOFactory::load($file)也能用它会自己探测文件类型但少了中间的参数设置机会。createReader(Excel2007)是显式指定适合你知道上游文件格式固定是 xlsx 的场景。三个参数按需取舍别无脑全开。参数作用什么场景开setReadDataOnly(true)跳过样式、列宽、合并单元格等对象只做数据统计、入库时必开setPreCalculateFormulas(false)读入时不跑公式引擎大文件加速需要结果时再getCalculatedValue()setLoadSheetsOnly([Sheet1])只解析指定 sheet文件有多个 sheet 但只用其中一个setReadFilter($filter)按行/列范围过滤读取几十万行的大表见第 5 章setReadDataOnly(true)对大文件的收益最明显样式对象比数据本身占内存大得多。代价是后面拿不到单元格的字体、背景色这些信息做格式导出需求的不要开。3.2 遍历工作表行迭代器、列号换算与空单元格?php $sheet $book-getSheet(0); // 按索引取第一个工作表 foreach ($sheet-getRowIterator() as $row) { $rowIndex $row-getRowIndex(); $cellIterator $row-getCellIterator(); $cellIterator-setIterateOnlyExistingCells(true); // 跳过空单元格 foreach ($cellIterator as $cell) { $addr $cell-getCoordinate(); // 形如 B3 $value $cell-getValue(); echo $rowIndex, , $addr, , $value, PHP_EOL; } }getRowIterator()是 PHPExcel 1.8 提供的迭代器接口比手写双重 for 循环省内存因为它不会把整个工作表一次性物化。setIterateOnlyExistingCells(true)是关键默认迭代器会扫描整行范围内的每个格子大表里大量空单元格会白跑 CPU。需要按列名定位时用两个配套的换算方法?php $colIndex PHPExcel_Cell::columnIndexFromString(C); // 结果为 3 $colName PHPExcel_Cell::stringFromColumnIndex(3); // 结果为 C手写循环时一般这样用getHighestRow()拿最大行号getHighestColumn()拿最大列字母再用columnIndexFromString转成数字做边界。注意getHighestRow()返回的是有内容的行不是文件的总行数Excel 里有人误按过空格也会算进去判断数据边界时最好配合getCell()-getValue() ! null再过滤一次。3.3 日期序列号和格式化值的两个坑从 Excel 单元格拿日期getValue()返回的不会是2016-01-01这样的字符串而是一个浮点数——Excel 的日期序列号。直接拿这个数入库十有八九要在报表上赔笑脸。?php $cell $sheet-getCell(B2); $rawValue $cell-getValue(); // float(42370) $formatted $cell-getFormattedValue(); // 2016-01-01按单元格格式输出 $timestamp PHPExcel_Shared_Date::ExcelToPHP($rawValue); // PHP 时间戳 echo date(Y-m-d H:i:s, $timestamp), PHP_EOL;两个坑要记住。第一getValue()拿序列号getFormattedValue()拿展示文本后者依赖单元格的数字格式如果源文件里格式是yyyy-mm-dd拿到的才是2016-01-01如果源文件格式不规范getFormattedValue()返回的可能还是序列号。第二ExcelToPHP()把序列号转成 Unix 时间戳这个函数内部已经处理了 Excel 1900 日期系统里那个不存在的 1900-02-29 偏移直接用不用自己减天数但要注意它第二个参数可以传时区对象跨时区项目里别省。提示判断一个单元格是不是日期别依赖getValue()的类型要拿$cell-getStyle()-getNumberFormat()-getFormatCode()看格式串里有没有y、d这些字符再做转换分支。4. 用 PHPExcel 1.8 导出 xlsx写入参数、Writer 选择与下载响应头导出比读取更常用。PHPExcel 1.8 的写入流程是new 一个 PHPExcel 对象往里填单元格、样式最后交给 Writer 输出。这套 API 是老项目里最常见的一段代码很多新手的第一个坑是忘记setActiveSheetIndex导致数据写到了默认的第二个空 sheet 上。4.1 一段能直接用的写入代码?php $book new PHPExcel(); $book-getProperties() -setCreator(IT Ops) -setTitle(date(Ymd) . 报表); $sheet $book-setActiveSheetIndex(0); $sheet-setTitle(月度流水); // 表头 $headers [订单号, 金额, 下单时间]; foreach ($headers as $i $title) { $col PHPExcel_Cell::stringFromColumnIndex($i); $sheet-setCellValue($col . 1, $title); $style $sheet-getStyle($col . 1); $style-getFont()-setBold(true); $style-getAlignment()-setHorizontal( PHPExcel_Style_Alignment::HORIZONTAL_CENTER ); $sheet-getColumnDimension($col)-setWidth($i 1 ? 14 : 20); } // 数据区订单号必须按字符串写否则长数字变科学计数法 $sheet-setCellValueExplicit( A2, 202501150001234567, PHPExcel_Cell_DataType::TYPE_STRING ); $sheet-setCellValue(B2, 128.50); $sheet-setCellValue(C2, date(Y-m-d H:i:s)); // 公式和数字格式 $sheet-setCellValue(B3, SUM(B2:B100)); $sheet-getStyle(B2:B100) -getNumberFormat() -setFormatCode(#,##0.00); $sheet-getStyle(A1:C1) -getBorders() -getAllBorders() -setBorderStyle(PHPExcel_Style_Border::BORDER_THIN);setCellValueExplicit强制指定数据类型是最容易被忽略的参数。订单号、身份证号这类超过 15 位的数字不指定TYPE_STRING会被当 float 处理导出的 Excel 里显示成1.23457E15这基本是导出功能被投诉的头号原因。样式层面的几个常量也值得记住对齐方式用PHPExcel_Style_Alignment::HORIZONTAL_CENTER边框用PHPExcel_Style_Border::BORDER_THIN字重用getFont()-setBold(true)这些都是 1.8 里最常用的样式参数。4.2 输出到浏览器Writer 选型与 zip 的关系?php header(Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); header(Content-Disposition: attachment; filenamereport.xlsx); header(Cache-Control: max-age0); $writer PHPExcel_IOFactory::createWriter($book, Excel2007); $writer-save(php://output);save(php://output)直接把文件流打到响应体不需要先生成临时文件。Content-Type 必须用 OOXML 的 MIME用application/octet-stream虽然能下载但文件名后缀经常被浏览器改掉。三个 header 之前不能有任何输出包括 BOM 和空行否则header()直接失败这个问题在 Windows 下用 UTF-8 编码保存 PHP 文件时尤其常见。Writer 类型输出格式行数上限依赖扩展使用场景Excel2007.xlsx1048576 行php_zip默认选择文件小兼容新 ExcelExcel5.xls65536 行php_xml老 ERP、银行系统只收 xlsCSV.csv无硬性限制无数据交换但丢样式和公式HTML.html无无快速预览Excel 能打开但不算真表格xlsx 本身就是 zip 容器里面是[Content_Types].xml、xl/workbook.xml这些 XML 部件所以不要再把生成的 xlsx 压一层 zip 发给用户双重后缀反而会让对方解压失败。反过来如果读取 xlsx 时报 read zip archive 类错误先怀疑这个 xlsx 是不是被改过扩展名的 HTML 文件——接口返回错误页面但保存成了 .xlsx这种事在对接第三方系统时很常见。4.3 大报表的内存参数单元格缓存与数据写入量PHPExcel 1.8 默认把每个单元格对象都放内存几万行的报表轻松吃掉几百 MB这是它最出名的问题。导出前可以改缓存策略?php PHPExcel_Settings::setCacheStorageMethod( PHPExcel_CachedObjectStorageFactory::cache_to_phpTemp, [memoryCacheSize 64MB] ); // 之后再创建 PHPExcel 对象 $book new PHPExcel();cache_to_phpTemp表示单元格对象在内存里攒够 64MB 就溢写到临时文件用磁盘换内存。cache_in_memory_serialized是序列化后驻内存速度比 phpTemp 快但省得有限cache_to_discISAM是纯磁盘缓存最慢但最省内存适合大批量后台导出。这个设置必须在new PHPExcel()之前调用而且对读取和写入都生效。5. PHPExcel 1.8 报错对照表以及分块读大表的 ReadFilter 技巧接手老项目时你面对的不是怎么用而是报错怎么解。把最常见的几类问题整理成对照表排错时先对着看能省大半时间。报错或症状根因处理方向Class ZipArchive not foundphp_zip 扩展未启用安装扩展并重启 PHP-FPM加载 xlsx 报read zip archive/could not find EOCD文件不是合法 zip多为 HTML 伪装的假 xlsx用file命令看文件头MAGIC 不是PK就找上游PHPExcel_Settings::setCacheStorageMethod无效设置放在了创建对象之后移到new PHPExcel()之前PHP 8 下直接Fatal error花括号字符串偏移语法被移除迁移 PhpSpreadsheet 或退回 PHP 7.4长数字列显示1.23457E15数字被识别为 float用setCellValueExplicit指定TYPE_STRING导出文件打不开提示格式错误save(php://output)前有 BOM 或空白检查 PHP 文件编码去掉输出前的一切字符这里要特别说明迁移的边界PHPExcel 1.8 和 PhpSpreadsheet 的类名、方法名基本一一对应PHPExcel_IOFactory对应PhpSpreadsheet\IOFactoryPHPExcel_Cell::columnIndexFromString对应Coordinate::columnIndexFromString但返回值类型更严格了很多老代码在 PHP 8 下跑不动不是库的错是返回值 null 判断没写。换库时先用静态分析工具扫一遍PHPExcel_前缀再按类逐个替换别指望一次性全量迁移。读大表时最值得留下的技巧是 ReadFilter 分块读取。PHPExcel 1.8 没有现成的只读第 N 到 M 行的参数但setReadFilter给了钩子自己实现一个行区间过滤器?php class ChunkReadFilter implements PHPExcel_Reader_IReadFilter { private $startRow 0; private $endRow 0; public function setRows($start, $end) { $this-startRow $start; $this-endRow $end; } public function readCell($column, $row, $worksheetName ) { // 表头行永远读其它行只读指定区间 return ($row 1) || ($row $this-startRow $row $this-endRow); } } $filter new ChunkReadFilter(); $reader PHPExcel_IOFactory::createReader(Excel2007); $reader-setReadDataOnly(true); $reader-setReadFilter($filter); // 假设有 20 万行每 5000 行一个分块 for ($start 2; $start 200000; $start 5000) { $filter-setRows($start, $start 5000); $book $reader-load($bigFile); $sheet $book-getSheet(0); // 在这里处理当前分块的数据比如拼 SQL 批量入库 $book-disconnectWorksheets(); // 断掉内部引用释放内存 unset($book); }disconnectWorksheets()是 1.8 提供的内存释放手段配合unset()才能让 PHP 的引用计数立刻回收否则分块循环里内存只增不减。这个方案也有代价每个分块都会重新解压整个 zip分块越小重复读取的开销越大所以 5000 行只是一个起点不是标准答案。上线前用memory_get_peak_usage(true)观察峰值从 5000 往 20000 试着调找到内存曲线开始快速爬升的那个分块大小就是你这台机器上的最优值。本文还有配套的精品资源点击获取
