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 überdb(), 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:
Accessprü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::customRoleIdsdient nur Prüfungen und wird nie ausgegeben. - GET ändert nichts, ebenso wenig
register(), Ausgabe-Rückrufe undvalidate()(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 aussnapshotName()nur für den gesetzlichen Zweck verwenden. - Ausgaben: Texte ins Frontend nur als reinen Text; Rich-Text nur aus
html()->sanitize()und nur überRichTextBody. In Twig-Vorlagen nie|raw,{% apply raw %}oder{% autoescape false %}, niesource()odertemplate_from_string(), undinclude/embed/import/extendsnur auf eigene Vorlagen (@plugin_<id>/…; Ausnahme: das Mail-Layoutemail/_layout.html.twiguntertemplates/email/). Verstöße findet schon der Scan – das Plugin ist dann nicht ladbar undapp:plugin:validatenennt 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 mitcrypto()->encryptSecret()gespeichert. - E-Mails mit
mandatory: truenur 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 überlist()mit Cursor ab, statt sich auf Hooks zu verlassen.