Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道-Laravel-PHP中文网

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

冰火之心

发布： 2025-12-19 15:16:59

原创

357人浏览过

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），实现更精细控制。

Copysmith

Copysmith是一款面向企业的 AI 内容创建解决方案

168

查看详情

例如，添加一个只记录警告及以上级别的处理器，并自定义输出格式：

'custom_file' => [
    'driver' => 'monolog',
    'handler' => \Monolog\Handler\StreamHandler::class,
    'with' => [
        'stream' => storage_path('logs/custom.log'),
    ],
    'level' => 'warning',
    'formatter' => \Monolog\Formatter\LineFormatter::class,
    'formatter_with' => [
        'format' => "[%datetime%] %level_name%: %message% %context% %extra%\n",
        'date_format' => 'Y-m-d H:i:s',
    ],
],

登录后复制

这样配置后，只有 warning、error 等级别日志会被写入，且格式清晰统一。

运行时动态写入不同日志

除了预定义通道，你也可以在代码中动态创建日志实例：

$logger = new \Monolog\Logger('runtime');
$logger->pushHandler(new \Monolog\Handler\StreamHandler(storage_path('logs/runtime.log'), \Monolog\Logger::INFO));

$logger->info('运行时日志', ['data' => 'example']);

登录后复制

适用于临时任务或特殊模块的日志隔离。

基本上就这些。Laravel 日志系统足够灵活，既能满足日常开发需求，也能通过 Monolog 扩展支持复杂场景。合理使用多通道和级别控制，能让日志更清晰、便于排查问题。

以上就是Laravel如何记录日志_Laravel Logging系统配置与自定义日志通道的详细内容，更多请关注php中文网其它相关文章！