LoveStack-Funktionen in Exponential 6 #

LoveStack ist die Distribution von Mugo Web des ursprünglich von eZ Systems veröffentlichten Legacy-Kernels (mugoweb/ezpublish-legacy auf GitHub und Packagist). Im Lauf der Jahre hat Mugo Web ihr eine Reihe wertvoller Funktionen und Korrekturen hinzugefügt. Exponential 6.0.15 übernimmt 36 davon in die Exponential-Distribution, jede in den eigenen APIs von Exponential neu gebaut, dokumentiert und durch Tests abgedeckt, sodass jede Exponential-Website sie zusammen mit den eigenen Funktionen von Exponential verwenden kann. Mit Dank an Mugo Web, auf dessen Arbeit dies aufbaut.

Diese Seite ist der Überblick: was jede Funktion tut, für wen sie gedacht ist, wie Sie sie einschalten, ihre Einstellungen und Standardwerte, was sich bei einem Upgrade und bei einer neuen Installation ändert, der Test, der sie abdeckt, und der LoveStack-Commit, aus dem sie stammt. Die ausführlichen Seiten sind unter Weitere Dokumente aufgeführt.

In einem Satz: Auf einer vorhandenen Website ändert sich nichts, außer Sie schalten es ein; Ausnahmen sind reine Fehlerkorrekturen, einige neue Warnungen und Log-Einstellungen sowie die Sicherheitsprüfungen beim Abmelden (L03) und für hochgeladene Bilder (L05, L06).

Wenn Sie Exponential betreiben und LoveStack nie betrieben haben, ist nichts zu tun: Die Funktionen sind in 6.0.15 enthalten, und diejenigen, die das Verhalten einer Website ändern könnten, sind ausgeschaltet, bis Sie sie einschalten. Wenn Sie LoveStack betreiben, siehe Eine Website von LoveStack umziehen.

Quellenangabe (woher die Funktionen stammen, und wann) #

Die in Exponential übernommenen LoveStack-Funktionen wurden aus dem Repository mugoweb/ezpublish-legacy von Mugo Web genommen, wie es am Tag der Portierung stand, dem 12. Oktober 2026. Jede Funktion, jeder Test und jeder Vergleich in diesem Dokument bezieht sich auf genau diesen Commit, sodass die Arbeit jederzeit nachvollzogen und gegen dieselbe Quelle geprüft werden kann.

Zum Nachvollziehen: git clone https://github.com/mugoweb/ezpublish-legacy && git -C ezpublish-legacy checkout e61e9fdf0ca464197b79935ef784ed459721aa87. Die für jede Funktion (L01–L36) unten genannten Commit-IDs sind Commits in diesem Repository und öffnen sich als https://github.com/mugoweb/ezpublish-legacy/commit/<id>.

Die Funktionen in einfachen Worten #

Was die 36 Funktionen sind, gruppiert danach, was sie nach dem Upgrade mit einer vorhandenen Website tun.

Für jede Website eingeschaltet: Korrekturen und Sicherheitsprüfungen #

Für jede Website eingeschaltet: kleine sichtbare Änderungen #

Neue Optionen, ausgeschaltet, bis Sie sie einschalten #

Für neue Installationen eingeschaltet, für Upgrades ausgeschaltet #

Neue APIs für Entwickler (nur Ergänzungen, nichts Bestehendes ändert sich) #

Kurz gesagt #

Die sichtbaren neuen Funktionen sind Pflicht-Alternativtext, getrimmte Textfelder, eine Schaltfläche Kopieren, Audit-Einträge für Orte, Bedienelemente für Custom Tags im Editor, zusätzliche Header für Fehlerseiten und Includes in Einstellungsdateien. Die Sicherheitsänderungen sind ezjscnode hinter einer Richtlinie, eine Registrierung, die sich schließen lässt, ein echtes Abmelden, eindeutige Anmeldenamen und Bild-Uploads, die anhand ihres Inhalts geprüft werden. Alles andere sind kleine Fehlerkorrekturen und Hilfen für Entwickler.

Funktion für Funktion #

Jeder Eintrag sagt, für wen die Funktion gedacht ist (Redakteur, Administrator, Entwickler), was sie tut, ihre Einstellungen mit ihren ausgelieferten Standardwerten, was eine neue Installation und eine aktualisierte Website erhalten, wie Sie sie einschalten, der Test, der sie abdeckt, und der LoveStack-Commit, aus dem sie stammt. Einstellungen, die Sie ändern, gehören in ein Override (settings/override/<file>.append.php) oder einen Siteaccess, nie in die ausgelieferte Datei; leeren Sie danach den INI-Cache (php bin/php/ezcache.php --clear-tag=ini). Die Testdateien liegen unter tests/tests/ und laufen für sich: php vendor/bin/phpunit tests/tests/<path>.

Sicherheit und Sitzungen #

L01 — Knotendaten-Aufrufe können eine Richtlinie verlangen #

Für Administratoren. Die ezjscore-Aufrufe ezjscnode::load, ::subtree und ::updatepriority geben Name, IDs, Remote-ID, Besitzer, Sektion, Daten, Klasse und Übersetzungen eines Knotens als JSON oder XML an jeden Benutzer zurück, der den Knoten lesen darf, anonyme Besucher eingeschlossen. Mit RequirePolicy=enabled braucht ein Benutzer zusätzlich die Richtlinie ezjscore / call mit der Funktionsliste ezjscnode.

L02 — Die Registrierung kann eine Richtlinie verlangen #

Für Administratoren. Das Registrieren eines neuen Kontos (user/register) kann aus der Liste der Views herausgenommen werden, die jeder öffnen darf; dann braucht es die Richtlinie User / Register. Die Anmeldeseiten von admin und admin4, das Design standard und seine Anmelde-Werkzeugleiste sowie die Designs media und starter zeigen den Link zum Registrieren oder die Schaltfläche Sign Up nur einem Benutzer, der user/register öffnen darf, sodass eine Website ohne offene Registrierung keinen toten Link zeigt.

L03 — Das Abmelden beendet die Sitzung und ihr Cookie #

Für alle. Das Abmelden entfernt die Sitzung und ihren Inhalt, statt ihr eine neue ID zu geben und den Inhalt zu behalten. Jeder Session-Handler sendet das Sitzungs-Cookie abgelaufen, mit demselben Pfad, derselben Domain, Secure, HttpOnly und SameSite, mit denen es gesetzt wurde, sodass der Browser genau dieses Cookie verwirft und die alte Sitzungs-ID niemanden mehr anmeldet. Eine später in derselben Anfrage gestartete Sitzung erhält eine neue ID, unter PHP-FPM wie unter Velocity.

L04 — Ein Konto pro Anmeldename #

Für Administratoren. Ein Anmeldename gehört zu einem Konto. Ein Konsolenbefehl führt die Anmeldenamen auf, die mehr als ein Konto hat (auch solche, die sich nur in der Groß- und Kleinschreibung unterscheiden), und fügt einen eindeutigen Index auf ezuser.login hinzu, sobald es keine mehr gibt. Eine erste Version eines Benutzerkontos, deren Formular die Validierung nicht bestanden hat, wird nicht gespeichert, und ein Entwurf, ein Paketimport, die Kontozeichenkette der Content-API und eine erste Anmeldung über LDAP geben einem Konto keinen Anmeldenamen mehr, den ein anderes Konto hat; zwei Anfragen, die gleichzeitig dasselbe Konto anlegen, enden mit einem Konto.

L05 — Hochgeladene Bilder werden anhand ihres Inhalts geprüft #

Für alle. Fileinfo von PHP liest den Typ eines hochgeladenen Bildes aus seinem Inhalt, und der Typ muss auf einer Liste erlaubter Typen stehen. Eine abgelehnte Datei wird nicht gespeichert. Das gilt für den Bild-Datentyp im Bearbeitungsformular, content/upload, den Upload-Dialog des Rich-Text-Editors, den AJAX-Uploader, WebDAV und Importe; eZContentUpload lehnt eine solche Datei ab, bevor es ein Objekt anlegt.

L06 — Vorschaubilder von Paketen werden ebenso geprüft #

Für Administratoren. Der Paket-Assistent prüft das Vorschaubild eines neuen Pakets und die Bilder eines Style-Pakets mit derselben Prüfung des Inhalts und derselben Liste erlaubter Typen wie L05.

Die Sitzungseinstellung SameSite von LoveStack wird ebenfalls gelesen #

Für Administratoren von Websites, die von LoveStack kommen. site.ini [Session] SameSite=, der Name, den LoveStack für das Attribut SameSite des Sitzungs-Cookies verwendet, wird gelesen, wenn CookieSameSite von Exponential nicht gesetzt ist (CookieSameSite gewinnt, wenn beide gesetzt sind), und einmal pro Anfrage auf der Deprecation-Stufe der Debug-Ausgabe vermerkt. Für Besucher ändert sich nichts; benennen Sie die Einstellung in CookieSameSite um, damit der Hinweis verschwindet.

Diagnose und Protokollierung #

L07 — PHP-Deprecations erhalten ein eigenes Log #

Für Administratoren und Entwickler. PHP-Deprecations haben eine eigene Debug-Stufe. Sie werden nach var/log/deprecated.log geschrieben, jede eindeutige Meldung einmal pro Anfrage, und nur gezählt: Die Debug-Leiste zeigt ihre Zahl (depr), sie bleiben in der Zahl der Warnungen der Seite, und keine wird im Speicher gehalten oder mit den anderen Meldungen aufgelistet. Unter PHP 8 hält das die Debug-Ausgabe lesbar und ihren Speicherverbrauch niedrig.

L08 — Größe der Log-Dateien in site.ini #

Für Administratoren. Die Größe, bei der Log-Dateien rotiert werden, und wie viele alte Dateien behalten werden, sind Einstellungen, die eZLog und eZDebug lesen.

L09 — Eine Warnung für einen Operator-Parameter ohne Standardwert #

Für Template-Entwickler. Ein Parameter eines Template-Operators, den das Template weglässt und für den der Operator keinen Standardwert gibt, ist null, mit der Warnung Operator '<op>' has no default value for parameter '<name>', einmal pro Operator und Parameter in einer Anfrage (für ein kompiliertes Template wird einmal gewarnt, beim Kompilieren).

L10 — Bearbeitungslinks in der Liste der verwendeten Templates #

Für Template-Entwickler. Die Links „Bearbeiten“ in der Liste der verwendeten Templates der Debug-Ausgabe können auf eine Adresse Ihrer Wahl zeigen, zum Beispiel auf den Template-Editor der Administration.

L11 — Datenbankfehler tragen die Fehlernummer des Treibers #

Für Entwickler. eZDBException::getCode() ist bei jedem Treiber die Fehlernummer des Treibers für die fehlgeschlagene Anweisung, wie errorNumber(): die Nummer von MySQL, der SQLSTATE von PostgreSQL (eine Zeichenkette), der Ergebniscode von SQLite, die ORA-Nummer von Oracle; MongoDB behält den Code des Servers in errorNumber(). Die Seite „Datenbank nicht verfügbar“ (HTTP 503) erkennt außerdem die Fehlernummern, die besagen, dass die Verbindung verloren ging oder nicht hergestellt werden konnte.

L12 — Eine Warnung, wenn eine Änderung jeden View-Cache leert #

Für Administratoren. Würde eine Änderung die View-Caches von site.ini [ContentSettings] CacheThreshold oder mehr Knoten leeren und werden stattdessen alle View-Caches als abgelaufen markiert, nennt eine Warnung im Log die Zahl der Knoten und den Schwellenwert (bisher war es eine Debug-Meldung).

Inhalte, Datentypen und die Administration #

L13 — Audit-Einträge für Änderungen an Orten #

Für Administratoren. Änderungen an Orten sind Ereignisse des Audit-Protokolls von Exponential (Kanal content): content.node.add einmal pro hinzugefügtem Ort, content.node.remove mit der Angabe, ob der entfernte Ort der Hauptort war, und content.node.main, wenn ein Redakteur einen anderen Hauptort wählt oder der nächste Ort an die Stelle eines entfernten Hauptorts tritt. Die Audit-Konsole zeigt sie als Ort hinzugefügt, Ort entfernt und Hauptort geändert. Die Namen location-assign, location-remove und main-node-update von LoveStack sind diesen Ereignissen zugeordnet, sodass Aufrufe von eZAudit::writeAudit() und Audit-Dateien mit diesen Namen weiter funktionieren.

L14 — Site-Daten in Templates und in der Administration #

Für Entwickler und Administratoren. Ein Template kann eine Zeile von ezsite_data über ihren Namen lesen, für Namen, die Sie aufführen; Setup > Site-Daten (setup/sitedata, Richtlinie setup/system_info) führt die Zeilen mit Filter und Seitenaufteilung auf, in admin, admin3 und admin4.

L15 — Eine Schaltfläche Kopieren in der vollständigen Admin-Ansicht #

Für Redakteure. Die vollständige Ansicht der Administration (admin, admin3, admin4) hat eine Schaltfläche Kopieren neben Verschieben, aktiv mit Erstellrecht am Elternknoten des Elements, wie im Kontextmenü. Sie öffnet dieselben Schritte zum Kopieren wie das Kontextmenü.

L16 — Pflicht-Alternativtext für Bildfelder #

Für Redakteure und Administratoren (Barrierefreiheit). Ein Bildattribut kann einen Alternativtext verlangen. Das Bearbeitungsformular, der Upload-Dialog des Online-Editors (auch von Tiptap verwendet) und der AJAX-Uploader von Relationsfeldern lehnen dann ein Bild ohne Alternativtext ab; der AJAX-Uploader hat ein Feld für den Alternativtext für Klassen mit einem Bildattribut. Pakete tragen die Option mit.

L17 — Den gespeicherten Wert von Textzeilenfeldern trimmen #

Für Redakteure und Administratoren. Ein Textzeilenattribut kann Leerzeichen am Anfang und am Ende seines Wertes entfernen, im Bearbeitungsformular, bei der Informationssammlung, bei Importen und Uploads.

L18 — Von einer PHP-Klasse erzeugte Namen #

Für Entwickler. Ein Muster für Objektnamen oder URL-Aliase einer Klasse, das mit {MyResolver} beginnt, wird von Ihrer PHP-Klasse MyResolver aufgelöst, wenn sie aufgeführt ist und expNamePatternResolverInterface implementiert. Jeder andere Name wird protokolliert, und das Muster wird wie üblich aus seinen Token aufgelöst.

L19 — Standard des Klassenfilters für Fetches #

Für Template-Entwickler. Der Typ des Klassenfilters, den die Fetch-Funktionen list, tree, list_count, tree_count und calendar verwenden, wenn ein Fetch class_filter_array ohne class_filter_type angibt.

L20 — Das Fenster Orte lässt einen versteckten Ort versteckt #

Für Redakteure. Im Fenster Orte des Bearbeitungsformulars beginnt ein vorhandener Ort bei „Unverändert“, nicht bei „Sichtbar“, sodass das Veröffentlichen einen versteckten Ort nicht mehr sichtbar macht; ein neuer Ort beginnt so, wie er angegeben wurde (EZP-26501).

L21 — Auswahl- und Matrixfelder ohne überzählige Zeilenumbrüche #

Für Designer und Besucher. Die View-Templates der Datentypen Auswahl und Matrix schreiben kein überzähliges <br />; mehrere ausgewählte Optionen werden durch je ein <br /> getrennt.

Rich-Text-Editor #

L22 — Versteckte Custom Tags #

Für Administratoren und Redakteure. Custom Tags, die Sie aufführen, werden in den Editoren (TinyMCE 3, TinyMCE 8, Tiptap) für neue Tags nicht angeboten. Wo ein versteckter Tag bereits in einem Text steht, wird er weiterhin angezeigt, gerendert, ist bearbeitbar und wird unverändert zurückgespeichert.

L23 — Bedienelemente für Custom Tags im Rich-Text-Editor #

Für Redakteure. Ein fokussierter Custom Tag erhält eine Leiste, um ihn nach oben oder unten zu verschieben, ihn zu bearbeiten und zu entfernen (sein Inhalt bleibt), auch mit Alt+Umschalt+Pfeil hoch, Alt+Umschalt+Pfeil runter, Alt+Umschalt+E und Alt+Umschalt+Entf; die Rücktaste in einem leeren Block-Custom-Tag entfernt ihn; jeder Block-Custom-Tag zeigt seinen Namen als Beschriftung; der Dialog eines Tags zeigt images/editor/custom_tags_thumbs/<name>.png aus einem Design als Beispiel. TinyMCE 3 erhält das Plugin exp_customtag_controls (auf der Plugin-API von TinyMCE 3 und dem jQuery von ezjscore gebaut, kein YUI), TinyMCE 8 die Schaltflächen in seiner Werkzeugleiste für Custom Tags, Tiptap dasselbe in exp_oe_tiptap 0.1.2.

L24 — Der Dialog sub/sup schließt bei OK #

Für Redakteure. Der Dialog der Custom Tags sub und sup von TinyMCE 3 schließt, wenn Sie OK drücken. Das tag_custom.tpl von Exponential hatte diese Korrektur bereits, daher hat sich nichts geändert; es wurde im Browser unter TinyMCE 3 und Tiptap geprüft (TinyMCE 8 hat eigene Schaltflächen für sub und sup).

APIs und Einstellungen für Entwickler #

L25 — eZURI::build() baut eine Site-URL in einem Aufruf #

Für Entwickler. eZURI::build( string $url, bool $full = false, bool $htmlEscape = true ) liefert denselben Link wie der Template-Operator ezurl (Indexdatei und Siteaccess davor; mit $full Schema und Host). Verwenden Sie $htmlEscape = false für eine URL in einem Header oder einer JSON-Antwort.

L26 — Eine Nachricht mit einem anderen Mail-Transport #

Für Entwickler. eZMailTransport::send( eZMail $mail, ?string $transportType = null ) sendet eine Nachricht mit einem anderen Transport aus site.ini [MailSettings] TransportAlias[] (zum Beispiel file), ohne die Einstellung zu ändern; die Mail-Sperre gilt wie bisher.

L27 — Die Template-Operatoren rawurlencode und rawurldecode #

Für Template-Entwickler. Kodierung nach RFC 3986 (%20 für ein Leerzeichen) in Templates: {$value|rawurlencode}. urlencode und urldecode sind unverändert. Alle vier Operatoren liefern einen leeren Text für einen Wert, der nicht gesetzt ist.

L28 — [Include …] in Einstellungsdateien #

Für Administratoren und Entwickler. Eine Zeile [Include site.d/*.ini] in einer Einstellungsdatei liest an dieser Stelle andere Dateien: Das Muster ist relativ zur einbindenden Datei, Platzhalter sind erlaubt, die Dateien werden in der Reihenfolge ihrer Namen gelesen, Includes lassen sich verschachteln, eine Schleife wird einmal mit einer Warnung gelesen, und ein Muster ohne Treffer ergibt einen Hinweis. Die eingebundenen Dateien sind Teil des INI-Caches, sodass php bin/php/ezcache.php --clear-tag=ini und exp:velocity deploy ihre Änderungen übernehmen. Die Einstellungsseite, der klassische Einstellungseditor und exp:ini behalten die Zeile, wie sie geschrieben ist, und lösen sie nicht auf.

L29 — Antwort-Header für Fehlerseiten #

Für Administratoren. Jede HTTP-Fehlerseite kann nach ihren Statuszeilen zusätzliche Antwort-Header senden; sie werden mit der Seite im View-Cache gespeichert und von dort erneut gesendet. Ein ungültiger Header-Name oder ein Wert mit einem Zeilenumbruch wird mit einer Warnung weggelassen.

L30 — Die Reihenfolge der Suchergebnisse in den Dialogen der Redakteure #

Für Administratoren. Die Suche von ezjscore (verwendet von den Dialogen zum Einbetten und Verlinken des Editors und von der Relationssuche) sortiert Ergebnisse von eZ Find nach den Sucheinstellungen, statt immer das Neueste zuerst.

L31 — Templates können Layout-Ansichten unterscheiden #

Für Designer und Entwickler. Jede Knotenansicht setzt den Override-Schlüssel layout (leer außerhalb von layout/set, das Layout von layout/set bleibt erhalten), sodass ein Template-Override wieder darauf passen kann. Neu: eZTemplateDesignResource::setKeyValue( string $key, $value, bool $override = true ).

URLs und Suche #

L32 — Anfrageadressen werden einmal dekodiert #

Für Administratoren. Die Adresse einer Anfrage wird einmal statt zweimal dekodiert, sodass /(tag)/bar%2Bbar den View-Parameter bar+bar statt bar bar ergibt. PHP-FPM und Velocity übergeben dem Kernel dieselbe rohe Adresse, und die Schlüssel des Antwort-Caches werden daraus gebildet, daher ändern sie sich nicht.

L33 — Das doppelte Anführungszeichen in IRI-URL-Aliasen #

Für Administratoren. Die Bereinigung von URL-Aliasen in LoveStack entfernt !, Punkte und Trennzeichen am Ende eines Alias und behandelt " als reserviertes Zeichen. Exponential entfernt diese nachgestellten Zeichen seit 2016; was hinzukommt, ist das doppelte Anführungszeichen: In der IRI-Transformation (urlalias_iri) wird es zu einem Trennzeichen und wie die anderen an den Enden entfernt.

L34 — Sehr große Zahlen halten den Suchindex nicht mehr an #

Für Administratoren. Eine Zahl in einem Text jenseits des Wertebereichs der Ganzzahlspalte des eingebauten Suchindex wird als Grenzwert der Spalte gespeichert, statt die Indizierung des Objekts anzuhalten. Jeder Treiber gibt seinen Wertebereich an (MAX_INT, MIN_INT: vorzeichenbehaftet 32 Bit für MySQL, PostgreSQL und andere Treiber, vorzeichenbehaftet 64 Bit für SQLite und MongoDB), und $db->clampInteger( $value ) hält einen Wert darin, auch einen, der als Gleitkommazahl geschrieben ist.

L35 — Relationen verknüpfter Objekte bleiben aus dem Suchindex heraus #

Für Administratoren. Der Suchindex lässt die Relationsfelder verknüpfter Objekte weg, und die Relations-Datentypen brauchen keinen Schutz vor Rekursion. Exponential tut dasselbe seit 2018 (EZP-27101), daher gibt es nichts einzuschalten und keine Einstellung; eine Website, die von LoveStack kommt, erhält dieselben Suchergebnisse.

L36 — Der Cronjob hide und der Suchindex #

Für Administratoren und Entwickler. Der Cronjob hide (hide.php) teilt der Suchmaschine jeden Knoten mit, den er versteckt (in Exponential seit 2018), und das Ereignis content/cache gibt seinen Listenern von jedem Absender im Kernel ( $nodeIDs, $objectIDs ), jetzt auch von der Seite der URL-Aliase eines Knotens; ein Listener, der nur die Knoten-IDs nimmt, funktioniert weiter.

PHP-8-Prüfung und weitere Korrekturen #

LoveStack enthält etwa vierzig Korrekturen für PHP 7.2 bis 8.3. Jede genannte Stelle wurde unter PHP 8.5 und 8.1 als Regressionstest nachgestellt; die meisten waren in Exponential (das unter PHP 8.1 bis 8.5 läuft) bereits behandelt und bleiben als Tests, die das dokumentieren. Die noch fehlschlagenden sind korrigiert, für jede Installation, ohne dass bei einem Upgrade etwas zu tun ist:

• die Template-Operatoren get_class und is_class akzeptieren auch ohne Template-Kompilierung einen Wert, der kein Objekt ist (LoveStack e828c54709);
• wash(email) eines leeren Wertes, der klassische HTML-Debug-Bericht, die Debug-Leiste und ezurl / eZURI einer Zahl oder von null ergeben keine Deprecation „Passing null“ und keine Warnung (LoveStack 4065ed16b3);
• eZHTTPTool kommt mit $_POST gleich null zurecht (LoveStack 75cbb1daa2);
• das Update-Skript cleanupfieldvaluerelations.php von 5.4 überspringt leere Relationsdaten, und eZPostgreSQLDB::escapeString( null ) liefert '' (LoveStack 1bd250d4c6);
• die Bestellungen eines Kunden werden aus den Bestelllisten, dem Archiv, der Kundenliste und dem Dashboard des Shops gefunden, wenn die E-Mail-Adresse ein „+“ enthält (LoveStack 5a17c08bfc). Ein eigenes Design, das auf shop/customerorderview verlinkt, kann auf dieselbe Weise |rawurlencode an die Adresse anfügen.

Der Teil zur Rechtschreibprüfung von LoveStack cb8a3a1c58 war bereits in Exponential und wird jetzt durch einen Test abgesichert. Stelle für Stelle, mit dem Test jeder Stelle: PHP-8-Prüfung.

Eine Website von LoveStack umziehen #

Eine LoveStack-Datenbank ist der von Exponential sehr ähnlich. Zwei Konsolenbefehle erledigen die Arbeit, die für sie spezifisch ist:

./console exp:lovestack check            # read only: what the installation brings along, and what to do with it
./console exp:lovestack migrate          # dry run: prints what it would write
./console exp:lovestack migrate --apply  # records the database as Exponential's

• check führt auf: die Versionszeile lovestack der Datenbank, die Zeile db-schema-version von LoveStack, einen eindeutigen Index auf ezuser.login, eine Spalte data_text NOT NULL DEFAULT '', eine aktive Erweiterung legacy_2018, Einstellungen, die es nur in LoveStack gibt, in settings/override, die Siteaccesses und die Erweiterungen (mit dem Namen in Exponential, wo es einen gibt) und das Paket mugoweb/ezpublish-legacy in composer.json. Exit-Code 0: nichts zu tun; 1: etwas braucht Aufmerksamkeit. --json für einen maschinenlesbaren Bericht.
• migrate setzt in ezsite_data ezpublish-version von lovestack auf die Version dieses Release (6.0.15stable) und trägt die Schemaversion von LoveStack als lovestack-schema-version ein (die eigene Zeile von LoveStack bleibt). Danach gibt es die Einstellungen und Erweiterungen aus, die von Hand zu ändern sind. Es ändert nie Inhalte oder Einstellungen, ein zweiter Lauf ändert nichts, und eine Datenbank, die nicht von LoveStack stammt, wird mit einer entsprechenden Meldung abgelehnt.
• Tests: kernel/classes/expLoveStackCheckTest.php und kernel/classes/expLoveStackMigrateTest.php, auf einer Datenbank in der Form von LoveStack, gebaut aus dem Schema von Exponential und den Schemaschritten 1 bis 4 von LoveStack. Dieselben Inhaltsoperationen (Veröffentlichen, neue Versionen, Hinzufügen, Verschieben und Entfernen von Orten, Kopieren, ein neues Klassenattribut an einer Klasse mit Objekten, der Papierkorb) ergeben denselben Inhalt wie auf einer Exponential-Datenbank, sodass die Spalte data_text NOT NULL und der eindeutige Index der Anmeldenamen von LoveStack bleiben können, wie sie sind.

Der vollständige Weg, von den Backups bis zu Ihrem eigenen Code: Eine Website von LoveStack umziehen und der Abschnitt Umstieg von LoveStack der Anleitung zum Upgrade.

Bereits in Exponential #

Diese LoveStack-Funktionen waren bereits in Exponential, gleich oder auf die eigene Weise von Exponential:

Nicht übernommen, und warum #

Einige Änderungen von LoveStack passen zur eigenen Arbeitsweise von LoveStack und wurden in Exponential nicht gebraucht, oder Exponential löst dasselbe Problem bereits auf andere Weise. Nichts davon ist ein Urteil über die Arbeit; jeder Punkt hat hier einfach eine andere Antwort.

Wie getestet wurde #

Jede der oben genannten Funktionen ist in der PHPUnit-Suite von Exponential abgedeckt. Jede Testdatei läuft für sich, und abgesehen von einigen Tests, die als datenbankabhängig markiert sind (und zurückrollen, was sie schreiben), laufen sie ohne Datenbank. Die Tests, die eine Änderung braucht, lassen sich allein ausführen: siehe nur die Tests einer Änderung ausführen. kernel/classes/expShippedFeatureDefaultsTest.php prüft, dass eine aktualisierte Website die Standardwerte behält, die diese Seite nennt.

Der eigene tests/-Baum von LoveStack wurde ebenfalls mit dem von Exponential verglichen: Jeder Testfall, den Mugo Web seit dem gemeinsamen Vorfahren hinzugefügt oder geändert hat und der Verhalten abdeckt, das Exponential hat, ist in der Suite, für PHPUnit neu gebaut und gewürdigt. Die vollständige Liste steht in Tests, Funktion für Funktion und Die Tests von LoveStack in der Testsuite von Exponential.

Lizenz und Danksagungen #

• LoveStack steht unter der GNU GPL Version 2 (seine LICENSE, mit dem Urheberrecht von eZ Systems; composer.json: GPL-2.0). Exponential steht unter der GNU GPL Version 2 oder später (GPL-2.0-or-later). Die Änderungen von Mugo Web stehen unter derselben GPL Version 2 und dürfen daher mit Exponential kombiniert werden; die davon abgeleiteten Teile werden unter den Bedingungen der GPL Version 2 verbreitet.
• Jede Funktion auf dieser Seite wird als von der Arbeit von Mugo Web abgeleitet behandelt, auch dort, wo sie neu gebaut statt kopiert wurde. Jede Datei mit abgeleitetem Code behält jeden vorhandenen Urheberrechtshinweis und fügt die Zeile Portions derived from LoveStack (mugoweb/ezpublish-legacy, commit <sha>), Copyright (C) Mugo Web, GPL v2 hinzu; der LoveStack-Commit wird in der Commit-Nachricht und im Changelog von 6.0.15 genannt.
• Die Bedienelemente für Custom Tags (L23) folgen dem Entwurf des Editor-Plugins custom_tags_controls von LoveStack, "Copyright 2014, Mugo Web"; dieser Hinweis wandert mit den abgeleiteten Teilen.
• Die Formulierung der Doppellizenz in der ursprünglichen README von eZ Systems kann immer nur von eZ Systems für den Code von eZ Systems gewährt werden; sie gibt keine Rechte am Code von Mugo Web oder von Exponential.
• „LoveStack“ ist der Name, den Mugo Web für seine Distribution verwendet. Exponential verwendet ihn nur, um zu beschreiben, woher eine Funktion stammt; keine Klasse, keine Einstellung und kein Produkt in Exponential trägt ihn, abgesehen vom Befehl exp:lovestack für Websites, die von dort umziehen. Nichts hier impliziert, dass Mugo Web Exponential unterstützt.

Danke an Mugo Web für Jahre sorgfältiger Arbeit am Legacy-Kernel, dafür, ihre Schemaschritte so genau zu dokumentieren, dass eine LoveStack-Datenbank erkannt und umgezogen werden kann, und dafür, alles als Open Source zu veröffentlichen. Diese Seite gibt es wegen dieser Arbeit.

Weitere Dokumente #