Php - PhpUnit



Command Line

Get the phar file for your php version. See Requirement

  • Powershell
cd phpHome
wget -OutFile phpunit.phar
wget -OutFile phpunit.phar # for the 7.5.9
php phpunit.phar --version
  • bash
cd phpHome
php phpunit.phar --version

Idea/WebStorm Configuration

  • Load from include_path. You need to set it for Idea. See below or the Pear webpage.

  • Path to phpunit.phar: the location of the phpunit.phar must be given.

  • Custom Working Directory. Generally, if the project include others technology, the php code is located in a child folder. You can set the default in the default.


Creating a test case

The TestClasses:

  • have the following name pattern classNameTest.php. For example, if the class to test is Myclass.php, the tests for it will be in MyclassTest.php.
  • are inherited from PHPUnit_Framework_TestCase.

The unit test are public methods that:

  • have the following prefix: test.
  • or have the @test annotation in a method's docblock
class MyClassTest extends PHPUnit_Framework_TestCase

    public function test()
        $this->assertEquals('foo', 'foo');

Annotations to group, filter test

    @group <group specification>
    @author <author specification>


# To run all test in the classFile  tests/myClassTest 
phpunit --bootstrap src/autoload.php tests/myClassTest 

# Or to execute all tests found declared in *Test.php sourcecode files in the tests directory.
phpunit --bootstrap src/autoload.php tests

# Or to execute all tests in a group
phpunit --bootstrap src/autoload.php --group plugins

# Or to exclude a group of test
phpunit --bootstrap src/autoload.php --exclude-group slow,internet


  • phpunit is the runner
  • --bootstrap src/autoload.php is a bootstrap script commonly used to set up load the classes that are to be tested before execution. Example: autoload.php. .

Example of output:

PHPUnit 3.7.21 by Sebastian Bergmann.

Time: 0 seconds, Memory: 2.00Mb

OK (1 test, 1 assertion)


Skipping test

$this->markTestSkipped('Skipped !' );

Testing for exception

  • A runtime test on an exception that should be thrown
try {
    $this->fail("Exception should be thrown");
} catch (ExceptionNotFound $e) {
  // other assertion or simply nothing

Documentation / Reference

Powered by ComboStrap