0

0

Laravel怎么配置日志_Laravel Logging系统使用教程【监控】

穿越時空

穿越時空

发布时间:2026-03-03 12:58:03

|

565人浏览过

|

来源于php中文网

原创

绝大多数项目该用 stack,因其天然支持多通道写入,如同时写文件和 slack;single 仅适合极简调试,扩展性差;laravel 9+ 已弃用 app_log 环境变量切换驱动。

laravel怎么配置日志_laravel logging系统使用教程【监控】

日志驱动选 stack 还是直接用 single

绝大多数项目该用 stack,不是因为它“高级”,而是它天然支持多通道写入——比如同时往文件和 Slack 发错误,或者开发环境只打屏、生产环境写文件+发告警。直接硬切 single 容易卡死在后续扩展上。

  • stack 是 Laravel 日志的默认驱动,配置在 config/logging.php'default' 键里
  • single 适合极简调试,但一旦要加日志级别过滤、异步写入或转发到第三方,就得重配 stack + 多个 channel
  • 别改 APP_LOG 环境变量来切驱动——Laravel 9+ 已弃用这个旧方式,改了也不生效

daily channel 的保留天数怎么真正生效?

设了 'days' => 7 却发现旧日志没删?问题常出在没触发日志轮转时机,或权限不对。

  • 轮转只发生在新日志写入时:当天第一个 Log::error() 才会检查并清理 7 天前的文件
  • 确保 storage/logs/ 目录对 Web 服务器用户(如 www-data)可写,否则 daily 会静默失败
  • 手动清理可用 php artisan log:clear(Laravel 9.20+),但注意它清的是整个 logs/ 目录,不区分 channel

自定义 channel 时,tapvia 到底用哪个?

tap 是给现有 channel “加钩子”,via 是彻底接管日志创建逻辑——95% 的场景只需要 tap

  • tap 接收一个闭包,参数是刚实例化的 Monolog handler,适合加 formatter、filter 或 context 注入
  • via 要返回一个完整 handler 实例,得自己 new RotatingFileHandler 等,容易漏掉 Laravel 默认的异常上下文(如 request id)
  • 常见误用:tap 里 return 东西——它不接受返回值,return 会被忽略
// 正确:在 tap 里修改 handler 属性
'tap' => [function ($handler) {
    $handler->setFormatter(new \Monolog\Formatter\JsonFormatter());
}]

生产环境报 Unable to create configured logger 怎么快速定位?

这错误不告诉你具体哪错了,本质是 Monolog 初始化失败,优先查三处。

  • 路径权限:storage/logs/ 是否存在?Web 用户是否有写权限?用 ls -ld storage/logs
  • 磁盘空间:df -h/var/www 所在分区是否满,满会导致 fopen 失败
  • 配置语法:config/logging.php 里 channel 定义是否用了未定义的变量?比如写了 'path' => storage_path('logs/' . env('LOG_FILE_NAME')),但 LOG_FILE_NAME 没在 .env 里设,结果 path 变成 logs/,末尾斜杠会触发 Monolog 报错
Laravel 日志真正的复杂点不在配置语法,而在 channel 生命周期和 Monolog handler 的初始化时机——很多问题只在第一次写日志时暴露,且不报具体原因。动手前先确认 storage/logs/ 可写、磁盘有空、.env 里所有 env() 引用都已定义。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

338

2024.04.09

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

290

2024.04.09

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

708

2024.04.09

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

384

2024.04.10

laravel入门教程
laravel入门教程

本专题整合了laravel入门教程,想了解更多详细内容,请阅读专题下面的文章。

133

2025.08.05

laravel实战教程
laravel实战教程

本专题整合了laravel实战教程,阅读专题下面的文章了解更多详细内容。

82

2025.08.05

laravel面试题
laravel面试题

本专题整合了laravel面试题相关内容,阅读专题下面的文章了解更多详细内容。

75

2025.08.05

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

411

2023.10.18

Swift iOS架构设计与MVVM模式实战
Swift iOS架构设计与MVVM模式实战

本专题聚焦 Swift 在 iOS 应用架构设计中的实践,系统讲解 MVVM 模式的核心思想、数据绑定机制、模块拆分策略以及组件化开发方法。内容涵盖网络层封装、状态管理、依赖注入与性能优化技巧。通过完整项目案例,帮助开发者构建结构清晰、可维护性强的 iOS 应用架构体系。

0

2026.03.03

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

PHP自制框架
PHP自制框架

共8课时 | 0.6万人学习

PHP面向对象基础课程(更新中)
PHP面向对象基础课程(更新中)

共12课时 | 0.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号