PHPUnit与Xdebug对抽象类代码覆盖率始终为0%的问题求助

问题情况 #

• 已创建抽象类TheAbstractClass及对应的测试类TheAbstractClassTest
• 因无法直接实例化抽象类，既创建了继承它的TheTestableClass，也尝试过PHPUnit的createMockForAbstractClass()方法
• 测试全部通过，但TheAbstractClass的代码覆盖率始终为0%，而TheConcreteClass覆盖率达100%

环境配置：

• Windows 10
• PHP 7.4.3
• Xdebug 2.8.1
• PHPUnit 9.6.6

排查与解决步骤 #

1. 明确覆盖率统计范围 #

抽象类里的抽象方法没有具体实现代码，不会被计入覆盖率统计。只有抽象类中**已实现的代码（比如构造函数、普通方法）**才会被统计。先确认TheAbstractClass是否存在这类可被统计的代码。

2. 确保测试执行了抽象类的代码 #

• 若使用子类TheTestableClass：测试时要触发子类调用父类（抽象类）的代码。比如调用子类构造函数时确保父类构造函数被执行，或者主动调用父类的已实现方法。
• 若使用createMockForAbstractClass()：需要通过mock对象触发抽象类的已实现方法，示例代码：

  $mock = $this->createMockForAbstractClass(TheAbstractClass::class);
  // 调用抽象类中已实现的方法
  $mock->someImplementedMethod();
  

3. 检查PHPUnit配置 #

打开phpunit.xml，确保抽象类所在文件没有被排除在覆盖率统计之外，同时正确设置包含规则：

<coverage>
  <include>
    <directory suffix=".php">./src</directory>
  </include>
  <!-- 移除或调整可能排除抽象类的规则 -->
</coverage>

4. 验证Xdebug配置 #

在php.ini中确认开启了覆盖率功能：

xdebug.coverage_enable = 1

修改后重启PHP服务，再重新运行测试。

5. 正确生成覆盖率报告 #

运行PHPUnit时带上生成覆盖率的参数，比如生成HTML报告：

phpunit --coverage-html ./coverage-report

查看生成的报告，确认抽象类是否被纳入统计范围。

内容的提问来源于stack exchange，提问作者gopher