PhpSpreadsheet读Excel需三步：加载文件→选工作表→取数据；必须用IOFactory::load()加载，路径要正确，注意格式匹配、权限、临时文件时效性，大文件需优化内存与读取范围，日期数字空值需特殊处理。
PhpSpreadsheet 读取 Excel 文件的基本流程
用 PhpSpreadsheet 读 Excel，核心就三步：加载文件 → 选工作表 → 取数据。它不直接操作二进制，而是把 Excel 解析成内存中的表格对象，所以别指望用 fopen() 或 file_get_contents() 直接读出单元格值。
常见错误是跳过“加载器”直接调用 getActiveSheet()，结果报 Call to a member function getActiveSheet() on null —— 因为没成功加载文件，返回的是 null。
- 必须用
IOFactory::load()加载，不能手动 newSpreadsheet - 路径要写对：
IOFactory::load('/path/to/file.xlsx')，相对路径容易失效，建议用__DIR__ . '/data/test.xlsx' - 如果文件是
.xls（Excel 2003），默认不支持，得显式指定读取器：IOFactory::createReader('Xls')
读取时遇到 “Could not open … for reading” 错误
这个错误不是权限问题就是格式/路径问题。PhpSpreadsheet 内部会先检查文件是否存在、是否可读、扩展名是否匹配已注册的读取器，任一失败就抛这个异常。
- 检查
is_readable($path)返回 true 吗？注意 web 服务器用户（如 www-data）可能无权读取你本地测试路径 - 确认后缀名和实际格式一致：有些文件明明是 CSV 却改名成
.xlsx，IOFactory::load()会按后缀选读取器，然后解析失败 - 如果用
$_FILES['file']['tmp_name']，记得上传后立刻读，别等页面刷新再读——临时文件可能已被删 - Windows 路径中的反斜杠
容易导致字符串截断，统一用正斜杠或str_replace('\', '/', $path)
读取大 Excel 文件时内存爆掉或超时
默认模式下，PhpSpreadsheet 把整张表加载进内存，10MB 的 Excel 可能吃掉 200MB+ 内存。不是代码写错了，是设计如此。
立即学习“PHP免费学习笔记（深入）”；
- 用
setReadDataOnly(true)关闭样式、公式解析，只读值，内存降一半以上 - 用
setLoadSheetsOnly(['Sheet1'])限制只读指定表，避免加载隐藏表或多余 sheet - 真要处理上万行，考虑用
ChunkReadFilter分块读，但注意它只支持.xlsx，且需手动设置行范围：$reader->setReadFilter(new ChunkReadFilter(1, 1000)) - PHP 的
memory_limit至少设到256M，max_execution_time别卡在 30 秒
日期、数字、空单元格读出来是乱码或 null
Excel 内部用序列号存日期（如 44197 表示 2021-01-01），用浮点存数字，空单元格可能是 null 或空字符串，取决于写入方式。
- 用
$cell->getFormattedValue()拿带格式的字符串（如 “2021/1/1”），但性能差；用$cell->getValue()拿原始值（如 44197），再用DateTime::createFromFormat('U', $excelTimestamp * 86400 - 2209161600)转时间 - 数字可能带科学计数法（
1.23E+10），用(string)$cell->getValue()强转再 trim，避免精度丢失 - 空单元格判断别只看
=== null，还要检查== ''和is_numeric()是否为 false，因为 Excel 里“空”有多种实现
真正麻烦的是混合类型列（比如 A 列前 10 行是数字，第 11 行是文本），PhpSpreadsheet 默认按首行类型推断整列，后面类型不一致的值会被转成空或 0。这种没法自动修复，只能提前约定格式或手动遍历每个单元格调 getDataType() 判断。
