laravel日志系统基于 Monolog 构建,支持文件、数据库 、Slack 等多种渠道。通过 config/Logging.php 配置通道,如 single、daily、slack 等,默认使用 stack 驱动聚合多个通道。可在。env 中设置 LOG_CHANNEL 指定默认通道。可自定义通道如 payment,按天分割日志并保留 14 天,写入特定文件。支持添加 Monolog处理器 和格式化器,如设置级别为 warning,自定义日志格式。还可运行时动态创建日志实例,用于临时任务。系统灵活,便于问题排查。

Laravel 的日志系统基于强大的 Monolog 库构建,提供了灵活的日志记录方式。你可以轻松将日志写入文件、标准输出、数据库、Slack、Telegram 等多种渠道。Laravel 通过配置驱动来管理不同的日志“通道”,让你能根据环境和需求选择合适的方式记录错误、调试信息或关键 事件。
默认日志配置
Laravel 的日志 配置文件 位于 config/logging.php。该文件定义了多个日志通道(channels),每个通道代表一种日志输出方式。默认情况下,Laravel 使用 stack 驱动作为主通道,它可以聚合多个日志通道。
常见内置驱动包括:
- single:单个日志文件(storage/logs/laravel.log)
- daily:按天分割日志文件,最多保留几天
- slack:发送日志到 Slack 频道
- syslog:写入系统日志
- Errorlog:使用 PHP 的 error_log 函数
- stderr:输出到标准错误流
在 .env 文件中可通过 LOG_CHANNEL 设置当前使用的通道,默认为 stack。
自定义日志通道
你可以在 config/logging.php 中的 channels 数组里添加自定义通道。例如,创建一个专门记录支付相关日志的 daily 类型通道:
'payment' => ['driver' => 'daily', 'path' => storage_path('logs/payment.log'), 'level' => 'debug', 'days' => 14, ],
然后在代码中使用这个通道:
Log::channel('payment')->info('订单支付成功', ['order_id' => 12345]);
这会将信息写入 storage/logs/payment-2025-04-05.log(按日期命名)。
使用 Monolog 自定义 处理器 和格式化器
Laravel 允许你在通道中注册 Monolog 的处理器(Handler)和格式化器(Formatter),实现更精细控制。
例如,添加一个只记录警告及以上级别的处理器,并自定义输出格式:
'custom_file' => ['driver' => 'monolog', 'handler' => MonologHandlerstreamHandler::class, 'with' => ['stream' => storage_path('logs/custom.log'), ], 'level' => 'warning', 'formatter' => MonologFormatterLineFormatter::class, 'formatter_with' => ['format' => "[%datetime%] %level_name%: %message% %context% %extra%n", 'date_format' => 'Y-m-d H:i:s', ], ],
这样配置后,只有 warning、error 等级别日志会被写入,且格式清晰统一。
运行时动态写入不同日志
除了预定义通道,你也可以在代码中动态创建日志实例:
$logger = new MonologLogger('runtime'); $logger->pushHandler(new MonologHandlerStreamHandler(storage_path('logs/runtime.log'), MonologLogger::INFO)); $logger->info('运行时日志', ['data' => 'example']);
适用于临时任务或特殊模块的日志隔离。
基本上就这些。Laravel 日志系统足够灵活,既能满足日常开发需求,也能通过 Monolog 扩展支持复杂场景。合理使用多通道和级别控制,能让日志更清晰、便于排查问题。
以上就是 Laravel 如何记录日志_Laravel Logging 系统配置与自定义日志通道的详细内容,更多请关注 php 中文网其它相关文章!