您当前的位置： 首页 > 慢生活 > 程序人生 网站首页程序人生

phpunit敏捷文档testdox的带参情况

发布时间：2021-09-18 11:08:34编辑：雪饮阅读（）

 前番了解了phpunit中testdox对于不同函数名像是仅仅只是后缀出现一个或多个数字这种情况生成敏捷文档的一种呈现方式。

那么这次来了解下如果一个测试方法带参，一般的像是数据供给器。则有实例如：
BankAccountTest.php：
<?php declare(strict_types=1);
//use PHPUnit\Framework\TestCase;
namespace TestNamespace;
use PHPUnit\Framework\TestCase;
class BankAccountTest extends TestCase
{
    public function testBalanceIsInitiallyZero()
    {
        $this->assertTrue(true);
    }
    public function test_balance_is_initially_zero()
    {
        $this->assertTrue(false);
    }
    public function testBalanceCannotBecomeNegative()
    {
        $this->assertTrue(true);
    }
    public function testBalanceCannotBecomeNegative2()
    {
        $this->assertTrue(true);
    }
    /**
     * @dataProvider provider
     */
    public function testMethod($data)
    {
        $this->assertTrue($data);
    }

    public function provider()
    {
        return [
            'my named data' => [true],
            'my data'       => [true]
        ];
    }
}
运行结果如：
C:\Users\Administrator>D:\phpstudy_pro\Extensions\php\php7.3.4nts\php.exe D:\phpstudy_pro\Extensions\php\php7.3.4nts\phpunit-9.5.8.phar --testdox C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php
PHPUnit 9.5.8 by Sebastian Bergmann and contributors.
 
Bank Account (TestNamespace\BankAccount)
 ✔ Balance is initially zero
 ✘ Balance is initially zero
   │
   │ Failed asserting that false is true.
   │
   │ C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php:13
   │
 
 ✔ Balance cannot become negative
 ✔ Balance cannot become negative
 ✔ Method with data set "my named data"
 ✔ Method with data set "my data"
 
Time: 00:00.035, Memory: 20.00 MB
 
Summary of non-successful tests:
 
Bank Account (TestNamespace\BankAccount)
 ✘ Balance is initially zero
   │
   │ Failed asserting that false is true.
   │
   │ C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php:13
   │
 
FAILURES!
Tests: 6, Assertions: 6, Failures: 1.
可见带参的测试方法时候不仅仅展示这个测试方法，一般的带参是数据供给器，那么像是这里同一个测试方法将会显示多次，每次就带上数据供给器中遍历的对应的一条数据。
同时这里可能导致误解，就是因为我的测试方法名称叫testMethod，结果这里就直接显示Method，其实只是自动处理了test前缀，不要以为这Method是什么phpunit的关键字之类的，这里只是凑巧。
像是如果修改为如下：

<?php declare(strict_types=1);
//use PHPUnit\Framework\TestCase;
namespace TestNamespace;
use PHPUnit\Framework\TestCase;
class BankAccountTest extends TestCase
{
    public function testBalanceIsInitiallyZero()
    {
        $this->assertTrue(true);
    }
    public function test_balance_is_initially_zero()
    {
        $this->assertTrue(false);
    }
    public function testBalanceCannotBecomeNegative()
    {
        $this->assertTrue(true);
    }
    public function testBalanceCannotBecomeNegative2()
    {
        $this->assertTrue(true);
    }
    /**
     * @dataProvider provider
     */
    public function testBanancingMethod($data)
    {
        $this->assertTrue($data);
    }

    public function provider()
    {
        return [
            'my named data' => [true],
            'my data'       => [true]
        ];
    }
}

那么再次执行这个结果就不同了：

C:\Users\Administrator>D:\phpstudy_pro\Extensions\php\php7.3.4nts\php.exe D:\phpstudy_pro\Extensions\php\php7.3.4nts\phpunit-9.5.8.phar --testdox C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php
PHPUnit 9.5.8 by Sebastian Bergmann and contributors.
 
Bank Account (TestNamespace\BankAccount)
 ✔ Balance is initially zero
 ✘ Balance is initially zero
   │
   │ Failed asserting that false is true.
   │
   │ C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php:13
   │
 
 ✔ Balance cannot become negative
 ✔ Balance cannot become negative
 ✔ Banancing method with data set "my named data"
 ✔ Banancing method with data set "my data"
 
Time: 00:00.012, Memory: 20.00 MB
 
Summary of non-successful tests:
 
Bank Account (TestNamespace\BankAccount)
 ✘ Balance is initially zero
   │
   │ Failed asserting that false is true.
   │
   │ C:\Users\Administrator\PhpstormProjects\untitled\BankAccountTest.php:13
   │
 
FAILURES!
Tests: 6, Assertions: 6, Failures: 1.