Docker bietet eine hervorragende Möglichkeit, Anwendungen in einer konsistenten Umgebung zu betreiben. Gerade bei Symfony-Projekten kann es hilfreich sein, Debugging-Tools direkt innerhalb des Containers einzusetzen, um Konfigurationsprobleme, Datenbankverbindungen oder Cache-Probleme zu identifizieren. In diesem Artikel erfährst Du, wie Du Schritt für Schritt vorgehst.

1. Vorbereitung und Grundlagen

Docker-Container starten

Stelle sicher, dass Dein Symfony-Container läuft. Falls nicht, starte ihn mit:

sudo docker run -d --name symfony-app your-symfony-image

Nutze den korrekten Namen bzw. das richtige Image für Deine Anwendung.

Symfony im Container

Die Symfony-Befehle (Console, Cache, Debug-Tools) werden innerhalb des Containers ausgeführt. Dafür nutzen wir den sudo docker exec-Befehl, um in den laufenden Container zu wechseln.

2. Container-Logs und Systemüberblick

Logs anzeigen

Manchmal gibt der Container wichtige Hinweise in den Logs. Um die Logs anzusehen, nutze:

sudo docker logs symfony-app

Hier findest Du Informationen zu Fehlern, die beim Starten oder während des Betriebs auftreten.

Container-Status überprüfen

Um sicherzustellen, dass der Container läuft und alle Dienste (z. B. PHP, Webserver) aktiv sind, kannst Du:

sudo docker ps -a

verwenden. Mit --filter "status=created" lassen sich zusätzlich Container anzeigen, die erstellt, aber noch nicht gestartet wurden.

3. Debugging der Symfony-Konfiguration

Debuggen der Container-Parameter und Umgebungsvariablen

Symfony kompiliert Umgebungsvariablen zur Compile-Zeit in den Container. So kannst Du überprüfen, ob die Datenbankverbindung und andere Parameter korrekt übernommen wurden.

Container-Parameter anzeigen

sudo docker exec -it symfony-app bin/console debug:container --parameters | grep XXX

Beachte: Falls keine Parameter angezeigt werden, wurden die Variablen bereits zur Compile-Zeit eingebettet.

Umgebungsvariablen prüfen

Um festzustellen, welche Umgebungsvariablen für Symfony zur Verfügung stehen, kannst Du:

sudo docker exec -it symfony-app bin/console debug:container --env-vars

verwenden. Häufig werden diese Werte aber bereits in den Container integriert.

Konfiguration mit debug:config überprüfen

Um die Doctrine-Konfiguration (Datenbankverbindungen) zu überprüfen:

sudo docker exec -it symfony-app bin/console debug:config doctrine

So siehst Du, wie die Datenbank-URLs (z. B. %env(resolve:DATABASE_URL_USER_IMMO)%) in die Konfiguration übernommen wurden.

4. Verbindungstests und SQL-Abfragen

Ein direkter Test der Datenbankverbindung ist oft der sicherste Weg, um Konfigurationsfehler zu erkennen:

sudo docker exec -it symfony-app bin/console doctrine:query:sql "SELECT 1"

Wenn der Befehl eine gültige Ausgabe liefert (zum Beispiel eine Tabelle mit der Zahl „1“), dann ist die Datenbankverbindung funktionsfähig. Andernfalls erhältst Du Fehlermeldungen, die auf Konfigurations- oder Netzwerkprobleme hinweisen.

5. Cache-Probleme und deren Behebung

Symfony nutzt Caching, um die Performance zu verbessern. Bei Änderungen an der Konfiguration oder den Umgebungsvariablen kann es notwendig sein, den Cache zu leeren:

sudo docker exec -it symfony-app bin/console cache:clear

Nach dem Leeren des Caches werden die neuen Einstellungen übernommen und eventuelle Konfigurationsfehler können dadurch behoben werden.

6. Netzwerkprobleme im Container-Umfeld

Zugriff auf den Datenbankserver

Häufig tritt das Problem auf, dass der Container keinen Zugriff auf den auf dem Host laufenden Datenbankserver hat. In einem solchen Fall kann es helfen, die korrekte IP-Adresse zu nutzen.

Beispiel:
Wenn der Datenbankserver auf dem Host läuft, so könnte die Konfiguration in Deiner .env-Datei folgendermaßen aussehen:

DATABASE_URL_USER_IMMO="mysql://dbuser:uhvUIZid23e@172.17.0.1:3306/immo?serverVersion=mariadb-10.11.11"

Unter Linux ist die IP 172.17.0.1 oft die Standard-Gateway-Adresse des Docker-Bridge-Netzwerks, über die der Container auf den Host zugreifen kann. Unter Windows oder macOS kann alternativ host.docker.internal verwendet werden.

Test der Erreichbarkeit

Um zu prüfen, ob der Container den Host erreichen kann, kannst Du von innerhalb des Containers ein einfaches Tool wie ping oder nc (netcat) nutzen. Beispielsweise:

sudo docker exec -it symfony-app ping -c 3 172.17.0.1

Dies gibt Dir einen Eindruck, ob Netzwerkverbindungen grundsätzlich möglich sind.

7. Zusammenfassung und Best Practices

• Verwende Debug-Tools von Symfony:
  Die Symfony-Console bietet hilfreiche Befehle wie debug:container, debug:config und doctrine:query:sql, um Konfigurationen und Verbindungen zu überprüfen.
• Überprüfe den Cache:
  Änderungen an Konfigurationen erfordern häufig das Leeren des Symfony-Caches, um in den Containerparameter übernommen zu werden.
• Teste die Netzwerkkonnektivität:
  Nutze IP-Adressen wie 172.17.0.1 oder host.docker.internal (je nach Betriebssystem) und prüfe die Erreichbarkeit des Hosts aus dem Container.
• Logs und Fehlermeldungen beachten:
  Die Logs des Containers liefern oft wichtige Hinweise, wenn etwas nicht wie erwartet funktioniert.

Mit diesen Schritten bist Du gut gerüstet, um Symfony direkt in einem Docker-Container zu debuggen und etwaige Probleme gezielt zu beheben. Die Arbeit in einer isolierten Umgebung kann die Fehlersuche zwar zunächst komplizierter erscheinen lassen, aber mit den richtigen Tools und Befehlen findest Du schnell zur Lösung.