PHP entkoppeln

Vor vier Jahren ist Ihre Laravel-Anwendung sauber in Produktion gegangen. Heute berührt jedes Feature drei Dateien, die nichts miteinander zu tun haben sollten, die Testsuite läuft neun Minuten, und das Upgrade von Version 9 auf 11 liegt seit zwei Quartalen als Draft-Pull-Request herum. Das Framework hat Sie nicht im Stich gelassen. Das Team hat eine Laravel-Anwendung geschrieben - nicht eine Anwendung, die Laravel nutzt.

Dieses Buch zeigt, wie man die zweite Sorte schreibt.

Entkoppeltes PHP kombiniert Hexagonal Architecture (Cockburns Ports und Adapter) mit Clean Architecture (Martins vier Ringe) zu einer einzigen, pragmatischen Synthese für PHP 8.3+. Keine Java-nach-PHP-Übersetzungen. Keine Glaubenskriege darüber, welche Architektur gewinnt. Beide sind vertreten, beide ehrlich darüber, was sie gut können, und beide angewendet auf reale Laravel-11- und Symfony-7-Codebasen.

In 30 Kapiteln werden Sie:

• eine Domain in reinem PHP modellieren - ohne Framework-Imports, ohne Eloquent-Vererbung;
• Ports in der Sprache des Geschäfts definieren, nicht in der Sprache der Datenbank;
• denselben Use Case hinter drei Inbound-Adaptern (HTTP, CLI, Queue-Worker) und drei Outbound-Adaptern (Doctrine, Guzzle, AMQP) implementieren;
• die Dependency Rule mit Deptrac durchsetzen, sodass die Architektur in CI greift - nicht erst beim ermüdeten Code-Review;
• Transaktionen, Fehlerbehandlung, Domain Events, Observability und Autorisierung über Ports abwickeln, damit das Framework sich bewegen kann, ohne dass die Anwendung etwas merkt;
• einen Legacy-Laravel- und einen Legacy-Symfony-Dienst in dieselbe Form überführen - in Produktion, ein Endpoint nach dem anderen, ohne Freeze-Week.

Das begleitende öffentliche Repository liefert eine vollständige, dockerisierte Referenzanwendung, die jedes Pattern des Buches Ende-zu-Ende ausführt. Klonen, starten, mitlesen.

Geschrieben für PHP-Entwickler auf mittlerer bis Senior-Ebene, die einen produktiven Dienst mit Laravel oder Symfony ausgeliefert und ihn verrotten gesehen haben. Kompakt, meinungsstark, ohne Vereinfachungen.

Begleit-Repository: github.com/gabrielanhaia/php-clean-hexagonal-examples