Skip to content

netresearch/typo3-testing-skill / skills/typo3-testing

typo3-testing

Flagged

Use when reproducing defects as failing tests, testing template or rendered output changes, confirming changes on a running TYPO3 instance, or setting up TYPO3 extension tests: unit/functional/E2E, PHPUnit 11-13, mutation testing, final-class mocks (v14), CI matrix across TYPO3 12/13/14.3 LTS, typo3-ci-workflows meta-package, CI failures. Also: transaction rollback, worker crashes, competing requests, testing-framework setup, test matrix, integration/e2e testing, coverage, test generation.

FileKindSize
SKILL.mdskill md6.8 KB
assets/.php-cs-fixer.dist.phpscript7.0 KB
assets/AGENTS.mdmarkdown5.0 KB
assets/Build/Scripts/runTests.shexecutablescript27.5 KB
assets/Build/playwright/.nvmrcother6 B
assets/Build/playwright/package.jsonmanifest535 B
assets/Build/playwright/playwright.config.tsscript1.3 KB
assets/Build/playwright/tests/playwright/accessibility/modules.spec.tsscript2.0 KB
assets/Build/playwright/tests/playwright/config.tsscript712 B
assets/Build/playwright/tests/playwright/e2e/backend-module.spec.tsscript1.9 KB
assets/Build/playwright/tests/playwright/fixtures/setup-fixtures.tsscript2.7 KB
assets/Build/playwright/tests/playwright/helper/login.setup.tsscript975 B
assets/FunctionalTests.xmlconfig1.4 KB
assets/FunctionalTestsBootstrap.phpscript1.6 KB
assets/Makefileother2.3 KB
assets/UnitTests.xmlconfig890 B
assets/UnitTestsBootstrap.phpscript2.1 KB
assets/bootstrap.phpscript1.4 KB
assets/codecov.ymlconfig1.6 KB
assets/docker/codeception.ymlconfig979 B
assets/docker/docker-compose.ymlconfig1.4 KB
assets/example-tests/ExampleAcceptanceCest.phpscript2.2 KB
assets/example-tests/ExampleFunctionalTest.phpscript2.4 KB
assets/example-tests/ExampleUnitTest.phpscript1.6 KB
assets/fixtures/README.mdmarkdown2.0 KB
assets/fixtures/be_users.csvother361 B
assets/fixtures/pages.csvother257 B
assets/fixtures/sys_category.csvother228 B
assets/fixtures/tt_content.csvother338 B
assets/github-actions-e2e.ymlconfig8.8 KB
assets/github-actions-tests.ymlconfig6.3 KB
assets/infection.json5other2.8 KB
assets/phpat.neonother330 B
assets/phpat.phpscript8.4 KB
assets/phpstan-baseline.neonother365 B
assets/phpstan.neonother1.4 KB
assets/rector.phpscript2.9 KB
checkpoints.yamlconfig61.7 KB
references/accessibility-testing.mdmarkdown7.6 KB
references/architecture-testing.mdmarkdown4.4 KB
references/asset-templates-guide.mdmarkdown3.4 KB
references/backend-module-render-verification.mdmarkdown9.7 KB
references/backend-user-access-testing.mdmarkdown9.5 KB
references/captainhook-setup.mdmarkdown2.4 KB
references/ci-cd.mdmarkdown39.5 KB
references/ci-debugging.mdmarkdown20.0 KB
references/ci-workflows-meta-package.mdmarkdown11.6 KB
references/crash-and-concurrency-testing.mdmarkdown4.8 KB
references/crypto-testing.mdmarkdown16.6 KB
references/datahandler-silent-rewrites.mdmarkdown7.2 KB
references/ddev-testing.mdmarkdown1.3 KB
references/e2e-testing.mdmarkdown53.0 KB
references/enforcement-rules.mdmarkdown5.7 KB
references/event-dispatch-testing.mdmarkdown2.8 KB
references/framework-compat-gate.mdmarkdown4.9 KB
references/functional-test-patterns.mdmarkdown11.0 KB
references/functional-testing.mdmarkdown46.3 KB
references/fuzz-testing.mdmarkdown8.6 KB
references/integration-testing.mdmarkdown14.1 KB
references/javascript-testing.mdmarkdown29.3 KB
references/live-instance-verification.mdmarkdown8.6 KB
references/mock-validity.mdmarkdown15.7 KB
references/mutation-testing.mdmarkdown36.0 KB
references/performance-testing.mdmarkdown11.2 KB
references/quality-tools.mdmarkdown25.5 KB
references/release-workflow-validation.mdmarkdown3.6 KB
references/sonarcloud.mdmarkdown18.8 KB
references/synthetic-secret-fixtures.mdmarkdown3.8 KB
references/tdd-discipline.mdmarkdown9.1 KB
references/test-environment-guards.mdmarkdown18.5 KB
references/test-runners.mdmarkdown24.6 KB
references/typo3-ci-config-patterns.mdmarkdown9.0 KB
references/typo3-v14-final-classes.mdmarkdown16.5 KB
references/unit-testing.mdmarkdown59.1 KB
scripts/generate-test.shexecutablescript6.0 KB
scripts/setup-testing.shexecutablescript6.3 KB
scripts/validate-setup.shexecutablescript4.0 KB

references/architecture-testing.md

View on GitHub
<!-- SPDX-License-Identifier: CC-BY-SA-4.0 -->
<!-- SPDX-FileCopyrightText: Netresearch DTT GmbH -->

# Architecture Testing with phpat

PHP Architecture Tester (phpat) enforces architectural rules through automated tests.

## Installation

```bash
composer require --dev carlosas/phpat
```

## Configuration

Create `phpat.php` in project root:

```php
<?php

declare(strict_types=1);

use PhpAT\Rule\Rule;
use PhpAT\Selector\Selector;
use PhpAT\Test\ArchitectureTest;

final class ArchitectureTests extends ArchitectureTest
{
    public function testServicesDoNotDependOnControllers(): Rule
    {
        return $this->newRule
            ->classesThat(Selector::haveClassName('*Service'))
            ->mustNotDependOn()
            ->classesThat(Selector::haveClassName('*Controller'))
            ->build();
    }

    public function testDomainDoesNotDependOnInfrastructure(): Rule
    {
        return $this->newRule
            ->classesThat(Selector::havePath('Domain/*'))
            ->mustNotDependOn()
            ->classesThat(Selector::havePath('Infrastructure/*'))
            ->build();
    }

    public function testEventsAreReadonly(): Rule
    {
        return $this->newRule
            ->classesThat(Selector::havePath('Event/*'))
            ->mustBeReadonly()
            ->build();
    }
}
```

## TYPO3 Extension Rules

### Layer Constraints

```php
public function testCleanArchitecture(): Rule
{
    return $this->newRule
        ->classesThat(Selector::havePath('Classes/Domain/*'))
        ->mustNotDependOn()
        ->classesThat(Selector::havePath('Classes/Controller/*'))
        ->andClassesThat(Selector::havePath('Classes/Command/*'))
        ->build();
}
```

### Service Layer Rules

```php
public function testServicesHaveInterface(): Rule
{
    return $this->newRule
        ->classesThat(Selector::haveClassName('*Service'))
        ->excludingClassesThat(Selector::haveClassName('*Interface'))
        ->mustImplement()
        ->classesThat(Selector::haveClassName('*Interface'))
        ->build();
}
```

## Running Tests

```bash
# Via PHPUnit
vendor/bin/phpunit --testsuite Architecture

# Via runTests.sh
Build/Scripts/runTests.sh -s architecture
```

## PHPUnit Configuration

Add to `phpunit.xml`:

```xml
<testsuite name="Architecture">
    <file>phpat.php</file>
</testsuite>
```

## Common Rules

| Rule | Purpose |
|------|---------|
| `mustNotDependOn` | Prevent unwanted dependencies |
| `mustImplement` | Enforce interface usage |
| `mustBeReadonly` | Enforce immutability (PHP 8.2+) |
| `mustBeFinal` | Prevent inheritance |
| `mustNotConstruct` | Enforce DI |

## Security-Critical Extensions

For security-critical code, enforce:

1. Events are readonly
2. Services don't construct other services (use DI)
3. Domain layer is isolated
4. No circular dependencies

## Hand-Rolled Reflective Sweeps on a Dual-Version Matrix

Beyond phpat, extensions write their own tests that walk `Classes/` with
reflection — API-surface snapshots, naming sweeps, "every X implements Y"
checks. On a CI matrix spanning two TYPO3 majors these hit a trap:

**`class_exists()` does not return false for a class whose parent or interface
is missing on this matrix leg — the autoload attempt THROWS an `Error`.**
Observed on a `^13.4 || ^14.3` matrix: an upgrade wizard implementing
`TYPO3\CMS\Core\Upgrades\UpgradeWizardInterface` (that name exists only on
14.x) made `class_exists()` fatal the whole sweep on every 13.4 leg, while all
14.x legs — including the local default — stayed green. The failure surfaces
one CI round trip after the test was written.

Guard the existence check and keep the two failure modes apart:

```php
try {
    $loadable = class_exists($fqcn) || interface_exists($fqcn)
        || trait_exists($fqcn) || enum_exists($fqcn);
} catch (\Throwable) {
    // THREW: a parent/interface comes from a package this matrix leg does
    // not ship — the class cannot be part of this leg's sweep. Skip it.
    continue;
}

// Clean FALSE (no throw): the PSR-4 name resolves to nothing anywhere.
// That is a broken discovery rule, not a matrix difference — keep it fatal.
self::assertTrue($loadable, sprintf('%s does not autoload', $fqcn));
```

Two consequences worth stating in the test: a snapshot-style sweep turns a
version-split class into a visible diff on the leg that lacks it (instead of a
fatal), and the `catch (\Throwable)` also swallows a `ParseError` in a swept
file — say explicitly that the lint job owns that case.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall