PHPUnit5.0中文手册11. 代码覆盖率分析包含与排除文件

包含与排除文件

默认情况下,代码覆盖率报告中包含(且只包括)所有内含至少一行已执行代码的源文件。

默认情况下,在生成代码覆盖率报告时会应用一个特定的黑名单来排除某些文件。这个黑名单中包含了 PHPUnit 本身及其所依赖的所有组件的相应源文件。

白名单代替上面提到的黑名单是一种良好的习惯。

可以在 PHPUnit 的配置信息中设置 addUncoveredFilesFromWhitelist="true" 来将白名单中包含的所有文件全部加入到代码覆盖率报告中(参见the section called “为代码覆盖率包含或排除文件”)。这样可以把完全没有测试到的文件也一并包含到报告中。如果需要知道这些未被覆盖文件中有哪些行是可执行的,需要同时在 PHPUnit 的配置信息中设置 processUncoveredFilesFromWhitelist="true"(参见the section called “为代码覆盖率包含或排除文件”)。

Note

请注意,当设置了 processUncoveredFilesFromWhitelist="true" 时将对源代码文件进行载入,这在某些情况下可能导致问题,比如,源代码文件包含有处于类或者函数作用域之外的代码。