Modulare Architektur

BeamReactor basiert auf einer vollständig modularen Architektur. Jede Funktion ist in einem eigenständigen Plugin gekapselt, das an beliebiger Stelle im Code oder direkt in WYSIWYG-Editoren integriert werden kann.

Die Engine zentralisiert alle Aufrufe: Kein PHP-Skript kann ausgeführt werden, ohne sie zu durchlaufen. Dieses Design gewährleistet vollständige Kontrolle über Ein-/Ausgabeflüsse und strikte Isolation zwischen den Komponenten.

Automatisches Laden

Wenn ein Plugin aufgerufen wird, übernimmt die Engine automatisch:

Das Laden der Konfiguration (conf/plugin.conf.inc.php)
Die Bibliotheksinjektion (lib/plugin.lib.inc.php)
Die Sprachauswahl basierend auf der Benutzersprache
Die Registrierung von Routen und Handlern

Mehrere Plugins können auf derselben Seite koexistieren, ohne Konflikte zu verursachen. Jedes Plugin arbeitet in seinem eigenen Namensraum, mit eigenen CSS- und JavaScript-Ressourcen.

Datenfilterung

Alle ein- und ausgehenden Daten durchlaufen die Klasse Sanitizer\Parser. Das System validiert jeden Wert anhand strenger Typen:

Primitive Typen

Bool, Int, Float, String mit Längen- und Formatbeschränkungen.

Strukturierte Typen

E-Mail, URL, UUID, IP, Datum, JSON mit Syntaxvalidierung.

Rich Types

HTML (Tag-Whitelist), Markdown, SQL (nur vorbereitete Anweisungen).

Geschäftstypen

Dateien (MIME, Größe, Erweiterung), Bilder (Abmessungen, Format), Tokens.

Alle Datenbankinteraktionen verwenden ausschließlich vorbereitete Anweisungen. Die direkte Parameterverkettung ist durch die SQL-Abstraktionsschicht strukturell untersagt.

Rechteverwaltung

Das System implementiert eine Rechtehierarchie, die sowohl global als auch pro Plugin konfigurierbar ist:

OVERMIND → ADMIN → MODERATOR → HIGHUSER → USER

Jedes Plugin kann seine eigenen Zugriffsschwellen definieren. Ein Statistik-Plugin kann auf Administratoren beschränkt sein, während ein Forum für registrierte Benutzer offen sein kann. Die Granularität reicht bis auf einzelne Aktionen innerhalb eines einzelnen Plugins.

Die Stufen sind als Konstanten definiert (BASE_LEVEL_*, PLUGIN_LEVEL_*). Numerische Werte werden in der Geschäftslogik niemals fest kodiert.

Plugin-Struktur

/plugins/example/ ├── example.php # Hauptschnittstelle ├── /conf/ │ ├── example.conf.inc.php # Konfiguration (automatisch geladen) │ ├── example.moderation.json # Zuordnung für die Löschung oder Anonymisierung von Benutzerdaten │ └── example.sitemap.json # Zuordnung für die Suchmaschine ├── /doc/ │ ├── example.md # Technische Dokumentation │ └── example.help.json # Kontextsensitive Hilfe ├── /lib/ │ ├── thing.class.php # Klasse, die vom Plugin-Autoloader geladen wird, wenn konfiguriert (example.conf.inc.php) │ └── example.lib.inc.php # Bibliothek (automatisch geladen) ├── /locale/ │ ├── example.en.inc.php # Englische Übersetzung │ └── example.fr.inc.php # Französische Übersetzung ├── /handlers/ │ ├── example.mod.php # Haupt-AJAX-Endpunkt │ └── example_blabla.mod.php # Sekundärer AJAX-Endpunkt ├── /widget/ │ └── example.widget.php # Einfaches Widget für schnelles und kostengünstiges Frontend-Rendering und Integration. ├── /css/ │ └── example.css # Spezifische Stile ├── /js/ │ └── example.js # Spezifische Skripte ├── /sql/ │ └── example.sql # Anfangsschema └── /tests/ └── example.test.php # Unit-Tests