Phpspreadsheet 2.0：如何获取FILTER数组公式影响的所有单元格值？

问题本质 #

你碰到的情况是：Excel的动态数组函数（比如你用的SORT+FILTER）会把计算结果溢出到相邻单元格，但这些溢出单元格本身没有独立公式——它们只是显示H3单元格公式的输出结果。PhpSpreadsheet的getCalculatedValue()只处理自带公式的单元格，直接调用H4这类溢出单元格的该方法自然返回null。

解决方法 #

直接获取H3单元格的计算结果（它会返回一个二维数组，对应整个溢出区域的所有值），遍历这个数组就能拿到所有受影响单元格的值，还可以选择把值填充到对应单元格中。

代码示例 #

// 获取目标工作表
$sheet = $spreadsheet->getSheet(1);

// 获取H3的动态数组计算结果，返回二维数组格式
$dynamicResult = $sheet->getCell('H3')->getCalculatedValue();

if (is_array($dynamicResult)) {
    // H3的起始行号和列索引（H对应列号8，行号3）
    $startRow = 3;
    $startCol = 8;

    foreach ($dynamicResult as $rowOffset => $rowValues) {
        foreach ($rowValues as $colOffset => $value) {
            // 计算目标单元格的位置
            $targetRow = $startRow + $rowOffset;
            $targetCol = $startCol + $colOffset;
            
            // 可选：将值写入对应单元格（如果需要持久化这些值）
            $sheet->getCellByColumnAndRow($targetCol, $targetRow)->setValue($value);
            
            // 直接读取值的示例
            $cellAddress = \PhpOffice\PhpSpreadsheet\Cell\Coordinate::stringFromColumnIndex($targetCol - 1) . $targetRow;
            echo "{$cellAddress} 的值：{$value}\n";
        }
    }
}

额外说明 #

• 若不需要修改原工作表，仅需读取溢出值，跳过setValue步骤直接遍历数组即可。
• PhpSpreadsheet 2.0已支持带_xlfn._xlws前缀的动态数组函数，因此H3的计算结果是可靠的。
• 溢出单元格在Excel中属于动态数组的“关联区域”，本身无公式存储，这是它们无法单独计算的核心原因。

内容的提问来源于stack exchange，提问作者Thomas Seven