ThinkPHP怎么写单元测试_ThinkPHP PHPUnit测试用例编写入门教程【教程】

ThinkPHP怎么写单元测试_ThinkPHP PHPUnit测试用例编写入门教程【教程】

如果你还在用 php think test 来跑 ThinkPHP 8 的单元测试，那大概率会碰壁。框架已经彻底转向原生 PHPUnit 了。换句话说，没配好 phpunit.xml 或者测试文件放错了位置，直接运行 ./vendor/bin/phpunit 只会得到 “no tests found” 或者类加载失败的提示。

为什么 php think test 报错或没反应

原因很简单：TP8 官方已经移除了 think:test 这个命令。这并非插件安装错误，而是框架设计思路的转变——测试这件事，完全交还给 PHPUnit 自己来管理。

• 执行 php think test 提示 Command not found：这是正常现象，命令本身已不存在。
• 执行后静默退出、没有任何输出：问题很可能出在缺少 phpunit.xml 配置文件，或者 tests/ 目录下没有符合命名规范的测试类。
• 报错 Class 'PHPUnit\Framework\TestCase' not found：要么是 PHPUnit 没安装，要么是 phpunit.xml 里漏写了 bootstrap="vendor/autoload.php" 这一行。

测试类怎么命名、放哪、怎么写

PHPUnit 的规则很明确，它只认准特定的路径和命名格式。具体来说，它会扫描 tests/ 目录下，所有类名以 Test 结尾、并且方法名以 test 开头的 public 方法。

• 目录：必须是项目根目录下的 tests/，放在 app/tests 或者 tests/Case 里是无效的。
• 文件名：例如 UserServiceTest.php，对应的类名必须严格是 UserServiceTest。
• 测试方法：必须是 public function testShouldUpdateUser() 这种形式，不能带参数，也不能是 protected。
• 继承类：请继承 PHPUnit\Framework\TestCase。注意，TP6 老文档里提到的 think\testing\TestCase 在 TP8 中已经被弃用了。

Model 测试为什么 sa ve() 报 Call to a member function query() on null

这个问题很典型。直接使用 new User() 来实例化模型，绕过了容器的初始化流程，导致模型内部的 $this->db 数据库连接对象为 null。在 TP8 中，模型的数据库连接、事件系统等核心功能都依赖容器来注入。

立即学习“PHP免费学习笔记（深入）”；

• 正确做法：使用 $user = \think\Container::get(\app\model\User::class); 来获取一个拥有完整生命周期的模型实例。
• 仅构造数据：如果只是构建数据对象而不操作数据库，可以用 User::make(['name' => 'test'])。这个方法会跳过容器，但依然保留时间戳、自动填充等模型逻辑。
• 重要提醒：Container::get() 默认不会加载应用的全部配置。要测试数据库操作，需要在测试类的 setUp() 方法里手动调用 \think\App::init()，或者显式绑定 \think\db\Connection。
• SQLite 内存库：推荐使用 sqlite::memory:，速度快且测试隔离性好。但需要自己写 DB::execute() 来建表，ThinkPHP 不会自动迁移表结构。

控制器测试不能直接 new Controller()->action()

直接调用控制器方法，等于跳过了整个 HTTP 生命周期：路由解析、中间件、验证器、请求对象绑定全部失效。这样测出来的只是一个“裸函数”，与真实的线上行为偏差极大。

• 模拟请求：使用 TP8 内置的 think\testing\Mocker 可以快速模拟，例如 $this->mockRequest('GET', '/user/123')。
• 控制请求细节：如果需要自定义 header、cookie 或 body，可以手动创建 think\Request 实例，然后通过 think\facade\Request::bind($request) 进行绑定。
• 清理状态：每个测试结束后，务必加上 think\facade\Request::clear()。否则，上一个测试设置的 param 或 header 会污染到下一个测试。
• 语义化调用：不要在测试里直接调用 $controller->index()。更推荐走 $this->get('/user') 这类语义化的方法。不过，TP8 官方并未内置 think\testing\TestCase 扩展，需要自己封装，或者直接使用原生 PHPUnit 配合 Mocker 来实现。

最后，也是最容易被忽略的一点：TP8 的测试已经完全脱离了框架的命令体系。这意味着所有的初始化、配置加载、环境清理都需要手动接管。比如数据库事务回滚、中间件的开关、Facade 的绑定状态——这些都不会自动重置，全靠你在 setUp() 和 tearDown() 方法里写清楚。一旦漏掉一次 Request::clear() 或者 DB::disconnect()，就可能导致后续某个测试莫名其妙地失败。