企业官网建设流程全解析

• 后端
• 数据处理

本文是一篇面向 PHP 开发者的内存管理实战指南，聚焦 PHPExcel 工作簿对象（PHPExcel）在完成读写任务后如何被彻底释放。由于 PHPExcel 对象内部存在工作簿与工作表、工作表与单元格之间的循环引用，普通的unset()无法真正回收内存，本文将以官方文档 05-Deleting-a-Workbook.md 为主体，结合仓库源码剖析循环引用的成因、disconnectWorksheets()的底层实现，并给出可复用的内存释放模式。

一、问题根源：PHPExcel 对象中的循环引用

PHPExcel 采用"内存中持有电子表格完整表示"的架构（见 01-Getting-Started.md 的 FAQ 部分），即整个工作簿的层级结构——工作簿、工作表、单元格——都以 PHP 对象的形式常驻内存。这种层级模型天然带来了双向引用：

• 工作簿（PHPExcel）持有所有工作表（PHPExcel_Worksheet）的集合，即workSheetCollection属性；
• 每个工作表又通过$parent属性反向指向它的父工作簿。

从源码可以看到，工作表的$parent属性声明于 Worksheet.php 第 52 行，并提供了getParent()获取父引用（Worksheet.php 第 771-774 行）：

private $parent; // Worksheet.php:52 public function getParent() // Worksheet.php:771 { return $this->parent; }

而在构造函数中，工作簿会将自身绑定给每一个新建的工作表，形成"工作簿 → 工作表 → 工作簿"的循环引用环。除此之外，还有更深的嵌套循环：

• 每个单元格对象（PHPExcel_Cell）持有所属工作表的 cell collection 引用；
• 计算引擎（PHPExcel_Calculation）、命名区域（NamedRange）、样式监督者（cellXfSupervisor）等组件同样与工作簿/工作表互相持有引用。

为什么循环引用会导致"内存泄漏"

PHP 的垃圾回收机制对普通对象采用引用计数：当某个对象的外部引用计数降为零时即可被回收。但在循环引用环中，工作簿引用工作表、工作表又引用工作簿，每个对象的引用计数都始终大于零，即便外部变量$objPHPExcel已被unset()或函数已返回（局部变量超出作用域），这些对象依然"互相拽住"对方，无法被判定为可回收。

结果正如原文档所指出的：这些对象会一直占用 PHP 有限的内存，造成事实上的内存泄漏。在批处理大量 Excel 文件（例如循环遍历目录逐个读取、转换、写出）的场景下，泄漏会在每次迭代中累积，最终触发Fatal error: Allowed memory size of xxx bytes exhausted。原文档（01-Getting-Started.md）也给出了两种常规缓解手段：

1. 修改php.ini中的memory_limit指令，或在代码中调用ini_set('memory_limit', '128M')（取决于 ISP 是否允许）；
2. 使用单元格缓存（cell caching）机制降低常驻内存占用（详见 CachedObjectStorageFactory.php）。

但这两者只是"扩容"或"压缩"，并没有从根本上解决循环引用对象无法回收的问题——必须手动打破引用环。

二、官方解法：disconnectWorksheets()

原文档明确指出，循环引用"只能手动解决"：如果你需要 unset 一个工作簿，就必须在 unset 之前先"打断"这些循环引用。PHPExcel 为此提供了disconnectWorksheets()方法：

$objPHPExcel->disconnectWorksheets(); unset($objPHPExcel);

这个两行模式就是官方文档给出的标准释放流程：先断开工作簿与所有工作表的引用关系，再 unset 工作簿变量，PHP 的引用计数才能归零并真正回收内存。

方法签名与定义位置

disconnectWorksheets()定义在工作簿类 PHPExcel.php 第 402-416 行：

/** * Disconnect all worksheets from this PHPExcel workbook object, * typically so that the PHPExcel object can be unset * */ public function disconnectWorksheets() { $worksheet = null; foreach ($this->workSheetCollection as $k => &$worksheet) { $worksheet->disconnectCells(); $this->workSheetCollection[$k] = null; } unset($worksheet); $this->workSheetCollection = array(); }

逐行解析实现逻辑

1. 遍历工作表集合：使用引用方式（&$worksheet）逐个取出集合中的工作表对象；
2. 调用disconnectCells()：对每个工作表执行"断开单元格"操作（见下文）；
3. 置空集合槽位：将workSheetCollection中对应位置的引用置为null，打破"工作簿 → 工作表"方向的引用；
4. 清理临时引用与集合：unset($worksheet)释放循环遍历中的引用变量，最后将整个集合重置为空数组。

工作表层的 disconnectCells()

disconnectWorksheets()的核心动作其实是委托给每个工作表的disconnectCells()（Worksheet.php 第 365-378 行）：

public function disconnectCells() { if ($this->cellCollection !== null) { $this->cellCollection->unsetWorksheetCells(); $this->cellCollection = null; } // detach ourself from the workbook, so that it can then delete this worksheet successfully $this->parent = null; }

它做了两件事：

• 调用单元格缓存控制器（cell collection）的unsetWorksheetCells()清空所有单元格，并把cellCollection置为null；
• 把$this->parent置为null——这正是注释中所说的"将自身从工作簿上摘除"，从而打破"工作表 → 工作簿"这一环。

单元格层的 unsetWorksheetCells() 与 detach()

单元格缓存的实现位于 Classes/PHPExcel/CachedObjectStorage/ 目录，所有缓存后端（Memory、MemorySerialized、MemoryGZip、PHPTemp、APC、Memcache、SQLite、SQLite3、DiscISAM、Igbinary、Wincache等）都实现了unsetWorksheetCells()。以默认的 Memory.php 第 100-117 行 为例：

public function unsetWorksheetCells() { // Because cells are all stored as intact objects in memory, we need to detach each one from the parent foreach ($this->cellCache as $k => &$cell) { $cell->detach(); $this->cellCache[$k] = null; } unset($cell); $this->cellCache = array(); // detach ourself from the worksheet, so that it can then delete this object successfully $this->parent = null; }

• 逐个对单元格调用detach()，即 Cell.php 第 103-106 行 的$this->parent = null，切断"单元格 → 父集合"的引用；
• 将cellCache各槽位置空并重置为空数组；
• 最后把缓存控制器自身的$parent置空。

至此，完整的三层引用环被逐级拆除：

工作簿 --workSheetCollection--> 工作表 --cellCollection--> 单元格缓存 --cellCache--> 单元格 ^ | | | |________________________________| |___________________| 断开（parent = null） 断开（parent = null） 断开（detach）

三、源码级佐证：析构函数也在调用 disconnectWorksheets()

值得注意的细节是，disconnectWorksheets()并非只在用户代码中手动调用——工作簿的析构函数 PHPExcel.php 第 392-400 行 同样会调用它：

public function __destruct() { $this->calculationEngine = null; $this->disconnectWorksheets(); }

同理，工作表的析构函数 Worksheet.php 第 380-389 行 会先调用PHPExcel_Calculation::getInstance($this->parent)->clearCalculationCacheForWorksheet($this->title)清理该工作表在计算引擎中的缓存结果，再执行disconnectCells()：

public function __destruct() { PHPExcel_Calculation::getInstance($this->parent)->clearCalculationCacheForWorksheet($this->title); $this->disconnectCells(); }

这印证了设计意图：即使开发者忘记手动释放，PHP 在对象析构时也会尽力拆除引用环。但不要依赖析构函数——析构的前提是引用计数归零，而循环引用恰恰使计数无法归零，析构根本不会触发。这也正是原文档强调"必须手动断开"的原因。

四、仓库中的真实使用范例

在仓库自带示例中，disconnectWorksheets()被用于"读完即弃"的场景——图表读写示例在输出文件后立即释放工作簿：

• Examples/32chartreadwrite.php 第 122 行
• Examples/35chartrender.php 第 125 行
• Examples/36chartreadwriteHTML.php 第 142 行
• Examples/36chartreadwritePDF.php 第 165 行

以 32chartreadwrite.php 为例，其结尾模式为：

$objPHPExcel->disconnectWorksheets(); unset($objPHPExcel);

这些示例表明：凡是创建了完整工作簿对象（尤其是涉及图表、富文本、样式等复杂对象图的场景），在不再需要后都应执行"断开 + unset"两步。

五、实战：批量处理时的标准释放模式

将官方解法落地到最常见的批量处理场景中，推荐如下模式：

$files = glob('/path/to/excels/*.xlsx'); foreach ($files as $file) { $objReader = PHPExcel_IOFactory::createReader('Excel2007'); $objPHPExcel = $objReader->load($file); // ... 读取、修改、写出等业务逻辑 ... // 释放内存：先断开循环引用，再 unset $objPHPExcel->disconnectWorksheets(); unset($objPHPExcel); }

几点实践建议：

1. 两步缺一不可：disconnectWorksheets()负责拆除引用环，unset($objPHPExcel)负责移除变量引用；只 unset 不 disconnect 会泄漏，只 disconnect 不 unset 变量仍指向对象。
2. 放在循环末尾：在每次迭代结束前释放，避免泄漏在多次循环中累积。
3. 可用引用计数验证：在断开前后分别对$objPHPExcel调用debug_zval_dump()或观察内存使用（memory_get_usage()）来验证释放效果。
4. 结合单元格缓存：对于超大文件，可在加载前通过PHPExcel_Settings::setCacheStorageMethod(...)切换缓存后端（如PHPTemp、SQLite3），进一步降低峰值内存（相关实现见 CachedObjectStorageFactory.php），与本文的断开释放相辅相成。

六、小结

PHPExcel 的"内存中持有电子表格"架构决定了内存释放是每一个长时间运行脚本都必须正视的问题。掌握disconnectWorksheets()的使用，就掌握了让 PHPExcel 对象真正"寿终正寝"的正确方式——这也是官方文档 05-Deleting-a-Workbook.md 的核心要义。

• 后端
• 数据处理