Laravel-Excel导入时无法读取PHPOffice单元格填充颜色问题

可能的原因 #

• Laravel-Excel默认忽略样式导入：为提升导入性能，Laravel-Excel默认不会加载单元格样式信息，导致读取到的样式均为默认的none。
• 样式继承问题：单元格的填充颜色可能从行、列或工作簿样式继承而来，而非单元格直接设置，直接读取单元格自身样式无法获取继承后的真实样式。
• 文件格式兼容问题：旧版.xls格式文件的样式存储逻辑与.xlsx存在差异，可能导致PhpSpreadsheet读取样式失败。

解决步骤 #

1. 开启样式读取选项 #

在你的Import类中，通过configureOptions方法开启完整数据加载（包含样式）：

use Maatwebsite\Excel\Options;

class YourImport implements ToCollection
{
    public function configureOptions(Options $options): void
    {
        // 关闭仅读取数据模式，加载样式信息
        $options->setReadDataOnly(false);
    }

    // 你的toCollection实现...
}

2. 获取继承后的最终样式 #

如果样式是继承而来，使用getCalculatedStyle()方法获取单元格实际应用的样式，替代直接调用getStyle()：

public static function beforeImport(BeforeImport $event)
{
    $sheet = $event->getDelegate()->getActiveSheet();
    
    for ($i = 1; $i < 10; $i++) {
        $cell = "A$i";
        \Log::info(json_encode($sheet->getCell($cell)->getValue()));
        
        // 获取包含继承逻辑的最终样式
        $fillStyle = $sheet->getCalculatedStyle($cell)->getFill()->exportArray();
        \Log::info(json_encode($fillStyle));
    }
}

3. 切换到afterSheet事件（可选） #

若beforeImport阶段文件样式未完全加载，可尝试在afterSheet事件中处理：

use Maatwebsite\Excel\Events\AfterSheet;

class YourImport implements ToCollection, WithEvents
{
    public function registerEvents(): array
    {
        return [
            AfterSheet::class => function(AfterSheet $event) {
                $sheet = $event->getSheet()->getDelegate();
                
                for ($i = 1; $i < 10; $i++) {
                    $cell = "A$i";
                    \Log::info(json_encode($sheet->getCell($cell)->getValue()));
                    $fillStyle = $sheet->getCalculatedStyle($cell)->getFill()->exportArray();
                    \Log::info(json_encode($fillStyle));
                }
            },
        ];
    }

    // 你的toCollection实现...
}

4. 检查文件格式 #

优先使用.xlsx格式文件测试，PhpSpreadsheet对该格式的样式支持更完善；若为.xls文件，可尝试转换为.xlsx后再导入。

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