Yii2基础模板单元测试：如何用Yii2方式自动加载接口？

问题场景 #

目录结构如下：

tests/unit
├── _bootstrap.php
└── models
    ├── AgamaTest.php        (测试类)
    └── ICrudUnitTest.php    (接口类)

接口代码（ICrudUnitTest.php） #

<?php

namespace tests\unit\models;

interface ICrudUnitTest
{
    public function testValidation();

    public function testInsertWithValidAttribute();

    public function testFindById();

    public function testDeleteById();

    public function testUpdateById();
}

测试类代码（AgamaTest.php） #

<?php

namespace tests\unit\models;

use app\models\Agama;
use Codeception\Specify;
use Codeception\Test\Unit;
use UnitTester;

class AgamaTest extends Unit implements ICrudUnitTest
{
    use Specify; 
    // 测试代码...
}

执行测试命令codecept run unit models/AgamaTest.php时出现错误：

Fatal error: Uncaught Error: Interface 'tests\unit\models\ICrudUnitTest' not found in /var/www/html/tests/unit/models/AgamaTest.php:10

已知通过Composer配置PSR-4自动加载并执行composer dump-autoload可以解决：

"autoload": {
  "psr-4": {
    "tests\\": "tests"
  }
}

需求：用Yii2自身的方式自动加载该接口，是否需要修改或添加相关配置？

Yii2自身解决方案 #

方法1：直接映射单个类（适用于少量接口/类） #

修改tests/unit/_bootstrap.php，通过Yii的类映射指定接口文件路径：

<?php

// 保留原有引导代码
require __DIR__ . '/../../vendor/autoload.php';
require __DIR__ . '/../../vendor/yiisoft/yii2/Yii.php';

// 添加接口类的映射
Yii::$classMap['tests\unit\models\ICrudUnitTest'] = __DIR__ . '/models/ICrudUnitTest.php';

Yii会在需要加载该接口时，直接读取指定路径的文件。

方法2：注册整个命名空间（适用于多个测试类/接口） #

同样在tests/unit/_bootstrap.php中，通过Yii的类加载器注册整个命名空间的路径：

<?php

// 保留原有引导代码
require __DIR__ . '/../../vendor/autoload.php';
require __DIR__ . '/../../vendor/yiisoft/yii2/Yii.php';

// 注册测试models命名空间的PSR-4映射
$loader = Yii::$classLoader;
$loader->addPsr4('tests\\unit\\models\\', __DIR__ . '/models');

这种方式和Composer的PSR-4配置逻辑一致，但完全通过Yii的加载器实现，无需修改composer.json。

注意事项 #

• Yii2的自动加载机制原生兼容PSR-4标准，上述两种方法本质是通过Yii的加载器注册命名空间与文件路径的映射，和Composer方案原理相同，但不需要修改Composer配置。
• 若后续需要新增更多测试接口或类，方法2的扩展性更强，只需维护命名空间对应的路径即可。

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