PHPUnit Manual

作成中のソフトウェアのテストを書いているうちに、 データベースに関するコードをテストする必要が出てくることもあるでしょう。 データベース拡張を使用すると、 データベースを特定の状態にしてからデータベース関連のコードを実行し、 データベースのデータが期待通りになっているかどうかを確かめることができます。

データベース関連のユニットテストを作成するもっとも手っ取り早い方法は、 PHPUnit_Extensions_Database_TestCase クラスを継承することです。 このクラスには、データベース接続を作成したり データベースにデータを送信したり、 テストの実行後にデータベースの中身を様々な形式のデータセットと比較したりする機能があります。 例 9.1 に、getConnection() と getDataSet() の実装例を示します。

<?php
require_once 'PHPUnit/Extensions/Database/TestCase.php';
 
class DatabaseTest extends PHPUnit_Extensions_Database_TestCase
{
    protected function getConnection()
    {
        $pdo = new PDO('mysql:host=localhost;dbname=testdb', 'root', '');
        return $this->createDefaultDBConnection($pdo, 'testdb');
    }
 
    protected function getDataSet()
    {
        return $this->createFlatXMLDataSet(dirname(__FILE__).'/_files/bank-account-seed.xml');
    }
}
?>

getConnection() メソッドは、 PHPUnit_Extensions_Database_DB_IDatabaseConnection インターフェイスの実装を返す必要があります。 createDefaultDBConnection() メソッドを使用して、データベース接続を返すことができます。 このメソッドの最初のパラメータには PDO オブジェクトを渡し、2 番目のパラメータにはテスト対象のスキーマの名前を渡します。

getDataSet() メソッドは、 PHPUnit_Extensions_Database_DataSet_IDataSet インターフェイスの実装を返す必要があります。 現在、PHPUnit では 3 種類のデータセットが使用できます。 データセットについては 「データセット」 で説明します。