Laravel提供五种日志记录方式：一、用Log门面调用八种级别方法；二、用logger()辅助函数快速记录；三、配置自定义通道如audit并显式调用；四、在Handler的report()中扩展异常上下文；五、通过Monolog处理器注入request_id等元数据。
如果您在开发 Laravel 应用时需要捕获运行时行为、错误细节或调试上下文，系统日志是关键的可观测性手段。Laravel 内置了灵活的日志机制，支持多种驱动与通道配置。以下是记录系统日志信息的多种方法：
一、使用 Log 门面写入日志
Log 门面是 Laravel 提供的最常用日志写入方式，底层调用 Illuminate\Log\LogManager，自动路由到默认或指定通道，适用于绝大多数调试场景。
1、在控制器、服务类或闭包中引入 Log 门面：use Illuminate\Support\Facades\Log;
2、调用不同日志级别方法写入信息：Log::info('用户登录成功', ['user_id' => 123]);
3、支持 debug、info、notice、warning、error、critical、alert、emergency 八种标准级别，例如：Log::error('数据库查询失败', ['sql' => $query, 'bindings' => $bindings]);
二、通过辅助函数 logger() 记录日志
logger() 是 Laravel 提供的全局辅助函数，本质是 Log 门面的快捷封装，适合快速调试且无需 use 声明的轻量场景。
1、直接在任意 PHP 文件中调用：logger('订单创建流程开始');
2、传入数组作为上下文时，自动使用 info 级别：logger(['order_id' => 'ORD-789', 'status' => 'pending']);
3、显式指定级别需链式调用：logger()->warning('缓存命中率低于阈值', ['rate' => 0.42]);
三、配置自定义日志通道并写入
当默认 stack 或 single 通道无法满足隔离需求（如将审计日志单独写入 audit.log），可通过 config/logging.php 定义新通道，并在代码中显式调用。
1、编辑 config/logging.php，在 'channels' 数组中添加：'audit' => ['driver' => 'single', 'path' => storage_path('logs/audit.log'), 'level' => 'info'],
2、在代码中获取该通道实例：$auditLog = Log::channel('audit');
3、向该通道写入日志：$auditLog->info('用户修改了个人资料', ['user_id' => auth()->id(), 'changes' => $diff]);
四、在异常处理器中自动记录未捕获异常
App\Exceptions\Handler 类负责全局异常处理，默认已在 report() 方法中调用 Log::error，但可扩展以增强调试信息。
1、打开 app/Exceptions/Handler.php，定位 report() 方法。
2、在父类调用前插入上下文增强逻辑：if ($exception instanceof \Illuminate\Database\QueryException) { Log::error('SQL 异常详情', ['sql' => $exception->getSql(), 'bindings' => $exception->getBindings(), 'message' => $exception->getMessage()]); }
3、确保仍调用 parent::report($exception) 以保留默认行为。
五、使用 Monolog 原生处理器注入额外字段
当需在每条日志中强制附加请求 ID、环境名或用户 IP 等元数据时，可直接操作底层 Monolog Logger 实例。
1、在 App\Providers\AppServiceProvider 的 boot() 方法中获取日志实例：$logger = Log::getLogger();
2、添加 Processor 回调注入 request_id：$logger->pushProcessor(function ($record) { $record['extra']['request_id'] = request()->header('X-Request-ID', 'N/A'); return $record; });
3、后续所有通过 Log::xxx 写入的日志都将包含该 extra 字段。
