Yii2：Codeception测试时日志被拦截，如何写入文件？

我之前也碰到过这个问题，根源在于Codeception的Yii2连接器会默认替换掉Yii原生的日志组件——它用Codeception\Lib\Connector\Yii2\Logger来捕获所有日志，方便你在测试里做seeLogContains()这类断言，但这就导致你主配置里的FileTarget完全不生效，日志文件夹自然是空的。

下面给你三种可行的解决思路，你可以根据自己的需求选：

1. 全局禁用Codeception日志捕获（最简单） #

如果你不需要在测试中验证日志内容，只是想让日志正常写入文件，直接修改你的Codeception套件配置文件（比如tests/unit.suite.yml或tests/functional.suite.yml），把Yii2模块的log选项设为false：

modules:
    enabled:
        - Yii2:
            configFile: 'config/test.php'
            log: false  # 关闭Codeception的日志捕获，用Yii原生日志组件

这样修改后，Yii会完全使用你主配置里的日志组件，日志会正常写入你指定的文件。但注意：这样就不能再用Codeception提供的日志断言方法了，如果需要验证日志，得自己读取日志文件来做判断。

2. 单个测试临时恢复原生日志组件 #

如果你只是某几个测试需要日志写入文件，其他测试还要用Codeception的日志断言，可以在测试方法里手动切换日志组件：

public function testPaymentErrorLogsToFile()
{
    // 先保存Codeception的日志组件，测试完要恢复
    $originalLogger = Yii::$app->get('log');
    
    // 加载你主配置里的日志组件配置
    $logConfig = require __DIR__ . '/../../config/main.php';
    Yii::$app->set('log', $logConfig['components']['log']);
    
    // 执行你的业务代码，比如触发一个错误日志
    Yii::error('支付失败：订单ID 123');
    
    // 验证日志是否写入文件（可选）
    $logContent = file_get_contents(Yii::getAlias('@runtime/logs/app.log'));
    $this->assertStringContainsString('支付失败：订单ID 123', $logContent);
    
    // 恢复原来的日志组件，不影响其他测试
    Yii::$app->set('log', $originalLogger);
}

3. 自定义日志组件，同时支持捕获和写入文件 #

如果想鱼和熊掌兼得——既保留Codeception的日志断言，又让日志写入文件，可以自定义一个日志组件，继承Codeception的Logger并添加FileTarget：

首先创建自定义日志类（比如放在tests/components/CustomLogger.php）：

namespace tests\components;

use Codeception\Lib\Connector\Yii2\Logger as CodeceptionLogger;
use yii\log\FileTarget;

class CustomLogger extends CodeceptionLogger
{
    public function init()
    {
        parent::init();
        // 添加你的FileTarget配置，和主配置保持一致
        $this->targets[] = new FileTarget([
            'logFile' => '@runtime/logs/test.log',
            'levels' => ['error', 'warning', 'info'],
            'maxFileSize' => 1024 * 1024,
            'maxLogFiles' => 5,
        ]);
    }
}

然后在测试套件配置里指定使用这个自定义日志组件：

modules:
    enabled:
        - Yii2:
            configFile: 'config/test.php'
            logger: tests\components\CustomLogger

这样修改后，日志会同时被Codeception捕获（方便你用seeLogContains()断言），也会写入你指定的文件。

额外注意事项 #

• 确保测试环境下的日志目录（比如@runtime/logs）存在且有写入权限，测试前可以手动创建：

  mkdir(Yii::getAlias('@runtime/logs'), 0777, true);
  

• 不同的Codeception套件（unit/functional/acceptance）需要对应修改各自的配置文件。

内容的提问来源于stack exchange，提问作者Mik