Yii2.0.55日志分级与轮转配置【排查Bug】

风萱大大_8780

风萱大大_8780

2026-08-09

972人浏览

原创

必须配置多级日志目标并禁用PHP轮转、启用logrotate:将error单独写入error.log,warning/info/trace写入app.log;每个FileTarget设enableRotation=>false,配合logrotate daily+copytruncate+dateext按日归档;同时设flushInterval=>1和exportInterval=>1确保错误秒级落盘。

yii2.0.55日志分级与轮转配置【排查bug】

排查Yii2.0.55线上Bug时,发现错误日志混在超大app.log里翻不到,warning和info又刷屏掩盖关键error——必须立刻分离日志级别并控制文件体积。

配置多级日志目标(error单独归档)

打开config/main.php或config/web.php,在'components' => ['log' => [...]]内修改'targets'数组:

删掉原有单个FileTarget配置,替换为两个并列目标:

方法一:error独立文件 + 其他级别合并

第一个target专抓error:设置'levels' => ['error'],'logFile' => '@runtime/logs/error.log';

第二个target抓warning/info/trace:设置'levels' => ['warning', 'info', 'trace'],'logFile' => '@runtime/logs/app.log';

【注意:两个target的logFile路径不能相同,否则会互相覆盖】

方法二:按模块分三级(适合中大型项目)

新增第三个target专捕debug:仅开发环境启用,'levels' => ['debug'],'logFile' => '@runtime/logs/debug.log',并在'except' => ['yii\db\*']排除数据库慢查询刷屏;

这一步做完后,Yii::error('DB timeout')只会写入error.log,不再淹没在app.log里。

关闭PHP层轮转,交由logrotate接管

第一步:强制禁用FileTarget自动切分

在每个FileTarget配置中添加'enableRotation' => false;

第二步:清空或注释掉'maxFileSize'和'maxLogFiles'——它们已失效;

第三步:确认所有'logFile'值是绝对路径,例如'@runtime/logs/error.log'最终解析为/var/www/myapp/runtime/logs/error.log;

【不关enableRotation会导致logrotate和PHP同时操作同一文件,100%丢日志】

第四步:用ls -l /var/www/myapp/runtime/logs/验证文件权限为644且nginx/php-fpm用户可写。

部署logrotate按日切分(生产必备)

创建配置文件:sudo vim /etc/logrotate.d/yii-app;

粘贴以下内容(路径需与上一步的logFile绝对路径匹配):

/var/www/myapp/runtime/logs/*.log {

daily

missingok

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载

rotate 30

compress

delaycompress

copytruncate

dateext

dateformat -%Y-%m-%d

}

执行sudo logrotate -d /etc/logrotate.d/yii-app调试模式检查语法;

无报错后运行sudo logrotate -f /etc/logrotate.d/yii-app立即触发一次切分;

观察ls /var/www/myapp/runtime/logs/是否生成error.log-2026-08-07这类带日期的归档文件。

确保日志即时可见(防缓冲丢失)

在log组件顶层配置中加入两项关键参数:

'flushInterval' => 1:每记录1条日志就刷新内存缓冲区;

'exportInterval' => 1:每1条日志就导出到目标文件;

这两项必须同时设为1,否则请求未结束前error可能卡在内存里不落盘;

验证方式:在控制器中写Yii::error('test-now');,立刻tail -f runtime/logs/error.log看是否秒级出现。

快速定位当前生效配置

第一步:在任意控制器action中插入

var_dump(Yii::$app->log->targets); exit;

第二步:访问对应URL,直接看到所有target的完整配置数组;

第三步:重点核对class、levels、logFile、enableRotation四项值;

如果logFile显示@runtime/logs/error.log而非真实路径,说明别名未解析——检查是否漏了Yii::setAlias('@runtime', ...)初始化。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2025.09.04

3110

22

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

2026.10.28

60

16

Vite 如何搭配 Vue.js
Vite 如何搭配 Vue.js

Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章,帮助读者完成从初始化到日常开发的配置。

2026.10.28

20

15

Vite 项目目录怎么看
Vite 项目目录怎么看

Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章,帮助读者理解各文件夹的用途与引用方式。

2026.10.28

40

10

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

2026.10.22

140

11

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

2026.10.22

80

10

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

2026.10.22

80

15

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

2026.10.22

40

10

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

2026.10.22

80

25

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习