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

Dateibasierte Design-Domäne für Wizard, Backup und KI-Import. Mehr ...

Öffentliche Methoden

 design_root ()
 Liefert den absoluten Design-Root.
 normalize_name (string $name)
 Normalisiert einen technischen Designnamen.
 is_valid_name (string $name)
 Prüft den technischen Designnamen.
 design_dir (string $name)
 Liefert den absoluten Pfad eines validierten Designs.
 list_designs ()
 Listet alle öffentlichen Designs mit Metadaten und Vertragsstatus.
 read_metadata (string $name)
 Liest optionale Wizard-Metadaten.
 defaults (string $source='dbxapp')
 Voreinstellungen für einen komfortablen Wizard.
 create_from_wizard (array $input, array $logo_upload=array())
 Erzeugt aus einem vorhandenen kompatiblen Design ein unabhängiges Paket.
 backup_design (string $name)
 Erstellt eine wiederherstellbare ZIP-Sicherung eines Designs.
 validate_design_directory (string $dir, bool $strict=true)
 Validiert den Designvertrag und sicherheitsrelevante Dateien.
 relative_files (string $dir)
 Liefert alle Paketdateien als relative, slash-normalisierte Pfade.
 is_allowed_design_file (string $relative)
 Prüft Dateitypen, die eine KI in einem Designpaket liefern darf.
 validate_result_file (string $relative, string $absolute)
 Prüft aktive Inhalte einer von außen gelieferten Ergebnisdatei.
 apply_result (string $source, string $target, string $result_dir, string $mode)
 Kopiert ein Design als sichere Grundlage und überschreibt es mit validierten Ergebnisdateien einer KI.

Öffentliche Attribute

const CONTRACT = 'dbx.design.v1'

Ausführliche Beschreibung

Dateibasierte Design-Domäne für Wizard, Backup und KI-Import.

Designs liegen ausschließlich unter dbx/design/{name}. Die Klasse nimmt keine Datenbankzugriffe vor. Alle Schreibvorgänge werden auf einen zuvor validierten Designnamen begrenzt und neue Designs zunächst in einem Staging-Verzeichnis aufgebaut.

Dokumentation der Elementfunktionen

◆ apply_result()

dbx\dbxDesign_admin\dbxDesignService::apply_result ( string $source,
string $target,
string $result_dir,
string $mode )

Kopiert ein Design als sichere Grundlage und überschreibt es mit validierten Ergebnisdateien einer KI.

Benutzt is_valid_name() und normalize_name().

◆ backup_design()

dbx\dbxDesign_admin\dbxDesignService::backup_design ( string $name)

Erstellt eine wiederherstellbare ZIP-Sicherung eines Designs.

Benutzt $dir und design_dir().

◆ create_from_wizard()

dbx\dbxDesign_admin\dbxDesignService::create_from_wizard ( array $input,
array $logo_upload = array() )

Erzeugt aus einem vorhandenen kompatiblen Design ein unabhängiges Paket.

Parameter
array$inputNormalisierte Wizardwerte.
array$logo_uploadOptionaler Eintrag aus $_FILES.
Rückgabe
array Ergebnis mit Designname, Backup und Prüfstatus.

Benutzt design_dir(), is_valid_name() und normalize_name().

◆ defaults()

dbx\dbxDesign_admin\dbxDesignService::defaults ( string $source = 'dbxapp')

Voreinstellungen für einen komfortablen Wizard.

◆ design_dir()

dbx\dbxDesign_admin\dbxDesignService::design_dir ( string $name)

Liefert den absoluten Pfad eines validierten Designs.

Benutzt is_valid_name() und normalize_name().

Wird benutzt von backup_design(), create_from_wizard() und read_metadata().

◆ design_root()

dbx\dbxDesign_admin\dbxDesignService::design_root ( )

Liefert den absoluten Design-Root.

◆ is_allowed_design_file()

dbx\dbxDesign_admin\dbxDesignService::is_allowed_design_file ( string $relative)

Prüft Dateitypen, die eine KI in einem Designpaket liefern darf.

Wird benutzt von validate_result_file().

◆ is_valid_name()

dbx\dbxDesign_admin\dbxDesignService::is_valid_name ( string $name)

Prüft den technischen Designnamen.

Wird benutzt von apply_result(), create_from_wizard(), design_dir() und list_designs().

◆ list_designs()

dbx\dbxDesign_admin\dbxDesignService::list_designs ( )

Listet alle öffentlichen Designs mit Metadaten und Vertragsstatus.

Benutzt $dir, $out, is_valid_name() und validate_design_directory().

◆ normalize_name()

dbx\dbxDesign_admin\dbxDesignService::normalize_name ( string $name)

Normalisiert einen technischen Designnamen.

Wird benutzt von apply_result(), create_from_wizard() und design_dir().

◆ read_metadata()

dbx\dbxDesign_admin\dbxDesignService::read_metadata ( string $name)

Liest optionale Wizard-Metadaten.

Benutzt design_dir().

◆ relative_files()

dbx\dbxDesign_admin\dbxDesignService::relative_files ( string $dir)

Liefert alle Paketdateien als relative, slash-normalisierte Pfade.

Benutzt $dir.

◆ validate_design_directory()

dbx\dbxDesign_admin\dbxDesignService::validate_design_directory ( string $dir,
bool $strict = true )

Validiert den Designvertrag und sicherheitsrelevante Dateien.

Benutzt $dir.

Wird benutzt von list_designs().

◆ validate_result_file()

dbx\dbxDesign_admin\dbxDesignService::validate_result_file ( string $relative,
string $absolute )

Prüft aktive Inhalte einer von außen gelieferten Ergebnisdatei.

Design-JavaScript bleibt grundsätzlich möglich, darf aber keinen eigenen Netzwerktransport einführen. HTML darf nur lokale Script-/Stylesheet- Dateien referenzieren und keine Inline-Handler enthalten. Damit bleibt der KI-Vertrag bei Darstellung und Layout und wird nicht zu einer zweiten API- oder Tracking-Pipeline.

Rückgabe
string Leerer String bei Erfolg, sonst verständlicher Fehler.

Benutzt if und is_allowed_design_file().

Dokumentation der Datenelemente

◆ CONTRACT

const dbx\dbxDesign_admin\dbxDesignService::CONTRACT = 'dbx.design.v1'

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