structuraphp/structura-phpunit

Architectural testing for PHP with phpunit

dev-main 2025-04-12 09:45 UTC

Requires

• php: ^8.2|^8.3|^8.4
• phpunit/phpunit: ^11.0|^12.0
• structuraphp/structura: dev-main

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.75
• phpstan/phpstan: ^2.1
• phpstan/phpstan-strict-rules: ^2.0
• rector/rector: ^2.0
• shipmonk/composer-dependency-analyser: ^1.8

MIT

README

PHPUnit extension for Structura

Requirements

PHP version

PHPUnit Version	PHP Version	Structura 0.x
<= 10.x	<= 8.1	✗ Unsupported
11.x / 12.x	8.2 / 8.3 / 8.4	✓ Supported

Installation

Using Composer

composer required --dev structuraphp/structura-phpunit

Usage

Here's an example of an architecture test for Laravel's HTTP scope:

<?php

declare(strict_types=1);

namespace Tests\Architecture;

use App\Http\Controllers\Controller;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Http\Resources\Json\JsonResource;
use PHPUnit\Framework\TestCase;
use Structura\Expr;
use StructuraPhp\StructuraPhpunit\ArchitectureAsserts;

final class ArchitectureHttpTest extends TestCase
{
    use ArchitectureAsserts;
    
    private static string $dir;
    
    public static function setUpBeforeClass(): void
    {
        self::$dir = dirname(__DIR__, 2).'/app/Http';
    }

    public function testHttpRequestsArchitecture(): void
    {
        $rules = $this
            ->allClasses()
            ->fromDir(self::$dir.'/Requests')
            ->should(
                static fn(Expr $assert): Expr => $assert
                    ->toExtend(FormRequest::class)
                    ->toHaveSuffix('Request')
                    ->or(static fn(Expr $assert) => $assert
                        ->toHaveMethod('attributes')
                        ->toHaveMethod('messages')
                    ),
            );

        self::assertRules($rules);
    }

    public function testHttpControllersArchitecture(): void
    {
        $rules = $this
            ->allClasses()
            ->fromDir(self::$dir.'/Controllers')
            ->should(
                static fn(Expr $assert): Expr => $assert
                    ->toExtend(Controller::class)
                    ->toBeFinal()
                    ->toHaveSuffix('Controller'),
            );

        self::assertRules($rules);
    }

    public function testHttpResourcesArchitecture(): void
    {
        $rules = $this
            ->allClasses()
            ->fromDir(self::$dir.'/Resources')
            ->should(
                static fn(Expr $assert): Expr => $assert
                    ->toExtend(JsonResource::class)
                    ->toBeFinal()
                    ->toHaveSuffix('Resources')
                    ->toHaveMethod('toArray'),
            );

        self::assertRules($rules);
    }
}

Then run your PHPUnit tests with the following command:

vendor/bin/phpunit --filter=Architecture