PHP 单元测试与 TDD 实战：PHPUnit 高级用法与代码覆盖率的质量保障体系-php教程-PHP中文网

phpunit是可配置可扩展的质量保障体系，关键在合理配置phpunit.xml（如backupglobals="false"）、审慎解读覆盖率、避免mock滥用、优化ci执行效率。

php 单元测试与 tdd 实战：phpunit 高级用法与代码覆盖率的质量保障体系

PHPUnit 不是“跑通测试就行”的工具，它是一套可配置、可扩展的质量保障体系。真正卡住团队的，从来不是写不出第一个 assertEquals，而是覆盖率虚高、Mock 泛滥、测试变慢、CI 里频繁飘红却找不到根因。

很多人把 phpunit.xml 当成模板复制粘贴，但几个关键开关不调，测试就容易在 CI 或不同环境里行为不一致：

backupGlobals="false" 是必须的——开启它会让每个测试用例重置全局变量，但代价是显著拖慢执行速度；多数现代 PHP 代码已无强依赖全局状态，关掉更稳更快
beStrictAboutTestsThatDoNotTestAnything="true" 能揪出空测试方法或只调用未断言的代码，避免“看似跑过实则没测”
convertDeprecationsToExceptions="true" 在 PHP 8.4+ 环境下尤其关键：把 E_DEPRECATED 当异常抛出，防止旧写法（如 create_function）在开发机不报错、上线后崩溃
别忽略 extensions 块：如果用了 phpstan 或 psalm 的自定义规则，需显式声明加载，否则覆盖率报告和静态分析会脱节

生成 vendor/bin/phpunit --coverage-html build/coverage 后看到红色行，第一反应不是“赶紧加 test”，而是先问三个问题：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

这行是不是 throw new \Exception(...) 或 exit() 这类防御性兜底？这类代码本就不该被常规路径触发，强行 mock 路径反而让测试脆弱
是否属于 setter/getter、DTO 属性赋值、或日志打点等纯副作用逻辑？覆盖率工具会标记它们，但 TDD 原则下，这类代码不应成为测试目标
是否在 catch 块里处理了极低概率异常（如网络超时、磁盘满）？真实模拟成本高，可用 expectException() + 人工构造异常对象覆盖主干，不必追求 100%
核心业务逻辑分支（如支付状态机中的 if ($order->isPaid() && !$order->isShipped())）必须覆盖，且要验证不同组合下的输出，不能只测 true && true

Mock 是隔离依赖的利器，但滥用会导致测试与实现细节强耦合，一改代码全红：

优先用真实轻量对象：比如测试一个依赖 LoggerInterface 的服务，直接传入 new NullLogger() 比 mock 接口更简单、更稳定
慎 mock 第三方 SDK：像 Stripe\Charge::create() 这类，应封装为自己的 PaymentGateway 接口，再 mock 这个接口；否则 SDK 升级时，mock 断言全失效
避免 mock 返回值链式调用：如 $mock->getOrder()->getUser()->getName()，这种 mock 本质是在测试框架行为而非业务逻辑；应重构为接受 User 对象入参，或使用 willReturnOnConsecutiveCalls() 控制返回序列
所有 mock 必须配 expects($this->once()) 或类似约束，否则“调没调”“调几次”都成黑盒，掩盖真实调用路径问题

本地秒过、CI 跑 5 分钟还超时？重点查这三项：

SQLite 内存数据库没配对：测试中用 sqlite::memory: 是快，但若在 setUp() 里反复 exec("CREATE TABLE...")，每次新建连接都重建 schema；应统一在 setUpBeforeClass() 里建一次，或用 DatabaseTestCase 类做事务回滚
Xdebug 开着跑覆盖率：CI 里生成 HTML 报告时默认启用 Xdebug，但 Xdebug 会拖慢执行 3–5 倍；正确做法是 CI 分两轮：第一轮 phpunit 快速验功能，第二轮 phpunit --coverage-clover 单独跑覆盖率（且仅限主干分支）
测试类没按层级拆分：把 UserTest、OrderTest、PaymentTest 全塞进一个大文件，PHPUnit 加载解析耗时剧增；严格按 tests/Unit/User/ 目录结构组织，配合 phpunit.xml 中的 <testsuites></testsuites> 显式指定路径