Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道

3次阅读

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

Laravel 如何记录日志_Laravel Logging 系统配置与自定义日志通道

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 中文网其它相关文章!

站长
版权声明:本站原创文章,由 站长 2025-12-19发表,共计1848字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
1a44ec70fbfb7ca70432d56d3e5ef742
text=ZqhQzanResources