woojean/php-coverage

php code coverage

PHPCoverage说明文档

PHPCoverage是一款基于xdebug实现的PHP代码覆盖率统计工具，可以方便地对PHP项目的代码覆盖率情况进行统计。, _(*1)

使用

PHPCoverage的使用非常简单，在下载了PHPCoverage的项目代码至本地后，只需在项目的主入口处（通常是项目的index.php文件的开头处）引用插桩文件，并添加插桩代码即可。, _(*2)

插桩代码的示例如下：

index.php文件开头处, _(*3)

<?php

// 引入插桩文件，例如我的本地PHPCoverage项目位置在：/vagrant/PHPCoverage处，则如下引用
require_once '/vagrant/PHPCoverage/src/Woojean/PHPCoverage/Injecter.php';

// 插桩
Woojean\PHPCoverage\Injecter::Inject([
    'log_dir'=>'/vagrant/logs',
    'ignore_file'=>'/vagrant/PHPCoverage/demo/example.ignore',
    'is_repeat' => true 
]);

// ...

参数说明：

log_dir

log_dir应该是一个PHP具有写权限的目录的路径（绝对路径），用于生成覆盖率统计文件及最终的覆盖率报告。, _(*4)

ignore_file

ignore_file用于指定需要忽略掉的文件，比如第三方的代码、框架文件以及其他不想关注的文件。 该文件使用PHP数组描述，在PHPCoverage项目的ignores文件夹中包含一个示例文件example.ignore，内容如下：, _(*5)

<?php

return [
    "/vagrant/www/cbd_wechat/vendor",
    "/vagrant/www/cbd_wechat/library"
];

is_repeat

is_repeat可以指定为ture或false，用于控制是否进行叠加测试。 当is_repeat为false时，将不进行叠加测试，这意味着每次开始执行测试之前，都会清空log_dir目录中的所有文件（即之前的测试记录）。 当is_repeat为true时，将进行叠加测试，这意味着多次测试生成的文件将会被保留，并最终进行合并分析。 如果想对单次PHP请求的代码覆盖率情况进行统计，应该将is_repeat设为false。 如果想要统计多次代码执行累计的代码覆盖率情况，则应该讲is_repeat设为true。 也可以手工清除log_dir中的内容以保证之前的测试结果不会被之后的测试一起统计。, _(*6)

报告说明：

当测试结束后，会在插桩时指定的log_dir目录下生成覆盖率统计文件和报告文件，其中index.html文件为报告的入口文件：, _(*7)

, _(*8)

打开index.html文件后，内容如下：, _(*9)

, _(*10)

文件顶部为本次测试的总体统计信息：, _(*11)

, _(*12)

文件左侧为本次测试覆盖到的所有文件的列表（不含在ignore_file忽略的文件），点击文件列表中的任意文件，将在右侧展示该文件的覆盖情况。, _(*13)

其中灰色的行为不可执行代码：, _(*14)

, _(*15)

其中淡黄色的行为可执行代码但未覆盖的代码：, _(*16)

, _(*17)

绿色的行为被覆盖的可执行代码：, _(*18)

, _(*19)

同时，在左侧文件列表中，针对不同的代码覆盖程度，也给出了不同颜色区分的标记：, _(*20)

, _(*21)

通过Composer安装使用

Composer包名：

woojean/php-coverage, _(*22)

插桩代码的示例如下：

index.php文件开头处, _(*23)

<?php

// 插桩
Woojean\PHPCoverage\Injecter::Inject([
    'log_dir'=>'/vagrant/logs',
    'ignore_file'=>'/vagrant/PHPCoverage/demo/example.ignore',
    'is_repeat' => true 
]);

// ...

参数配置及说明见上文。, _(*24)