1. Test-Driven
Development
for TYPO3
Oliver Klee, 2012-14-08
typo3-coding@oliverklee.de

2. Unit
tests?

3. Manual testing is cumbersome

4. Automated
testing is
fast

5. Unit tests for the
Realty Manager
extension

6. more than
1600 tests

7. in less than 60
seconds

8. Verify that your code
does what you expect

9. Make sure that your
changes won‘t break
anything

10. Keep
other coders
from breaking your code

11. Don‘t break anything
even in complex projects

12. Create asafety net
for refactoring

13. Green feels good!

14. Green feels good!

16. Know
your
tools

17. The phpunit extension
has it all

18. The phpunit extension
has it all
phpunit (TYPO3 extension)

19. The phpunit extension
has it all
phpunit (TYPO3 extension)
PHPUnit (PEAR package)

20. The phpunit extension
has it all
phpunit (TYPO3 extension)
PHPUnit (PEAR package)
Testrunner
(back-end-
module)

21. The phpunit extension
has it all
phpunit (TYPO3 extension)
PHPUnit (PEAR package)
Testrunner Testrunner
(back-end-
module) (CLI module)

22. The phpunit extension
has it all
phpunit (TYPO3 extension)
PHPUnit (PEAR package)
Testing framework for FE & DB
Testrunner Testrunner
(back-end-
module) (CLI module)

23. Let‘s get
some terms
straight

24. Two tests
meet in a
bar ...

25. Two tests
Test meet in a
bar ...

26. Two tests
Test meet in a
Assertion bar ...

27. Two tests
Test meet in a
Assertion bar ...
Test
Test

28. Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case

29. Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case
Test case

30. Two tests
Test meet in a
Assertion bar ...
Test
Test
Test case
Test case
Test suite

31. The life cycle unit test
of a

32. The life cycle unit test
of a

33. The life cycle unit test
of a
new FooTest();

34. The life cycle unit test
of a
new FooTest();

35. The life cycle unit test
of a
new FooTest();
setUp();

36. The life cycle unit test
of a
new FooTest();
setUp();
/** @test */
lifeIsGood();

37. The life cycle unit test
of a
new FooTest();
setUp();
/** @test */
lifeIsGood();

38. The life cycle unit test
of a
new FooTest();
setUp();
/** @test */
lifeIsGood();
tearDown();

39. The life cycle unit test
of a
new FooTest();
setUp();
/** @test */
lifeIsGood();
tearDown();

40. The life cycle unit test
of a
new FooTest();
setUp();
/** @test */
lifeIsGood();
tearDown();

41. Code test-first

42. Code test-first

43. Code test-first
write
test

44. Code test-first
write
test

45. Code test-first
write write
test code

46. Code test-first
write write
test code

47. Code test-first
write write
test code

48. Code test-first
write write
test code
refactor

49. Code test-first
write write
test code
refactor

51. Use meaningful
unit test names

52. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated

53. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated
Mention the
method. setTitleSetsTitle

54. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated
Mention the
method. setTitleSetsTitle
Name the setSizeWithZeroThrowsException
preconditions. hasTitleForEmptyTitleReturnsFalse

55. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated
Mention the
method. setTitleSetsTitle
Name the setSizeWithZeroThrowsException
preconditions. hasTitleForEmptyTitleReturnsFalse
Dont‘t use
"works" or
"correctly".

56. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated
Mention the
method. setTitleSetsTitle
Name the setSizeWithZeroThrowsException
preconditions. hasTitleForEmptyTitleReturnsFalse
Dont‘t use
"works" or measureFrubbleWorksCorrectly
"correctly".

57. Use meaningful
unit test names
Name the
behavior. classCanBeInstantiated
Mention the
method. setTitleSetsTitle
Name the setSizeWithZeroThrowsException
preconditions. hasTitleForEmptyTitleReturnsFalse
Dont‘t use
"works" or measureFrubbleWorksCorrectly
"correctly".

58. The testing framework
is created quickly
/**
* @var Tx_Phpunit_Framework
*/
protected $testingFramework = NULL;
public function setUp() {
$this->testingFramework = new Tx_Phpunit_Framework('tx_news2');
}
public function tearDown() {
$this->testingFramework->cleanUp();
unset($this->testingFramework);
}

59. The testing framework
is created quickly
/**
* @var Tx_Phpunit_Framework
*/
protected $testingFramework = NULL;
public function setUp() {
$this->testingFramework = new Tx_Phpunit_Framework('tx_news2');
}
discard the FE,
public function tearDown() {
delete DB records,
$this->testingFramework->cleanUp();
unset($this->testingFramework);
delete files
}

60. The testing framework
is created quickly
/**
* @var Tx_Phpunit_Framework
*/
protected $testingFramework = NULL;
public function setUp() {
$this->testingFramework = new Tx_Phpunit_Framework('tx_news2');
}
discard the FE,
public function tearDown() {
delete DB records,
$this->testingFramework->cleanUp();
unset($this->testingFramework);
delete files
}
CREATE TABLE tx_news2_domain_model_news (
…
is_dummy_record tinyint(1) unsigned DEFAULT '0' NOT NULL,
…

61. The testing framework
can fake almost everything

62. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());

63. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);

64. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);

65. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);

66. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);

67. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);
$tf->removeRelation($tableName, $uidLocal, $uidForeign);

68. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);
$tf->removeRelation($tableName, $uidLocal, $uidForeign);
$numberOfRecords = $tf->countRecords($tableName, $whereClause = '');

69. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);
$tf->removeRelation($tableName, $uidLocal, $uidForeign);
$numberOfRecords = $tf->countRecords($tableName, $whereClause = '');
$success = $tf->existsRecord($tableName, $whereClause = '');

70. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);
$tf->removeRelation($tableName, $uidLocal, $uidForeign);
$numberOfRecords = $tf->countRecords($tableName, $whereClause = '');
$success = $tf->existsRecord($tableName, $whereClause = '');
$success = $tf->existsExactlyOneRecord($tableName, $whereClause = '');

71. The testing framework
can fake almost everything
$recordUid = $tf->createRecord($tableName, array $recordData = array());
$tf->changeRecord($tableName, $uid, array $recordData);
$tf->deleteRecord($tableName, $uid);
$tf->createRelation($tableName, $uidLocal, $uidForeign, $sorting = 0);
$tf->createRelationAndUpdateCounter($tableName, $uidLocal, $uidForeign, $columnName);
$tf->removeRelation($tableName, $uidLocal, $uidForeign);
$numberOfRecords = $tf->countRecords($tableName, $whereClause = '');
$success = $tf->existsRecord($tableName, $whereClause = '');
$success = $tf->existsExactlyOneRecord($tableName, $whereClause = '');
$success = $tf->existsRecordWithUid($tableName, $uid);

72. The testing framework
can fake almost everything

73. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());

74. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());

75. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());

76. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());

77. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);

78. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();

79. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());

80. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());
$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());

81. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());
$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());
$tf->loginFrontEndUser($userId);

82. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());
$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());
$tf->logoutFrontEndUser(); $tf->loginFrontEndUser($userId);

83. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());
$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());
$tf->logoutFrontEndUser(); $tf->loginFrontEndUser($userId);
$userUid = $tf->createAndLoginFrontEndUser($groups = '', array $recordData = array());

84. The testing framework
can fake almost everything
$pageUid = $tf->createFrontEndPage($parentId = 0, array $recordData = array());
$pageUid = $tf->createSystemFolder($parentId = 0, array $recordData = array());
$elementUid = $tf->createContentElement($pageId = 0, array $recordData = array());
$tf->createTemplate($pageId, array $recordData = array());
$pageUid = $tf->createFakeFrontEnd($pageUid = 0);
$tf->discardFakeFrontEnd();
$groupUid = $tf->createFrontEndUserGroup(array $recordData = array());
$userUid = $tf->createFrontEndUser($groups = '', array $recordData = array());
$tf->logoutFrontEndUser(); $tf->loginFrontEndUser($userId);
$userUid = $tf->createAndLoginFrontEndUser($groups = '', array $recordData = array());
$isLoggedIn = $tf->isLoggedIn();

85. The testing framework
can fake almost everything

86. The testing framework
can fake almost everything
$recordUid = $tf->createBackEndUser(array $recordData = array());

87. The testing framework
can fake almost everything
$recordUid = $tf->createBackEndUser(array $recordData = array());
$recordUid = $tf->createBackEndUserGroup(array $recordData = array());

88. The testing framework
can fake almost everything

89. The testing framework
can fake almost everything
$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');

90. The testing framework
can fake almost everything
$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');
$path = $tf->createDummyZipArchive($fileName = 'test.zip', array $filesToAdd = array());

91. The testing framework
can fake almost everything
$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');
$path = $tf->createDummyZipArchive($fileName = 'test.zip', array $filesToAdd = array());
$tf->deleteDummyFile($fileName);

92. The testing framework
can fake almost everything
$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');
$path = $tf->createDummyZipArchive($fileName = 'test.zip', array $filesToAdd = array());
$tf->deleteDummyFile($fileName);
$path = $tf->createDummyFolder($folderName);

93. The testing framework
can fake almost everything
$path = $tf->createDummyFile($fileName = 'test.txt', $content = '');
$path = $tf->createDummyZipArchive($fileName = 'test.zip', array $filesToAdd = array());
$tf->deleteDummyFile($fileName);
$path = $tf->createDummyFolder($folderName);
$tf->deleteDummyFolder($folderName);

94. Use vfsStream for creating
fake files and folders
public function setUp {
$root = vfsStream::setUp('Stuff');
$this->moreStuff = vfsStream::newDirectory('moreStuff')->at($root);
}

95. Use vfsStream for creating
fake files and folders
public function setUp {
$root = vfsStream::setUp('Stuff');
$this->moreStuff = vfsStream::newDirectory('moreStuff')->at($root);
}
/**
* @test
*/
public function checkFileWithPathOfExistingNonEmptyFileReturnsTrue() {
$file = vfsStream::createFile('test.txt')->at($this->moreStuff);
$file->withContent('Hello world!');
$this->assertTrue(
$this->fixture->checkFile(vfsStream::url('Stuff/moreStuff/test.txt'))
);
}