主頁 > 知識庫 > 使用PHPUnit進(jìn)行單元測試并生成代碼覆蓋率報(bào)告的方法

使用PHPUnit進(jìn)行單元測試并生成代碼覆蓋率報(bào)告的方法

熱門標(biāo)簽:銀川ai電話機(jī)器人 浙江外呼電話系統(tǒng)軟件 電梯外呼線路板維修視頻 上海公司外呼系統(tǒng)線路 十堰ai電話機(jī)器人效果怎么樣 地圖標(biāo)注風(fēng)向標(biāo) 芒果電銷機(jī)器人 安陽自動外呼系統(tǒng)價(jià)格是多少 臨沂智能電銷機(jī)器人軟件

安裝PHPUnit

使用 Composer 安裝 PHPUnit

#查看composer的全局bin目錄 將其加入系統(tǒng) path 路徑 方便后續(xù)直接運(yùn)行安裝的命令
composer global config bin-dir --absolute
#全局安裝 phpunit
composer global require --dev phpunit/phpunit
#查看版本
phpunit --version

使用Composer構(gòu)建你的項(xiàng)目

我們將新建一個(gè)unit項(xiàng)目用于演示單元測試的基本工作流

創(chuàng)建項(xiàng)目結(jié)構(gòu)

mkdir unit  cd unit  mkdir app tests reports
#結(jié)構(gòu)如下
./
├── app #存放業(yè)務(wù)代碼
├── reports #存放覆蓋率報(bào)告
└── tests #存放單元測試

使用Composer構(gòu)建工程

#一路回車即可
composer init

#注冊命名空間
vi composer.json
...
  "autoload": {
    "psr-4": {
      "App\\": "app/",
      "Tests\\": "tests/"
    }
  }
...
#更新命名空間
composer dump-autoload

#安裝 phpunit 組件庫
composer require --dev phpunit/phpunit

到此我們就完成項(xiàng)目框架的構(gòu)建,下面開始寫業(yè)務(wù)和測試用例。

編寫測試用例

創(chuàng)建文件app/Example.php 這里我為節(jié)省排版就不寫注釋了

?php
namespace App;

class Example
{
  private $msg = "hello world";

  public function getTrue()
  {
    return true;
  }

  public function getFalse()
  {
    return false;
  }

  public function setMsg($value)
  {
    $this->msg = $value;
  }

  public function getMsg()
  {
    return $this->msg;
  }
}

創(chuàng)建相應(yīng)的測試文件tests/ExampleTest.php

?php
namespace Tests;

use PHPUnit\Framework\TestCase as BaseTestCase;
use App\Example;

class ExampleTest extends BaseTestCase
{
  public function testGetTrue()
  {
    $example = new Example();
    $result = $example->getTrue();
    $this->assertTrue($result);
  }
  
  public function testGetFalse()
  {
    $example = new Example();
    $result = $example->getFalse();
    $this->assertFalse($result);
  }
  
  public function testGetMsg()
  {
    $example = new Example();
    $result = $example->getTrue();
    // $result is world not big_cat
    $this->assertEquals($result, "hello big_cat");
  }
}

執(zhí)行單元測試

[root@localhost unit]# phpunit --bootstrap=vendor/autoload.php \

tests/

PHPUnit 6.5.14 by Sebastian Bergmann and contributors.

..F                                 3 / 3 (100%)

Time: 61 ms, Memory: 4.00MB

There was 1 failure:

1) Tests\ExampleTest::testGetMsg
Failed asserting that 'hello big_cat' matches expected true.

/opt/unit/tests/ExampleTest.php:27
/root/.config/composer/vendor/phpunit/phpunit/src/TextUI/Command.php:195
/root/.config/composer/vendor/phpunit/phpunit/src/TextUI/Command.php:148

FAILURES!
Tests: 3, Assertions: 3, Failures: 1.

這是一個(gè)非常簡單的測試用例類,可以看到,執(zhí)行了共3個(gè)測試用例,共3個(gè)斷言,共1個(gè)失敗,可以參照PHPUnit手冊學(xué)習(xí)更多高級用法。

代碼覆蓋率

代碼覆蓋率反應(yīng)的是測試用例測試對象行,函數(shù)/方法,類/特質(zhì)的訪問率是多少(PHP_CodeCoverage 尚不支持 Opcode覆蓋率、分支覆蓋率 及 路徑覆蓋率),雖然有很多人認(rèn)為過分看重覆蓋率是不對的,但我們初入測試還是俗氣的追求一下吧。

測試覆蓋率的檢測對象是我們的業(yè)務(wù)代碼,PHPUnit通過檢測我們編寫的測試用例調(diào)用了哪些函數(shù),哪些類,哪些方法,每一個(gè)控制流程是否都執(zhí)行了一遍來計(jì)算覆蓋率。

PHPUnit 的覆蓋率依賴 Xdebug,可以生成多種格式:

--coverage-clover file>  Generate code coverage report in Clover XML format.
--coverage-crap4j file>  Generate code coverage report in Crap4J XML format.
--coverage-html dir>    Generate code coverage report in HTML format.
--coverage-php file>    Export PHP_CodeCoverage object to file.
--coverage-text=file>   Generate code coverage report in text format.
--coverage-xml dir>    Generate code coverage report in PHPUnit XML format.

同時(shí)需要使用 --whitelist dir參數(shù)來設(shè)定我們需要檢測覆蓋率的業(yè)務(wù)代碼路徑,下面演示一下具體操作:

phpunit \

--bootstrap vendor/autoload.php \

--coverage-html=reports/ \

--whitelist app/ \

tests/
#查看覆蓋率報(bào)告
cd reports/  php -S 0.0.0.0:8899

這樣我們就對業(yè)務(wù)代碼App\Example做單元測試,并且獲得我們單元測試的代碼覆蓋率,現(xiàn)在自然是百分之百,因?yàn)槲业臏y試用例已經(jīng)訪問了App\Example的所有方法,沒有遺漏的,開發(fā)中則能體現(xiàn)出你的測試時(shí)用力對業(yè)務(wù)代碼測試度的完善性。

基境共享測試數(shù)據(jù)

可能你會發(fā)現(xiàn)我們在每個(gè)測試方法中都創(chuàng)建了App\Example對象,在一些場景下是重復(fù)勞動,為什么不能只創(chuàng)建一次然后供其他測試方法訪問呢?這需要理解 PHPUnit 執(zhí)行測試用例的工作流程。

我們沒有辦法在不同的測試方法中通過某成員屬性來傳遞數(shù)據(jù),因?yàn)槊總€(gè)測試方法的執(zhí)行都是新建一個(gè)測試類對象,然后調(diào)用相應(yīng)的測試方法

即測試的執(zhí)行模式并不是

testObj = new ExampleTest();
testObj->testMethod1();
testObj->testMethod2();

而是

testObj1 = new ExampleTest();
testObj1->testMethod1();

testObj2 = new ExampleTest();
testObj2->testMethod2();

所以testMethod1()修改的屬性狀態(tài)無法傳遞給 testMethod2()使用。

PHPUnit則為我們提供了全面的hook接口:

public static function setUpBeforeClass()/tearDownAfterClass()//測試類構(gòu)建/解構(gòu)時(shí)調(diào)用
protected function setUp()/tearDown()//測試方法執(zhí)行前/后調(diào)用
protected function assertPreConditions()/assertPostConditions()//斷言前/后調(diào)用

當(dāng)運(yùn)行測試時(shí),每個(gè)測試類大致就是如下的執(zhí)行步驟

#測試類基境構(gòu)建
setUpBeforeClass

#new一個(gè)測試類對象
#第一個(gè)測試用例
setUp
assertPreConditions
assertPostConditions
tearDown

#new一個(gè)測試類對象
#第二個(gè)測試用例
setUp
assertPreConditions
assertPostConditions
tearDown
...

#測試類基境解構(gòu)
tearDownAfterClass

所以我們可以在測試類構(gòu)建時(shí)使用setUpBeforeClass創(chuàng)建一個(gè) App\Example 對象作為測試類的靜態(tài)成員變量(tearDownAfterClass主要用于一些資源清理,比如關(guān)閉文件,數(shù)據(jù)庫連接),然后讓每一個(gè)測試方法用例使用它:

?php
namespace Tests;

use App\Example;
use PHPUnit\Framework\TestCase as BaseTestCase;

class ExampleTest extends BaseTestCase
{
  // 類靜態(tài)屬性
  private static $example;

  public static function setUpBeforeClass()
  {
    self::$example = new Example();
  }

  public function testGetTrue()
  {
    // 類的靜態(tài)屬性更新
    self::$example->setMsg("hello big_cat");
    $result = self::$example->getTrue();
    $this->assertTrue($result);
  }

  public function testGetFalse()
  {
    $result = self::$example->getFalse();
    $this->assertFalse($result);
  }

  /**
   * 依賴 testGetTrue 執(zhí)行完畢
   * @depends testGetTrue
   * @return [type] [description]
   */
  public function testGetMsg()
  {
    $result = self::$example->getMsg();
    $this->assertEquals($result, "hello big_cat");
  }
}

或者使用@depends注解來聲明二者的執(zhí)行順序,并使用傳遞參數(shù)的方式來滿足需求。

public function testMethod1()
{
  $this->assertTrue(true);
  return "hello";
}

/**
 * @depends testMethod1
 */
public function testMethod2($str)
{
  $this->assertEquals("hello", $str);
}
#執(zhí)行模式大概如下
testObj1 = new Test;
$str = testObj1->testMethod1();

testObj2 = new Test;
testObj2->testMethod2($str);

理解測試執(zhí)行的模式還是很有幫助的,其他高級特性請瀏覽官方文檔。

使用phpunit.xml編排測試套件

使用測試套件來管理測試,vi phpunit.xml

?xml version="1.0" encoding="UTF-8"?>
phpunit backupGlobals="false"
     backupStaticAttributes="false"
     bootstrap="./vendor/autoload.php"
     colors="true"
     convertErrorsToExceptions="true"
     convertNoticesToExceptions="true"
     convertWarningsToExceptions="true"
     processIsolation="false"
     stopOnFailure="false">
  testsuites>
    !--可以定義多個(gè) suffix 用于指定待執(zhí)行的測試類文件后綴-->
    testsuite name="Tests">
      directory suffix="Test.php">./test/directory>
    /testsuite>
  /testsuites>
  filter>
    whitelist processUncoveredFilesFromWhitelist="true">
      !--可以定義多個(gè) 對./app下的業(yè)務(wù)代碼做覆蓋率統(tǒng)計(jì)-->
      directory suffix=".php">./app/directory>
    /whitelist>
  /filter>
  logging>
    !--覆蓋率報(bào)告生成類型和輸出目錄 lowUpperBound低覆蓋率閾值 highLowerBound高覆蓋率閾值-->
    log type="coverage-html" target="./reports" lowUpperBound="35" highLowerBound="70"/>
  /logging>
/phpunit>

然后直接運(yùn)phpunit行即可:

[root@localhost unit]# phpunit 
PHPUnit 6.5.14 by Sebastian Bergmann and contributors.

Time: 81 ms, Memory: 4.00MB

No tests executed!

Generating code coverage report in HTML format ... done

以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。

您可能感興趣的文章:
  • PHPUnit 單元測試安裝與使用入門教程
  • ThinkPHP5與單元測試PHPUnit使用詳解
  • PHP單元測試配置與使用方法詳解
  • PHPUnit + Laravel單元測試常用技能
  • PHP使用phpunit進(jìn)行單元測試示例
  • PHPStorm中如何對nodejs項(xiàng)目進(jìn)行單元測試詳解
  • PHP單元測試框架PHPUnit用法詳解
  • thinkPHP框架單元測試庫tpunit用法示例
  • 淺談如何提高PHP代碼質(zhì)量之單元測試

標(biāo)簽:吐魯番 常州 荊門 遵義 徐州 遂寧 武威 寧夏

巨人網(wǎng)絡(luò)通訊聲明:本文標(biāo)題《使用PHPUnit進(jìn)行單元測試并生成代碼覆蓋率報(bào)告的方法》,本文關(guān)鍵詞  使用,PHPUnit,進(jìn)行,單元,測試,;如發(fā)現(xiàn)本文內(nèi)容存在版權(quán)問題,煩請?zhí)峁┫嚓P(guān)信息告之我們,我們將及時(shí)溝通與處理。本站內(nèi)容系統(tǒng)采集于網(wǎng)絡(luò),涉及言論、版權(quán)與本站無關(guān)。
  • 相關(guān)文章
  • 下面列出與本文章《使用PHPUnit進(jìn)行單元測試并生成代碼覆蓋率報(bào)告的方法》相關(guān)的同類信息!
  • 本頁收集關(guān)于使用PHPUnit進(jìn)行單元測試并生成代碼覆蓋率報(bào)告的方法的相關(guān)信息資訊供網(wǎng)民參考!
  • 推薦文章