Quick Reference:php5 Xdebug 代码覆盖分析

以前写过一篇关于xdebug生成profile的文章
关于xdebug就不再啰嗦了。

---

这次写的是代码覆盖分析。
官方文档在这里
在php.ini中有一个变量是关于是否激活这个功能的，不过默认值是true，可以无视。
变量名是xdebug.coverage_enable

这个功能的实现主要是几个xdebug函数的调用。

void xdebug_start_code_coverage( [int options] )
开启功能，options不填的话，结果中只输出实际执行的行。标记值为1
options 有两个选项：
XDEBUG_CC_UNUSED 输出可执行，但没有执行的行。标记值为-1
XDEBUG_CC_DEAD_CODE 这个标志需要与前面的那个一起用，输出没有可执行代码的行，
标记值为-2。但在下没还没有搞明白什么样的代码能输出-2.文档原话是这样的：
-2: this line did not have executable code on it

---

boolean xdebug_code_coverage_started()
判断功能是否是开启状态。就是在调用xdebug_start_code_coverage后会返回true

---

void xdebug_stop_code_coverage( [int cleanup=true] )
停止功能。clean参数用来标示是否清除收集的信息。默认为true就是会清掉信息。

---

array xdebug_get_code_coverage()
取得分析信息。此信息只包含在start与stop函数之间的代码调用。如果
xdebug_stop_code_coverage中cleanup为true的话，这个函数要在stop前调用才能返回结果。结果格式看下面的例子吧

---

例子代码如下

<?php
xdebug_start_code_coverage(XDEBUG_CC_DEAD_CODE|XDEBUG_CC_UNUSED );
include 'xdbgTarget.php';
xdebug_stop_code_coverage(false);

/* result analysis */
$res=xdebug_get_code_coverage();
echo 'After Coverage!'.PHP_EOL;
var_dump($res);

echo 'Coverage Rate'.PHP_EOL;
foreach($res as $k=>$i){
    $c_arr=array_count_values($i);
    $cv[basename($k)]=(100*$c_arr[1])/sizeof($i);
}

var_dump($cv);

内容很简单，就是分析xdbgTarget.php中的代码调用覆盖。因为原始的结果是以行号=>覆盖值的形式给出的，所以覆盖率要自己转换，计算一下。
运行结果如下。具体的细节，自己编写xdbgTarget.php试一下就会明白了。