Exponential 6.0 installieren und betreiben: das Handbuch
Dieses Handbuch führt Sie von einem leeren Server zu einer Exponential-6.0-Site im Produktivbetrieb. Es behandelt die Prüfung der Voraussetzungen, die Beschaffung des Codes, die Wahl und Ausführung eines Installers, die Auslieferung der Site, die Wahl einer Datenbank und den gesunden Betrieb der Site danach, bis hin zu Upgrades, Fehlerbehebung und Absicherung. Jedes Kapitel steht für sich und endet mit Verweisen auf die ergänzende Dokumentation in diesem Repository und auf die offiziellen Quellen außerhalb davon.
Warnung
.htaccessbremst jede Anfrage. Sind.htaccess-Dateien erlaubt (AllowOverridealles außerNone), geschweige denn genutzt, sucht Apache sie bei jeder Anfrage in jedem Verzeichnis des Pfads und liest und wertet sie aus, und die Ladezeiten der Seiten steigen drastisch (gemessen). Die einzige wirkliche Abhilfe ist, die Funktion für den virtuellen Host abzuschalten:AllowOverride Noneim virtuellen HTTPS-Host, und die Regeln in der Konfiguration des virtuellen Hosts selbst als mod_rewrite-Regeln. Das ist in Geschwindigkeitstests im Produktivbetrieb weit schneller und die Zeit für die Optimierung einer Produktivkonfiguration unbedingt wert. Stellen Sie sofort um: Übernehmen Sie die Regeln des Beispiels für einen virtuellen HTTPS-Host in Ihren virtuellen Host (mit dem statischen Cache auchstaticcache_offload.conf), setzen SieAllowOverride None, führen Sieapachectl configtestaus, laden Sie Apache neu und testen Sie die Website. Dieselben Regeln für andere Server: nginx, LiteSpeed, Caddy, IIS, Velocity (eingebaut); wohin Regeln für virtuelle Hosts in einem Control Panel gehören: Plesk, cPanel, DirectAdmin, ISPConfig. Unter LiteSpeed oder OpenLiteSpeed kann zusätzlich der Seiten-Cache des Servers anonyme Besucher und Crawler ohne PHP bedienen: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.
Wenig Zeit? Die Kurzanleitung zur Installation enthält den Schnellstart und verweist zurück auf die Kapitel hier.
Inhalt
Teil I: Vor der Installation
| Kapitel | Inhalt |
|---|---|
| 1. Einführung: Was Sie installieren | Der Kernel, Extensions, Siteaccesses (site, admin, editor) und Designs; die drei Installationsmethoden; Konventionen und Glossar |
| 2. Voraussetzungen | PHP 8.0 bis 8.5 (PHP 7.4 ohne Support nutzbar), jede PHP-Erweiterung und wozu sie dient, die php.ini-Einstellungen, die das Setup prüft, Datenbanken, Composer, Webserver, Betriebssysteme, Dimensionierung; die Übersichten Datenbankunterstützung und Unterstützte Betriebssysteme |
| 3. Den Code beschaffen | Versionen und Tags, Git-Klone mit Historie (empfohlen), composer create-project, Installation unter PHP 8.0 bis 8.3, das Velocity-Paket, Extensions als Pakete, ein Rundgang durch das Installationsverzeichnis |
Teil II: Installieren
| Kapitel | Inhalt |
|---|---|
| 4. Eine Installationsmethode wählen | Ein Installer mit drei Oberflächen, Site-Pakete, was eine Installation schreibt, unbeaufsichtigte Installationen in CI und Containern |
| 5. Der Setup-Assistent | Der Browser-Installer Seite für Seite: jedes Feld, seine Prüfungen und was es schreibt; einen abgebrochenen Assistenten neu starten |
| 6. Der Kickstarter | Unbeaufsichtigte Installationen aus kickstart.ini: Befehle, die vollständige Referenz der Einstellungen, DatabaseAction, kommentierte Beispiele, Probeläufe, erneute Ausführung |
7. Die Installation über die Konsole: exp:install | Ein Befehl mit Optionen statt einer Einstellungsdatei: jede Option, Probelauf, Exit-Status, Beispiele je Datenbank |
Teil III: Die Site betreiben
| Kapitel | Inhalt |
|---|---|
| 8. Die Site ausliefern | Exponential Velocity, das HTTP und HTTPS selbst ausliefert, ohne separaten Webserver; FrankenPHP; Apache und nginx mit PHP-FPM; Berechtigungen; Reverse Proxys |
| 9. Datenbanken | Die unterstützten Datenbanken in ihrer offiziellen Reihenfolge (SQLite 3, die Voreinstellung; PostgreSQL; MongoDB; MariaDB; Oracle; MySQL): SQLite 3 als Produktivdatenbank unter hoher Last (WAL, Schreibwarteschlangen, Caching, Skalierung, Sicherungen), jede Server-Engine, ein Vergleich, der Wechsel der Engine und Microsoft SQL Server |
| 10. Nach der Installation: das Betriebshandbuch | Erste Anmeldung, Siteaccesses, Cron, Mail, Benachrichtigungen und Newsletter, Caches, Autoloads, Sicherungen, Logs, Überwachung, Performance, Extensions |
Teil IV: Den Betrieb aufrechterhalten
| Kapitel | Inhalt |
|---|---|
| 11. Upgrade | Welche Version Sie betreiben, die Update-Dateien, die Wege von 3.x, 4.x und 5.x sowie von jeder 6.0.x bis heute |
| 12. Fehlerbehebung | Symptom, Ursache und Lösung für jede Phase: Composer, der Assistent, der Kickstarter, Laufzeit, Datenbanken, Velocity, Caches, Anmeldung |
| 13. Sicherheitshärtung für den Produktivbetrieb | Was der Server niemals herausgeben darf, Geheimnisse, Debug-Ausgaben, der Admin-Siteaccess, Passwörter und Sitzungen, Formular-Tokens, Header und HTTPS, das Audit-Protokoll |
Teil V: Migration zu, innerhalb von und weg von Exponential
Beginnen Sie bei der Migrationsübersicht: einer geprüften Tabelle aller Exponential-Produkte und ihrer Versionen, einer Entscheidungshilfe und einer Anleitung je Weg, innerhalb der Exponential-Familie (Platform Legacy, Nexus, DXP, Exponential Platform, Exponential Basic, ältere Releases) und von oder zu anderen Systemen (WordPress, Drupal, Joomla, Magento, Shopify, Contentful, Adobe Experience Manager, Wix, Squarespace, GoDaddy, statische Sites, JavaScript-, Symfony- und ColdFusion-Anwendungen), mit der gemeinsamen Checkliste, den Import- und Export-Werkzeugen und der Zuordnung der Inhaltsmodelle.
Die folgenden Kapitel nennen die alten Produkte (eZ Publish, eZ Platform, Ibexa) nur, um das System zu bezeichnen, von dem Sie migrieren. Jedes geht die Migrationsseiten des jeweiligen Herstellers Punkt für Punkt durch und sagt, wo Exponential sich unterscheidet.
| Kapitel | Inhalt |
|---|---|
| 14. Migration von der 4.x-Linie | eZ Publish 3.10 und 4.0 bis 4.7 unter PHP 5: Bestandsaufnahme, die Datenbank Schritt für Schritt, Dateien und Cluster, Einstellungen, Designs, Portierung von Extensions auf PHP 8, Passwörter, Suche, Überprüfung, häufige Probleme, Rückkehr zum alten Stand |
| 15. Migration vom 5.x-Legacy-Stack | eZ Publish 5.x mit dem Symfony-Stack: welche Variante Sie betreiben, Herauslösen des Legacy-Teils, YAML zu INI, Feldtypen gegenüber Datentypen, Bildvarianten, Twig zu TPL, REST, Caches, häufige Probleme |
| 16. Migration von eZ Platform und Ibexa | eZ Platform 1.x bis 3.x und Ibexa DXP/OSS zu Exponential Platform Nexus (der gleichwertige Symfony-Weg) oder zum Exponential-Legacy-Kernel, mit einer Entscheidungstabelle |
| 17. Migrationsreferenz | Nachschlagetabellen: jede Kernel-Tabelle, Datentypen und Feldtypen, INI- und YAML-Einstellungen, TPL und Twig, die PHP-API, Passwort-Hashes, URL-Aliase und Bildpfade, Datenprüfungen, Werkzeuge, Glossar |
Welche Kapitel brauche ich?
| Ihre Situation | Lesen Sie |
|---|---|
| Eine erste Testinstallation auf einem Laptop | Kurzanleitung, dann die Kapitel 3 und 7 |
| Eine Produktiv-Site auf einem Server, ohne separaten Webserver | Kapitel 2, 3, 5 oder 6, 8 (Velocity), 9 (SQLite), 10, 13 |
| Eine Produktiv-Site hinter Apache oder nginx mit MySQL oder PostgreSQL | Kapitel 2, 3, 5 oder 6, 8, 9, 10, 13 |
| Unbeaufsichtigte Installationen in CI oder Containern | Kapitel 4, 6, 7 |
| Upgrade einer bestehenden Site | Kapitel 11, 12 |
| Umzug einer Site von eZ Publish 3.x oder 4.x | Kapitel 14, 17, dann 11 für die Update-Kette |
| Umzug einer Site von eZ Publish 5.x | Kapitel 15, 17 |
| Umzug einer Site von eZ Platform oder Ibexa | Kapitel 16, 17 |
| Wechsel zwischen Exponential-Produkten, von einem anderen CMS oder Website-Baukasten, oder weg von Exponential | Die Migrationsübersicht |
.htaccess und config.php anlegen, eine Einstellung in config.php ändern | .htaccess und config.php von der Konsole aus einrichten, Kapitel 3 und 8 |
| Etwas funktioniert nicht | Kapitel 12 |
Weitere Dokumentation
- Erste Schritte, Eine Site betreiben und Upgrades: die Aufgaben-Anleitungen.
- Hinweise zur Abwärtskompatibilität für 6.0: was sich geändert hat und was eine Site deswegen tun muss, nach Thema.
- Changelogs: was jede 6.0.x-Release geändert hat.
- Das README des Projekts: ein Überblick über Exponential und seine Funktionen.
Öffentliche Demos
Sie installieren eine öffentliche Demo, deren Administrator-Anmeldung veröffentlicht ist? Setzen Sie die
Umgebungsvariable EXP_DEMO_MODE=1 für die Installation und danach für jeden PHP-Prozess der Demo: Die Installer
akzeptieren dann das veröffentlichte Passwort (publish, publishing), und Administratorpasswörter können weder
geändert noch zurückgesetzt werden. Die Kapitel 5, 6, 7 und 13 enthalten je einen Hinweis dazu; die ganze Geschichte
steht unter Demo-Modus, die Einrichtung auf einem Server unter
Rezept: eine öffentliche Demo unter LiteSpeed und Plesk betreiben.
Werden Sie Exponential-Partner
Partner teilen ihre Informationen, stellen Mittel bereit, geben Beiträge zurück und entwickeln die Produkte mit uns, und so wächst Exponential. Eine Partner-Website und ein Dashboard sind für Mitte 2027 geplant: Werden Sie noch heute Partner, damit wir schneller wachsen und neue Funktionen früher liefern.