Yii2如何配置日志目标输出_Yii2配置日志目标输出方法【调试】

在Yii2应用里调了Yii::debug()或Yii::info()，结果日志就是憋不出来？别急着怀疑代码有问题——大概率是日志目标没配好。光有调用方法，没有配置目标，系统自然不知道要把这些消息往哪儿送。下面把这几种目标类型掰开揉碎，挨个说清楚。

一、启用 log 组件并配置 FileTarget

FileTarget 是最常用的日志目标，说白了就是把日志往 runtime/logs/ 目录下的文件里写。这个目标必须显式配置，而且一旦开启，需要确保 Web 服务器进程对这个目录有写入权限。

具体操作分几步走：

第一，在 config/web.php 的 components 配置块里加上 log 组件定义，同时务必确保 'bootstrap' => ['log'] 这个配置已经存在——很多问题都出在忘了这一项。

第二，在 log 组件的 targets 数组里，添加一条 class 为 'yii\log\FileTarget' 的配置项。

第三，通过 levels 参数来指定捕获哪些日志级别，比如 ['error', 'warning', 'info', 'trace', 'debug']。如果需要输出到特定文件，还可以用 logFile 指定路径，比如 '@runtime/logs/debug.log'。

第四，检查 runtime/logs/ 目录是否存在，以及 Web 用户（www-data 或 nginx）对它是否有写入权限——这一步往往是被忽略的关键点。

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

DbTarget 适合需要结构化查询和长期归档的场景。把日志写进数据库表，方便后续检索和分析，但前提是得有对应的表结构和可用的数据库连接组件。

配置起来也不复杂：在 config/web.php 的 log 组件 targets 里加一条 class 为 'yii\log\DbTarget' 的配置，指定 levels（比如 ['error', 'warning']），再确保 db 组件已在 components 中正确配置。

表结构这块，Yii2 提供了现成的迁移脚本。在项目根目录执行 ./yii migrate --migrationPath=@yii/log/migrations/ 就能自动创建 {{%log}} 表。如果要用自定义表名，在 DbTarget 配置里设置 logTable 属性即可，比如 '{{%app_log}}'。

三、启用 ConsoleTarget 输出至控制台

ConsoleTarget 专为 CLI 环境设计，比如命令行脚本或 cron 任务。日志直接打印到终端 stdout，对于调试和即时观察执行流来说非常直观。

配置也很直接：在 config/console.php 的 log 组件 targets 里加一条 class 为 'yii\log\ConsoleTarget' 的配置项，设置 levels 包含所需级别，比如 ['info', 'error', 'debug']。运行时日志会实时显示在终端，不需要刷新或查看文件。

需要注意的是，如果想同时输出到控制台和文件，可以在 targets 数组里并列配置 ConsoleTarget 和 FileTarget，两者互不冲突。

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

生产环境里，某些关键错误需要第一时间响应。EmailTarget 就是为此而生——在特定严重日志触发时自动发送邮件告警。

配置时需要注意几个细节：在 log 组件 targets 里添加 class 为 'yii\log\EmailTarget' 的配置项，然后通过 message 属性设置邮件主题（比如 'Yii2 Application Error Alert'）和 from/to 地址。levels 建议只设置 ['error']，避免警告或调试信息触发过多邮件，否则一旦出问题，邮箱可能会被塞爆。

还有个重要的前置条件：必须保证应用已配置有效的 mailer 组件（smtp 或 phpmail 均可），否则邮件发送会静默失败，没有任何提示。

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

默认情况下，FileTarget 把所有日志都写进同一个文件。业务模块一多，这种方式就不太够用了。通过继承 yii\log\FileTarget 并重写 getLogFileName() 方法，可以实现动态的日志文件分割。

具体做法：新建一个类文件，比如 common/components/ModuleFileTarget.php，继承 yii\log\FileTarget。然后重写 getLogFileName() 方法，根据 $message[2]（category）或 $message[0]（文本内容）来提取模块标识，比如 'api.auth' 或 'backend.user'。最后返回类似 @runtime/logs/{module}_{date}.log 的路径。

在 config/web.php 的 targets 里引用这个自定义类时，class 设置为 'common\components\ModuleFileTarget' 即可。这样一来，不同模块的日志会各自归位，分析时一目了然。