Files
breadcrumb-the-shire/docs/howto-betriebscheck-doctor.md
fs 93a1d95c07 docs: add CLI command reference and update key docs to use bin/console
New docs/reference-cli-commands.md covers all commands, bootstrap helpers,
and how to add new commands. Updated lokale-entwicklung, entwickler-checkliste,
betriebscheck-doctor, index, and web/index.php error message to reference
bin/console instead of legacy bin/*.php scripts.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-19 19:25:38 +01:00

1.2 KiB

Betriebscheck mit doctor

Letzte Aktualisierung: 2026-03-19

Ziel

php bin/console doctor ist der schnelle Gesundheitscheck fuer eine Instanz.

Er prueft unter anderem:

  • ENV-Validierung (Pflichtkeys + Formate)
  • AppContainer-Bootstrap
  • Datenbankverbindung + Kern-Tabellen
  • Schreibbarkeit von APP_STORAGE_PATH
  • RBAC-Basisrechte
  • Admin-Rollen-Zuweisung
  • Scheduler-Heartbeat (Warnung, falls alt/fehlend)

Aufruf

Lokal (wenn PHP + DB direkt erreichbar sind):

php bin/console doctor

Im Docker-Setup:

docker compose exec php php bin/console doctor

Exit-Code

  • 0: keine harten Fehler
  • 1: mindestens ein FAIL-Check

WARN fuehrt nicht zu Exit 1, sollte aber geprueft werden.

Typischer Einsatz im Betrieb

  1. Direkt nach Neuinstallation / Deployment.
  2. Bei 4xx/5xx-Symptomen als erster Schritt.
  3. Nach Konfigurations- oder RBAC-Aenderungen.

Beispielausgabe

Minty Doctor Report
===================
[OK] Environment validation: all required env keys and formats are valid
[OK] Database connectivity: connection established
[WARN] Scheduler heartbeat: last heartbeat 900s ago (result=ok)

Summary: ok=7 warn=1 fail=0