8. 数据库测试

在各种编程语言中,许多入门与中级的单元测试范例都暗示着这样一种信息:很容易用简单的测试来对应用程序的逻辑进行测试。但是对于以数据库为中心的应用程序而言,这与现实相去甚远。一旦开始使用诸如 Wordpress、TYPO3、或 Symfony(配合 Doctrine 或 Propel)之类的东西,就很容易在用 PHPUnit 时碰到超多问题:正是由于这些库和数据库之间实在耦合的太紧密了。

Note

请确保已经安装了 PHP 扩展模块 pdo 和与数据库对应的特定扩展,比如 pdo_mysql。否则以下范例是无法运行的。

你大概会在日常工作面对的项目中经历这一幕。你打算把你那或生疏或纯熟的 PHPUnit 技能用到工作中去,结果被以下问题之一卡住了:

  • 待测方法执行了一个相当大的 JOIN 操作,并且得到的数据用于计算某些重要的结果。
  • 业务逻辑中混合执行了 SELECT、INSERT、UPDATE 和 DELETE 语句。
  • 为了给待测方法建立合理的初始数据,需要在两个以上(可能远超过)表里设置测试数据。
    DbUnit 扩展大大简化了为测试设置数据库的操作,并且可以在对数据执行了一系列操作之后验证数据库的内容。

数据库测试所支持的供应商

DbUnit 目前支持 MySQL、PostgreSQL、Oracle 和 SQLite。通过集成 Zend FrameworkDoctrine 2,也可以访问其他数据库系统,比如 IBM DB2 或者 Microsoft SQL Server。

数据库测试的难点

为什么所有单元测试的范例都不包含数据库交互?这里有个很好的理由:这类测试的建立和维护都很复杂。对数据库进行测试时,需要考虑以下这些变数:

  • 数据库和表
  • 向表中插入测试所需要的行
  • 测试运行完毕后验证数据库的状态
  • 每个新测试都要清理数据库
    许多数据库 API,比如 PDO、MySQLi 或者 OCI8,都十分繁琐且书写起来十分冗长,因此,手工进行这些步骤绝对是噩梦。

测试代码应当尽可能简短精确,这有若干原因:

  • 你不希望因为生产代码的小变更而需要对测试代码进行数量可观的修改。
  • 你希望在哪怕好几个月以后也能轻松地阅读并理解测试代码。
    另外,必须认识到,对于代码而言,本质上来说数据库是全局输入变量。测试套件中的两个不同的测试可能是运行在同一个数据库上的,并且可能把数据重用好多次。一个测试中出现的失败很容易影响到后继测试的结果,从而让整个测试过程变得非常艰难。前面提到的清理步骤对于解决“数据库是全局输入“的问题是非常重要的。

DbUnit 以一种优雅的方式来帮助简化数据库测试中的所有这些问题。

PHPUnit 无法帮你解决的问题是,相对于不使用数据的测试而言,数据库测试是非常慢的。随着数据库交互规模的增大,运行测试可能需要耗费可观的时间。然而,只要保持每个测试所使用的数据量较小并且尽可能用非数据库测试来对代码进行测试,即使很大的测试套件也能轻松在一分钟内跑完。

Doctrine 2 为例,此项目的测试套件目前包含了大约1000个测试,其中将近一半访问了数据库。但是在一台安装了MySQL的普通的台式机上,整个测试套件依然能在15秒钟内跑完。

数据库测试的四个阶段

Gerard Meszaros 在他的书《xUnit 测试模式》中列出了单元测试的四个阶段:

  • 建立基境(fixture)

  • 执行被测系统

  • 验证结果

  • 拆除基境(fixture)

什么是基境(fixture)?

基境(fixture)是对开始执行某个测试时应用程序和数据库所处初始状态的描述。

对数据库进行测试至少要处理建立与拆除的步骤,在其中完成清理工作,并将所需的基境数据写入表内。因而,对于数据库扩展模块而言,在数据库测试中有很好的理由将这四个步骤还原成类似下面这样的工作流程,这个流程对于每个测试都会完整执行:

1. 清理数据库

由于总是会有某个测试运行在并不确定表中是否有数据的数据库上,PHPUnit 在所有指定表上执行 TRUNCATE 操作来把它们清空。

2. 建立基境

PHPUnit 随后将迭代所有指定的基境数据行并将其插入到对应的表里。

3–5. 运行测试、验证结果、并拆除基境

在所有数据库都完成重置并加载好初始状态后,PHPUnit 才会执行实际的测试。这个部分的测试代码完全不需要数据库扩展模块的参与,可以随意测试任何想要测试的内容。

在测试中,验证的目的可以使用一个名为 assertDataSetsEqual() 的特殊断言来实现。当然,这完全是可选的。这个特性将在“数据库断言“一节中进行解说。

PHPUnit 数据库测试用例的配置

一般而言,使用 PHPUnit 时,测试用例都是按如下方式扩展自 PHPUnit\Framework\TestCase 类:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3.  
  4. class MyTest extends TestCase
  5. {
  6. public function testCalculate()
  7. {
  8. $this->assertEquals(2, 1 + 1);
  9. }
  10. }
  11. ?>

如果测试代码用到了数据库扩展模块,那么建立的过程就会更复杂一些,需要扩展另一个抽象 TestCase 类,它要求实现两个抽象方法,getConnection()getDataSet()

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class MyGuestbookTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. /**
  10. * @return PHPUnit_Extensions_Database_DB_IDatabaseConnection
  11. */
  12. public function getConnection()
  13. {
  14. $pdo = new PDO('sqlite::memory:');
  15. return $this->createDefaultDBConnection($pdo, ':memory:');
  16. }
  17.  
  18. /**
  19. * @return PHPUnit_Extensions_Database_DataSet_IDataSet
  20. */
  21. public function getDataSet()
  22. {
  23. return $this->createFlatXMLDataSet(dirname(__FILE__).'/_files/guestbook-seed.xml');
  24. }
  25. }
  26. ?>

实现 getConnection()

为了让清理与载入基境的功能正常运作,PHPUnit 数据库扩展模块需要用 PDO 库来实现跨供应商抽象访问数据库连接。重要的是要注意到,使用 PHPUnit 的数据库扩展模块并不要求应用程序本身基于PDO,PDO连接仅仅用于清理和建立基境。

在之前的例子里,我们在内存中创建 Sqlite 数据库并建立了连接,将此连接传递给 createDefaultDBConnection 方法,这个方法将 PDO 实例和第二参数(数据库名)包装在一个非常简单的数据库连接抽象层中,这个抽象层的类型是 PHPUnit_Extensions_Database_DB_IDatabaseConnection

“使用数据库连接“一节解说了这个接口的API以及如何充分利用它们。

实现 getDataSet()

getDataSet() 方法定义了在每个测试执行之前的数据库初始状态应该是什么样。数据库的状态通过由 PHPUnit_Extensions_Database_DataSet_IDataSet 所代表的 DataSet(数据集)和由 ``PHPUnit_Extensions_Database_DataSet_IDataTable``所代表的 DataTable(数据表)这两个概念进行抽象。下一节将详细讲述这些概念是如何运作的以及在数据库测试中使用它们有什么好处。

对于具体实现,只需要知道 setUp() 中会调用一次 getDataSet() 方法来接收基境数据集并将其插入数据库。在范例中使用了工厂方法 createFlatXMLDataSet($filename),它代表一个用 XML 表示的数据集。

数据库构架(DDL)怎么办?

PHPUnit 假设在测试运行之前数据库以及其中的所有表(table)、触发器(trigger)、序列(Sequence)和视图(view)都已经创建好。这意味着开发者必须在运行测试套件之前确保数据库已经正确建立。

有几种方法来达成这个数据库测试的先决条件。

  • 如果使用的是持久化数据库(不是 Sqlite Memory),可以很轻松地用 phpMyAdmin(针对MySQL)之类的工具来一次性建立数据库,并在每个测试中复用这个数据库。
  • 如果使用的是诸如 Doctrine 2Propel 这样的库,可以用它们的API来在测试运行前一次性建立所需的数据库。可以利用 PHPUnit 的引导和配置 功能来在每次测试运行时执行这些代码。

小建议:使用你自己的抽象数据库 TestCase 类

从前面的实现范例中容易发现 getConnection() 方法是相当稳定的,可以在不同的数据库测试用例中重用。另外,为了保持测试的性能良好和数据库的开销较低,可以对代码进行一点重构,来为应用程序形成一个通用的抽象测试用例,同时依然可以为每个具体测试用例指定不同的数据基境:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. abstract class MyApp_Tests_DatabaseTestCase extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. // only instantiate pdo once for test clean-up/fixture load
  10. static private $pdo = null;
  11.  
  12. // only instantiate PHPUnit_Extensions_Database_DB_IDatabaseConnection once per test
  13. private $conn = null;
  14.  
  15. final public function getConnection()
  16. {
  17. if ($this->conn === null) {
  18. if (self::$pdo == null) {
  19. self::$pdo = new PDO('sqlite::memory:');
  20. }
  21. $this->conn = $this->createDefaultDBConnection(self::$pdo, ':memory:');
  22. }
  23.  
  24. return $this->conn;
  25. }
  26. }
  27. ?>

这个例子里,数据库连接信息硬编码在 PDO 连接里了。PHPUnit 有另外一个绝妙的特性,可以让这个 TestCase 类更加通用。通过 XML 配置 可以为每个测试单独配置数据库连接信息。首先,在应用程序的 tests/ 目录下创建 “phpunit.xml“ 文件,内容大体是这样:

  1. <?xml version="1.0" encoding="UTF-8" ?>
  2. <phpunit>
  3. <php>
  4. <var name="DB_DSN" value="mysql:dbname=myguestbook;host=localhost" />
  5. <var name="DB_USER" value="user" />
  6. <var name="DB_PASSWD" value="passwd" />
  7. <var name="DB_DBNAME" value="myguestbook" />
  8. </php>
  9. </phpunit>

现在可以修改 TestCase 类了,像这样:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. abstract class Generic_Tests_DatabaseTestCase extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. // only instantiate pdo once for test clean-up/fixture load
  10. static private $pdo = null;
  11.  
  12. // only instantiate PHPUnit_Extensions_Database_DB_IDatabaseConnection once per test
  13. private $conn = null;
  14.  
  15. final public function getConnection()
  16. {
  17. if ($this->conn === null) {
  18. if (self::$pdo == null) {
  19. self::$pdo = new PDO( $GLOBALS['DB_DSN'], $GLOBALS['DB_USER'], $GLOBALS['DB_PASSWD'] );
  20. }
  21. $this->conn = $this->createDefaultDBConnection(self::$pdo, $GLOBALS['DB_DBNAME']);
  22. }
  23.  
  24. return $this->conn;
  25. }
  26. }
  27. ?>

现在可以从命令行界面以不同的配置来运行数据库测试套件了:

  1. $ user@desktop> phpunit --configuration developer-a.xml MyTests/
  2. $ user@desktop> phpunit --configuration developer-b.xml MyTests/

在开发机上进行开发时能够轻松的针对不同的目标数据库来运行数据库测试显得非常重要。如果多个开发人员在同一个数据库连接上运行数据库测试,很容易因为竞态而导致测试失败。

理解 DataSet(数据集)和 DataTable(数据表)

PHPUnit 的数据库扩展模块的核心概念是 DataSet(数据集)和 DataTable(数据表)。为了掌握如何使用 PHPUnit 进行测试,需要试着去了解这些简单的概念。DataSet(数据集)和 DataTable(数据表)是围绕着数据库表、行、列的抽象层。通过一套简单的API,底层数据库内容被隐藏在对象结构之下,同时,这个对象结构也可以用其他非数据库数据源来实现。

为了能比较实际内容和预期内容,这种抽象是必须的。预期内容可以用诸如 XML、 YAML、 CSV 文件或者 PHP 数组等方式来表达。DataSet 和 DataTable 接口以语义相似的方式模拟关系数据库存储,从而能够对这些概念上完全不同的数据源进行比较。

在测试中,数据库断言的工作流由以下三个简单的步骤组成:

  • 用表名称来指定数据库中的一个或多个表(实际上是指定了一个数据集)
  • 用你喜欢的格式(YAML、XML等等)来指定预期数据集
  • 断言这两个数据集陈述是彼此相等的。
    在 PHPUnit 的数据库扩展中,断言并非唯一使用 DataSet 和 DataTable 的情形。就像上一节中所展示的那样,它们也用于描述数据库的初始内容。数据库 TestCase 类强制要求定义一个基境数据集,随后用它来:

  • 根据此数据集所指定的所有表名,将数据库中对应表内的行全部删除。

  • 将数据集内数据表中的所有行写入数据库。

可用的各种实现

有三种不同类型的 DataSet/DataTable:

  • 基于文件的 DataSet 和 DataTable
  • 基于查询的 DataSet 和 DataTable
  • 筛选与组合 DataSet 和 DataTable
    基于文件的数据集和表一般用于初始化基境或描述数据库的预期状态。

Flat XML DataSet (平直 XML 数据集)

最常见的一种数据集名叫 Flat XML。这是一种非常简单的 XML 格式,根节点为 <dataset>,根节点下的每个标签就代表数据库中的一行数据。标签的名称就等于表名,而每个属性代表一个列。一个简单的留言本应用程序的例子大致上可能是这样:

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

显然,这非常易于编写。在这里,<guestbook> 是表名,这个表内有两行记录,每行有四个列:“id“、“content“、“user“ 和 “created“,以及各自的值。

不过,这种简单性是有代价的。

从上面这个例子里不太容易看出该如何指定一个空表。其实可以插入一个没有属性值的标签,以空表的名字作为标签名。空的 guestbook 表所对应的 Flat XML 文件大致上可能是这样:

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <guestbook />
  4. </dataset>

在 Flat XML DataSet 中,要处理 NULL 值会非常烦。在几乎所有数据库中(Oracle 是个例外),NULL 值和空字符串值是有区别的,这一点在 Flat XML 格式中很难表述。可以在数据行的表述中省略掉对应的属性来表示NULL值。假定上面这个留言本通过在 user 列使用 NULL 值的方式来允许匿名留言,那么 guestbook 表的内容可能是这样:

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

在这个例子里第二个条目是匿名发表的。但是这为列的识别带来了一个非常严重的问题。在数据集相等断言的判定过程中,每个数据集都需要指明每个表拥有哪些列。如果有一个列在数据表的所有行里其值都是 NULL,那么数据库扩展模块又该从何得知表中包含这个列呢?

在这里,Flat XML DataSet 做了一个关键假设:一个表的列信息由此表第一行的属性定义决定。在上面这个例子里,这意味着 guestbook 有 “id“、“content“、“user“ 和 “created“ 这几个列。第二行中 “user“ 列没有定义,因此将向数据库中插入 NULL 值。

如果从数据集中删掉第一行,因为没有指定 “user“,guestbook 表拥有的列就只剩下 “id“、“content“ 和 “created“。

要在有 NULL 值的情况下有效地使用 Flat XML Dataset,就必须保证每个表的第一行不包含 NULL 值,只有后继的那些行才能省略属性。这就有点棘手,因为数据行的排列顺序也是数据断言的一个相关因素。

反过来,如果在 Flat XML Dataset 中只指明了实际表中所有列的某个子集,那么所有省略掉的列都会设为它们的的默认值。如果某个省略掉的列的定义是 “NOT NULL DEFAULT NULL“,就会出现错误。

总的来说,建议只在不需要 NULL 值的情况下使用 Flat XML Dataset。

可以在数据库 TestCase 中调用 createFlatXmlDataSet($filename) 方法来创建 Flat XML Dataset 实例:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class MyTestCase extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function getDataSet()
  10. {
  11. return $this->createFlatXmlDataSet('myFlatXmlFixture.xml');
  12. }
  13. }
  14. ?>

XML DataSet (XML 数据集)

有另外一种更加结构化的 XML DataSet,它写起来有点冗长,但是规避了 Flat XML DataSet 所存在的 NULL 问题。在根节点 <dataset> 内,可以指定 <table><column><row><value><null /> 标签。和上面用 Flat XML 所定义的留言本数据集等价的 XML DataSet 如下:

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <table name="guestbook">
  4. <column>id</column>
  5. <column>content</column>
  6. <column>user</column>
  7. <column>created</column>
  8. <row>
  9. <value>1</value>
  10. <value>Hello buddy!</value>
  11. <value>joe</value>
  12. <value>2010-04-24 17:15:23</value>
  13. </row>
  14. <row>
  15. <value>2</value>
  16. <value>I like it!</value>
  17. <null />
  18. <value>2010-04-26 12:14:20</value>
  19. </row>
  20. </table>
  21. </dataset>

所定义的每个 <table> 都有一个名称,并且必须有对所有列及其名称的定义。其下可以包含零个或任意正整数个 <row> 元素。没有定义 <row> 意味着这是个空表。<value><null /> 标签必须按照之前给定 <column> 元素的顺序来指定。<null /> 标签显然意味着这个值为 NULL。

可以在数据库 TestCase 中调用 createXmlDataSet($filename) 方法来创建 XML DataSet 实例:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class MyTestCase extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function getDataSet()
  10. {
  11. return $this->createXMLDataSet('myXmlFixture.xml');
  12. }
  13. }
  14. ?>

MySQL XML DataSet (MySQL XML 数据集)

这种新的 XML 格式是 MySQL 数据库服务器 <http://www.mysql.com>`专用的。PHPUnit 3.5 加入了对这种格式的支持。可以用 ``mysqldump <http://dev.mysql.com/doc/refman/5.0/en/mysqldump.html>` 工具来生成这种格式的文件。与同样为 mysqldump 所支持的 CSV 数据集不同,这种 XML 格式可以在单个文件中包含多个表的数据。要生成这种格式的文件,可以这样调用 mysqldump

  1. $ mysqldump --xml -t -u [username] --password=[password] [database] > /path/to/file.xml

可以在数据库 TestCase 中调用 createMySQLXMLDataSet($filename) 方法来使用这个文件:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class MyTestCase extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function getDataSet()
  10. {
  11. return $this->createMySQLXMLDataSet('/path/to/file.xml');
  12. }
  13. }
  14. ?>

YAML DataSet (YAML 数据集)

也可以用 YAML DataSet 来写这个留言本的例子:

  1. guestbook:
  2. -
  3. id: 1
  4. content: "Hello buddy!"
  5. user: "joe"
  6. created: 2010-04-24 17:15:23
  7. -
  8. id: 2
  9. content: "I like it!"
  10. user:
  11. created: 2010-04-26 12:14:20

简单方便,同时还解决了和它类似的 FLat XML DataSet 所具有的 NULL 问题。在 YAML 中,只有列名而没有指定值就表示 NULL。空白字符串则这样指定:column1: ""

目前,数据库 TestCase 中没有 YAML DataSet 的工厂方法,因此需要手工进行实例化:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4. use PHPUnit\DbUnit\DataSet\YamlDataSet;
  5.  
  6. class YamlGuestbookTest extends TestCase
  7. {
  8. use TestCaseTrait;
  9.  
  10. protected function getDataSet()
  11. {
  12. return new YamlDataSet(dirname(__FILE__)."/_files/guestbook.yml");
  13. }
  14. }
  15. ?>

CSV DataSet (CSV 数据集)

另外一种基于文件的 DataSet 是基于 CSV 文件的。数据集中的每个表用一个单独的 CSV 文件表示。对于留言本的例子,可以这样定义 guestbook-table.csv 文件:

  1. id,content,user,created
  2. 1,"Hello buddy!","joe","2010-04-24 17:15:23"
  3. 2,"I like it!","nancy","2010-04-26 12:14:20"

用 Excel 或者 OpenOffice 来对这种格式进行编辑是非常方便的,但是在 CSV DataSet 中无法指定 NULL 值。给出一个空白列的结果是往这个列中插入数据库的默认空值。

可以这样创建 CSV DataSet:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4. use PHPUnit\DbUnit\DataSet\CsvDataSet;
  5.  
  6. class CsvGuestbookTest extends TestCase
  7. {
  8. use TestCaseTrait;
  9.  
  10. protected function getDataSet()
  11. {
  12. $dataSet = new CsvDataSet();
  13. $dataSet->addTable('guestbook', dirname(__FILE__)."/_files/guestbook.csv");
  14. return $dataSet;
  15. }
  16. }
  17. ?>

Array DataSe (数组数据集)

在 PHPUnit 的数据库扩展中,(尚)没有基于数组的 DataSet,不过很容易自行实现之。留言本的例子大致是这样:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ArrayGuestbookTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. protected function getDataSet()
  10. {
  11. return new MyApp_DbUnit_ArrayDataSet(
  12. [
  13. 'guestbook' => [
  14. [
  15. 'id' => 1,
  16. 'content' => 'Hello buddy!',
  17. 'user' => 'joe',
  18. 'created' => '2010-04-24 17:15:23'
  19. ],
  20. [
  21. 'id' => 2,
  22. 'content' => 'I like it!',
  23. 'user' => null,
  24. 'created' => '2010-04-26 12:14:20'
  25. ],
  26. ],
  27. ]
  28. );
  29. }
  30. }
  31. ?>

PHP 版本的 DataSet 相比于所有其他基于文件的 DataSet 相比有很明显的优点:

  • PHP 数组显然可以处理 NULL 值。
  • 不需要为断言提供任何额外文件,可以直接在 TestCase 中指定。
    对于这种 DataSet 而言,和平直 XML、CSV、YAML DataSet 一样,表的列名信息由第一个指定的行的键名定义。在上面这个例子里,就是 “id“、“content“、“user“ 和 “created“。

这个数组 DataSet 类的实现是非常简单直接的:

  1. <?php
  2. class MyApp_DbUnit_ArrayDataSet extends PHPUnit_Extensions_Database_DataSet_AbstractDataSet
  3. {
  4. /**
  5. * @var array
  6. */
  7. protected $tables = [];
  8.  
  9. /**
  10. * @param array $data
  11. */
  12. public function __construct(array $data)
  13. {
  14. foreach ($data AS $tableName => $rows) {
  15. $columns = [];
  16. if (isset($rows[0])) {
  17. $columns = array_keys($rows[0]);
  18. }
  19.  
  20. $metaData = new PHPUnit_Extensions_Database_DataSet_DefaultTableMetaData($tableName, $columns);
  21. $table = new PHPUnit_Extensions_Database_DataSet_DefaultTable($metaData);
  22.  
  23. foreach ($rows AS $row) {
  24. $table->addRow($row);
  25. }
  26. $this->tables[$tableName] = $table;
  27. }
  28. }
  29.  
  30. protected function createIterator($reverse = false)
  31. {
  32. return new PHPUnit_Extensions_Database_DataSet_DefaultTableIterator($this->tables, $reverse);
  33. }
  34.  
  35. public function getTable($tableName)
  36. {
  37. if (!isset($this->tables[$tableName])) {
  38. throw new InvalidArgumentException("$tableName is not a table in the current database.");
  39. }
  40.  
  41. return $this->tables[$tableName];
  42. }
  43. }
  44. ?>

Query (SQL) DataSet (查询(SQL)数据集)

对于数据库断言,不仅需要有基于文件的 DataSet,同时也需要有一种内含数据库实际内容的基于查询/SQL 的 DataSet。Query DataSet 在此闪亮登场:

  1. <?php
  2. $ds = new PHPUnit_Extensions_Database_DataSet_QueryDataSet($this->getConnection());
  3. $ds->addTable('guestbook');
  4. ?>

单纯以名称来添加表是一种隐式地用以下查询来定义 DataTable 的方法:

  1. <?php
  2. $ds = new PHPUnit_Extensions_Database_DataSet_QueryDataSet($this->getConnection());
  3. $ds->addTable('guestbook', 'SELECT * FROM guestbook');
  4. ?>

可以在这种用法中为你的表任意指定查询,例如限定行、列,或者加上 ORDER BY 子句:

  1. <?php
  2. $ds = new PHPUnit_Extensions_Database_DataSet_QueryDataSet($this->getConnection());
  3. $ds->addTable('guestbook', 'SELECT id, content FROM guestbook ORDER BY created DESC');
  4. ?>

在关于数据库断言的那一节中有更多关于如何使用 Query DataSet 的细节。

Database (DB) Dataset (数据库数据集)

通过访问测试所使用的数据库连接,可以自动创建包含数据库所有表以及其内容的 DataSet。所使用的数据库由数据库连接工厂方法的第二个参数指定。

可以像 testGuestbook() 中那样创建整个数据库所对应的 DataSet,或者像 testFilteredGuestbook() 方法中那样用一个白名单来将 DataSet 限制在若干表名的集合上。

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class MySqlGuestbookTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. /**
  10. * @return PHPUnit_Extensions_Database_DB_IDatabaseConnection
  11. */
  12. public function getConnection()
  13. {
  14. $database = 'my_database';
  15. $user = 'my_user';
  16. $password = 'my_password';
  17. $pdo = new PDO('mysql:...', $user, $password);
  18. return $this->createDefaultDBConnection($pdo, $database);
  19. }
  20.  
  21. public function testGuestbook()
  22. {
  23. $dataSet = $this->getConnection()->createDataSet();
  24. // ...
  25. }
  26.  
  27. public function testFilteredGuestbook()
  28. {
  29. $tableNames = ['guestbook'];
  30. $dataSet = $this->getConnection()->createDataSet($tableNames);
  31. // ...
  32. }
  33. }
  34. ?>

Replacement DataSet (替换数据集)

前面谈到了 Flat XML 和 CSV DataSet 所存在的 NULL 问题,不过有一种稍微有点复杂的解决方法可以让这两种数据集都能正常处理 NULL。

Replacement DataSet 是已有数据集的修饰器(decorator),能够将数据集中任意列的值替换为其他替代值。为了让留言本的例子能够处理 NULL 值,首先指定类似这样的文件:

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

然后将 Flat XML DataSet 包装在 Replacement DataSet 中:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ReplacementTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function getDataSet()
  10. {
  11. $ds = $this->createFlatXmlDataSet('myFlatXmlFixture.xml');
  12. $rds = new PHPUnit_Extensions_Database_DataSet_ReplacementDataSet($ds);
  13. $rds->addFullReplacement('##NULL##', null);
  14. return $rds;
  15. }
  16. }
  17. ?>

DataSet Filter (数据集筛选器)

如果有一个非常大的基境文件,可以用数据集筛选器来为需要包含在子数据集中的表和列指定白/黑名单。与 DB DataSet 联用来对数据集中的列进行筛选尤其方便。

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class DataSetFilterTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testIncludeFilteredGuestbook()
  10. {
  11. $tableNames = ['guestbook'];
  12. $dataSet = $this->getConnection()->createDataSet();
  13.  
  14. $filterDataSet = new PHPUnit_Extensions_Database_DataSet_DataSetFilter($dataSet);
  15. $filterDataSet->addIncludeTables(['guestbook']);
  16. $filterDataSet->setIncludeColumnsForTable('guestbook', ['id', 'content']);
  17. // ..
  18. }
  19.  
  20. public function testExcludeFilteredGuestbook()
  21. {
  22. $tableNames = ['guestbook'];
  23. $dataSet = $this->getConnection()->createDataSet();
  24.  
  25. $filterDataSet = new PHPUnit_Extensions_Database_DataSet_DataSetFilter($dataSet);
  26. $filterDataSet->addExcludeTables(['foo', 'bar', 'baz']); // 只保留 guestbook 表!
  27. $filterDataSet->setExcludeColumnsForTable('guestbook', ['user', 'created']);
  28. // ..
  29. }
  30. }
  31. ?>
  32.  
  33. *注意:*不能对同一个表同时应用排除与包含两种列筛选器,只能分别应用于不同的表。另外,表的白名单和黑名单也只能选择其一,不能二者同时使用。

Composite DataSet (组合数据集)

Composite DataSet 能将多个已存在的数据集聚合成单个数据集,因此非常有用。如果多个数据集中存在同样的表,其中的数据行将按照指定的顺序进行追加。例如,假设有两个数据集, fixture1.xml

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <guestbook id="1" content="Hello buddy!" user="joe" created="2010-04-24 17:15:23" />
  4. </dataset>

fixture2.xml

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <guestbook id="2" content="I like it!" user="##NULL##" created="2010-04-26 12:14:20" />
  4. </dataset>

通过 Composite DataSet 可以把这两个基境文件聚合在一起:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class CompositeTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function getDataSet()
  10. {
  11. $ds1 = $this->createFlatXmlDataSet('fixture1.xml');
  12. $ds2 = $this->createFlatXmlDataSet('fixture2.xml');
  13.  
  14. $compositeDs = new PHPUnit_Extensions_Database_DataSet_CompositeDataSet();
  15. $compositeDs->addDataSet($ds1);
  16. $compositeDs->addDataSet($ds2);
  17.  
  18. return $compositeDs;
  19. }
  20. }
  21. ?>

当心外键

在建立基境的过程中, PHPUnit 的数据库扩展模块按照基境中所指定的顺序将数据行插入到数据库内。假如数据库中使用了外键,这就意味着必须指定好表的顺序,以避免外键约束失败。

实现自有的 DataSet/DataTable

为了理解 DataSet 和 DataTable 的内部实现,让我们来看看 DataSet 的接口。如果没打算自行实现 DataSet 或者 DataTable,可以直接跳过这一部分。

  1. <?php
  2. interface PHPUnit_Extensions_Database_DataSet_IDataSet extends IteratorAggregate
  3. {
  4. public function getTableNames();
  5. public function getTableMetaData($tableName);
  6. public function getTable($tableName);
  7. public function assertEquals(PHPUnit_Extensions_Database_DataSet_IDataSet $other);
  8.  
  9. public function getReverseIterator();
  10. }
  11. ?>

这些 public 接口在数据库 TestCase 中 assertDataSetsEqual() 断言内使用,用以检测数据集是否相等。IDataSet 中继承自 IteratorAggregate 接口的 getIterator() 方法用于对数据集中的所有表进行迭代。逆序迭代器让 PHPUnit 能够按照与创建时相反的顺序对所有表执行 TRUNCATE 操作,以此来保证满足外键约束。

根据具体实现的不同,要采取不同的方法来将表实例添加到数据集中。例如,在所有基于文件的数据集中,表都是在构造过程中直接从源文件生成并加入数据集中,比如 YamlDataSetXmlDataSet``FlatXmlDataSet``均是如此。

数据表则由以下接口表示:

  1. <?php
  2. interface PHPUnit_Extensions_Database_DataSet_ITable
  3. {
  4. public function getTableMetaData();
  5. public function getRowCount();
  6. public function getValue($row, $column);
  7. public function getRow($row);
  8. public function assertEquals(PHPUnit_Extensions_Database_DataSet_ITable $other);
  9. }
  10. ?>

除了 getTableMetaData() 方法之外,这个接口是一目了然的。数据库扩展模块中的各种断言(将于下一章中介绍)用到了所有这些方法,因此它们全部都是必需的。getTableMetaData() 方法需要返回一个实现了 PHPUnit_Extensions_Database_DataSet_ITableMetaData 接口的描述表结构的对象。这个对象包含如下信息:

  • 表的名称
  • 表的列名数组,按照列在结果集中出现的顺序排列。
  • 构成主键的列的数组。
    这个接口还包含有检验两个表的元数据实例是否彼此相等的断言,供数据集相等断言使用。

数据库连接 API

由数据库 TestCase 中的 getConnection() 方法所返回的连接接口有三个很有意思的方法:

  1. <?php
  2. interface PHPUnit_Extensions_Database_DB_IDatabaseConnection
  3. {
  4. public function createDataSet(Array $tableNames = NULL);
  5. public function createQueryTable($resultName, $sql);
  6. public function getRowCount($tableName, $whereClause = NULL);
  7.  
  8. // ...
  9. }
  10. ?>
  • createDataSet() 方法创建一个在数据集实现一节描述过的 Database (DB) DataSet(数据库数据集)。
  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ConnectionTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testCreateDataSet()
  10. {
  11. $tableNames = ['guestbook'];
  12. $dataSet = $this->getConnection()->createDataSet();
  13. }
  14. }
  15. ?>
  • createQueryTable() 方法用于创建 QueryTable 的实例,需要为其指定结果名称和所使用的 SQL 查询。当涉及到结果/表的断言(如后面关于数据库断言 API 那一节所示)时,这个方法会很方便。
  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ConnectionTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testCreateQueryTable()
  10. {
  11. $tableNames = ['guestbook'];
  12. $queryTable = $this->getConnection()->createQueryTable('guestbook', 'SELECT * FROM guestbook');
  13. }
  14. }
  15. ?>
  • getRowCount() 方法提供了一种方便的方式来取得表中的行数,并且还可以选择附加一个 WHERE 子句来在计数前对数据行进行过滤。它可以和一个简单的相等断言合用:
  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ConnectionTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testGetRowCount()
  10. {
  11. $this->assertEquals(2, $this->getConnection()->getRowCount('guestbook'));
  12. }
  13. }
  14. ?>

数据库断言 API

作为测试工具,数据库扩展模块理所当然会提供一些断言,可以用来验证数据库的当前状态、表的当前状态、表中数据行的数量。本节将详细描述这部分功能:

对表中数据行的数量作出断言

很多时候,确认表中是否包含特定数量的数据行是非常有帮助的。可以轻松做到这一点,不需要任何额外的使用连接 API 的粘合剂代码。比如说,在往留言本中插入一个新行之后,想要确认在表中除了之前的例子中一直都有的两行之外还有第三行:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class GuestbookTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testAddEntry()
  10. {
  11. $this->assertEquals(2, $this->getConnection()->getRowCount('guestbook'), "Pre-Condition");
  12.  
  13. $guestbook = new Guestbook();
  14. $guestbook->addEntry("suzy", "Hello world!");
  15.  
  16. $this->assertEquals(3, $this->getConnection()->getRowCount('guestbook'), "Inserting failed");
  17. }
  18. }
  19. ?>

对表的状态作出断言

前面的这个断言很有帮助,但是肯定还想要检验表的实际内容,好核实是否所有值都写到了正确的列中。可以通过表断言来做到这一点。

为此,先定义一个 QueryTable 实例,从表名称和 SQL 查询派生出其内容,随后将其与一个基于文件/数组的数据集进行比较:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class GuestbookTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testAddEntry()
  10. {
  11. $guestbook = new Guestbook();
  12. $guestbook->addEntry("suzy", "Hello world!");
  13.  
  14. $queryTable = $this->getConnection()->createQueryTable(
  15. 'guestbook', 'SELECT * FROM guestbook'
  16. );
  17. $expectedTable = $this->createFlatXmlDataSet("expectedBook.xml")
  18. ->getTable("guestbook");
  19. $this->assertTablesEqual($expectedTable, $queryTable);
  20. }
  21. }
  22. ?>

现在需要为这个断言编写Flat XML 文件 expectedBook.xml

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <guestbook id="1" content="Hello buddy!" user="joe" created="2010-04-24 17:15:23" />
  4. <guestbook id="2" content="I like it!" user="nancy" created="2010-04-26 12:14:20" />
  5. <guestbook id="3" content="Hello world!" user="suzy" created="2010-05-01 21:47:08" />
  6. </dataset>

在整个时间长河中,只有特定的一秒钟内这个断言可以通过评定,在 2010–05–01 21:47:08。在数据库测试中,日期构成了一个特殊的问题。可以从这个断言中省略 “created“ 列来规避失败。

为了让断言能得以通过, Flat XML 文件 expectedBook.xml 需要调整成大致类似这样:

  1. <?xml version="1.0" ?>
  2. <dataset>
  3. <guestbook id="1" content="Hello buddy!" user="joe" />
  4. <guestbook id="2" content="I like it!" user="nancy" />
  5. <guestbook id="3" content="Hello world!" user="suzy" />
  6. </dataset>

还得修正一下 QueryTable 的调用:

  1. <?php
  2. $queryTable = $this->getConnection()->createQueryTable(
  3. 'guestbook', 'SELECT id, content, user FROM guestbook'
  4. );
  5. ?>

对查询的结果作出断言

利用 QueryTable,也可以对复杂查询的结果作出断言,只需要指定查询以及结果名称,并随后将其与某个数据集进行比较:

  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class ComplexQueryTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testComplexQuery()
  10. {
  11. $queryTable = $this->getConnection()->createQueryTable(
  12. 'myComplexQuery', 'SELECT complexQuery...'
  13. );
  14. $expectedTable = $this->createFlatXmlDataSet("complexQueryAssertion.xml")
  15. ->getTable("myComplexQuery");
  16. $this->assertTablesEqual($expectedTable, $queryTable);
  17. }
  18. }
  19. ?>

对多个表的状态作出断言

当然可以一次性对多个表的状态作出断言,并将查询数据集与基于文件的数据集进行比较。有两种不同的方式来进行数据集断言。

  • 可以从自数据库连接建立数据库数据集,并将其与基于文件的数据集进行比较。
  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class DataSetAssertionsTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testCreateDataSetAssertion()
  10. {
  11. $dataSet = $this->getConnection()->createDataSet(['guestbook']);
  12. $expectedDataSet = $this->createFlatXmlDataSet('guestbook.xml');
  13. $this->assertDataSetsEqual($expectedDataSet, $dataSet);
  14. }
  15. }
  16. ?>
  • 也可以自行构造数据集:
  1. <?php
  2. use PHPUnit\Framework\TestCase;
  3. use PHPUnit\DbUnit\TestCaseTrait;
  4.  
  5. class DataSetAssertionsTest extends TestCase
  6. {
  7. use TestCaseTrait;
  8.  
  9. public function testManualDataSetAssertion()
  10. {
  11. $dataSet = new PHPUnit_Extensions_Database_DataSet_QueryDataSet();
  12. $dataSet->addTable('guestbook', 'SELECT id, content, user FROM guestbook'); // 额外的表
  13. $expectedDataSet = $this->createFlatXmlDataSet('guestbook.xml');
  14.  
  15. $this->assertDataSetsEqual($expectedDataSet, $dataSet);
  16. }
  17. }
  18. ?>

常见问题(FAQ)

PHPUnit 会为每个测试(重新)创建数据库吗?

不,PHPUnit 要求在测试套件开始时所有数据库对象必须全部可用。数据库、表、序列、触发器还有视图,必须全部在运行测试套件之前创建好。

Doctrine 2eZ Components 拥有强力的工具,可以按预定义的数据结构创建数据库,但是这些都必须和 PHPUnit 扩展模块对接之后才能自动在整个测试套件运行之前重新创建数据库。

由于每个测试都会彻底清空数据库,因此无须为每个测试重新创建数据库。持久可用的数据库同样能够完美工作。

为了让数据库扩展模块正常工作,需要在应用程序中使用 PDO 吗?

不,只在基境的清理与建立阶段还有断言检定时用到PDO。在你的自有代码中,可以使用任意数据库抽象。

如果看到 “Too much Connections“ 错误该怎么办?

如果没有对 TestCase 中 getConnection() 方法所创建 PDO 实例进行缓存,那么每个数据库测试都会增加一个或多个数据库连接。MySQL的默认配置只允许100个并发连接,其他供应商的数据库也都有各自的最大连接限制。

子章节 “使用你自己的抽象数据库 TestCase 类“展示了如何通过在所有测试中使用单个PDO实例缓存来防止发生此错误。

Flat XML / CSV 数据集中如何处理 NULL?

别这么干。应当改用 XML 或者 YAML 数据集。

原文: https://phpunit.readthedocs.io/zh_CN/latest/database.html