Website-fabianschieder/adminer/README.md

34 lines
1.1 KiB
Markdown

# DB-Verwaltung (Mini-Admin)
Dieses Projekt enthält eine kleine, selbst implementierte DB-Verwaltung unter `/adminer`.
## Schutz / Login
Statt Browser-Basic-Auth gibt es eine eigene Login-Seite.
- User werden in der Datenbanktabelle `adminer_users` gespeichert.
- Passwörter werden gehasht (`password_hash`).
### Initialen User anlegen (Seed)
Setze in deiner lokalen `.env` (Projekt-Root) einmalig:
- `ADMINER_APP_SEED_USER=...`
- `ADMINER_APP_SEED_PASS=...`
Beim ersten Aufruf von `/adminer` wird (falls der User noch nicht existiert) automatisch ein Nutzer angelegt.
## Setup
1. Erstelle eine lokale `.env` im Projekt-Root (siehe `.env.example`).
2. Trage dort deine DB-Zugangsdaten ein (`DB_*`).
> Wichtig: `.env` wird durch `.gitignore` ignoriert.
## Nutzung
- Öffne im Browser: `/adminer`
- Schritt 1: App-Login
- Schritt 2: DB-Verbindung testen und Datenbanken laden
- Schritt 3: In gewünschte Datenbank einloggen
## Hinweise
- Das Tool ist bewusst minimal (Tabellenliste + Browse + einfache SQL-Query).
- Für produktive Nutzung bitte zusätzlich absichern (z.B. IP-Allowlist, VPN).