必须配置多级日志目标并禁用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时,发现错误日志混在超大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
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', ...)初始化。











