Wer jahrelang Erweiterungen für Contao 4 oder noch ältere Versionen geschrieben hat, kennt den typischen Workflow: Man kämpfte mit DCA-Konfigurationen, globalen Arrays und einer Ordnerstruktur, die stark an die alten CMS-Zeiten erinnerte.
Mit Contao 5 hat sich die Architektur fundamental verändert. Das System hat sich fast vollständig von Altlasten befreit und setzt nun konsequent auf moderne Symfony-Standards.
Für uns Webentwickler bedeutet das: Weniger proprietärer "Contao-Code" und mehr natives Symfony. Wenn man die zugrundeliegende Logik einmal verstanden hat, schreibt sich ein Contao 5 Bundle sauberer, schneller und wartungsärmer als je zuvor.
Die 3 wichtigsten Architektur-Sprünge in Contao 5
Echtes Dependency Injection (DI) & Autowiring: Schluß mit unhandlichen Hooks und globalen Registrierungen. Services, Listener und Controller werden in Contao 5 wie in jeder modernen Symfony-Applikation injiziert.
PHP-Attribute statt YAML/Annotations: Routen und Service-Konfigurationen lassen sich direkt dort definieren, wo sie hingehören – als native PHP-Attribute direkt über den Klassen und Methoden.
Strikte Trennung vom Core: Bundles verhalten sich nun wie isolierte Micro-Pakete. Das macht das Gesamtsystem extrem updatesicher und performant.
Ein typischer Stolperstein beim Einstieg
Obwohl das neue System extrem logisch aufgebaut ist, scheitern viele Entwickler beim ersten Versuch an den neuen Konventionen. Ein einziger falscher Namespace oder ein inkorrektes File-Placement im src/-Verzeichnis (z. B. beim Setup des ContaoManager/Plugin.php) sorgt dafür, dass das Bundle im Contao Manager überhaupt nicht erst auftaucht.
Um Bundles in Contao 5 erfolgreich zu entwickeln, muss man die genaue Kette aus Bundle-Klasse, Manager-Plugin, Dependency Injection und der finalen Service-Registrierung fehlerfrei aufsetzen.
Der vollständige Schritt-für-Schritt-Guide
Weil die Theorie gut, echter Code aber besser ist, habe ich mein gesamtes Praxiswissen aus der täglichen Agentur-Arbeit in einem extrem ausführlichen Leitfaden dokumentiert.
Dort zeige ich dir anhand eines realen Beispiels die komplette Entwicklung – von der nackten Ordnerstruktur über die automatische Service-Registrierung bis hin zur sauberen Integration in den Contao-Core.
Hier geht es zum vollständigen Tutorial: Contao 5 Bundle-Entwicklung in der Praxis
Wie steht ihr zu den Änderungen in Contao 5? Seid ihr froh über den harten Symfony-Schnitt oder vermisst ihr alte Workflows? Schreibt es mir gerne in die Kommentare!