ThinkPHP导入Excel如何记录导入日志配置方法介绍-ThinkPHP-PHP中文网

thinkphp导入excel需记录文件名、行数、成功数、失败数、错误详情及时间戳，通过配置excel_import日志通道和封装excelimportlogger服务类实现结构化日志记录，且必须在数据处理明确结束后调用record方法。

thinkphp导入excel如何记录导入日志配置方法介绍

ThinkPHP导入Excel时需记录每批次导入的文件名、行数、成功数、失败数、错误详情及时间戳，避免数据回溯无依据、排查问题靠猜。

配置日志驱动与通道

在 config/log.php 中新增名为 excel_import 的日志通道，指定独立日志文件路径和格式：

return [
  'channels' => [
    'excel_import' => [
      'type' => 'single',
      'path' => runtime_path('log/excel_import/'),
      'level' => 'info',
      'file_size' => 1024 * 1024 * 5,
      'max_files' => 30,
    ],
  ],
];

注意：runtime_path('log/excel_import/') 会自动创建子目录，但需确保 runtime/log/ 目录可写，否则日志写入静默失败。

封装日志记录方法

在 app/common/service/ExcelImportLogger.php 中新建服务类，统一处理日志结构化输出：

namespace app\common\service;
use think\facade\Log;
class ExcelImportLogger
{
  public static function record($filename, $totalRows, $successCount, $failCount, $errors = [])
  {
    $logData = [
      'file' => $filename,
      'total' => $totalRows,
      'success' => $successCount,
      'fail' => $failCount,
      'errors' => array_slice($errors, 0, 5), // 只记前5条错误，防日志爆炸
      'time' => date('Y-m-d H:i:s'),
    ];
    Log::channel('excel_import')->info('EXCEL_IMPORT_RESULT', $logData);
  }
}

excel-clean

Excel 数据清洗——去重、填补缺失值、格式转换。

下载

在导入逻辑中调用日志记录

第一步：在控制器导入方法开头捕获上传文件名；

第二步：执行逐行解析与数据库写入，同步统计成功/失败数量；

第三步：解析完成后立即调用 ExcelImportLogger::record()，传入全部参数；

示例关键片段：
$file = request()->file('excel');
$filename = $file->getOriginalName();
// ……（中间解析与入库逻辑）
ExcelImportLogger::record($filename, $totalRows, $successCount, $failCount, $errorList);

这一步不能放在 try-catch 的 finally 里——如果解析中途抛出未捕获异常，$errorList 就无法完整收集，必须在所有数据处理明确结束之后再写日志。