Utilisation, API et possibilités d'extension Le Quickstart permet déja de se rendre compte des capacités de tests d'une base de données avec PHPUnit et Zend Framework. Cette section donne un aperçu de l'API de Zend_Test_PHPUnit_Db ainsi que de son fonctionnement interne. Remarque sur les tests de bases de données Tout comme les TestCase de vos contrôleurs, les tests de bases de données sont efféctués au niveau intégration. Ils utilisent différentes couches applicatives pour lancer les tests et à ce titre devraient être utilisés avec précaution. Notez que tester la logique métier au seul moyen de tests d'intégration comme ceux fournis avec Zend_Test de Zend Framework est une mauvaise pratique. Les tests d'intégration sont là pour prouver le bon fonctionnement de l'assemblage des composants entre eux, ils ne doivent donc pas remplacer des tests unitaires éffectués plus bas dans les couches de votre logique métier. La classe Zend_Test_PHPUnit_DatabaseTestCase La classe Zend_Test_PHPUnit_DatabaseTestCase étend PHPUnit_Extensions_Database_TestCase, celle-ci permet de configurer un jeu de données concernant la base, pour chaque test. L'implementation du Zend Framework offre quelques fonctionalités supplémentaires par rapport à l'extension PHPUnit concernant les bases de données, ceci dans le but d'utiliser des ressources provenant de Zend_Db. Voici le scénario classique d'un test de base de données : Pour chaque test, PHPUnit crée une instance de la classe de tests (TestCase) et lance la méthode setUp(). Le scénario de test (TestCase) crée à son tour une instance du testeur de base de données (Database Tester) qui s'occupe de la construction et destruction de la base de données. Le testeur de base de données récupère la connexion à la base et le jeu de données initiales grâce à getConnection() et getDataSet() qui sont toutes deux des méthodes abstraites que vous devez implémenter dans votre scénario de test. Par défaut le testeur vide les tables spécifiées dans le jeu de données, puis peuple la base avec le jeu de données. Lorsque le testeur a fini de monter la base, PHPUnit lance votre test. Après que votre test ait fini, tearDown() est appelée. Cette méthode n'exécute aucune action du la base de données elle-même car les actions à mener sont efféctuées en setUp() (vider les tables). Le test de la base s'attend à ce que la base de données et les tables soient présentes. Il n'existe pas de mécanisme pour créer/détruire des base de données et/ou des tables. La classe Zend_Test_PHPUnit_DatabaseTestCase permet les tests de base de données à l'echelle du Zend Framework. Le tableau suivant liste uniquement les nouvelles méthodes par rapport à la classe PHPUnit_Extensions_Database_TestCase, dont l'API est documentée dans la documentation de PHPUnit. Méthodes de Zend_Test_PHPUnit_DatabaseTestCase Méthode Description createZendDbConnection(Zend_Db_Adapter_Abstract $connection, $schema) Créer une connexion compatible avec l'extension PHPUnit Database depuis une instance de Zend_Db_Adapter_Abstract. Cette méthode devrait être utilisée dans la configuration du scénario de tests en implémentant la méthode abstraite getConnection(). getAdapter() Méthode permettant l'accès à l'instance de Zend_Db_Adapter_Abstract qui est encapsulée dans la connexion efféctuée par PHPUnit au moyen de getConnection(). createDbRowset(Zend_Db_Table_Rowset_Abstract $rowset, $tableName = null) Créer un objet représentant les données d'une table depuis une instance de Zend_Db_Table_Rowset_Abstract donnée. La table reliée au rowset est choisie lorsque $tableName est NULL. createDbTable(Zend_Db_Table_Abstract $table, $where = null, $order = null, $count = null, $offset = null) Créer un objet qui représente les données contenues dans une instance de Zend_Db_Table_Abstract donnée. La récupération des données est faite grâce à fetchAll(), les paramètres additionnels peuvent servir à limiter les données retournées. createDbTableDataSet(array $tables=array()) Crée un jeu de données basé sur les tables $tables, tableau d'instances de Zend_Db_Table_Abstract.
Intégrer les tests de bases de données avec les tests de contrôleurs PHP n'autorise pas l'héritage multiple, donc vous ne pouvez utiliser les tests de contrôleurs et de bases de données en même temps via héritage. Cependant, vous pouvez utiliser Zend_Test_PHPUnit_Db_SimpleTester dans vos tests de contrôleurs pour configurer un environnement relatif à la base pour chaque test de contrôleur. Exemple d'intégration d'une base de données Cet exemple reprend le test de UserController utilisé dans la documentation de Zend_Test_PHPUnit_ControllerTestCase et y inclut la gestion d'une base de données. setupDatabase(); $this->bootstrap = array($this, 'appBootstrap'); parent::setUp(); } public function setupDatabase() { $db = Zend_Db::factory(...); $connection = new Zend_Test_PHPUnit_Db_Connection($db, 'database_schema_name'); $databaseTester = new Zend_Test_PHPUnit_Db_SimpleTester($connection); $databaseFixture = new PHPUnit_Extensions_Database_DataSet_FlatXmlDataSet( dirname(__FILE__) . '/_files/initialUserFixture.xml' ); $databaseTester->setupDatabase($databaseFixture); } } ]]> Ici le jeu de données XML "initialUserFixture.xml" est utilisé pour monter des données en base avant chaque test, exactement de la même manière que DatabaseTestCase le fait en interne.