dbxapp 4.5.3
Technische API-Referenz der dbxapp-Plattform
Lade ...
Suche ...
Keine Treffer
dbx\dbxSetup\dbxInstallationService Klassenreferenz

Reproduzierbare Erstinstallation aus DDs und idempotenten Seeds. Mehr ...

Öffentliche Methoden

 __construct (?object $db=null, ?object $dd=null)
 discover_dds (array $modules=array())
 Liefert alle installierbaren DDs, optional begrenzt auf Module.
 bind_all_to_server (string $server, array $modules=array())
 Bindet alle gefundenen DDs auf einen konfigurierten Server.
 provision_schema (array $modules=array())
 Erstellt beziehungsweise ergänzt die DD-Struktur ohne Force-Rebuild.
 verify_bundled_schema (array $modules=array())
 Prüft die mitgelieferten DB3-Tabellen ausschließlich lesend.
 transfer_declared_data_to_server (string $target_server, array $modules=array())
 Überträgt vorhandene Daten aus den in den DDs deklarierten Quellspeichern auf einen neu konfigurierten SQL-Server.
 seed_core_groups ()
 Legt die verbindlichen Core-Gruppen an, ohne bestehende Werte zu überschreiben.
 inspect_initial_admin ()
 Liefert den Zustand des initialen Administrators ohne Datenänderung.
 ensure_initial_admin (bool $create_if_missing, string $language, string $password, bool $password_reset_required=false)
 Stellt bei der Installation den persönlichen Administratorzugang bereit.
 create_admin (string $password, string $email, string $language='de')
 Erstellt den Admin nur bei einer echten Erstinstallation.

Ausführliche Beschreibung

Reproduzierbare Erstinstallation aus DDs und idempotenten Seeds.

DDs definieren die Struktur, lokale DD-Serverbindungen den physischen Speicher und diese Klasse ausschließlich die notwendigen Ausgangsdaten. Es werden keine SQL-Dumps und keine ausgelieferten Produktiv-DB3 benutzt.

Beschreibung der Konstruktoren und Destruktoren

◆ __construct()

dbx\dbxSetup\dbxInstallationService::__construct ( ?object $db = null,
?object $dd = null )

Dokumentation der Elementfunktionen

◆ bind_all_to_server()

dbx\dbxSetup\dbxInstallationService::bind_all_to_server ( string $server,
array $modules = array() )

Bindet alle gefundenen DDs auf einen konfigurierten Server.

Die Methode schreibt nur den lokalen, releasegeschützten Binding-Teil. Einzelne Bindungen können danach weiter unabhängig angepasst werden.

Benutzt discover_dds().

◆ create_admin()

dbx\dbxSetup\dbxInstallationService::create_admin ( string $password,
string $email,
string $language = 'de' )

Erstellt den Admin nur bei einer echten Erstinstallation.

Ein vorhandener Admin wird weder verändert noch mit einem neuen Passwort versehen.

◆ discover_dds()

dbx\dbxSetup\dbxInstallationService::discover_dds ( array $modules = array())

Liefert alle installierbaren DDs, optional begrenzt auf Module.

Rückgabe
array<int,array{ module:string, name:string, dd:string, file:string, declared_server:string, table:string }>

Benutzt $root.

Wird benutzt von bind_all_to_server(), provision_schema() und verify_bundled_schema().

◆ ensure_initial_admin()

dbx\dbxSetup\dbxInstallationService::ensure_initial_admin ( bool $create_if_missing,
string $language,
string $password,
bool $password_reset_required = false )

Stellt bei der Installation den persönlichen Administratorzugang bereit.

Ein vorhandener Administrator bleibt als Datensatz erhalten. Passwort, Admin-Rolle und Aktivstatus werden anhand der Installationsangaben aktualisiert. Der optionale Reset-Schalter bleibt für spätere administrative Passwortwechsel verfügbar.

Benutzt if.

◆ inspect_initial_admin()

dbx\dbxSetup\dbxInstallationService::inspect_initial_admin ( )

Liefert den Zustand des initialen Administrators ohne Datenänderung.

Rückgabe
array{ exists:bool,id:int,email:string,default_password:bool, password_reset_required:bool,created:bool,reset:bool }

◆ provision_schema()

dbx\dbxSetup\dbxInstallationService::provision_schema ( array $modules = array())

Erstellt beziehungsweise ergänzt die DD-Struktur ohne Force-Rebuild.

Rückgabe
array{ok:bool,total:int,finished:int,results:array,errors:array}

Benutzt discover_dds().

◆ seed_core_groups()

dbx\dbxSetup\dbxInstallationService::seed_core_groups ( )

Legt die verbindlichen Core-Gruppen an, ohne bestehende Werte zu überschreiben.

Benutzt $id und $result.

◆ transfer_declared_data_to_server()

dbx\dbxSetup\dbxInstallationService::transfer_declared_data_to_server ( string $target_server,
array $modules = array() )

Überträgt vorhandene Daten aus den in den DDs deklarierten Quellspeichern auf einen neu konfigurierten SQL-Server.

Der Aufruf ist bewusst separat von provisionSchema(): Eine frische Installation erzeugt nur Strukturen und Seeds. Erst die ausdrückliche Auswahl im Installer darf vorhandene lokale Tabellen in das neue Ziel kopieren und dort ersetzen.

Rückgabe
array{ok:bool,total:int,transferred:int,skipped:int,results:array,errors:array}

◆ verify_bundled_schema()

dbx\dbxSetup\dbxInstallationService::verify_bundled_schema ( array $modules = array())

Prüft die mitgelieferten DB3-Tabellen ausschließlich lesend.

Der Standard-Installer darf die ausgelieferten Datenbanken weder synchronisieren noch neu anlegen. Fehlende Tabellen werden deshalb gemeldet, statt den Lieferzustand stillschweigend zu verändern.

Rückgabe
array{ok:bool,total:int,verified:int,results:array,errors:array}

Benutzt $table und discover_dds().


Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei: