Laravel中怎么使用Log日志_Laravel Log日志等级与存储【教程】

laravel的log门面默认可用，但日志等级控制、多通道输出、文件轮转和敏感信息过滤需配置config/Logging.php；info日志用log::info(‘msg’, $context)，注意环境差异与权限问题。

直接说结论：Laravel 的 Log 门面默认就可用，不用额外配置就能写日志；但日志等级控制、多通道输出、文件轮转和敏感信息过滤，得靠改 config/logging.php 和理解底层驱动行为。

怎么快速写一条 info 日志？

最常用也最容易出错的其实是「以为写了就一定进文件」。Laravel 默认在 APP_ENV=local 时写入 storage/logs/laravel.log，但生产环境（APP_ENV=production）默认用 stack 驱动，实际可能走 daily 或 stderr，取决于配置。

• Log::info('用户登录成功', ['user_id' => 123]); —— 推荐带上下文数组，方便结构化检索
• 别用 echo 或 dd() 替代日志，尤其在队列或命令行任务里，它们根本不会落地
• 如果没看到日志，先检查 storage/logs/ 目录权限是否为 755 且 web server 可写

debug/info/warning/Error 这些等级怎么选？

等级不是按「严重程度」粗略划分，而是和后续处理强绑定。比如 error 级别会触发 Slack/Webhook 通知（如果你配了），而 debug 在生产环境默认被丢弃。

• Log::debug()：仅开发环境有效，生产环境即使开了 LOG_LEVEL=debug，也建议关掉——量太大易拖慢性能
• Log::warning()：用于可恢复的异常，比如第三方 API 返回 404 但有降级逻辑
• Log::error()：必须人工介入的问题，如数据库事务失败、支付回调验签失败
• 别滥用 Log::emergency() 或 Log::alert()，这些会触发系统级告警，多数项目根本没接通对应通道

怎么让不同日志写到不同文件？

靠自定义 channel，不是靠改 Log::xxx() 的调用方式。核心是编辑 config/logging.php，加一个以 daily 或 single 为 driver 的新 channel。

/*  * config/logging.php 内追加：  */ 'channels' => [     // ...     'payment' => [         'driver' => 'daily',         'path' => storage_path('logs/payment.log'),         'level' => 'debug',         'days' => 14,     ], ],

• 然后用 Log::channel('payment')->info('支付请求发出');
• 注意：每个 channel 是独立实例，level 和 handler 不共享
• 如果想让某个 channel 同时推送到 sentry，就在它的配置里加 'tap' => [AppLoggingSentryTap::class]

为什么有些日志内容被自动脱敏了？

Laravel 7+ 默认启用了日志敏感字段过滤，只要字段名匹配 password、Token、secret 等关键词，值就会变成 ***。这个行为在 IlluminateLogLogger 中硬编码，不走配置。

• 查看过滤列表：源码里搜 $this->dontDisplaySensitiveFields
• 自定义过滤需重写 createPdoHandler() 或继承 Logger，但更推荐在打日志前手动处理：Log::info('登录请求', ['email' => $request->email, 'password' => '[hidden]']);
• 别依赖日志查原始密码或 token——这本身就不符合安全规范

真正容易被忽略的是：日志轮转（daily 驱动）依赖系统时间而非写入时间，跨月日志可能混在一个文件里；还有就是队列任务中用 Log::stack() 时，上下文变量可能因序列化丢失，得显式传参。