Testing Wizardry how mocks and fixtures can save your sanity Jeff Carouth #ZendCon 2012 

Jeff Carouth tweets jcarouth blogs http://carouth.com checks [email protected] works 

Writing Tests Is easy 

Is more difficult Writing Effective Tests 

Unit Tests Vs. Integration Tests 

Fake or Simulated object exposing the same interface as the object it mimics 

Why Mocks? Objects which have states that are difficult to create or reproduce. 

Mocks and Stubs with PHPUnit http://crth.net/phpunit-mock-docs 

interface MyInterface { public function sayHi(); } class FirstMockTest extends PHPUnit_Framework_TestCase { public function testJeffShouldBeAbleToMockHisInterface() { $mockMyInterface = $this->getMock('MyInterface'); $mockMyInterface->expects($this->any()) ->method('sayHi') ->will($this->returnValue('Oh, hi!')); $this->assertEquals('Oh, hi!', $mockMyInterface->sayHi()); } } 

Stubs (in PHPUnit) Can: returnValue(‘hello world!’) returnArgument(1) returnSelf() returnValueMap($map) returnCallback(‘str_rot13’) throwException(new OopsException()) 

class OrderTest extends PHPUnit_Framework_TestCase { public function testSaveOrderSendsEmailWithOrderConfirmation() { $order = new Order(new \EmailService\Service\Sendmail()); $order->setId(12345); $order->save(); // log into email account // find email in inbox // verify it has the correct subject // No. No. No. } } NO! 

class OrderTest extends PHPUnit_Framework_TestCase { public function testSaveOrderSendsEmailWithOrderConfirmation() { $mockEmailService = $this->getMock( '\\EmailService\\EmailServiceInterface' ); $mockEmailService->expects($this->once()) ->method('send'); $order = new Order($mockEmailService); $order->setId(12345); $order->save(); } } 

class Order { private $emailService; private $logger; private $id; public function __construct($service, $logger = null) { $this->emailService = $service; $this->logger = $logger; } public function save() { //do some saving logic $this->emailService->send( 'Order Confirmation #' . $this->id ); } } 

class OrderTest extends PHPUnit_Framework_TestCase { //...snip... public function testEmailConfirmationFailLogs() { $mockLogger = $this->getMock('\\System\\LoggerInterface'); $mockLogger->expects($this->once()) ->method('log'); $mockEmailService = $this->getMock( '\\EmailService\\EmailServiceInterface' ); $mockEmailService->expects($this->once()) ->method('send') ->will($this->throwException(new Exception())); $order = new Order($mockEmailService, $mockLogger); $order->setId(12345); $order->save(); } } 

class Order { public function save() { //do some saving logic try { $this->emailService->send( 'Order Confirmation #' . $this->id ); } catch (Exception $e) { if (null !== $this->logger) { $this->logger->log( "email failed for order {$this->id}" ); } } } } 

Phake http://phake.digitalsandwich.com/docs/html/ 

class OrderTest extends PHPUnit_Framework_TestCase { public function testSaveOrderSendsEmailWithOrderConfirmation() { $mockEmailService = Phake::mock( '\\EmailService\\EmailServiceInterface' ); Phake::when($mockEmailService)->send()->thenReturn(true); $order = new Order($mockEmailService); $order->setId(12345); $order->save(); Phake::verify($mockEmailService)->send(); } } 

Mockery https://github.com/padraic/mockery 

class OrderTest extends PHPUnit_Framework_TestCase { public function tearDown() { m::close(); } public function testSaveOrderSendsEmailWithOrderConfirmation() { $mockEmailService = \Mockery::mock( '\\EmailService\\EmailServiceInterface' ); $mockEmailService->shouldReceive('send') ->withAnyArgs() ->andReturn(true); $order = new Order($mockEmailService); $order->setId(12345); $order->save(); } } 

Fixtures Defined 

DbUnit 

class TodoListTest extends PHPUnit_Extensions_Database_TestCase { private $pdo; /** * @return PHPUnit_Extensions_Database_DB_IDatabaseConnection */ public function getConnection() { $this->pdo = new PDO('DSN', 'USER', 'PASS'); return $this->createDefaultDBConnection( $this->pdo, 'todolist'); } /** * @return PHPUnit_Extensions_Database_DataSet_IDataSet */ public function getDataSet() { return $this->createFlatXMLDataSet( __DIR__ . "/fixtures/todo-seed.xml"); } } 



class TodoListTest extends PHPUnit_Extensions_Database_TestCase { public function testGetCountReturnNumberOfUnfinishedTasks() { $todoModel = new TodoModel($this->pdo); $expectedNumberOfTodos = 4; $todos = $todoModel->getUnfinishedTasks(); $this->assertCount( $expectedNumberOfTodos, $todos, 'The expected number of unfinished tasks is wrong.' ); } } 

class TodoModel { private $db; public function __construct($db) { $this->db = $db; } public function getUnfinishedTasks() { $sql = "SELECT * FROM todo"; $result = $this->db->query($sql); return $result->fetchAll(); } } 

Phabric https://github.com/benwaine/Phabric 

class FeatureContext extends MinkContext { protected $phabric; public function __construct(array $parameters) { $config = new \Doctrine\DBAL\Configuration(); self::$db = \Doctrine\DBAL\DriverManager::getConnection(...); $datasource = new \Phabric\Datasource\Doctrine( self::$db, $parameters['Phabric']['entities'] ); $this->phabric = new Phabric\Phabric($datasource); } } 

Feature: As an organized person I want to be able to manage my todo list So that I can ensure I accomplish my tasks Scenario: I want to see all incomplete tasks Given The following tasks exist | summary | createdDate | completed | estimate | | Task 1 | 2012-09-21 19:53:33 | false | 1 | | Task 2 | 2012-09-21 19:53:33 | false | 1 | | Task 3 | 2012-09-21 19:53:33 | false | 1 | When I am on "/tasks" Then I should see "3" tasks /** * @Given /^The following tasks exist$/ */ public function theFollowingTaskssExist(TableNode $table) { $this->phabric->insertFromTable('tasks', $table); } 

Faker https://github.com/fzaninotto/Faker 

' . PHP_EOL; print '' . PHP_EOL; for ($i = 0; $i < 50; $i++) { print " firstName}\" " . "lastname=\"{$faker->lastName}\" " . "email=\"{$faker->email}\" />" . PHP_EOL; } print ''; 



Thank You! https://joind.in/7039 @jcarouth | [email protected] http://speakerdeck.com/jcarouth