Symfony Schulung für Entwickler: Doctrine, Twig und Tests

Symfony einordnen und einrichten

• Symfony als Full-Stack-Framework und Komponentenbibliothek – Einsatz in Laravel, Drupal, API Platform
• Release-Zyklus, LTS-Versionen (6.4, 7.4) und Deprecation-Politik für die Upgrade-Planung auf 8.x
• Neues Projekt mit Symfony CLI oder Composer: webapp-Skelett und schlanke Variante
• Symfony Flex und Rezepte: Pakete installieren und Konfiguration automatisch erzeugen
• Entwicklungsumgebung: PHP ≥ 8.4 für Symfony 8 (≥ 8.2 für 7.4 LTS), PhpStorm mit Symfony-Plugin, lokaler Server, Docker
• bin/console und symfony-CLI: Server starten, Befehle auflisten, Umgebungen wechseln
• Verzeichnisstruktur, Umgebungen dev, test, prod und Konfiguration in config/

Request, Routing und Controller

• Request-Response-Zyklus: Front-Controller, Kernel, Request- und Response-Objekte
• Routen mit #[Route]-Attributen: Parameter, Anforderungen, HTTP-Methoden, Präfixe
• Routen prüfen mit debug:router und router:match
• MVC in Symfony: schlanke Controller, Logik in Services, Darstellung in Twig
• Request-Daten abbilden mit #[MapQueryString], #[MapRequestPayload] und #[MapEntity]
• JSON-Antworten, Weiterleitungen, Flash-Nachrichten und eigene Fehlerseiten
• Profiler und Web Debug Toolbar: Anfragen, Abfragen und Ereignisse nachvollziehen

Twig-Templates

• Twig als Template-Sprache: Auto-Escaping, Trennung von Logik und Darstellung
• Basissyntax: Ausgaben, Filter, Funktionen, Kommentare und Whitespace-Steuerung
• Zugriff auf Controller-Variablen, app.user, app.request und Flash-Nachrichten
• Schleifen mit for, Bedingungen mit if, Tests wie defined und empty
• Template-Vererbung mit extends und block, Wiederverwendung mit include und embed
• Links und URLs mit path() und url(), Assets mit asset()
• Wiederverwendbare Oberflächenbausteine mit Twig Components

Assets und Frontend

• AssetMapper und Importmaps: JavaScript und CSS ohne Node-Build-Kette
• Webpack Encore in Bestandsprojekten: Konfiguration, Einträge und Umstieg auf AssetMapper
• Versionierte Dateinamen, Caching und Kompilieren der Assets für die Produktion
• Symfony UX: Stimulus-Controller und Turbo für interaktive Seiten ohne SPA

Datenzugriff mit Doctrine

• Doctrine ORM: Entities, Repositories und der Entity Manager
• Datenbankverbindung über DATABASE_URL für PostgreSQL, MySQL oder SQLite
• Entities mit make:entity anlegen, Mapping über PHP-Attribute
• Migrationen erzeugen mit make:migration, prüfen und mit doctrine:migrations:migrate ausführen
• Beziehungen ManyToOne, OneToMany, ManyToMany – Owning Side und Kaskaden
• Testdaten mit DoctrineFixturesBundle und Factories aus Zenstruck Foundry
• CRUD-Abläufe, Gerüst mit make:crud und eigene Abfragen mit dem QueryBuilder
• N+1-Abfragen erkennen und mit Joins und Fetch-Strategien beheben

Formulare und Validierung

• Form-Komponente: Formulartypen, Datenbindung an Entities oder DTOs
• Eigene Formulartypen mit make:form, Optionen und wiederverwendbare Felder
• Formular-Request verarbeiten mit handleRequest(), isSubmitted() und isValid()
• Validierung mit Constraint-Attributen wie #[Assert\NotBlank], Gruppen und eigene Constraints
• Formular-Themes in Twig und CSRF-Schutz

Services und Dependency Injection

• Dependency Injection und Service-Container: warum Symfony ohne globale Helfer auskommt
• Verfügbare Services finden mit debug:autowiring und debug:container
• Autowiring über den Konstruktor, Interfaces binden, #[Autowire] für Sonderfälle
• Services konfigurieren in services.yaml: Parameter, Tags, Aliase, Decorators
• Umgebungsvariablen in .env und .env.local, Secrets mit secrets:set
• Middleware-Ketten im Messenger: Nachrichten asynchron verarbeiten

Konsolenbefehle

• Console-Komponente: eingebaute Befehle und eigene Werkzeuge für Betrieb und Wartung
• Eigene Befehle mit make:command und #[AsCommand]
• Hilfsklassen SymfonyStyle, Fortschrittsbalken, Tabellen und interaktive Fragen
• Argumente und Optionen deklarieren, auslesen und validieren
• Wiederkehrende Aufgaben mit der Scheduler-Komponente (stabil seit 6.4) statt Crontab-Einträgen

Sicherheit

• SecurityBundle: Firewalls, User-Provider und Passwort-Hashing
• Benutzer anlegen mit make:user, Login-Formular und Abmeldung
• Eigener Authenticator mit AbstractAuthenticator und Passport für API-Token oder SSO
• Rollen, Rollenhierarchie und access_control in security.yaml
• Prüfung mit #[IsGranted] und is_granted() in Twig
• Voter für Rechte auf einzelne Ressourcen, z. B. „nur eigene Buchungen bearbeiten“
• Login-Drosselung, Remember-me und Schutz vor CSRF bei der Anmeldung

Ereignisse

• Event Dispatcher: Entkopplung über Ereignisse statt direkter Aufrufe
• Listener mit #[AsEventListener] und Subscriber mit EventSubscriberInterface
• Kernel-Ereignisse kernel.request, kernel.controller, kernel.response, kernel.exception
• Ereignisse von Formularen, Security und Doctrine im Zusammenspiel
• Prioritäten, Propagation stoppen und Registrierung prüfen mit debug:event-dispatcher

Tests und Codequalität

• Teststrategie: Unit-, Integrations- und funktionale Tests in Symfony
• PHPUnit mit symfony/test-pack einrichten, eigene Testdatenbank für die Umgebung test
• Services mit KernelTestCase, Controller mit WebTestCase und Crawler testen
• Testgetrieben arbeiten: erst der funktionale Test, dann Route und Controller
• Statische Analyse mit PHPStan, Upgrades und Deprecations mit Rector abarbeiten

Betrieb und Deployment

• Produktionskonfiguration: APP_ENV=prod, Cache aufwärmen, OPcache und Preloading
• Logging mit Monolog und Fehlerbehandlung in der Produktion
• Container-Betrieb mit Docker und FrankenPHP oder klassisch mit PHP-FPM und Nginx

Symfony mit Coding-Agenten

• Ausgaben von debug:router, debug:container und debug:autowiring als Kontext für den Agenten
• Gerüste mit Maker-Befehlen erzeugen lassen und erst danach anpassen – Konventionen bleiben erhalten
• Feedbackschleife nach jeder Änderung: lint:container, lint:twig, PHPStan und WebTestCase-Suite
• Generierte Doctrine-Migrationen vor migrate lesen; security.yaml und Voter nur mit Review
• Major-Upgrades: Agent arbeitet das Deprecation-Log ab, Rector-Regeln erledigen das Mechanische

Praxisprojekt: Raumbuchung für ein Bürogebäude

• Räume, Buchungen und Nutzer als Doctrine-Entities mit Migrationen und Fixtures
• Buchungsformular mit Validierung gegen Überschneidungen und Voter für eigene Buchungen
• Bestätigungsmail über einen Event-Subscriber, Erinnerungen per Konsolenbefehl und Scheduler
• Funktionale Tests für Anmeldung, Buchung und Zugriffsschutz als Abnahme

Lernziele

• Sie legen ein Symfony-Projekt an und verfolgen eine Anfrage vom Front-Controller über Kernel und Controller bis zur Response
• Sie modellieren Daten mit Doctrine-Entities, Beziehungen und Migrationen und testen sie mit Fixtures
• Sie bauen Formulare mit Validierung und rendern Seiten mit Twig-Vererbung
• Sie strukturieren Logik in Services, konfigurieren Autowiring und nutzen Events zur Entkopplung
• Sie sichern Anwendungen mit Authenticator, Rollen und Votern ab und prüfen das mit funktionalen Tests

Zielgruppe

• PHP-Entwickler:innen, die vom eigenen Code oder einem Mikroframework auf Symfony umsteigen
• Entwickler:innen aus Laravel, Java oder .NET, die Symfony-Projekte übernehmen
• Teams, die eine bestehende Symfony-Anwendung pflegen und auf eine aktuelle Version bringen wollen