README

Displays the PHPUnit test results in a more presentable and friendly format. The Presenter includes timings for tests, colour support and better displays of errors and failures.

This has only been tested with PHPUnit ^7.5. However, this plugin still allows PHPUnit up to ^9.0 (via composer.json) to ease dependency restrictions but please note that things may not work as expected (use at your own 'risk').

Features

• Different formatting types depending on your preferences.
• Grouping of test cases and suites.
• Time taken for each test case.
• Optional colour support.

How to use

Simply include this library via Composer:

composer require --dev abwebdevelopers/phpunit-presenter

And then add it to your phpunit.xml file as the printerClass attribute

<phpunit
        ...
        printerClass="ABWebDevelopers\PHPUnitPresenter\Presenter"
        ...
>

Configuration

The Presenter can be configured via environment variables. The following environment variables are used:

Formats

There are three types of formatting of the results displayed by Presenter - default, feed and condensed.

default and feed display the same information (shown in the screenshot above), however, default uses CLI line overwriting to show real-time progress of tests. This may not work with some log readers used in test environments (such as Travis CI), so it is recommended to use feed for test environments.

A third format condensed presents test results in a condensed format closer to PHPUnit's default result printer. When using condensed, it is implied that PRESENTER_SHOW_TIMES is set to 0. The formatting of condensed looks similar to this:

License

MIT.