ThinkPHP 8 中 php think test 命令已移除,必须使用原生 phpunit;需确保 phpunit.xml 在根目录并配置 tests 目录、测试文件以 Test.php 结尾、类继承 PHPUnit\Framework\TestCase,缺一即报 “no tests found”。

php think test 命令在 ThinkPHP 8 中已彻底移除,直接运行会提示 “Command not found” 或静默退出——这不是配置错误,是框架设计变更:测试必须交由原生 phpunit 管理。
怎么让 phpunit 找到你的测试类
PHPUnit 默认不扫描任意路径下的任意文件,它只认严格符合三要素的测试入口:
-
phpunit.xml必须放在项目根目录(和app/、public/同级),且包含<directory suffix="Test.php">tests</directory> - 测试文件必须放在根目录下的
tests/目录(不是app/tests或tests/Unit) - 文件名必须以
Test.php结尾,例如UserModelTest.php;类名必须完全一致,即class UserModelTest - 类必须继承
PHPUnit\Framework\TestCase,别用 TP6 旧文档里的think\testing\TestCase(TP8 已删)
漏掉任一条件,./vendor/bin/phpunit 就会报 “no tests found” 或 “Class not found”。
Model 测试为什么 save() 报 Call to a member function query() on null
直接 new User() 绕过了容器初始化,模型内部的 $this->db 是 null。TP8 的 Model 依赖容器注入数据库连接、事件系统、自动时间戳等能力。
- 要测完整生命周期逻辑(如关联查询、事件钩子、
append属性),必须用\think\Container::get(\app\model\User::class) - 如果只是构造测试数据(不查库、不写库),可用
User::make(['name' => 'test']),它跳过容器但保留字段处理逻辑 -
Container::get()默认不加载应用配置,测数据库前需在setUp()中手动调用\think\App::init()或显式绑定\think\db\Connection - 别在测试里写
User::where()->find()——这跳过模型实例,hidden、getAttr全部不生效
控制器测试不能 (new IndexController())->index()
那样调用等于绕过整个 HTTP 生命周期:路由未解析、中间件未执行、验证器未触发、$this->request 为 null,测出来的是“裸函数”,跟真实请求行为偏差极大。
立即学习“PHP免费学习笔记(深入)”;
- 必须模拟真实请求,推荐用 TP8 内置的
think\testing\Mocker:$this->mockRequest('GET', '/user/123', ['id' => 123]) - 需要控制 header、cookie 或 HTTPS 时,手动构造:
Request::create('/api/user', 'GET', [], [], [], ['HTTP_HOST' => 'api.example.com', 'HTTPS' => 'on']),再通过App::bind('request', $request)注入 - 每个测试末尾加
Request::clear(),否则上一个测试的请求上下文可能污染下一个 - 多域名场景下,
$_SERVER['HTTP_HOST']必须在setUp()中显式设置,并在tearDown()清理
数据库测试怎么避免脏数据和慢速
真连 MySQL 会导致 CI 失败、本地数据残留、速度慢——这不是风格问题,是可靠性问题。
- 优先用 SQLite 内存库:
sqlite::memory:,速度快、隔离性好;但建表得自己写Db::execute(),TP 不自动迁移 - 若需 Mock,别 Mock
think\db\Connection实例,而应 Mock 门面:Mockery::mock('alias:think\Db'),再用$this->app->bind('think\Db', $mockDb)替换 - 事务必须显式控制:在
setUp()调Db::startTrans(),在tearDown()强制Db::rollback();依赖 PHPUnit 的@before/@after注解会失效 - 测试中别用
Db::table()->insert()直写,优先走模型层,便于统一替换连接或 mock 行为
最易被忽略的是环境初始化:没在 tests/bootstrap.php 里调 think\initializer\Bootstrap::init(),模型、Db、配置全不可用;还有 phpunit.xml 里漏掉 bootstrap="vendor/autoload.php",导致类根本加载不了。



















