Yii2日志输出配置方法详解

在 Yii2 应用中，调用 Yii::debug()、Yii::info() 等日志方法却看不到输出？问题几乎都出在日志目标（Target）未正确配置或未启用——本文直击核心，手把手教你精准配置 FileTarget（按模块分文件写入）、DbTarget（自动建表存库）、ConsoleTarget（CLI 实时终端输出）、EmailTarget（错误自动邮件告警）以及自定义 FileTarget，并逐一强调权限设置、组件依赖、表结构迁移、mailer 配置等关键细节，帮你彻底打通 Yii2 日志系统的“最后一公里”。

如果您在 Yii2 应用中调用了 Yii::debug()、Yii::info() 等方法，但未在预期位置（如文件或数据库）看到日志内容，则很可能是日志目标（Target）未正确配置或未启用。以下是配置日志目标输出的具体方法：

一、启用 log 组件并配置 FileTarget

FileTarget 是最常用的目标类型，用于将日志写入 runtime/logs/ 目录下的文件。该目标需显式声明并加入 targets 数组，且必须确保 web 服务器进程对 runtime/logs/ 具有写权限。

1、在 config/web.php 的 components 配置块中添加 log 组件定义，并确保 'bootstrap' => ['log'] 已存在。

2、在 log 组件的 targets 数组中，加入一个 class 为 'yii\log\FileTarget' 的配置项。

3、设置 levels 指定捕获的日志级别（如 ['error', 'warning', 'info', 'trace', 'debug']），并可选配置 logFile 指向自定义路径（如 '@runtime/logs/debug.log'）。

4、确认 runtime/logs/ 目录存在且 web 用户（如 www-data 或 nginx）拥有写入权限。

二、配置 DbTarget 将日志存入数据库

DbTarget 可将日志消息持久化至数据库表，适用于需要结构化查询与长期归档的场景。其依赖预设的数据表结构，且需确保数据库连接组件已正确定义。

1、在 config/web.php 的 log 组件 targets 中添加 class 为 'yii\log\DbTarget' 的配置项。

2、指定 levels（如 ['error', 'warning']），并确保 db 组件已在 components 中正确定义且可用。

3、在项目根目录执行命令：./yii migrate --migrationPath=@yii/log/migrations/，以创建 {{%log}} 表。

4、若使用自定义表名或前缀，需在 DbTarget 配置中设置 logTable 属性（如 '{{%app_log}}'）。

三、启用 ConsoleTarget 输出至控制台

ConsoleTarget 专用于 CLI 环境（如命令行脚本或 cron 任务），将日志直接打印到终端 stdout，便于调试和即时观察执行流。

1、在 config/console.php 的 log 组件 targets 中添加 class 为 'yii\log\ConsoleTarget' 的配置项。

2、设置 levels 包含所需级别（如 ['info', 'error', 'debug']）。

3、运行命令时，日志将实时显示在终端，无需刷新或查看文件。

4、若需同时输出到控制台与文件，可在 targets 数组中并列配置 ConsoleTarget 和 FileTarget。

四、配置 EmailTarget 在异常时发送邮件通知

EmailTarget 用于在发生特定严重日志（如 error）时自动触发邮件告警，适用于生产环境关键故障响应。

1、在 log 组件 targets 中添加 class 为 'yii\log\EmailTarget' 的配置项。

2、配置 message 属性，设定邮件主题（如 'Yii2 Application Error Alert'）及 from/to 地址。

3、设置 levels 仅限 ['error']，避免警告或调试信息触发过多邮件。

4、确保应用已配置有效的 mailer 组件（如 smtp 或 phpmail），否则邮件发送将失败且无提示。

五、自定义 FileTarget 实现按模块分文件记录

默认 FileTarget 将所有日志写入同一文件，不利于按业务模块隔离分析。通过继承 yii\log\FileTarget 并重写 getLogFileName() 方法，可实现动态日志文件路径生成。

1、新建类文件 common/components/ModuleFileTarget.php，继承 yii\log\FileTarget。

2、重写 getLogFileName() 方法，根据 $message[2]（category）或 $message[0]（文本内容）提取模块标识（如 'api.auth'、'backend.user'）。

3、返回形如 @runtime/logs/{module}_{date}.log 的路径。

4、在 config/web.php 的 targets 中引用该类，class 设置为 'common\components\ModuleFileTarget'。

到这里，我们也就讲完了《Yii2日志输出配置方法详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！