PHPUnit是PHP质量保障基石，需嵌入开发流程；通过Composer安装、三步法写测试、覆盖率报告诊断盲区，并集成到提交与CI中形成闭环。
PHPUnit 是 PHP 项目质量保障的基石，不是附加项，而是开发流程中必须嵌入的一环。它不只验证“代码能跑”，更确保“逻辑无遗漏”“边界不崩塌”“重构不破防”。真正起作用的，是写得准、跑得稳、看得清的测试——尤其是覆盖率报告，它把“盲区”变成可读、可追、可补的具体行号。
安装与初始化：从命令到配置文件
用 Composer 将 PHPUnit 作为开发依赖引入，避免全局污染和版本冲突：
- composer require --dev phpunit/phpunit ^10
- 执行 ./vendor/bin/phpunit --generate-configuration 自动生成 phpunit.xml，无需手写基础结构
- 关键配置项要明确：<directory>src/</directory> 指定被测源码路径，<exclude>tests/</exclude> 避免把测试代码计入覆盖率
写测试：三步法 + 断言选型
每个测试方法本质是“准备–执行–断言”三步闭环。重点不在数量，而在覆盖关键路径：
- 正常流程：如 $this->assertEquals(5, $calc->add(2, 3))
- 异常分支：用 $this->expectException(InvalidArgumentException::class) 显式捕获预期异常
- 数据驱动：配合 @dataProvider 复用同一逻辑测试多组输入，避免重复样板
- 别滥用 assertEquals：数值比对用它，严格类型需 assertSame；检查数组含某值用 assertContains；验证空值优先 assertNull
覆盖率分析：不止看数字，要看红绿行
覆盖率报告不是 KPI，是诊断地图。生成 HTML 报告后，直接点进未覆盖的文件，重点关注：
立即学习“PHP免费学习笔记（深入）”；
- 红色行：完全未执行，通常是 if 分支里的 else、异常抛出路径、或未触发的回调
- 黄色行：部分覆盖（如条件表达式只测了 true 没测 false）
- 运行命令：./vendor/bin/phpunit --coverage-html coverage-report
- 覆盖率目标要有侧重：行覆盖率 >90% 是基础，但分支覆盖率 >80% 才反映逻辑完整性；单测不追求 100%，而要覆盖所有 public 方法 + 关键 private 边界
集成与习惯：让测试真正运转起来
测试只有被持续运行，才有质量价值。把它变成日常节奏的一部分：
- 每次提交前本地运行：./vendor/bin/phpunit，快速反馈
- CI 流水线中加入覆盖率门禁：如 --min-full=85，低于阈值则构建失败
- 不写“测试文档”，而写“行为说明”：方法名用 testUserCannotLoginWithInvalidPassword 而非 testLogin，让测试本身成为可读的需求快照
- 测试类与被测类保持同级目录结构（如 src/User.php → tests/UserTest.php），便于定位和维护
