PHP代码覆盖率

一  安装php环境

二 统计php代码覆盖率

1 须要安装xdebug

安装步骤：

http://www.jb51.net/article/116419.htm

测试环境

• LNMP 军哥一键包1.3版本
• PHP 7.0.7
• Xdebug 2.6

配置步骤

 

1 2 3 4 5 6 7 8

git clone git: //github .com /xdebug/xdebug .git cd xdebug find / -name phpize /usr/bin/phpize find / -name php-config . /configure -- enable -xdebug --with-php-config= /usr/local/php/bin/php-config make make install

 

开启扩展

?

1 2 3 4

find / -name php.ini vi /usr/local/php/etc/php .ini 添加 extension=xdebug.so [Xdebug] xdebug.collect_params=on xdebug.collect_return=on xdebug.remote_autostart=on service restart php-fpm

成功验证：①在linux输入php -version，以下：

② 访问index.php（phpinfo()）

 

2 安装composer

curl -sS https://getcomposer.org/installer | php
php composer.phar --version Composer version 1.6.5 2018-05-04 11:44:59

3 安装phpcov 和 phpunit

此处选了phpunit 6.5.0 和phpcov 4.0.8，编辑composer.json文件(phpcov是根据phpunit自动匹配的，php和phpunit对应关系可百度或看底部)

#composer.json
{
    "name": "root/php-code-coverage",
    "require-dev": {
        "phpunit/phpunit":"6.5.0",
        "phpunit/phpcov": "*" 
}

执行命令安装   php composer.phar install

安装完成后校验 以下便可（phpunit和phpcov必定要在这个目录下使用)

vendor/bin
[root@mt-jry-01 bin]# ll
lrwxrwxrwx 1 root root      24 Jul 13 10:22 phpcov -> ../phpunit/phpcov/phpcov
lrwxrwxrwx 1 root root      26 Jul 13 10:21 phpunit -> ../phpunit/phpunit/phpunit
[root@mt-jry-01 bin]# .vendor/bin/phpunit --version
PHPUnit 6.5.0 by Sebastian Bergmann and contributors.

[root@mt-jry-01 bin]# .vendor/bin/phpcov --version
phpcov 4.0.5 by Sebastian Bergmann.

　　

4 编写测试代码

#userinfo.php
<?php
include_once("*****/prepend.php");  
$id = $_POST["user_id"];
if ($id != 10086){
    exit();
}
$userinfo = array(
    'username'=>'jason',
    'password'=>'123456',
);
$result = array(
          'code'=>10000,
          'message'=>"success",
          'data'=>$userinfo,
        );
echo json_encode($result);

　　

#prepend.php
<?php
require_once dirname(__FILE__).'/vendor/autoload.php';  # 在composer生成的vender同级目录
use SebastianBergmann\CodeCoverage\CodeCoverage;
$coverage = new CodeCoverage;

$coverage->filter()->addDirectoryToWhitelist('/var/www/html/userinfo.php');  # 白名单

$coverage->start('<Site coverage>');#开始统计
register_shutdown_function('__coverage_stop',$coverage);#注册关闭方法
 
function __coverage_stop(CodeCoverage $coverage){
  $coverage->stop();#中止统计
  $cov = '<?php return unserialize(' . var_export(serialize($coverage), true) . ');';#获取覆盖结果，注意使用了反序列化
  //echo $cov;
  file_put_contents(dirname(__FILE__).'/cov/site.' . date('U') .'.'.uniqid(). '.cov', $cov);#将结果写入到文件中
}

若多个域名或者接口请求要在同一个prepend文件里分别统计，在新建$coverage前加if条件便可，如
if(strpos($_SERVER['HTTP_HOST'],'www.baidu.com') === true){}

　　

5  测试

执行命令

[root@mt-jry-01 html]# curl -d "user_id=10086" "127.0.0.1/userinfo.php"
{"code":10000,"message":"success","data":{"username":"jason","password":"123456"}}

查看prepend.php统计目录cov下

-rw-r--r-- 1 apache apache   4609 Jul 13 14:45 site.1531464305.5b484a71c0a1c.cov

生成xml或者html报告命令以下：

./vendor/bin/phpcov merge --clover cov/coverage.xml cov/ -vvv   # 在cov目录下生成xml报告
./vendor/bin/phpcov merge --html="cov/coverage_html" cov/ -vvv  # 在cov目录下生成html报告　

6 查看报告结果

8 工程配置

在实际项目中有三种配置方式

1. 在php.ini中引入prepend文件：auto_prepend_file = /***/prepend.php (配置后重启php) --- 全部php请求均会预加载该文件，文件有错误时影响整个php服务
2. 在文件入口文件中引入prepend文件：include_once(/www/***/prepend.conf); （通常为index.php） --- 效果同3，从新部署清掉配置
3. 在nginx.conf中引入prepend文件 --- 对于该域名的请求会加载该文件（配置后重启nginx）

 

location ~ .*\.php?$
        {   
                fastcgi_pass  127.0.0.1:9200;
                fastcgi_index index.php;
                include common/fastcgi.conf;
                fastcgi_param MY_ENV pre;
                fastcgi_param PHP_VALUE 'auto_prepend_file=/www/data/phpcoverage_wallet/prepend.php';
        }

　　

7 问题：

① 开始使用的phpcov 2.0.2 & phpunit 4.8.7 生成的报告数据全为0 - phpunit4 不能支持 php7，对应版本见⑦

② 开始老是报错PHP Fatal error:  Uncaught Error: Class 'SebastianBergmann\CodeCoverage\CodeCoverage' not found in

     是由于没有引用vender目录，在prepend.php里加一句require_once dirname(__FILE__).'/vendor/autoload.php';  便可

③ 配置nginx

④ 请求域名没有生成site文件：请求权限不够，不能在对应目录下写文件

     chmod 777 -R 域名请求是apache权限，若是与cov文件夹权限不一致则不可写入

 ⑤ 生成覆盖率文件有要统计的代码文件，可是命中状况count全为0，有两种可能

      A xdebug的collect_param 与collect_return没打开，致使未收集到数据，须要在php.ini里配置

      B 若是在php.ini里配置了auto_prepend_file=‘**/prepend.php’,则只有用指定目录下的prepend.php文件才能生成覆盖率数据，不然覆盖行全为0

 ⑥ 将xml报告集成到jenkins

      注意：go 和 c++ 的xml报告能够用 Cobertura 统计到jenkins展现，php 的要用Clover PHP 插件统计，phpcov生成的xml格式Cobertura解析不了会报错  

 ⑦ php 和 phpunit 的对应关系 https://phpunit.de/supported-versions.html

      

 

 

 

https://github.com/sebastianbergmann/phpcov