fs
93a1d95c07
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>
57 lines
1.2 KiB
Markdown
57 lines
1.2 KiB
Markdown
# 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):
|
|
|
|
```bash
|
|
php bin/console doctor
|
|
```
|
|
|
|
Im Docker-Setup:
|
|
|
|
```bash
|
|
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
|
|
|
|
```text
|
|
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
|
|
```
|