Laravel Excel导出XLSX时保留电话号码前缀+1的问题求助

问题描述 #

通过SQL的concat函数格式化电话号码，添加+1前缀并去除空格，SQL语句如下：

SELECT ...
FROM 
    (SELECT ...
       case when p2.national_number is not null then concat('+1', p2.national_number) else p2.national_number end as PhoneNumber)

该字段以字符串形式从数据库返回，通过Laravel Excel导出为XLSX：

return collect($receipts);

遇到的问题：导出的XLSX中该列被识别为数字，+1前缀被当作正号丢失。尝试用columnFormats设置G列为文本格式但无效：

public function columnFormats(): array
{
    return [
        'G' => NumberFormat::FORMAT_TEXT
    ];
}

解决建议 #

1. 在数据前添加隐藏单引号（SQL层处理） #

在SQL的concat中前置一个转义的单引号，Excel会自动将单元格识别为文本，且单引号仅在编辑时可见，正常显示时隐藏：

SELECT ...
FROM 
    (SELECT ...
       case when p2.national_number is not null then concat('''+1', p2.national_number) else p2.national_number end as PhoneNumber)

注：SQL中用两个单引号表示转义的单个单引号。

2. 在导出映射中强制文本格式（Laravel Excel层处理） #

使用Laravel Excel的map方法，给电话号码字段前置单引号，确保Excel识别为文本：

public function map($receipt): array
{
    return [
        // 其他导出字段...
        'PhoneNumber' => "'" . $receipt->PhoneNumber,
    ];
}

3. 强制设置单元格数据类型（事件监听） #

通过AfterSheet事件，直接将G列单元格的数据类型设为字符串，彻底避免Excel自动识别：

use PhpOffice\PhpSpreadsheet\Cell\DataType;
use Maatwebsite\Excel\Events\AfterSheet;

public function registerEvents(): array
{
    return [
        AfterSheet::class => function(AfterSheet $event) {
            $sheet = $event->sheet->getDelegate();
            $highestRow = $sheet->getHighestRow();
            
            // 遍历G列所有数据行（假设第1行是表头，从第2行开始处理）
            for ($row = 2; $row <= $highestRow; $row++) {
                $cell = $sheet->getCell('G' . $row);
                $cell->setValueExplicit($cell->getValue(), DataType::TYPE_STRING);
            }
        },
    ];
}

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