forked from fa/breadcrumb-the-shire
61 lines
2.1 KiB
Markdown
61 lines
2.1 KiB
Markdown
# Einstellungen: Speicherung (DB + Cache)
|
|
|
|
Letzte Aktualisierung: 2026-03-06
|
|
|
|
## Kurzfassung
|
|
|
|
- **Source of truth ist immer die Tabelle `settings` in der Datenbank.**
|
|
- `config/settings.php` ist nur ein **Teil-Cache** für wenige, sehr häufig gelesene UI-Basiswerte.
|
|
- Nicht alle Settings müssen oder sollen im Datei-Cache stehen.
|
|
|
|
## Warum es beides gibt
|
|
|
|
Die Kombination ist bewusst so gebaut:
|
|
|
|
1. **DB als Wahrheit**
|
|
- Alle Settings werden persistiert in `settings`.
|
|
- Validierung und Schreiblogik laufen über `SettingService`.
|
|
|
|
2. **Datei-Cache für Hot-Path-Reads**
|
|
- `config/settings.php` wird durch `SettingCacheService` geschrieben.
|
|
- Verwendet wird er über `appSetting(...)` nur für globale Basiswerte wie:
|
|
- `app_title`
|
|
- `app_locale`
|
|
- `app_theme`
|
|
- `app_theme_user`
|
|
- `app_registration`
|
|
- `app_primary_color`
|
|
|
|
## Was **nicht** im Cache der Datei liegen muss
|
|
|
|
Sicherheits- oder Integrationswerte werden direkt aus DB gelesen, z. B.:
|
|
|
|
- SMTP (`smtp_host`, `smtp_port`, `smtp_user`, `smtp_from`, ...)
|
|
- Microsoft SSO Shared App Settings
|
|
- API-spezifische Policies
|
|
- User-Lifecycle-Policies (`user_inactivity_deactivate_days`, `user_inactivity_delete_days`)
|
|
- Scheduler-/Job-Konfiguration (`scheduled_jobs`, `scheduled_job_runs`)
|
|
|
|
Daher ist es korrekt, wenn diese Werte in `settings` (DB) vorhanden sind, aber nicht in `config/settings.php`.
|
|
|
|
## Laufzeitfluss
|
|
|
|
1. Admin speichert Settings in `admin/settings`.
|
|
2. `SettingGateway` (aus `SettingServicesFactory`) delegiert auf `SettingService`, der in DB schreibt.
|
|
3. `SettingCacheService` aktualisiert den Datei-Cache nur für den definierten Teilbereich.
|
|
4. UI-Helfer `appSetting(...)` liest danach aus Datei-Cache.
|
|
|
|
## Wenn DB und Datei scheinbar nicht zusammenpassen
|
|
|
|
Das ist oft erwartbar, solange es um nicht-gecachte Keys geht.
|
|
|
|
Prüfregel:
|
|
|
|
- Geht es um `appSetting(...)`-Keys? Dann Datei-Cache relevant.
|
|
- Geht es um SMTP/SSO/API-Details? Dann DB ist massgeblich.
|
|
|
|
## Betriebs-Hinweis
|
|
|
|
Direkte DB-Änderungen an gecachten `appSetting(...)`-Keys werden erst wirksam, wenn der Datei-Cache aktualisiert wurde
|
|
(z. B. durch erneutes Speichern in den Settings).
|