Zehn Stolperfallen für Framework-Entwickler #

Diese Seite richtet sich an Entwickler in ihren ersten Wochen mit Exponential. Jede Stolperfalle stammt aus einer Gewohnheit, die in einem anderen Framework richtig und hier falsch ist.

Inhalt #

1. Ausgabe ohne wash
2. Eine neue Klasse wird „nicht gefunden“
3. Eine Einstellung wirkt nicht
4. Eine Template-Änderung wird nicht angezeigt
5. Zustand sickert zwischen Requests durch
6. SQL in Inhaltstabellen schreiben
7. Eine Tabelle für etwas, das Inhalt sein sollte
8. Berechtigungen nur in Templates prüfen
9. Den Siteaccess auf der Kommandozeile vergessen
10. Vergleiche mit Symbolen

1. Ausgabe ohne wash #

Symptom: Text mit < oder & zerstört die Seite, oder ein Skript wird ausgeführt. Ursache: Templates maskieren nicht automatisch. Lösung: {$value|wash} auf alles, was von Benutzern oder aus der Datenbank kommt (Die View-Schicht).

2. Eine neue Klasse wird „nicht gefunden“ #

Ursache: Klassen werden über erzeugte Class Maps gefunden, für Erweiterungsklassen nicht über PSR-4. Lösung: php bin/php/ezpgenerateautoloads.php -e, dann deployen; --kernel für Kernel-Klassen (Autoloads und Klassenbenennung).

3. Eine Einstellung wirkt nicht #

Ursachen: der INI-Cache; oder der Wert wird von einer späteren Ebene überschrieben, zum Beispiel gewinnen die globalen Einstellungen einer Erweiterung gegenüber settings/siteaccess/. Lösung: ./console exp:ini where <file>/<block>/<key> <siteaccess>, dann php bin/php/ezcache.php --clear-tag=ini (Konfiguration).

4. Eine Template-Änderung wird nicht angezeigt #

Ursachen: der View-Cache, ein Cache-Block oder der Override-Cache bei einer neuen Template-Datei. Lösung: Leeren Sie template-override nach dem Hinzufügen einer Template-Datei, leeren Sie content und template-block, wenn zwischengespeicherte Ausgaben veraltet sind; exp:velocity deploy erledigt all das in der richtigen Reihenfolge (Caching).

5. Zustand sickert zwischen Requests durch #

Symptom: Ein Benutzer sieht die Daten eines anderen Benutzers, oder ein Listener läuft zweimal, nur unter Velocity. Ursache: Persistente Worker behalten statische Eigenschaften und angehängte Listener. Lösung: kein Request-bezogener Zustand in statischen Eigenschaften; registrieren Sie Listener in den Einstellungen (Server und Deployment).

6. SQL in Inhaltstabellen schreiben #

Symptom: Eine Änderung erscheint nicht, oder sie erscheint ohne Versionsgeschichte, Suche oder Cache-Aktualisierung. Ursache: Die Inhaltstabellen sind nicht Ihre Tabellen. Lösung: eZContentFunctions oder die Operationen, die Workflows ausführen und Caches leeren (Das Inhaltsmodell).

7. Eine Tabelle für etwas, das Inhalt sein sollte #

Symptom: Sie bauen eine Administrationsseite, eine Revisionstabelle und eine Übersetzungstabelle. Lösung: Machen Sie daraus eine Inhaltsklasse und erhalten Sie alle drei geschenkt (ORM).

8. Berechtigungen nur in Templates prüfen #

Ursache: Einen Link auszublenden ist keine Zugriffskontrolle. Lösung: Nennen Sie die Funktion in functions der View, prüfen Sie den Objektzugriff in der View, filtern Sie Listen in der Abfrage (Autorisierung).

9. Den Siteaccess auf der Kommandozeile vergessen #

Symptom: Ein Befehl oder Cronjob-Teil findet Ihr Modul, Ihre Einstellung oder Ihren Jobtyp nicht. Ursache: Ihre Erweiterung ist nur in einem Siteaccess aktiv. Lösung: -s <siteaccess> (Kommandozeile).

10. Vergleiche mit Symbolen #

Symptom: Ein {if} verhält sich willkürlich, und das Log zeigt einen Parser-Fehler. Ursache: Die Template-Sprache hat keine Infix-Operatoren. Lösung: gt, lt, eq, ne, and, or (Kein Infix-Vergleich).

Verwandte Seiten #

• Checklisten für Framework-Entwickler
• Häufige Fehler in Templates
• Wenn etwas schiefgeht
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.