Yii2 API中使用PHPExcel读取CSV/XLSX文件的编码问题求解

针对你在Yii2 API中使用PHPExcel处理文件时遇到的编码问题，结合我之前踩过的类似坑，给你几个实用的解决方案：

1. 优化CSV文件的编码检测逻辑 #

你当前用mb_check_encoding直接检测整个文件的方式有两个明显问题：一是大文件会占用过多内存，二是只覆盖了UTF-8和Windows-1255两种编码，实际业务中可能遇到GBK、GB2312、ISO-8859-1等其他常见编码。可以改成读取文件开头的部分内容来检测，同时增加更多编码选项：

if($inputFileType == 'CSV') {
    // 读取文件前1024字节检测编码，避免大文件内存溢出
    $fileContent = file_get_contents($inputFileName['link'], false, null, 0, 1024);
    // 按业务常见编码优先级检测，顺序会影响结果，可根据需求调整
    $detectedEncoding = mb_detect_encoding($fileContent, ['UTF-8', 'GBK', 'Windows-1255', 'ISO-8859-1'], true);
    // 检测失败时 fallback 到业务默认编码
    $objReader->setInputEncoding($detectedEncoding ?: 'UTF-8');
}

2. 处理XLSX文件的隐性编码异常 #

XLSX格式本身基于XML，默认是UTF-8编码，但有些老旧工具生成的XLSX可能存在单元格编码异常。可以在读取行数据后，对每个单元格统一做转码处理：

// 完整的行数据读取逻辑 + 编码转换
for ($row = 1; $row <= $highestRow; $row++) {
    // 读取整行数据，参数确保保留原始格式
    $rowData = $sheet->rangeToArray('A' . $row . ':' . $highestColumn . $row, null, true, true, true);
    // 递归遍历单元格，统一转成UTF-8
    array_walk_recursive($rowData, function(&$value) {
        if(is_string($value)) {
            $currentEncoding = mb_detect_encoding($value, ['UTF-8', 'GBK', 'Windows-1255'], true);
            if($currentEncoding && $currentEncoding !== 'UTF-8') {
                $value = mb_convert_encoding($value, 'UTF-8', $currentEncoding);
            }
        }
    });
    $fileData[] = $rowData;
}

3. 兜底：强制统一输出编码 #

不管输入文件是什么编码，最终API返回的数组统一使用UTF-8编码，这样前端或下游服务处理时更省心。如果上面的检测和转码仍有遗漏，可以在读取完成后对整个$fileData数组做一次全局递归转码。

另外补充下，你代码里的rangeToArray调用不完整，示例中已经补全了列范围的拼接逻辑。如果经常遇到特殊编码的文件，也可以尝试用iconv扩展辅助转码，它对部分边缘编码的支持比mbstring更友好。

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