PHPUnit Extension

Run architecture checks as part of your test suite.

Contents

  1. Register The Extension
  2. Behavior
  3. Disable For One Run
  4. Disable Progress Output
  5. When To Use It

Register The Extension 

<!-- phpunit.xml -->
<extensions>
    <bootstrap class="Boundwize\StructArmed\PHPUnit\StructArmedExtension"/>
</extensions>

Behavior

Violations cause the test run to fail before any tests execute. This makes architecture checks part of the same feedback loop as your normal PHPUnit suite.

Disable For One Run

Set STRUCTARMED_DISABLED to 1 to run PHPUnit without the architecture checks:

STRUCTARMED_DISABLED=1 vendor/bin/phpunit

The extension remains configured in phpunit.xml, but it does not analyse anything for that run. Other values do not disable StructArmed.

Disable Progress Output

The extension shows the same progress bar as structarmed analyse. PHPUnit’s own --no-progress flag hides it together with PHPUnit’s test progress:

vendor/bin/phpunit --no-progress

To hide only the StructArmed progress bar while keeping PHPUnit’s own progress output, set the progress parameter on the extension:

<extensions>
    <bootstrap class="Boundwize\StructArmed\PHPUnit\StructArmedExtension">
        <parameter name="progress" value="false"/>
    </bootstrap>
</extensions>

When To Use It

Use the extension when a project already treats PHPUnit as the main local or CI verification command. If your CI pipeline separates static analysis and tests, running vendor/bin/structarmed analyse as a dedicated step may be clearer.