当前位置:

首页 > 编程开发 > ThinkPHP 8.0 单元测试(PHPUnit)入门指南【测试】

ThinkPHP 8.0 单元测试(PHPUnit)入门指南【测试】

想在 ThinkPHP 8.0 项目里跑通第一个单元测试,结果执行 php think test 报错“Command not found”,或者用 ./vendor/bin/phpunit 跑却提示“No tests found”、类加载失败、Call to a member function q

想在 ThinkPHP 8.0 项目里跑通第一个单元测试,结果执行 php think test 报错“Command not found”,或者用 ./vendor/bin/phpunit 跑却提示“No tests found”、类加载失败、Call to a member function query() on null——先别怀疑代码写错了,问题出在 TP8 彻底移除了内置测试命令,所有环节必须手动对齐 PHPUnit 原生规范,一步都不能少。

ThinkPHP 8.0 单元测试(PHPUnit)入门指南【测试】

安装与验证 PHPUnit 版本

TP8 基于 PHP 8.1+,必须用 PHPUnit ^10.5;装 v9 或更低版本会导致断言方法缺失、类找不到、启动即崩溃。项目根目录下执行:

composer require --dev phpunit/phpunit ^10.5

装完后立马验证:./vendor/bin/phpunit --version,输出必须是 PHPUnit 10.5.x 开头才算数。

别忘了检查 PHP 扩展:dom、json、pcre、reflection、spl、tokenizer 缺一不可,少一个 PHPUnit 进程启动前就静默终止,没有任何错误提示——这是静默失败的最常见原因,没有之一。

配置 phpunit.xml 文件

这个文件必须放在项目根目录(和 app/、public/ 同级),路径绝对不能错,也别用 phpunit.xml.dist 顶替。新建 phpunit.xml,内容严格按下面来(注意缩进和闭合):



  
    
      tests
    
  

【bootstrap="vendor/autoload.php" 绝对不能省,否则 Container::get()、模型类全报 Class not found】

另外别漏掉 suffix="Test.php"——TP8 只认这个后缀,写成 test.php 或 Tests.php 都会被直接跳过。

创建标准 tests 目录结构

第一步:根目录下 mkdir tests,确保 tests/ 和 app/ 平级。

第二步:在 tests/ 下新建基类 TestCase.php,内容如下:

⚠️ 注意:千万不要继承 think\testing\TestCase——TP8 已经删掉这个类,继承它会报 Call to a member function bind() on null。

第三步:创建首个测试文件 tests/UserModelTest.php,文件名必须以 Test.php 结尾。

第四步:类名必须和文件名完全一致:class UserModelTest,且必须继承 PHPUnit\Framework\TestCase。

编写可运行的 Model 测试

方法一:测完整生命周期(含数据库、事件、自动时间戳)

在 UserModelTest.php 里写:

public function testShouldFindUserById()
{
  $user = \think\Container::get(app\model\User::class);
  $result = $user->find(1);
  $this->assertNotNull($result);
}

绝不能直接 new User(),否则 $this->db 为 null,sa ve()/where() 全崩

方法二:仅构造测试数据(不查库、不写库)

$user = app\model\User::make(['name' => 'test', 'email' => 't@example.com']);

这跳过了容器,但保留字段过滤、时间戳格式化、自动填充等逻辑,适合纯数据层校验。

注意:如果要真正执行数据库操作,必须在 setUp() 中手动初始化应用:\think\App::init();,否则 Db::connect() 找不到配置。

模拟真实请求测控制器

第一步:用 TP8 内置 Mocker 快速发起 GET 请求

$response = $this->mockRequest('GET', '/api/user/123', ['id' => 123]);

第二步:断言响应状态与结构

$this->assertEquals(200, $response->getCode());
$this->assertArrayHasKey('data', $response->getData());

第三步:清理请求上下文(防止污染下一个测试)

\think\facade\Request::clear();

⚠️ 绝对禁止写 (new app\controller\User())->index()——这样会跳过路由解析、中间件、验证器、请求绑定,$this->request 为 null,测的是裸函数,CI 环境必然漏 bug。

如果需要控制 header 或 HTTPS,改用手动构造:$request = \think\facade\Request::create('/api/user', 'GET', [], [], [], ['HTTP_HOST' => 'api.example.com', 'HTTPS' => 'on']); → \think\App::bind('request', $request);

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
作者最新文章
编程开发
相关文章 更多
codex安装windows教程桌面版完整安装步骤指南
codex安装windows教程桌面版完整安装步骤指南

详解如何在 Windows 电脑上通过 Microsoft Store 安装 Codex 桌面应用,包括启动登录、切换 Codex 模式、关联本地代码项目及终端环境配置的界面操作指引。

github配置ssh key windows
github配置ssh key windows

本文详解如何在Windows环境中使用PowerShell生成SSH密钥对,配置ssh-agent自动加载私钥,并将公钥安全添加至GitHub账户,最后通过git remote set-url切换为SSH地址,解决每次操作需输入账号密码的问题。

backdrop和background区别
backdrop和background区别

深入解析backdrop与background在网页开发及视觉设计中的区别。通过CSS代码示例,展示如何正确使用background设置元素背景,以及利用backdrop-filter创建弹窗遮罩模糊效果,避免概念混用。

windsurf ide download Windows版安装教程
windsurf ide download Windows版安装教程

详解 Windsurf IDE 在 Windows 系统的下载来源、安装步骤及首次启动界面。指导用户如何导入编辑器设置、打开项目文件夹及使用终端与 AI 功能,适合初次接触该工具的开发者阅读。

ServBay安装配置详细教程与操作指南
ServBay安装配置详细教程与操作指南

新手入门 ServBay 本地开发环境,详解安装包下载、Dashboard 状态监控、Packages 组件安装、Services 服务控制及 Websites 项目配置。掌握 .servbay.config 版本管理与日志排查技巧,快速搭建稳定的 PHP、Node.js 等多语言开发环境。

codekit环境配置指南从安装到环境搭建完整教程
codekit环境配置指南从安装到环境搭建完整教程

详解 CodeKit 在 macOS 下的安装步骤、项目导入方法、Sass与JavaScript编译设置及浏览器自动刷新功能,助您快速搭建高效的前端开发环境。

codex安装windows 命令行完整操作教程
codex安装windows 命令行完整操作教程

详解Windows环境下安装OpenAI Codex CLI的步骤,包括WSL环境检查、Node.js/npm配置、npm全局安装命令及首次启动验证,适合开发者快速上手。

NativeRest环境配置要求与完整操作教程
NativeRest环境配置要求与完整操作教程

学习如何配置 NativeRest REST API 客户端。涵盖 Windows/macOS/Linux 安装后的工作区创建、环境变量管理、请求编辑及响应查看步骤,帮助开发者快速完成基础环境搭建与连通性测试。

CSS设置透明度的注意事项有哪些?opacity属性详解
CSS设置透明度的注意事项有哪些?opacity属性详解

深入解析CSS中设置透明度的核心属性opacity,剖析子元素继承、事件穿透、层叠上下文等关键注意事项,并提供与rgba、hsla的实用选型对比。

flutter页面传值到后台的方法及示例代码
flutter页面传值到后台的方法及示例代码

flutter页面传值到后台的完整实现方法及示例代码,帮助读者快速掌握相关技术要点。

查看更多
精品专题 更多
装机必备
装机必备

正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

Windows
Windows

正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

PDF教程
PDF教程

正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

Mac软件 更多
WPS Office macOS版
WPS Office macOS版
macOS

WPS Office是一款面向macOS用户的综合办公套件,将文字处理、电子表格、演示文稿、PDF工具、模板与云协作整合在同一应用中。它兼容常见Microsoft Office格式,支持Intel及Apple芯片Mac,基础功能可免费使用,

Shapr3D macOS版
Shapr3D macOS版
Mac

Shapr3D是一款面向工业设计、机械工程、建筑概念和三维打印工作流的CAD软件。Mac版采用Parasolid建模内核,支持草图约束、实体建模、工程图、可视化渲染及常见CAD格式交换,并可通过账户在多台设备之间同步项目。

REAPER macOS版
REAPER macOS版
Mac

REAPER是Cockos开发的数字音频工作站,提供多轨音频与MIDI录制、剪辑、处理、混音和母带制作工具。Mac版兼容Intel与Apple芯片,支持AU、VST、VST3、CLAP等插件格式,并提供高度可定制的工作流程。

WINDOWS 更多
Adobe InDesign Windows版
Adobe InDesign Windows版
Windows

Adobe InDesign 是面向印刷与数字出版的专业页面排版工具,可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力,并能与 Photoshop、Illustrator

Adobe Illustrator Windows版
Adobe Illustrator Windows版
Windows

Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心,作品放大后仍能保持清晰,并提供画板、文字、渐变、图像描摹及精确变换等功能,适合品牌视觉、印刷物料、数字界面和商业插画创作。

Adobe Bridge Windows版
Adobe Bridge Windows版
Windows

Adobe Bridge 是 Adobe 推出的创意资产管理工具,可集中预览、分类和查找照片、视频、PDF及多种设计文件,并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接,