1. The most unknown parts of
PHPUnit
Bastian Feder IPC Spring 2011 Berlinl
lapistano@php.net 1st June 2011

2. Me, myself & I
JavaScript since 2002
PHP since 2001
Trainer & coach
Opensource addict
PHP manual translations
FluentDOM
...

3. CLI

4. … on the command line
-- testdox[-(html|text)] -- filter <pattern>
generates a especially styled filters which testsuite to run.
test report.
$ phpunit --filter Handler --testdox ./
PHPUnit 3.4.15 by Sebastian Bergmann.
FluentDOMCore
[x] Get handler
FluentDOMHandler
[x] Insert nodes after
[x] Insert nodes before

5. … on the command line (cont.)
-- strict
marks test without an assertion as incomplete. Use in
combination with –verbose to get the name of the test.
-- coverage-(html|source|clover) <(dir|file)>
generates a report on how many lines of the code has how often
been executed.
-- group <groupname [, groupname]>
runs only the named group(s).
-- d key[=value]
alter ini-settings (e.g. memory_limit, max_execution_time)

6. Annotations

7. Annotations
„In software programming, annotations are used
mainly for the purpose of expanding code
documentation and comments. They are typically
ignored when the code is compiled or executed.“
( Wikipedia: http://en.wikipedia.org/w/index.php?title=Annotation&oldid=385076084 )

8. Annotations (cont.)
/** @covers, @group
* @covers myClass::run
* @group exceptions
* @group Trac-123
*/
public function testInvalidArgumentException() {
$obj = new myClass();
try{
$obj->run( 'invalidArgument' );
$this->fail('Expected exception not thrown.');
} catch ( InvalidArgumentException $e ) {
}
}

9. Annotations (cont.)
Depending on other tests
public function testIsApcAvailable() {
if ( ! extension_loaded( 'apc' ) ) {
$this->markTestSkipped( 'Required APC not available' );
}
}
/**
* @depend testIsApcAvailable
*/
public function testGetFileFromAPC () {
}

10. Assertions

11. Assertions
„In computer programming, an assertion is a predicate
(for example a true–false statement) placed in a
program to indicate that the developer thinks that the
predicate is always true at that place. [...]
It may be used to verify that an assumption made by
the programmer during the implementation of the
program remains valid when the program is executed..
[...]“
(Wikipedia, http://en.wikipedia.org/w/index.php?title=Assertion_(computing)&oldid=382473744)

12. Assertions (cont.)
assertContains(), assertContainsOnly()
Cameleon within the asserts, handles
Strings ( like strpos() )
Arrays ( like in_array() )
$this->assertContains('bar', 'foobar'); // ✓
$this->assertContainsOnly('string', array('1', '2', 3)); // ✗

13. Assertions (cont.)
assertXMLFileEqualsXMLFile()
assertXMLStringEqualsXMLFile()
assertXMLStringEqualsXMLString()
$this->assertXMLFileEqualsXMLFile(
'/path/to/Expected.xml',
'/path/to/Fixture.xml'
);

14. Assertions (cont.)
$ phpunit XmlFileEqualsXmlFileTest.php
PHPUnit 3.4.15 by Sebastian Bergmann.
…
1) XmlFileEqualsXmlFileTest::testFailure
Failed asserting that two strings are
equal.
--- Expected
+++ Actual
@@ -1,4 +1,4 @@
<?xml version="1.0"?>
<foo>
- <bar/>
+ <baz/>
</foo>
/dev/tests/XmlFileEqualsXmlFileTest.php:7

15. Assertions (cont.)
assertAttribute*()
Asserts the content of a class attribute regardless its
visibility
[…]
private $collection = array( 1, 2, '3' );
private $name = 'Jakob';
[…]
$this->assertAttributeContainsOnly(
'integer', 'collection', new myClass );
$this->assertAttributeContains(
'ko', 'name', new myClass );

16. Assertions (cont.)
assertType()
// TYPE_OBJECT
$this->assertType( 'FluentDOM', new FluentDOM );
$this->assertInstanceOf( 'FluentDOM', new FluentDOM );
// TYPE_STRING
$this->assertInternalType( 'string', '4221' );
// TYPE_INTEGER
$this->assertInternalType( 'integer', 4221 );
// TYPE_RESSOURCE
$this->assertInternalType(
'resource', fopen('/file.txt', 'r' );

17. Assertions (cont.)
assertSelectRegExp()
$xml = '
<items version="1.0">
<persons>
<person class="firstname">Thomas</person>
<person class="firstname">Jakob</person>
<person class="firstname">Bastian</person>
</persons>
</items>
';
$this->assertSelectRegExp(
'person[class*="name"]','(Jakob|Bastian)', 2, $xml);

18. Assertions (cont.)
assertThat()
Evaluates constraints to build complex assertions.
$this->assertThat(
$expected,
$ths->logicalAnd(
$this->isInstanceOf('tire'),
$this->logicalNot(
$this->identicalTo($myFrontTire)
)
)
);

19. Weaving in

20. Test Listeners
Get called on several states of the test runner
startTest
endTest
addIncompleteTest
…

21. Test Listeners (cont.)
Configuration
Add to your phpunit.xml
<listeners>
<listener class="myListener"
file="PATH/TO/YOUR/CODE">
<arguments>
<string>build/log</string>
</arguments>
</listener>
</listeners>

22. Test Listeners (cont.)
Implementation example
class ListenerLog implements PHPUnit_Framework_TestListener
{
public function __construct($path)
{
$this->path = $path;
}
public function startTestSuite(PHPUnit_Framework_TestSuite $suite)
{
$this->log("Test suite '%s' precesed.n", $test->getName());
}
}

23. Specialities

24. Special tests
Testing exceptions
@expectedException
/**
* @expectedException InvalidArgumentException
*/
public function testInvalidArgumentException() {
$obj = new myClass();
$obj->run('invalidArgument');
}

25. Special tests (cont.)
Testing exceptions
setExpectedException( 'Exception' )
for internal use only!!
don't use it directly any more.

26. Special tests (cont.)
Testing exceptions
try/catch
Does not work when using --strict switch
public function testInvalidArgumentException() {
$obj = new myClass();
try{
$obj->run( 'invalidArgument' );
$this->fail('Expected exception not thrown.');
} catch ( InvalidArgumentException $e ) {
}
}

27. Special tests (cont.)
public function callbackGetObject($name, $className = '')
{
retrun strtolower($name) == 'Jakob';
}
[…]
$application = $this->getMock('FluentDOM');
$application
->expects($this->any())
->method('getObject')
->will(
$this->returnCallback(
array($this, 'callbackGetObject')
)
);
[…]

28. Special tests (cont.)
[…]
$application = $this->getMock('FluentDOM');
$application
->expects($this->any())
->method('getObject')
->will(
$this->onConsecutiveCalls(
array($this, 'callbackGetObject',
$this->returnValue(true),
$this->returnValue(false),
$this->equalTo($expected)
)
);
[…]

29. Special tests (cont.)
implicit integration tests
public function testGet() {
$mock = $this->getMock(
'myAbstraction'
);
$mock
->expected( $this->once() )
->method( 'method' )
->will( $this->returnValue( 'return' );
}

30. Questions
@lapistano
lapistano@php.net

31. Slides'n contact
Please comment the talk on joind.in
http://joind.in/3518
Slides
http://slideshare.net/lapistano
Email:
lapistano@php.net

32. PHP5.3 Powerworkshop
New features of PHP5.3
Best Pratices using OOP
PHPUnit
PHPDocumentor

33. License

This set of slides and the source code included
in the download package is licensed under the
Creative Commons Attribution-Noncommercial-Share
Alike 2.0 Generic License
http://creativecommons.org/licenses/by-nc-sa/2.0/deed.en