Bounded Context erklärt: klare Modellgrenzen statt einem Modell für alles. Schnitt, Integration und Absicherung mit Deptrac in PHP und Symfony Projekten.
Mehr erfahren
Ein Tag inhouse mit Benjamin Klein für Developer, Tester und Admins. Context Engineering, Harness, ADRs und zwei Hands on Blöcke mit KI Agenten in eurem Setup.
--report-uncovered zeigt Deptrac sie an, mit --fail-on-uncovered bricht die Analyse ab. Skipped sind bekannte Verstöße, die ihr bewusst unter skip_violations eintragt, um sie Schritt für Schritt abzubauen.
init legt eine erste Konfiguration an.
composer require --dev deptrac/deptrac
vendor/bin/deptrac init
deptrac, paths legt fest, welcher Code geprüft wird.
# deptrac.yaml
deptrac:
paths:
- src/
layers:
- name: Controller
collectors:
- type: classLike
value: .*Controller.*
- name: Service
collectors:
- type: classLike
value: .*Service.*
- name: Repository
collectors:
- type: classLike
value: .*Repository.*
ruleset:
Controller:
- Service
Service:
- Repository
Repository: ~
vendor/bin/deptrac analyse
deptrac.php automatisch und bevorzugt sie vor der YAML Datei. In PHP legt ihr Layer als Variablen an und nutzt sie in den Regeln wieder. Das spart Tippfehler bei Layer Namen. Die Konfigurationsklassen liegen im Namespace Deptrac\Deptrac\Contract\Config und fallen unter das Versprechen zur Rückwärtskompatibilität.
// deptrac.php
use Deptrac\Deptrac\Contract\Config\DeptracConfig;
use Symfony\Component\DependencyInjection\Loader\Configurator\ContainerConfigurator;
return static function (DeptracConfig $config, ContainerConfigurator $containerConfigurator): void {
// Layer, Collector und Regeln hier definieren
};
vendor/bin/deptrac analyse --formatter=baseline
deptrac.baseline.yaml bindet ihr in eure Konfiguration ein. Ab dann ist die Pipeline grün, und jeder neue Verstoß fällt sofort auf.
# deptrac.yaml
imports:
- deptrac.baseline.yaml
skip_violations auf keinen Verstoß mehr zu, meldet Deptrac das als Fehler. So bleibt die Baseline sauber und wächst nicht heimlich mit.
helps you communicate, visualize and enforce architectural decisions in your projects.
Bounded Context erklärt: klare Modellgrenzen statt einem Modell für alles. Schnitt, Integration und Absicherung mit Deptrac in PHP und Symfony Projekten.
Mehr erfahren
Wir arbeiten seit über 20 Jahren mit PHP und Symfony. Wir helfen bei PHP Updates und PHP Refactoring und beraten remote zu allen Fragen rund um PHP. Zuerst sichern Tests und statische Analyse den Code ab, dann räumen wir auf. Automatische CI/CD Deployments und eine stabile Docker Umgebung sorgen dafür, dass jede Änderung sicher live geht.
Deptrac ist ein Werkzeug zur statischen Analyse für PHP. Es prüft, ob die Abhängigkeiten zwischen den Schichten eurer Anwendung euren Regeln folgen. Ihr fasst Code per Collector zu Layern zusammen und legt im Ruleset fest, welcher Layer welchen nutzen darf. Jeder Verstoß erscheint mit Datei und Zeile, lokal oder in der CI Pipeline.
Aktuell ist die Version 4 unter dem Paketnamen deptrac/deptrac. Sie verlangt PHP 8.2. Das alte Paket qossmic/deptrac ist abandoned und das alte Repository archiviert. Seit Version 4.7 erkennt Deptrac außerdem eine deptrac.php automatisch als Konfiguration und bevorzugt sie vor der YAML Datei.
Ihr entfernt das alte Paket mit composer remove qossmic/deptrac --dev und installiert das neue mit composer require --dev deptrac/deptrac. Danach prüft ihr eure Konfiguration. Ältere YAML Dateien ohne den Schlüssel deptrac oder mit veralteten Collector Namen solltet ihr an das aktuelle Format anpassen. Der Upgrade Guide auf der Projektseite hilft dabei.
Für kleine Projekte reicht YAML völlig. In größeren Projekten spielt PHP seine Stärken aus. Layer liegen als Variablen vor und werden in Regeln und Formattern wiederverwendet, das verhindert Tippfehler. Außerdem lassen sich eigene Collector und Regeln einbinden. Die Konfigurationsklassen fallen unter das Versprechen zur Rückwärtskompatibilität.
Ja. KI Agents greifen gern direkt auf Klassen zu, die eigentlich tabu sind, weil das der kürzeste Weg ist. Deptrac in der Pipeline fängt das ab und meldet Datei und Zeile. Der Agent muss dann eine Lösung finden, die zur Architektur passt. Das ist ein einfacher Guardrail, der auch bei hohem Tempo hält.
Mit dem Baseline Formatter. Der Befehl vendor/bin/deptrac analyse --formatter=baseline schreibt alle heutigen Verstöße in die Datei deptrac.baseline.yaml. Die bindet ihr per imports in eure Konfiguration ein. Ab dann bleibt die Pipeline grün, neue Verstöße fallen sofort auf, und die alten baut ihr Schritt für Schritt ab.
Das sind Abhängigkeiten zu Klassen, die in keinem Layer liegen. Deptrac kann sie nicht bewerten, weil keine Regel für sie gilt. Mit der Option --report-uncovered zeigt Deptrac sie an, mit --fail-on-uncovered schlägt die Analyse fehl. Interne PHP Klassen ignoriert Deptrac dabei standardmäßig.
Deptrac bringt rund zwanzig Collector mit. Häufig genutzt werden classLike für Namen per Regex, directory für Ordner, implements und extends für Vererbung sowie composer für Code aus bestimmten Paketen. Mit layer und bool kombiniert ihr Layer und baut Ausnahmen. Die vollständige Liste steht in der Dokumentation.
Mit dem Codeclimate Formatter. Er gibt Verstöße in einem Format aus, das GitLab CI als Code Quality Report versteht. Die Verstöße erscheinen dann direkt im Merge Request. In GitHub Actions ist der GitHubActions Formatter automatisch aktiv und zeigt Verstöße als Annotations im Pull Request.
PHPStan prüft Typen und findet Fehler im Code, etwa falsche Aufrufe oder fehlende Methoden. Deptrac prüft die Architektur, also welche Teile des Codes voneinander abhängen dürfen. Beide ergänzen sich. Ein Projekt kann fehlerfrei durch PHPStan laufen und trotzdem quer durch alle Schichten verdrahtet sein.
Deptrac ist ein eigenes Tool mit vielen Collectorn, Baseline und Diagrammen. PHPat hängt sich als Erweiterung in PHPStan ein und braucht kein weiteres Tool. PHP Arkitect formuliert Regeln in PHP fast wie Sätze. Für große, gewachsene Projekte mit vielen Modulen ist Deptrac oft die flexibelste Wahl.
Ja. Die Graphviz Formatter erzeugen Diagramme als Bild, HTML oder dot Datei. Der MermaidJS Formatter liefert eine Diagramm Definition, die ihr direkt in Markdown Dokumentation einbetten könnt. So seht ihr Layer, erlaubte Wege und Verstöße auf einen Blick, etwa für Reviews oder Architektur Gespräche im Team.