README

A PHPUnit extension that profiles test execution time and reports the slowest tests.

Supports PHPUnit 10, 11, 12, and 13.

日本語版はこちら: README.ja.md

Installation

composer require --dev takigawaakinori/phpunit-profiler

Usage

Add the extension to your phpunit.xml (or phpunit.xml.dist):

<extensions>
    <bootstrap class="TakigawaAkinori\PhpunitProfiler\TestProfilerExtension"/>
</extensions>

Configuration

You can customize the extension behavior by adding <parameter> elements:

<extensions>
    <bootstrap class="TakigawaAkinori\PhpunitProfiler\TestProfilerExtension">
        <parameter name="showTopN" value="false"/>
        <parameter name="topCount" value="50"/>
        <parameter name="showPareto" value="true"/>
        <parameter name="slowThreshold" value="1.0"/>
        <parameter name="jsonOutput" value=".test-profile-result.json"/>
    </bootstrap>
</extensions>

Invalid Parameter Values

• topCount: If the value is non-numeric or less than 1, it falls back to the default 20.
• slowThreshold: If the value is non-numeric, threshold filtering is disabled.
• showTopN / showPareto: These are string-based flags. Use true or false exactly.

Output Examples

After running your tests, you'll see output like:

Top 20 Slowest Tests:
--------------------------------------------------------------------------------
  1.  5.032s  Tests\Feature\ExampleTest::test_heavy_operation
  2.  3.210s  Tests\Feature\ExampleTest::test_api_call
  3.  0.523s  Tests\Unit\ExampleTest::test_calculation
--------------------------------------------------------------------------------

Requirements

• PHP 8.1+
• PHPUnit 10.0+

License

MIT