PHPOffice/PhpSpreadsheet内存优化指南：使用缓存机制处理大型Excel文件-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00107/article/details/148391932

PHPOffice/PhpSpreadsheet内存优化指南：使用缓存机制处理大型Excel文件

PhpSpreadsheet A pure PHP library for reading and writing spreadsheet files 项目地址: https://gitcode.com/gh_mirrors/ph/PhpSpreadsheet

内存消耗问题概述

在使用PHPOffice/PhpSpreadsheet处理Excel文件时，开发者经常会遇到内存不足的问题。这是因为PhpSpreadsheet默认会将所有单元格数据保存在内存中，每个单元格大约占用1KB内存（64位PHP环境下约为1.6KB）。当处理包含数万甚至数十万单元格的大型Excel文件时，内存消耗会迅速攀升，导致脚本执行失败。

缓存机制原理

PhpSpreadsheet提供了一套基于PSR-16标准的缓存机制，允许开发者将单元格数据存储在更高效的内存区域，甚至完全移出内存（如磁盘、APCu、Memcache或Redis等）。这种机制通过牺牲少量访问速度来换取内存使用的大幅降低。

核心概念

单元格对象管理：默认情况下，所有单元格对象都保存在PHP内存中
缓存替代方案：可以自定义缓存实现来替代默认的内存存储
自动命名空间：PhpSpreadsheet会自动为缓存键添加命名空间，避免冲突
自动清理：使用完毕后，缓存数据会被自动清除

缓存配置方法

要启用缓存功能，需要提供一个符合PSR-16标准的缓存实现：

// 创建自定义缓存实例
$cache = new MyCustomPsr16Implementation();

// 配置PhpSpreadsheet使用该缓存
\PhpOffice\PhpSpreadsheet\Settings::setCache($cache);

重要注意事项：

每个工作表会维护独立的缓存实例
缓存配置必须在读取工作簿或创建第一个工作表之前完成
一旦开始处理Excel文件，就不能再修改缓存配置

缓存实现的关键考虑因素

TTL（生存时间）陷阱

与传统缓存不同，PhpSpreadsheet的缓存数据不能重新生成。如果缓存数据被删除或过期，将直接导致异常。因此必须确保：

第三方程序不会删除缓存数据
如果使用TTL机制，必须设置为足够长的时间
理想情况下应禁用TTL，或确保TTL远长于脚本执行时间

常用缓存方案实现

虽然PhpSpreadsheet本身不提供缓存实现，但开发者可以选择现有的PSR-16兼容库。以下是几种常见方案的配置示例：

APCu缓存方案

APCu是PHP的本地内存缓存扩展，适合单服务器环境。

安装依赖：

composer require cache/simple-cache-bridge cache/apcu-adapter

配置代码：

$pool = new \Cache\Adapter\Apcu\ApcuCachePool();
$simpleCache = new \Cache\Bridge\SimpleCache\SimpleCacheBridge($pool);

\PhpOffice\PhpSpreadsheet\Settings::setCache($simpleCache);

Redis缓存方案

Redis是高性能的内存数据库，适合分布式环境。

安装依赖：

composer require cache/simple-cache-bridge cache/redis-adapter

配置代码：

$client = new \Redis();
$client->connect('127.0.0.1', 6379);
$pool = new \Cache\Adapter\Redis\RedisCachePool($client);
$simpleCache = new \Cache\Bridge\SimpleCache\SimpleCacheBridge($pool);

\PhpOffice\PhpSpreadsheet\Settings::setCache($simpleCache);

Memcache缓存方案

Memcache是经典的内存缓存系统。

安装依赖：

composer require cache/simple-cache-bridge cache/memcache-adapter

配置代码：

$client = new \Memcache();
$client->connect('localhost', 11211);
$pool = new \Cache\Adapter\Memcache\MemcacheCachePool($client);
$simpleCache = new \Cache\Bridge\SimpleCache\SimpleCacheBridge($pool);

\PhpOffice\PhpSpreadsheet\Settings::setCache($simpleCache);