Wie kann man die Fehlerausgabe im Terminal detaillierter anzeigen, wenn die Couscous-Generierung abbricht?

Melden

Couscous basiert auf der Symfony Console-Komponente. Daher stehen dir die Standard-Flags zur Verfügung, um die Detailtiefe (Verbosity) der Fehlermeldungen zu steuern.

Hier sind die Möglichkeiten, um mehr Details zu erhalten:

1. Verbosity-Flags (Der Standardweg)

Du kannst die Detailstufe erhöhen, indem du -v (verbose) bis -vvv (debug) an deinen Befehl anhängst:

  • Einfach detailliert:
    couscous generate -v
  • Sehr detailliert (zeigt mehr Interna):
    couscous generate -vv
  • Vollständiger Debug-Modus (zeigt den gesamten Stack-Trace):
    couscous generate -vvv

    Dies ist am hilfreichsten, wenn die Generierung mit einem PHP-Fehler abbricht, da du genau siehst, in welcher Datei und Zeile das Problem auftritt.

2. PHP-Fehlermeldungen erzwingen

Manchmal bricht Couscous ab, bevor das Tool selbst eine Fehlermeldung ausgeben kann (z. B. bei Speicherlimit-Problemen oder Syntaxfehlern in PHP). In diesem Fall kannst du PHP anweisen, alle Fehler direkt anzuzeigen:

php -d display_errors=1 -d error_reporting=E_ALL vendor/bin/couscous generate -vvv

(Hinweis: Ersetze vendor/bin/couscous durch den Pfad zu deiner Couscous-Installation, falls du es global installiert hast, reicht meist einfach couscous).

3. Häufige Fehlerquellen prüfen

Wenn die detaillierte Ausgabe immer noch unklar ist, liegt es oft an folgenden Punkten:

  • YAML-Syntax: Überprüfe deine couscous.yml auf Einrückungsfehler. Ein einziger falscher Tab/Space kann die Generierung stoppen.
  • Twig-Fehler: Wenn du eigene Templates nutzt, liegt der Fehler oft in einer Twig-Variable, die nicht existiert. Mit -vvv wird dir der Twig-Kompilierfehler meist angezeigt.
  • Fehlende Verzeichnisse: Stelle sicher, dass das Zielverzeichnis (meist .couscous/generated) beschreibbar ist.
  • PHP-Version: Couscous benötigt eine kompatible PHP-Version (meist 7.3 bis 8.1, je nach Version). Prüfe dies mit php -v.

Zusammenfassung

Der schnellste Weg für eine detaillierte Analyse ist: couscous generate -vvv (oder couscous preview -vvv).