Plugins laufen mit allen Rechten der Plattform (siehe Vertrauen und Sicherheit). Die Grenzen unten schützen Betrieb und Daten vor Fehlern; die statischen Prüfungen der Entwicklungsumgebung setzen die Regeln durch, technisch erzwungen sind nicht alle.

Limits

Zeitgrenzen

Die harten Grenzen messen die Rechenzeit des PHP-Prozesses (Warten auf Datenbank oder Dateien zählt nicht) und fangen Endlosschleifen ab. Wird eine erreicht, endet der Worker-Prozess und startet neu; der abgebrochene Auftrag wird nicht wiederholt. Ein Job hält seinen Anspruch über einen „Herzschlag“ – er sollte zwischen den Communities shouldStop() prüfen und lange Arbeit über mehrere Läufe verteilen. Endpunkte und Seiten unterliegen den Grenzen des Webservers (PHP-FPM). Plugin-Code läuft im Hintergrund nur im eigenen Plugin-Worker, nie im Worker des Kerns. Das gilt auch für die Platzhalter der E-Mail-Serien: Schritte mit Platzhaltern eines Plugins verschickt der Plugin-Worker. Hängt ein Platzhalter, verzögern sich nur diese Mails; andere Mails, Push-Mitteilungen und Integrationen laufen weiter. Beendet ein Platzhalter den Prozess, gehen die betroffenen Mails danach mit leeren Platzhaltern dieses Plugins raus, ohne Wiederholung des Plugin-Aufrufs.

Verbotene Funktionen und Klassen

Plugins arbeiten nur über die Kern-Dienste: Datenbank über db(), Dateien über storage(), Mail über mailer(). Eigene Verbindungen, Netzwerkzugriffe, Prozesse und Schreibzugriffe aufs Dateisystem melden die PHPStan-Regeln der Entwicklungsumgebung als Fehler: Auch über Umwege wie array_map('unlink', …) sind diese Funktionen verboten. Ausgehende HTTP-Aufrufe zu fremden Diensten bietet die Schnittstelle in Version 1 nicht an; die einzige Ausnahme ist der vom Betreiber eingerichtete Zeitstempeldienst. Excel-Dateien schreibt der Kern (Response::xlsx, csv()->xlsx()), weil Plugins ZipArchive nicht nutzen dürfen.

Regeln

  • Mandanten trennen: Jede eigene Abfrage filtert nach community_id; IDs aus Requests nie ungeprüft verwenden. Für jeden Endpunkt gibt es einen Test, dass eine fremde Community nichts liefert.
  • Rechte im Handler: Access prüft nur die Rolle in der Community. Eigene Regeln („nur der Anbieter selbst“, „nur Mitglieder mit Rolle Vorstand“) prüft der Handler bzw. guard. Viewer::customRoleIds dient nur Prüfungen und wird nie ausgegeben.
  • GET ändert nichts, ebenso wenig register(), Ausgabe-Rückrufe und validate() (siehe PHP-Schnittstelle).
  • Sichtbarkeit wie im Kern: Daten von Mitgliedern nur im Umfang zeigen, den QuickTribe der betrachtenden Person zeigt – über die Methoden mit Viewer. Werte aus snapshotName() nur für den gesetzlichen Zweck verwenden.
  • Ausgaben: Texte ins Frontend nur als reinen Text; Rich-Text nur aus html()->sanitize() und nur über RichTextBody. In Twig-Vorlagen nie |raw, {% apply raw %} oder {% autoescape false %}, nie source() oder template_from_string(), und include/embed/import/extends nur auf eigene Vorlagen (@plugin_<id>/…; Ausnahme: das Mail-Layout email/_layout.html.twig unter templates/email/). Verstöße findet schon der Scan – das Plugin ist dann nicht ladbar und app:plugin:validate nennt den Grund; Vorlagen kommen nie aus Datenbank oder Einstellungen. Bausteine und Feldtypen (ab 1.2) laufen zusätzlich durch einen Sanitizer des Kerns (siehe Filter-Hooks).
  • Filter-Hooks sind lesend und schnell: keine schreibenden Kern-Dienste, keine langsamen Abfragen je Empfänger bzw. Eintrag – einmal für die ganze Liste rechnen. Bausteine auf Landingpages sind öffentlich: nur Daten ausgeben, die jede Person sehen darf.
  • Keine Geheimnisse in Protokoll, Log, Session-Daten oder Zustand – Geheimnisse gehören in secret-Einstellungen oder werden mit crypto()->encryptSecret() gespeichert.
  • E-Mails mit mandatory: true nur für Bestätigungen eigener Handlungen und rechtlich nötige Mitteilungen.
  • Idempotent: Hook-Listener, Jobs, Datenschutz-Methoden und Beispieldaten vertragen es, mehrfach oder gar nicht zu laufen.
  • Keine Styles zur Laufzeit einfügen; kein v-html (siehe Frontend-SDK).
  • Forderungen nur über debits(): Ein Plugin zieht nie selbst ein, speichert keine Bankdaten und fragt sie nicht ab – Bankverbindung, Mandat, Einzug und Mahnung gehören dem Kern. Ausgleichen darf es nur bar (settleCash()) und prüft dabei seine Rollen selbst (z. B. Theke). Es meldet jede Forderung mit einer festen Referenz, korrigiert über Storno oder Gegenforderung und gleicht seinen Stand über list() mit Cursor ab, statt sich auf Hooks zu verlassen.