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

phpunit指明应当不覆盖任何方法的测试-@coversNothing

发布时间：2021-09-29 21:32:59编辑：雪饮阅读（）

 “@coversNothing 标注来指明一个测试不覆盖任何方法（参见@coversNothing）。这可以在编写集成测试时用于确保代码覆盖全部来自单元测试。”

这是来自官方文档https://phpunit.readthedocs.io/zh_CN/latest/code-coverage-analysis.html中的说明。
那么实际上我是没有看出执行结果有什么不同，不过这里有点比较重要的就是它这篇文章中的这段话所描述给出的一个实例仅仅是代码片段，直接就不能跑起来。
这里要跑这个demo，我这里根据数据库测试相关资料，结合我这里的实际情况，这里整理了一下，应该实现步骤如下：
(1)   phpunit.xml:
首先phpunit.xml中要配置下与数据库连接相关的信息，因为它这个代码片段中并没有实现父类接口的getConnection方法。
所以：phpunit.xml:
<phpunit bootstrap="src/autoload.php">
    <testsuites>
        <testsuite name="Database">
            <file>tests/UserTest.php</file>
            <file>tests/DatabaseTest.php</file>
            <file>tests/InvoiceTest.php</file>
            <file>tests/GuestbookIntegrationTest.php</file>
        </testsuite>
    </testsuites>
    <php>
        <var name="DB_DSN" value="mysql:dbname=myguestbook;host=localhost" />
        <var name="DB_USER" value="root" />
        <var name="DB_PASSWD" value="123456" />
        <var name="DB_DBNAME" value="myguestbook" />
    </php>
</phpunit>
(2)   _files\guestbook-seed.xml:
除了getConnection方法要为父类实现，另外就是获取数据集的getDataSet方法也要为父类实现，它需要一个平面flat的数据集：

<?xml version="1.0" ?>
<dataset>
    <guestbook id="1" content="Hello buddy!" user="joe" created="2010-04-24 17:15:23" />
    <guestbook id="2" content="I like it!" user="nancy" created="2010-04-26 12:14:20" />
</dataset>

(3)   flat.xml：

上面的数据集实现完成后，在测试类中任何一个测试方法运行之前则数据集会入库。
那么接下来它这个测试方法中其实就是断言了已经入库中的这些数据（来自guestbook表中的数据（入库到具体什么表，主要是在数据集的来源文件，像是这里就是_files\guestbook-seed.xml））与另外一个来源的flat平面数据进行对比，以断言表状态的一致性，这里将另外一个来源的flat数据当作预期表状态的数据，而来源于实际数据库中的数据和这个预期的数据对比，这样以断言表状态。
<?xml version="1.0" ?>
<dataset>
<guestbook id="1" content="Hello buddy!" user="joe" created="2010-04-24 17:15:23" />
<guestbook id="2" content="I like it!" user="nancy" created="2010-04-26 12:14:20" />
<guestbook id="3" content="Hello world!" user="suzy" created="2010-04-26 12:14:20" />
</dataset>

当然了它这里是在数据集入库后自己又新增了一条后然后才和这个flat.xml中的数据进行表状态断言的。

(4)   GuestbookIntegrationTest.php:
那么这里GuestbookIntegrationTest.php就是具体的实现了：
<?php declare(strict_types=1);
use PHPUnit\DbUnit\TestCase;
final class GuestbookIntegrationTest extends TestCase
{
    static private $pdo = null;
    private $conn = null;
    final public function getConnection()
    {
        if ($this->conn === null) {
            if (self::$pdo == null) {
                self::$pdo = new PDO( $GLOBALS['DB_DSN'], $GLOBALS['DB_USER'], $GLOBALS['DB_PASSWD'] );
            }
            $this->conn = $this->createDefaultDBConnection(self::$pdo, $GLOBALS['DB_DBNAME']);
        }
        return $this->conn;
    }
    public function getDataSet()
    {
        return $this->createFlatXMLDataSet(dirname(__FILE__).'\_files\guestbook-seed.xml');
    }
    /**
     * @coversNothing
     */
    public function testAddEntry(): void
    {
        self::$pdo->exec("insert into guestbook(user,content,created) values('suzy','Hello world!','2010-04-26 12:14:20')");

        $queryTable = $this->getConnection()->createQueryTable(
            'guestbook', 'SELECT * FROM guestbook'
        );

        $expectedTable = $this->createFlatXmlDataSet(dirname(__FILE__)."/flat.xml")->getTable("guestbook");

        $this->assertTablesEqual($expectedTable, $queryTable);
    }
}

实际上这里以这个GuestbookIntegrationTest.php进行单独的phpunit测试或者是以组织测试，仍旧是看不出执行结果中有什么覆盖率。难道说文档中说的集成测试不是指组织测试？

这里先不纠结这个了，这里我用过GuestbookIntegrationTest.php的独立的phpunit测试或者是testsuite测试或者是组织测试都一样的差不多的。
那么这里不纠结了，直接看看最后的组织测试执行结果如：
C:\Users\Administrator>D:\phpstudy_pro\Extensions\php\php7.3.4nts\php.exe C:\Users\Administrator\PhpstormProjects\untitled\vendor\phpunit\phpunit\phpunit -c C:\Users\Administrator\PhpstormProjects\untitled\organizing\phpunit.xml -v C:\Users\Administrator\PhpstormProjects\untitled\organizing\tests
PHPUnit 7.5.20 by Sebastian Bergmann and contributors.
 
Runtime:       PHP 7.3.4 with Xdebug 2.7.2
Configuration: C:\Users\Administrator\PhpstormProjects\untitled\organizing\phpunit.xml
 
.......                                                             7 / 7 (100%)
 
Time: 102 ms, Memory: 6.00 MB
 
OK (7 tests, 8 assertions)