php数据库mock测试核心是绕过真实连接,用模拟对象替代dao层或查询逻辑,实现快速稳定可重复的单元测试;常用方法包括phpunit mockbuilder、doctrine/laravel内存sqlite、pdo替换及mockery/prophecy等工具。

PHP 数据库 Mock 测试的核心是**绕过真实数据库连接,用可控的模拟对象替代 DAO 层或查询执行逻辑**,从而让单元测试快速、稳定、可重复。不依赖 MySQL/PostgreSQL 实例,也不需要清理测试数据。
使用 PHPUnit 的 MockBuilder 模拟数据库操作类
适用于已封装数据库访问逻辑的类(如 Repository、DAO)。
- 将数据库操作方法(如 find()、save())设为 public 或 protected,便于 mock
- 用 $this->createMock( UserRepository::class ) 创建模拟对象
- 通过 expects()->method()->willReturn() 预设返回值,例如返回固定数组或抛出异常
- 关键点:确保业务逻辑代码依赖的是接口或可注入的对象,而非 new PDO() 等硬编码实例
用 Doctrine DBAL 或 Laravel Eloquent 的测试专用驱动
框架级方案,更贴近真实行为但无需真实数据库。
- Doctrine 支持 pdo_sqlite 内存数据库:
sqlite::memory:,每次测试新建干净 schema - Laravel 中设置 DB_CONNECTION=sqlite + DB_DATABASE=:memory:,配合 RefreshDatabase trait 快速重置
- 优点:SQL 语法、事务、外键等行为接近真实环境;缺点:仍需启动 SQLite 引擎,不属于纯 Mock
替换 PDO 实例并拦截 query/execute 调用
适合无法重构 DAO 层、但又想隔离数据库的遗留项目。
立即学习“PHP免费学习笔记(深入)”;
- 通过依赖注入或构造函数传入 PDO 对象,在测试中传入自定义 PDO 子类或 Mock 对象
- Mock PDO::prepare() 返回一个 mock PDOStatement,再 mock 其 execute() 和 fetchAll()
- 注意:PDO 方法多为 final,建议用组合而非继承;更稳妥方式是封装一层 DatabaseConnection 接口再 mock
使用专门的 Mock 库(如 Mockery + prophecy)增强表达力
尤其适合复杂交互场景,比如验证 SQL 是否被正确拼接调用。
- Mockery 可模拟“伪造”的 PDOStatement,支持 shouldReceive('execute')->with(['id' => 123]) 校验参数
- Prophecy 可声明式描述行为:
$statement->fetch()->willReturn(['name' => 'Tom']) - 避免直接 mock 全局函数(如 mysql_connect),应先包装成可注入服务
纯 Mock 关注行为契约而非 SQL 执行,内存 DB 关注集成正确性。选哪种取决于测试目标:验证逻辑分支用 Mock,验证查询结构或关联结果用内存 SQLite。不复杂但容易忽略依赖解耦这一步。











