---
title: "Grenzen und Regeln"
description: "Limits, Zeitgrenzen, verbotene Funktionen und Klassen sowie die Regeln, an die sich jedes Plugin hält"
---

Plugins laufen mit allen Rechten der Plattform (siehe [Vertrauen und Sicherheit](/plugins/ueberblick#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

| Bereich | Grenze |
| --- | --- |
| JSON-Body eines Endpunkts | Standard 1 MiB, einstellbar bis 10 MiB (`ApiOptions::maxJsonBytes`) |
| Uploads | je Datei bis 20 MB, höchstens 5 Dateien je Request; jede Datei zählt im Upload-Limit der Plattform (60 je Stunde und Person) |
| Aufrufe der Schnittstelle | allgemeines Limit der Plattform je Person, dazu optional ein eigenes je Route (`RateLimit`, bis 100 000 je Intervall, Intervall bis 7 Tage) |
| Benachrichtigungen | 60 je Stunde, Empfänger und Plugin |
| E-Mails | je Stunde, Plugin und Community so viele, wie der Plattform-Admin einstellt (Standard 300, 1–1000), `send()` und `sendToAddress()` (ab 1.8) zusammen; Anhänge zusammen bis 10 MB; `sendToAddress()` nur an Adressen bis 180 Zeichen, Name bis 100 Zeichen; abgemeldete Adressen zählen nicht |
| Einladungen per E-Mail | eigenes Kontingent je Stunde, Plugin und Community (Standard 50, 1–1000, Plattform-Admin); höchstens 3 je Adresse und Tag |
| PDF | 30 je 10 Minuten und Person; synchron nur kleinere Dokumente (Richtwert 50 Seiten) |
| Zeitstempel | 30 je Stunde und Community |
| Session-Daten | 4 KB JSON |
| Zustand (`state()`) | Schlüssel bis 100 Zeichen, Wert bis 64 KB JSON |
| Aufgaben | Payload bis 64 KB JSON, Verzögerung bis 7 Tage |
| Speicher | Pfade bis 8 Segmente und 255 Zeichen; `read()` bis 20 MB, größere Dateien über `stream()` |
| ZIP-Archive (ab 1.8) | `putZip()` bis 50 000 Einträge und 2 GiB unkomprimiert; Namen bis 8 Ebenen und 255 Zeichen, eindeutig ohne Groß-/Kleinschreibung |
| CSV lesen | bis 500 Spalten, 1 MiB je Zeile, 20 MB je Datei, bis 100 000 Zeilen |
| Excel schreiben | 1–20 Blätter, je Blatt bis 200 Spalten und 100 000 Zeilen; längere Zellen als 32 767 Zeichen werden gekürzt |
| Protokoll | Aktion samt Präfix bis 64 Zeichen, Payload bis 8 KB |
| Personendaten (ab 1.4) | `loginEmails()` und `missingProfileData()` bis 500 Mitgliedschaften je Aufruf; `loginEmails()` schreibt `plugin.<id>.email_viewed` höchstens einmal je Betrachter, Mitgliedschaft und Tag ins Protokoll; `correctPersonalData()` bis 10 Korrekturen je Stunde, Akteur und Person (wie im Kern), Begründung bis 500 Zeichen |
| Dienste (ab 1.6) | `duties()->standings()` höchstens 500 Mitgliedschaften je Aufruf; `book()`/`release()` nur in schreibenden Rahmen und im Request nur für die angemeldete Person als Viewer |
| Momentaufnahme (ab 1.5) | `accountSnapshot()` nur während `deleteUserData()` für genau die gelöschte Person; die Momentaufnahme liegt verschlüsselt an der Löschaufgabe des Plugins und verschwindet mit ihr (nach einem Wechsel von `APP_SECRET` läuft die Löschung ohne sie) |
| Gruppen-Chats | bis 50 Teilnehmer, Titel bis 80 Zeichen |
| Forderungen (`debits()`) | `submitMany()`, `byReferences()`, `mandates()`, `standings()` bis 500 Einträge je Aufruf (`Debits::MAX_BATCH`), `list()` bis 500 je Seite; Betrag je Forderung ungleich 0 und bis 1 Mio. €, nur EUR; Text bis 140 Zeichen, Kategorie bis 60, `subjectLabel` bis 100, `detailPath` bis 500 (Pfad dieser Community); Referenz 1–100 Zeichen aus `A–Z a–z 0–9 . _ : / -`; Storno-Grund 1–200 Zeichen; Hooks `claim.*` mit höchstens 200 Forderungen je Teil |
| Eingaben in Editoren (`extra` an Event, Beitrag, Kurs, Lektion) | bis 20 Plugins, je Plugin 64 KB JSON, Verschachtelung bis Tiefe 5 |
| Rangliste (`leaderboard.ranking`, ab 1.2) | bis 1000 Einträge je Liste in `RankingChange`, Delta je Mitgliedschaft bis ±1 000 000 |
| Platzhalter (ab 1.2) | bis 20 je Plugin, Schlüssel `^[a-z][a-z0-9_]{0,30}$`, Wert bis 500 Zeichen reiner Text |
| Bausteine und Feldtypen (ab 1.2) | je bis 20 je Plugin; ein Baustein bis 20 Felder; eine Antwort eines Feldtyps bis 2000 Zeichen nach der Prüfung |
| Mitglieder, Termine | `members()->list()` bis 200 je Seite, `search()` bis 50 Treffer; `events()->occurrences()` für höchstens 366 Tage |
| Cache | Lebensdauer 1 Sekunde bis 30 Tage |
| Datenexport | Dateien über 20 MB stehen nur als Hinweis in der Liste großer Dateien |
| Oberfläche | Einstieg `dist/plugin.js` bis 15 KB (gzip) |

## Zeitgrenzen

| Was | Warnung im Log | Harte Grenze im Worker bzw. auf der Konsole (Rechenzeit) |
| --- | --- | --- |
| Konstruktor und `register()` | – | 60 s |
| Hook-Listener | ab 2 s | 120 s |
| `ResponseExtension::load()` und andere Ausgabe-Rückrufe | ab 200 ms | – im Request; 120 s im Worker bzw. auf der Konsole (ab 1.2) |
| Filter `leaderboard.ranking`, `landing_page.blocks`, `form.field_types` (ab 1.2) | ab 200 ms je Aufruf | – (läuft im Request) |
| Filter `sequence.placeholders` (ab 1.2) | ab 500 ms je Aufruf | 120 s (läuft im Plugin-Worker) |
| Job | ab 60 s; `shouldStop()` wird nach 4 Minuten wahr | 540 s |
| Aufgabe | – | 600 s |
| Lebenszyklus (`Lifecycle`) | – | 120 s |
| Datenschutz (Export, Löschung) | – | 600 s |
| Beispieldaten (`DemoAware`) | – | 600 s |

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](/plugins/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:

| Verboten | Beispiele |
| --- | --- |
| Prozesse | `exec`, `shell_exec`, `system`, `passthru`, `proc_open`, `popen`, Backticks, `pcntl_*`, `dl` |
| Netzwerk | `curl_*`, `fsockopen`, `stream_socket_client`, `stream_socket_server`, `get_headers`, `socket_*`, `ftp_*`, `ssh2_*`; Lesefunktionen wie `file_get_contents`, `fopen`, `file`, `readfile`, `getimagesize` mit einem Schema wie `https://` |
| Dateien schreiben | `file_put_contents`, `unlink`, `rename`, `copy`, `mkdir`, `rmdir`, `touch`, `symlink`, `link`, `chmod`, `chown`, `tempnam`, `move_uploaded_file`; `fopen` und `SplFileObject` nur mit festem Lesemodus (`php://memory` und `php://temp` sind frei) |
| Mail und Laufzeit | `mail`, `mb_send_mail`, `putenv`, `ini_set`, `ini_alter`, `ini_restore`, `set_include_path` |
| Klassen | `PDO`, `mysqli`, `SQLite3`, `Redis`, `Memcached`, `SoapClient`, `SoapServer`, `ZipArchive`, `Phar`, `CURLFile` |
| Symfony | HttpClient, Process, Filesystem, HttpFoundation, HttpKernel |
| Andere Plugins und der Kern | Klassen anderer Plugins (`QuickTribePlugin\…`) und alles aus `App\` außer `App\Plugin\Api` |

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](/plugins/kern-dienste#zeitstempel). 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](/plugins/php-api#endpunkte)).
- **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](/plugins/erweiterungspunkte#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](/plugins/frontend#stile-mit-tailwind)).
- **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.
