README

Requirements

• PHP 8.4+
• PHPUnit 13.x

Installation

Require the package with Composer:

composer require --dev josrom/phpunit-unicode-printer:13.*

Or update your require-dev block manually and run composer update:

{
    "require-dev": {
        "josrom/phpunit-unicode-printer": "13.*"
    }
}

Configuration (PHPUnit 10 / 11 / 12 / 13)

PHPUnit 10 removed the printerClass XML attribute and replaced the printer architecture with an event-driven extension system, which PHPUnit 11, 12 and 13 keep. Register the printer as a <bootstrap> extension in your phpunit.xml:

<phpunit ...
         colors="true"
         ...>
    <extensions>
        <bootstrap class="PHPUnit\Extension\UnicodePrinterMethod"/>
    </extensions>
    ...
</phpunit>

Pick one of the three available extensions depending on the level of detail you want:

Status symbols

To make a test be flagged as Risky, set beStrictAboutTestsThatDoNotTestAnything="true" on <phpunit> and write a test method without any assertion.

Disable PHPUnit's default progress output

PHPUnit 10/11/12/13 always renders its own dotted progress (.IIFWES…). To avoid two progress streams interleaving, run PHPUnit with the --no-progress flag:

./vendor/bin/phpunit --no-progress

A convenient way is to alias it in your composer.json scripts section:

{
    "scripts": {
        "test": "phpunit --no-progress"
    }
}

Note: --no-progress is a CLI-only option; there is no equivalent attribute on the <phpunit> element.

Migrating from older versions

The old printerClass="..." attribute was removed by PHPUnit 10. Replace any of these:

<phpunit printerClass="PHPUnit\Printer" ...>
<phpunit printerClass="PHPUnit\PrinterClass" ...>
<phpunit printerClass="PHPUnit\PrinterMethod" ...>

with the corresponding <extensions> block shown above. The original three class names map to the new ones as:

Older PHPUnit versions

For previous versions of PHPUnit use these tags: