Using PHPUnit to create a unit testing framework.Presented at the 2008 DC PHP Conference

1. Automated Unit Testing Getting Started The 2008 DC PHP Conference June 2nd, 2008

17. PHPUnit - Creating a Test Case <?php require_once( 'PHPUnit/Framework/TestCase.php' ); class SubStrTest extends PHPUnit_Framework_TestCase { public function testSubstr () { $this -> assertEquals ( 'o wo' , substr ( 'Hello world!' , 4 , 4 )); } } ?>

19. PHPUnit - Call Order PHPUnit_Framework_TestCase::setUp(); PHPUnit_Framework_TestCase::testMyCode1(); PHPUnit_Framework_TestCase::tearDown(); PHPUnit_Framework_TestCase::setUp(); PHPUnit_Framework_TestCase::testMyCode2(); PHPUnit_Framework_TestCase::tearDown();

20. PHPUnit - Fixtures <?php class BankAccountTest extends PHPUnit_Framework_TestCase { protected $ba ; protected function setUp () { $this -> ba = new BankAccount ; } public function testBalanceIsInitiallyZero () { $this -> assertEquals ( 0 , $this -> ba -> getBalance ()); } protected function tearDown () { $this -> ba = NULL ; } } ?>

22. PHPUnit - Testing Code <?php $this -> assertEquals ( 'o wo' , substr ( 'hello world' , 4 , 4 )); $this -> assertGreaterThan ( 3 , 4 ); $this -> assertTrue ( TRUE ); $this -> assertNULL ( NULL ); $this -> assertContains ( 'value1' , array( 'value1' , 'value2' , 'value3' )); $this -> assertFileExists ( '/tmp/testfile' ); $this -> assertType ( 'int' , 20 ); $this -> assertRegExp ( '/{3}-{2}-{4}/' , '123-45-6789' ); ?>

24. PHPUnit - Testing Code <?php require_once 'PHPUnit/Framework.php' ; class ExceptionTest extends PHPUnit_Framework_TestCase { public function testException () { $this -> setExpectedException ( 'Exception' , 'exception message' , 100 ); } } ?>

25. PHPUnit - Running a Test Usage: phpunit [switches] UnitTest [UnitTest.php] --log-graphviz <file> Log test execution in GraphViz markup. --log-json <file> Log test execution in JSON format. --log-tap <file> Log test execution in TAP format to file. --log-xml <file> Log test execution in XML format to file. --coverage-html <dir> Generate code coverage report in HTML format. --coverage-xml <file> Write code coverage information in XML format. --test-db-dsn <dsn> DSN for the test database. --test-db-log-rev <r> Revision information for database logging. --test-db-prefix ... Prefix that should be stripped from filenames. --test-db-log-info ... Additional information for database logging. --filter <pattern> Filter which tests to run. --group ... Only runs tests from the specified group(s). --exclude-group ... Exclude tests from the specified group(s). --loader <loader> TestSuiteLoader implementation to use. --repeat <times> Runs the test(s) repeatedly. --tap Report test execution progress in TAP format. --testdox Report test execution progress in TestDox format.

26. PHPUnit - Running a Test Usage: phpunit [switches] UnitTest [UnitTest.php] --no-syntax-check Disable syntax check of test source files. --stop-on-failure Stop execution upon first error or failure. --verbose Output more verbose information. --wait Waits for a keystroke after each test. --skeleton Generate skeleton UnitTest class for Unit in Unit.php. --help Prints this usage information. --version Prints the version and exits. --configuration <file> Read configuration from XML file. -d key[=value] Sets a php.ini value.

28. PHPUnit - Test Suites <?php if (! defined ( 'PHPUnit_MAIN_METHOD' )) define ( 'PHPUnit_MAIN_METHOD' , 'AllTests::main' ); require_once 'PHPUnit/Framework.php' ; require_once 'PHPUnit/TextUI/TestRunner.php' ; require_once 'MyTest.php' ; require_once 'MyOtherTest.php' ; class AllTests { public static function main () { PHPUnit_TextUI_TestRunner :: run ( self :: suite ()); } public static function suite () { $suite = new PHPUnit_Framework_TestSuite ( 'My Test Suite' ); $suite -> addTestSuite ( 'MyTest' ); $suite -> addTestSuite ( 'MyOtherTest' ); return $suite ; } } if ( PHPUnit_MAIN_METHOD == 'AllTests::main' ) AllTests :: main (); ?>

30. PHPUnit - XML Configuration Running a list of tests <phpunit> <testsuite name=&quot;My Test Suite&quot;> <directory suffix=&quot;Test.php&quot;> mytests/directory </directory> <file> mytests/dirtory/fileTest.php </file> </testsuite> </phpunit>

32. PHPUnit - XML Configuration <?php require_once( 'PHPUnit/Framework/TestCase.php' ); class SubStrTest extends PHPUnit_Framework_TestCase { /** * @group builtins */ public function testSubstr () { $this -> assertEquals ( 'o wo' , substr ( 'Hello world!' , 4 , 4 )); } } ?> >phpunit --configuration tests.xml --group builtins

39. PHPUnit - Skeleton Generator > phpunit --verbose CalculatorTest PHPUnit 3.2.19 by Sebastian Bergmann. CalculatorTest I Time: 0 seconds There was 1 incomplete test: 1) testAdd(CalculatorTest) This test has not been implemented yet. /home/mike/phpunit/CalculatorTest.php:65 OK, but incomplete or skipped tests! Tests: 1, Incomplete: 1.

42. PHPUnit - Skeleton Generator > phpunit --verbose CalculatorTest PHPUnit 3.2.19 by Sebastian Bergmann. CalculatorTest ..... Time: 0 seconds OK (5 tests)

43. PHPUnit - Skeleton Generator @assert (...) == X > assertEquals(X, method(...)) @assert (...) != X > assertNotEquals(X, method(...)) @assert (...) === X > assertSame(X, method(...)) @assert (...) !== X > assertNotSame(X, method(...)) @assert (...) > X > assertGreaterThan(X, method(...)) @assert (...) >= X > assertGreaterThanOrEqual(X, method(...)) @assert (...) < X > assertLessThan(X, method(...)) @assert (...) <= X > assertLessThanOrEqual(X, method(...)) @assert (...) throws X > @expectedException X

44. PHPUnit - Incomplete Tests TODO: finish slide

45. PHPUnit - Incomplete Tests Slide TODO: finish slide don't worry...just a little irony

46. PHPUnit - Incomplete Tests <?php require_once 'PHPUnit/Framework.php' ; class SampleTest extends PHPUnit_Framework_TestCase { public function testSomething () { // Optional: Test anything here, if you want. $this -> assertTrue ( TRUE , 'This should already work.' ); // Stop here and mark this test as incomplete. $this -> markTestIncomplete ( 'This test has not been implemented yet.' ); } } ?>

47. PHPUnit - SkippedTests <?php require_once 'PHPUnit/Framework.php' ; class DatabaseTest extends PHPUnit_Framework_TestCase { protected function setUp () { if (! extension_loaded ( 'mysqli' )) { $this -> markTestSkipped ( 'The MySQLi extension is not available.' ); } } } ?>

48. Advanced Features Mock Objects Database Testing Selenium RC PHPUnderControl Come see me again! Same room, same day, 3:30 PM

49. Thanks http://phpun.it http://planet.phpunit.de http://digitalsandwich.com http://dev.sellingsource.com Questions???