首页 > 编程语言 >TP5.1 编写单元测试：PHPUnit 模拟数据库与 Mock 对象

TP5.1 编写单元测试：PHPUnit 模拟数据库与 Mock 对象

来源：互联网 2026-07-11 07:57:16

PHP资讯合集

TP5.1单元测试应解耦静态调用，将数据库操作封装为可注入的Repository/Service类，利用Mockery或PHPUnitmock自定义DAO层，禁用Db/Model静态调用，避免直接mockDb类，不推荐使用SQLite内存库。

ThinkPHP5.1单元测试需解耦静态调用，将Db/Model操作封装为可注入的Repository/Service类，用Mockery部分mock或PHPUnit mock自定义DAO层，禁用Db::/Model::静态调用，避免直接mock Db类，并慎用SQLite内存库。

直接使用 PHPUnit 执行原生 ThinkPHP5.1 代码，通常无法通过测试。ThinkPHP5.1 的自动加载、数据库连接、配置加载等机制与标准 PHPUnit 测试环境不兼容。若不手动桥接或重构依赖注入方式，Db::table()、Model::get() 这类静态调用会自动连接真实数据库，导致测试不可控且无法重复执行。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

TP5.1 单元测试前必须解耦数据库静态调用

ThinkPHP5.1 大量依赖 Db 和 Model 的静态方法，这直接导致 PHPUnit 无法对它们进行 mock。例如 Db::name('user')->where(...)->select() 无法被 mock，因为静态调用只能被实例对象 mock。因此，首要步骤是：

将所有数据库操作封装进 Repository 或 Service 类，并通过构造函数或 Setter 注入依赖，例如传入 Db 实例或自定义的 QueryInterface。
禁用 Db:: 和 Model:: 的静态调用，改用 $this->db 或 $this->userModel 等实例属性。
业务逻辑类中避免直接 new 任何 ThinkPHP 核心类，全部采用依赖注入（即使仅传入一个 PDO 或 Connection 对象）。

使用 `createMock()` 替换 DAO 层，而非模拟 `Db`

不应尝试 mock Db 类本身，因为它包含大量静态、final 方法，mock 成功率低。正确做法是 mock 自定义的数据访问层。

假设创建了 UserRepository，内部使用 $this->db 执行查询。测试时可直接 $mockRepo = $this->createMock(UserRepository::class)。
使用 expects()->method('findByName')->willReturn(['id' => 1, 'name' => 'Alice']) 控制返回值。
如需验证调用参数，加上 with($this->equalTo('admin'))，注意避免因字符串空格或类型隐式转换导致断言失败。
注意 mock 对象默认不继承原方法的 type hint。若原方法有 array $where 等类型声明，mock 返回值也需匹配，否则运行时会报 Fatal error。

TP5.1 中 SQLite 内存库不推荐用于单元测试

sqlite::memory: 虽然表面简洁，但在 ThinkPHP5.1 中实际存在较多问题：配置复杂、事务行为与 MySQL 不一致、外键默认关闭，且 Db 类对内存库的适配不完整，某些聚合函数可能报错。

TP5.1 的 database.php 不支持直接设置 'dsn' => 'sqlite::memory:'，需要额外 patch think\db\connector\Sqlite。
即便配置成功，也可能出现 Db::table('user')->insert() 后再 select 查不到数据的情况，因为 TP5.1 的连接复用机制在内存库下容易丢失上下文。
真正需要验证 SQL 行为（如 join、group by）的场景，才考虑使用 RefreshDatabase 配合真实 SQLite 文件（非内存），并在 setUp() 中清空数据。

Mockery 比 PHPUnit 原生 Mock 更适合 TP5.1 场景

ThinkPHP5.1 的类往往包含复杂构造逻辑（如自动读取配置、初始化连接），PHPUnit 的 createMock() 创建空对象后，很多方法调用会直接 fatal。Mockery 支持更灵活的“伪造”和部分 mock。

安装命令：composer require --dev mockery/mockery
写法示例：$mockDb = Mockery::mock('think\db\Query')->makePartial()，然后 shouldReceive('select')->andReturn([['id'=>1]])。
关键点：使用 makePartial() 保留原方法的骨架，只 mock 需替换的部分。否则 select() 调用时可能因未 mock 内部的 parseWhere() 等方法而崩溃。
测试结束时务必调用 Mockery::close()，通常放在 tearDown() 中，避免残留 mock 影响后续测试。