Symfony Code Review: Was ein externer Reviewer in einem Symfony-Projekt prüft

#Symfony Code Review

Gründer & Lead Developer

Experte für Softwareentwicklung und Legacy-Code-Optimierung

LinkedIn

Wenn uns ein Tech Lead um ein Symfony Code Review bittet, geht es in der ersten Frage meistens um den Umfang. Was genau schaut sich ein externer Reviewer an, und worin unterscheidet sich das von dem allgemeinen Audit, über das man anderswo gelesen hat? Dieser Beitrag beantwortet das speziell für Symfony-Projekte. Er geht die Checkliste, die wir verwenden, Bereich für Bereich durch und erklärt dann, wie die Befunde bewertet werden und was am Ende im Bericht steht.

Wenn du den allgemeinen Ablauf suchst (Kennenlerngespräch, automatisierte Analyse, manuelles Review, Besprechung), findest du ihn in der Methodik hinter einem PHP-Anwendungsaudit. Die Liste unten ist ein Teil dieses Ablaufs. Es ist der Teil, der nur Sinn ergibt, wenn das Framework Symfony heißt.

Warum ein Symfony Code Review eine eigene Checkliste braucht

Viele Risiken in Symfony stecken in der Konfiguration und nicht in PHP-Klassen. Eine Firewall, die auf das falsche Pfadmuster passt, ein Service, der ohne Grund public ist, ein Messenger-Transport ohne Failure-Queue: Nichts davon fällt als hässlicher Code auf. Werkzeuge für statische Analyse lesen das PHP und ignorieren größtenteils das YAML, die Attribute und den Container, der alles zusammenhält. Ein Reviewer, der das Framework kennt, verbringt deshalb einen guten Teil der Zeit damit, config/ zu lesen, bin/console debug:*-Befehle auszuführen und zu vergleichen, was der Container tatsächlich baut und was das Team glaubt, dass er baut.

Symfony- und PHP-Versionen und der Deprecation-Rückstau

Wir beginnen mit den langweiligen Fakten, weil sie alles andere prägen. Welche Symfony-Version ist installiert, und bekommt sie noch Sicherheitsupdates? Welche PHP-Version läuft in Produktion, und stimmt sie mit der in der CI und auf den Entwicklerrechnern überein? Wir prüfen composer.lock statt composer.json, denn die Lock-Datei ist das, was tatsächlich ausgeliefert wird.

Danach schauen wir uns die Deprecations an. Die Testsuite mit aktiviertem Deprecation-Helper laufen zu lassen oder einfach das Deprecation-Log im Profiler zu lesen, zeigt, wie viel Arbeit das nächste Major-Upgrade kosten wird. Ein Projekt mit ein paar Dutzend Deprecation-Hinweisen ist in ordentlichem Zustand. Ein Projekt mit Tausenden, viele davon aus aufgegebenen Bundles, hat ein Upgrade-Problem, von dem das Team wissen sollte, bevor es das nächste Jahr plant. Unser Leitfaden zu Symfony-LTS-Versionen und Supportzeiträumen geht genauer auf die Zeitpläne ein.

Auffälligkeiten in der Service-Konfiguration

Autowiring hat die Symfony-Konfiguration deutlich kürzer gemacht, und es hat auch manche Fehler leichter übersehbar gemacht. Darauf achten wir:

  • Services, die als public markiert sind und zur Laufzeit aus dem Container geholt werden. Das bedeutet meistens, dass ein Service-Locator-Muster dort gewachsen ist, wo Dependency Injection hingehört hätte.
  • Klassen mit zehn oder mehr Konstruktorargumenten. Das ist selten ein Container-Problem. Es ist ein Designproblem, das sich dank Container bequem ignorieren lässt.
  • Parameter, die tief in Services mit getenv() oder $_ENV gelesen werden, statt über die Konfiguration injiziert zu werden.
  • Große services.yaml-Dateien, in denen die Hälfte der Definitionen nur wiederholt, was Autowiring ohnehin tun würde. Dadurch sind die Überschreibungen, auf die es ankommt, kaum noch zu erkennen.
  • Compiler Passes oder Event Subscriber, die niemand im aktuellen Team erklären kann.

Keiner dieser Punkte legt die Produktion allein lahm. Zusammen zeigen sie uns, wie schwer es für einen neuen Entwickler ist, etwas ohne Nebenwirkungen zu ändern.

Security: Firewalls, Voter, CSRF und Secrets

Hier verbringen wir die meiste Zeit, weil die Folgen am größten sind. Wir lesen security.yaml Zeile für Zeile und prüfen die Reihenfolge der Firewalls, denn die erste passende Firewall gewinnt, und ein breites Muster weit oben kann unbemerkt Routen abdecken, die für eine strengere gedacht waren. Wir gleichen die access_control-Regeln mit der tatsächlichen Routenliste aus debug:router ab und suchen nach Admin- oder API-Pfaden, die keine Regel abdeckt.

Die Autorisierungslogik bekommt einen eigenen Durchgang. Voter sind der richtige Ort für Entscheidungen wie „darf dieser Nutzer diese Rechnung bearbeiten“. Wenn wir if ($user->getRole() === 'ADMIN') quer über Controller verteilt finden, notieren wir jede Stelle, denn jede davon ist ein Ort, an dem eine künftige Änderung eine Lücke öffnen kann. Unser Artikel über die Symfony-Security-Komponente im Jahr 2026 zeigt die Muster, die wir stattdessen empfehlen.

Außerdem prüfen wir, ob Formulare den CSRF-Schutz aktiviert lassen, ob zustandslose API-Endpunkte auf andere Weise authentifizieren und ob Login-Throttling konfiguriert ist. Bei Secrets schauen wir, ob Zugangsdaten im Symfony-Secrets-Vault liegen oder in Umgebungsvariablen, die von der Deployment-Plattform verwaltet werden, und ob jemals eine .env.local, eine gedumpte Konfiguration oder ein privater Schlüssel in der Git-Historie gelandet ist. Dieser letzte Check dauert mit dem richtigen Tool ein paar Minuten und findet öfter etwas, als Teams erwarten.

Doctrine: N+1-Queries, Migrationsstand und Raw SQL

Doctrine-Probleme sind meist Performance-Probleme, die unter Last zu Verfügbarkeitsproblemen werden. Wir öffnen den Profiler auf den schwersten Seiten und zählen die Queries. Eine Listenansicht, die pro Zeile eine Query ausführt, ist das klassische N+1-Muster, und die Lösung (ein Join mit explizitem Select oder eine eigene Lese-Query) ist meistens klein, sobald jemand das Problem gefunden hat.

Wir vergleichen das Mapping mit der echten Datenbank, indem wir doctrine:schema:validate ausführen und prüfen, ob doctrine:migrations:diff eine leere Migration erzeugt. Wenn nicht, hat sich das Schema in Produktion vom Code entfernt, und jede künftige Migration trägt ein gewisses Risiko. Außerdem lesen wir die bestehenden Migrationen auf destruktive Änderungen ohne Rollback-Plan.

Raw SQL ist in Ordnung, wenn es parametrisiert ist und einen Grund dafür gibt. Wir suchen nach String-Verkettung in executeQuery, createNativeQuery und nach DQL, das aus Request-Daten gebaut wird, denn genau dort taucht Injection auch in ansonsten modernen Codebases noch auf.

Messenger und Hintergrundverarbeitung

Wenn das Projekt Symfony Messenger nutzt, prüfen wir, welche Transports konfiguriert sind und ob es einen Failure-Transport gibt. Ohne ihn verschwindet eine Nachricht, die zu oft eine Exception wirft, einfach. Wir schauen uns die Retry-Strategien an, ob Handler idempotent sind (kann dieselbe Nachricht zweimal laufen, ohne einem Kunden doppelt etwas zu berechnen?) und wie Worker in Produktion überwacht werden. Worker, die nie neu starten, verlieren langsam Speicher. Deshalb prüfen wir, ob --memory-limit oder --time-limit gesetzt sind und ob ein Prozessmanager sie wieder hochfährt.

Tests und CI

Eine Coverage-Zahl allein sagt wenig. Deshalb schauen wir, was die Tests schützen. Sind die Geldpfade abgedeckt, also Checkout, Rechnungsstellung, Berechtigungen und Importe? Treffen die funktionalen Tests die echte Security-Konfiguration, oder loggen sie einen Nutzer so ein, dass die Firewall umgangen wird? Läuft die Suite in der CI bei jedem Pull Request, und blockiert ein fehlschlagender Test den Merge tatsächlich?

Wir schauen auch, was die CI sonst noch ausführt. PHPStan oder Psalm auf einem sinnvollen Level, ein Coding-Standard-Check und composer audit für Pakete mit bekannten Schwachstellen sind günstig und finden überraschend viel. Eine Pipeline, die nur phpunit ausführt, überlässt diese Befunde dem Reviewer, der sie dann von Hand machen muss.

Logging, Monitoring und Deployment

Die Monolog-Konfiguration zeigt uns, wie das Team von Problemen erfährt. Wir prüfen, ob Produktionslogs an einem durchsuchbaren Ort landen, ob die Log-Level sinnvoll sind und ob personenbezogene Daten wie E-Mail-Adressen, Tokens oder vollständige Request-Bodies im Klartext in die Logs geschrieben werden. Error-Tracking (Sentry oder ein vergleichbares Tool) und grundlegende Health Checks sollten vorhanden sein.

Beim Deployment schauen wir, wie die Anwendung in die Produktion kommt. Ist der Build reproduzierbar? Läuft composer install --no-dev mit optimiertem Autoloader, und wird der Cache vor dem Umschalten aufgewärmt? Werden Migrationen als kontrollierter Schritt ausgeführt? Ist APP_ENV=prod mit deaktiviertem Debug gesetzt, und ist der Profiler aus dem Internet nicht erreichbar? Offen erreichbare Profiler finden wir immer noch öfter, als uns lieb ist.

Wie Befunde bewertet werden

Jeder Befund bekommt einen Schweregrad und eine Aufwandsschätzung. Wir verwenden vier Schweregrade. Kritisch bedeutet: jetzt ausnutzbar oder wahrscheinlich mit Datenverlust verbunden, sollte diese Woche behoben werden. Hoch bedeutet ein echtes Risiko, das in den nächsten ein, zwei Sprints eingeplant werden sollte. Mittel umfasst Wartbarkeits- und Performance-Themen, die mit der Zeit Geld kosten. Niedrig sammelt Stil- und Hygienepunkte, die sich lohnen, wenn ohnehin jemand den Code anfasst.

Die Aufwandsschätzung ist genauso wichtig wie der Schweregrad. Ein kritischer Befund, der in einer Stunde behoben ist, und ein mittlerer, der drei Wochen dauert, brauchen ganz unterschiedliche Gespräche mit dem Product Owner. Wenn beide Zahlen nebeneinanderstehen, kann das Team die Liste ohne weiteres Meeting in „jetzt erledigen“, „einplanen“ und „vorerst akzeptieren“ sortieren.

Wie der Bericht aussieht

Der Bericht beginnt mit einer kurzen Zusammenfassung für jemanden, der den Rest nicht lesen wird: Gesamtzustand, die paar Befunde, die am meisten zählen, und eine grobe Schätzung des Aufwands. Danach folgt die vollständige Liste, gruppiert nach den Bereichen oben, mit Datei und Zeile, einer Beschreibung des Problems, warum es wichtig ist, und einem konkreten Vorschlag zur Behebung. Wo es hilft, zeigen wir ein Code-Snippet mit der korrigierten Version.

Zum Abschluss gibt es einen Besprechungstermin, in dem das Team Befunde hinterfragen kann. Manchmal gibt es Kontext, den wir nicht hatten, und ein Befund wird herabgestuft. Für dieses Gespräch planen wir von Anfang an Zeit ein. Wenn du dich fragst, mit welchem Budget du rechnen solltest, findest du in unserem Beitrag dazu, was ein PHP-Code-Audit in Deutschland kostet, realistische Spannen nach Projektgröße.

Ein Symfony Code Review von Wolf-Tech

Wir reviewen Symfony-Projekte für Teams, die eine Außensicht wollen: vor einem Upgrade, vor einer Finanzierungsrunde, bei einer Übergabe zwischen Agenturen oder einfach, weil die Codebase schneller gewachsen ist als das Verständnis aller Beteiligten. Das Review ist Teil unserer Code-Quality-Beratung, und wenn die Befunde auf tiefere strukturelle Arbeit hinweisen, helfen wir dabei mit Legacy-Code-Optimierung.

Wenn wir uns dein Projekt anschauen sollen, schreib an hello@wolf-tech.io oder schau auf wolf-tech.io vorbei. Eine kurze Beschreibung deiner Symfony-Version, der Teamgröße und des Anlasses für deine Anfrage reicht für den Start.