在Yii2.0.55生产环境中，不合理的日志配置往往导致磁盘空间耗尽或关键错误信息被淹没。本文如何通过配置log组件实现日志分级（Levels）与日志轮转（Rotation），通过精准的日志策略快速排查Bug，提升应用的可维护性。
你是否遇到过线上服务器突然报警，磁盘I/O飙升，排查后发现是runtime/logs目录下的日志文件撑爆了磁盘？😱 或者当系统出现Bug时，面对动辄几个G的混合日志，根本无法快速定位错误源头？在复杂的Web应用中，日志是系统的“黑匣子”，但如果没有正确的配置，它就会变成一堆无用的“垃圾”。针对Yii2.0.55版本，掌握日志的分级过滤与自动轮转机制，是每一位开发者从“救火”转向“防火”的必经之路。🔥
1. 日志分级：过滤噪音，聚焦核心 🎯
Yii2的日志系统支持多种级别，合理配置级别可以避免记录无关紧要的信息，从而提升性能并降低存储压力。
在config/web.php或common/config/main.php中，通过levels属性进行配置：
'components' => [
'log' => [
'targets' => [
[
'class' => 'yii\log\FileTarget',
'levels' => ['error', 'warning', 'info'], // 仅记录这三个级别
'logFile' => '@runtime/logs/app.log',
],
],
],
],常见级别解析：
-
error：致命错误，必须立刻处理（如数据库连接失败）。❌
-
warning：警告信息，不影响运行但需关注（如弃用API）。⚠️
-
info：运行时的关键业务节点（如用户登录成功）。ℹ️
-
trace：调试专用，记录变量详情，生产环境务必关闭。🔍
排查Bug技巧：在排查特定Bug时，可以临时将levels改为['error']，瞬间过滤掉大量干扰信息，直击崩溃点。
2. 日志轮转：防止磁盘爆满的“安全阀” 🔄
日志轮转（Log Rotation）是指当日志文件达到指定大小或日期时，自动归档并创建新文件的过程。Yii2.0.55的FileTarget内置了强大的轮转功能。
核心配置参数：
-
maxFileSize：单个日志文件的最大值（单位：MB）。默认10MB。 -
maxLogFiles：保留的归档文件数量。默认5个。 -
rotateByCopy：在Windows环境下建议设为true，避免日志丢失。
推荐的生产环境配置：
'log' => [
'targets' => [
[
'class' => 'yii\log\FileTarget',
'levels' => ['error', 'warning'],
'logFile' => '@runtime/logs/app.log',
'maxFileSize' => 1024 * 5, // 5MB
'maxLogFiles' => 30, // 保留30个文件，约150MB上限
'rotateByCopy' => true,
'exportInterval' => 100, // 每100条消息写一次文件，减少IO
],
// 单独记录错误日志，便于监控
[
'class' => 'yii\log\FileTarget',
'levels' => ['error'],
'logFile' => '@runtime/logs/error.log',
'maxFileSize' => 1024 * 10,
'maxLogFiles' => 50,
]
],
],配置解析：通过分离error日志与普通warning日志，运维人员可以直接监控error.log文件，无需在海量数据中筛选。📊
3. 结合Trace级别进行深度调试 🛠️
当遇到复杂的逻辑Bug，且无法通过error日志复现时，可以开启trace级别。
// 在开发环境配置中
'levels' => ['error', 'warning', 'info', 'trace'],配合Yii::trace()方法，可以将关键变量的值输出到日志中。但请注意，上线前务必关闭，否则会产生巨大的性能开销和安全风险（如泄露敏感数据）。🔒
4. 日志性能优化建议 ⚡
-
减少
exportInterval的默认值：默认是1000，如果并发高，建议改为100或50，防止内存中堆积过多日志。 -
使用
flushInterval：控制内存中的日志刷新频率。 -
禁用
enablePrettyPrint：在生产环境JSON格式日志更易于被ELK等日志分析系统采集。
结尾
通过精细化的日志分级与轮转配置，Yii2.0.55应用不仅能有效规避磁盘空间风险，更能在故障发生时提供清晰的排查路径。日志配置并非一劳永逸，建议根据业务增长定期审视maxFileSize与maxLogFiles的设置。良好的日志习惯，是构建高可用系统的基石。🚀
