Zurück zur README · Erste Schritte →

Laravel Model Settings

Laravel Model Settings speichert gemeinsame Standardwerte und modellspezifische Überschreibungen in einer separaten Datenbanktabelle. Verwende das Paket, wenn jedes Modell mit demselben Wert beginnen soll, einzelne Datensätze ihn aber überschreiben dürfen.

Das Paket fügt den übergeordneten Tabellen keine Einstellungsspalten hinzu. Die Einstellungen bleiben vom Modellschema unabhängig und werden nach der Eloquent-Morph-Klasse des Modells gruppiert.

Wann das Paket passt

Anforderung	Verhalten des Pakets
Allen gespeicherten Modellen denselben Anfangswert geben	Einen Standardwert auf Klassenebene speichern
Den Wert eines Modells ändern	Eine modellspezifische Überschreibung speichern
Eine Überschreibung entfernen	Den Klassenstandard wieder verwenden
Viele Modelle lesen	Eine Relation mit Standardwerten und Überschreibungen vorab laden

Auflösungsreihenfolge

Beim Lesen einer Einstellung gibt das Paket den ersten verfügbaren Wert zurück:

1. Die Überschreibung des gespeicherten Modells.
2. Den Standardwert für die Klasse dieses Modells.
3. null.

Quelle	timezone
Standardwert für User	UTC
Überschreibung für Benutzer 123	Europe/Paris
Effektiver Wert für Benutzer 123	Europe/Paris
Effektiver Wert für einen anderen gespeicherten Benutzer	UTC

Das Entfernen einer Überschreibung macht den Standardwert wieder sichtbar. Der Standardwert selbst wird nicht gelöscht.

Kernoperationen

(new User)->defaultSettings()->set('timezone', 'UTC');

$user->settings()->set('timezone', 'Europe/Paris');

$timezone = $user->settings()->get('timezone');
$settings = $user->settings()->all();
$hasTimezone = $user->settings()->has('timezone');

$user->settings()->setMany([
    'locale' => 'fr',
    'notifications.email' => true,
]);
$user->settings()->forgetMany(['timezone', 'locale']);

get() gibt einen effektiven Wert zurück. all() gibt eine Illuminate\Support\Collection zurück, in der Standardwerte und Überschreibungen zusammengeführt sind. Verwende has(), wenn die Existenz eines effektiven Schlüssels relevant ist, auch bei einem gespeicherten JSON-null. get() akzeptiert absichtlich keinen vom Aufrufer angegebenen Ersatzwert: Der persistierte Klassenstandard ist der einzige Rückfallwert, gefolgt von null, wenn der Schlüssel in beiden Bereichen fehlt.

Für Standardwerte und Überschreibungen stehen dieselben Operationen bereit: all(), get(), has(), set(), setMany(), forget(), forgetMany() und purge().

Klare Paketgrenzen

Laravel Model Settings ist ein fokussiertes Eloquent-Paket und kein allgemeines Framework für Anwendungseinstellungen.

Grenze	Beabsichtigtes Verhalten
Speicherung	Eine Datenbanktabelle; kein Redis-Backend und keine Speicherung in Feldern des übergeordneten Modells
Standardwerte	Reservierte Zeilen in derselben Tabelle; keine zweite Standardwerttabelle
Registrierung	Keine Repository-Registry, typisierten globalen Einstellungsklassen oder Klassenerkennung
Migrationen	Kein Migrations-Runner pro Einstellungsschlüssel
Caching	Kein verpflichtender Cache über mehrere Requests; Eager Loading verwendet nur eine geladene Relation erneut

Anwendungen mit solchen Anforderungen müssen die Funktionen außerhalb dieses Pakets zusammensetzen, statt modelSettings oder das interne Repository als Erweiterungs-API zu behandeln.

Speichergrenzen

Jede Zeile wird durch vier Werte identifiziert:

Wert	Bedeutung
item_type	Morph-Klasse oder Morph-Map-Alias des übergeordneten Modells
item_id	Primärschlüssel des übergeordneten Modells; Klassenstandards behalten den physischen Wert 0
is_default	true für einen Klassenstandard, false für eine Modellüberschreibung
key	Name der Einstellung

Dadurch bleiben Standardwerte für jede Modellklasse unabhängig. Ein User-Standard wird nie zum Post-Standard, selbst wenn beide Klassen denselben Einstellungsschlüssel verwenden.

Unterstützte Modelle

Das Paket unterstützt Eloquent-Modelle mit ganzzahligen, Zeichenfolgen-, UUID- oder ULID- Primärschlüsseln. Gespeicherte Modelle mit der Ganzzahl-ID 0 oder der Zeichenfolge '0' können Überschreibungen speichern, ohne mit Klassenstandards zu kollidieren. Modelle können außerdem eine Laravel Morph Map verwenden.

Modellspezifische Einstellungen gehören zu gespeicherten Modellen. Ein ungespeichertes Modell erbt keine Standardwerte: get() gibt null, has() gibt false und all() eine leere Collection zurück. set(), setMany(), forget(), forgetMany() oder purge() für einen ungespeicherten Besitzer lösen vor einer Speicherabfrage eine InvalidSettingsOwnerException aus.

Payloads werden als JSON gespeichert, einschließlich null, leerer Zeichenfolgen, reiner Leerzeichenfolgen, leerer Arrays, 0 und false. Ohne konfigurierten Cast geben Lesevorgänge den exakt dekodierten Wert zurück. Payload-Casts können stattdessen anwendungsspezifische Objekte zurückgeben.

Siehe auch

• Erste Schritte — das Paket installieren und ein Modell konfigurieren.
• Mit Einstellungen arbeiten — Standardwerte, Überschreibungen, Schlüssel und Werte verwalten.
• API-Referenz — alle öffentlichen Methoden und Rückgabetypen prüfen.