Laravel日志系统基于Monolog,支持single、daily等多种通道,可通过config/logging.php配置,使用Log门面按级别记录信息,并集成异常处理与第三方服务,便于问题定位与系统监控。

Laravel 内置了强大且灵活的日志系统,基于 Monolog 库构建,可以轻松记录应用运行过程中的各类信息,并根据环境配置不同的处理方式。合理使用日志功能,有助于快速定位问题、监控系统状态和优化性能。
配置日志通道
Laravel 的日志配置文件位于 config/logging.php,你可以在这里定义多个“通道”,每个通道代表一种日志输出方式。常见的内置驱动包括:
- single:单个日志文件,适用于开发环境
- daily:按天分割日志文件,便于归档和清理
- syslog:写入系统日志服务
- errorlog:写入 PHP 的 error_log
- slack:将错误通知发送到 Slack 频道
- papertrail:远程日志服务(如 Loggly、Papertrail)
在 .env 文件中通过 LOG_CHANNEL 指定默认通道,例如:
LOG_CHANNEL=daily使用日志门面记录信息
Laravel 提供了 Log 门面,支持多种日志级别,常见级别从低到高为:
- debug:调试信息
- info:一般信息性消息
- notice:需要注意的事件
- warning:警告但不影响运行
- error:错误但未导致程序中断
- critical:严重错误,需立即处理
- alert:需要立即采取行动
- emergency:系统不可用
在控制器或服务中使用示例:
use Illuminate\Support\Facades\Log;
Log::info('用户登录成功', ['user_id' => 123]);
Log::warning('请求超时', ['url' => 'https://api.example.com']);
Log::error('数据库连接失败', ['exception' => $e->getMessage()]);
你也可以指定通道写入:
Log::channel('slack')->error('应用崩溃!');
异常处理中的日志集成
Laravel 的异常处理机制会自动记录未捕获的异常。你可以在 app/Exceptions/Handler.php 中的 report() 方法中自定义日志行为:
public function report(Throwable $exception)
{
if (app()->bound('sentry') && $this->shouldReport($exception)) {
app('sentry')->captureException($exception);
}
parent::report($exception);
}
这样可以在记录日志的同时,将关键异常上报到 Sentry 等第三方监控平台。
日志文件管理与轮转
若使用 daily 通道,Laravel 默认最多保留 5 天的日志文件。可通过修改 logging.php 调整保留天数:
'daily' => [
'driver' => 'daily',
'path' => storage_path('logs/laravel.log'),
'level' => 'debug',
'days' => 14, // 保留14天
],
建议配合 Linux 的 logrotate 或定时任务定期清理旧日志,避免磁盘占用过高。
基本上就这些。Laravel 的日志系统开箱即用,结合多通道配置和结构化输出,能很好地满足开发、测试和生产环境的需求。关键是根据项目规模选择合适的驱动,并确保关键错误能被及时发现和响应。










