Exponential 6.0 installieren #

Diese Anleitung führt Sie von null bis zu einer funktionierenden Website mit Exponential 6.0: was Sie brauchen, wie Sie den Code erhalten, die drei Installationswege (der Einrichtungsassistent im Browser, der Kickstarter, die Installation mit einem einzigen Konsolenbefehl), wie Sie die Website ausliefern und was danach zu tun ist. Was Exponential ist und wie es ausgeliefert wird, lesen Sie zuerst in der README des Projekts. Eine geführte erste Stunde nach der Installation finden Sie unter Erste Schritte.

Warnung .htaccess bremst jede Anfrage. Sind .htaccess-Dateien erlaubt (AllowOverride alles außer None), 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 None im 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 auch staticcache_offload.conf), setzen Sie AllowOverride None, führen Sie apachectl configtest aus, 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.

Jeder Befehl wird im Wurzelverzeichnis der Installation ausgeführt: dem Verzeichnis, das index.php, autoload.php, bin/ und settings/ enthält. Die Befehlskonsole ist bin/php/console. Viele Installationen legen im Wurzelverzeichnis eine Verknüpfung darauf an (ln -s bin/php/console console), sodass ./console und php bin/php/console dasselbe Programm sind. Wenn Sie ein Skript als root ausführen, ergänzen Sie --allow-root-user; das Skript weist Sie darauf hin, wenn es nötig ist.

Das vollständige Buch. Diese Seite ist die Kurzanleitung. Zu jedem der folgenden Abschnitte gibt es ein Kapitel im Installationsbuch mit allen Einzelheiten, kommentierten Beispielen und Referenzen: der Einrichtungsassistent Seite für Seite, jeder Schlüssel der kickstart.ini, Exponential Velocity, das HTTPS ohne separaten Webserver ausliefert, SQLite 3 unter hoher Produktionslast, das Betriebshandbuch, Fehlerbehebung und Sicherheitshärtung.

Inhalt #

1. Was Sie erhalten, und der Schnellstart
2. Voraussetzungen
3. Den Code beschaffen
4. Eine Installationsmethode wählen
5. Installation mit dem Einrichtungsassistenten
6. Installation mit dem Kickstarter
7. Installation mit einem Konsolenbefehl
8. Die Website ausliefern: Webserver, HTTPS und Berechtigungen
9. SQLite im Produktivbetrieb
10. Nach der Installation
11. Aktualisierung von einer älteren Version
12. Fehlerbehebung

1. Was Sie erhalten, und der Schnellstart #

Vollständiges Kapitel: 01-introduction

Eine Installation besteht aus dem Exponential-Kernel, den in composer.json aufgeführten Extensions (welche sie hat und aktiviert: Erweiterungen einer neuen Installation), einem Site-Paket mit seinen Inhalten und seinem Design sowie drei Siteaccesses. Ihre Namen lauten immer site, admin und editor; was Sie bei der Installation wählen, ist der URL-Pfad, der Port oder der Hostname, der zu jedem von ihnen führt (der Match-Wert):

Der kürzeste funktionierende Weg braucht nur PHP und Composer. Er installiert auf SQLite (kein Datenbankserver) und liefert die Website mit dem PHP-Server aus, den Exponential für Sie starten kann:

composer create-project se7enxweb/exponential exponential
cd exponential
php bin/php/console exp:install --apply --random-password --url=http://localhost:8087
php bin/php/console exp:velocity start --engine=php

Öffnen Sie http://localhost:8087/site/ für die Website und http://localhost:8087/admin/user/login für die Administration. Der Benutzer ist admin; das Passwort wird am Ende der Installation einmal ausgegeben und in var/log/initial-admin-password geschrieben (nur für den Eigentümer lesbar). Ändern Sie es nach der ersten Anmeldung und löschen Sie diese Datei. Beenden Sie den Server mit php bin/php/console exp:velocity stop --engine=php.

Die Engine php ist der eingebaute Server von PHP und für die Entwicklung gedacht. Für eine echte Website verwenden Sie die Engine qbix von Exponential Velocity oder Apache/nginx mit PHP-FPM (Abschnitt 8).

Bauen Sie eine Website, statt eine auszuprobieren? Holen Sie den Code stattdessen als Git-Klone mit ihrer vollständigen Historie: Dieselben zwei Installationsbefehle funktionieren auch in einem Klon, und Abschnitt 3 zeigt die Befehle, mit denen der Kernel und jede Extension zu einem Klon werden, den Sie verfolgen, ändern und von dem aus Sie Beiträge zurückgeben können.

2. Voraussetzungen #

Vollständiges Kapitel: 02-requirements

PHP #

PHP-Extensions:

Die Systemprüfung des Einrichtungsassistenten testet all diese Punkte und sagt Ihnen, was fehlt. Auf einer laufenden Installation listet php bin/php/console exp:velocity ext check jede Extension auf, die die Installation benötigt, markiert, was fehlt, und gibt den Installationsbefehl für Ihr System aus.

Composer #

Composer 2.x. Er installiert die Bibliotheken des Kernels, die expcomponents (se7enxweb/expcomponents-*, seit 6.0.15 der Fork der Zeta Components durch Exponential), und die Exponential-Extensions, die composer.json aufführt.

Datenbank #

Unterstützte Datenbanken (Exponential 6.0.x), in der Reihenfolge der Präferenz: 1. SQLite 3 (der Standard) · 2. PostgreSQL · 3. MongoDB · 4. MariaDB · 5. Oracle · 6. MySQL. Microsoft SQL Server ist derzeit bekanntermaßen mit zusätzlichem Aufwand möglich. Einzelheiten: Datenbankunterstützung.

Die Namen sind die Aliase in settings/site.ini, Block [DatabaseSettings], ImplementationAlias[]. Die minimalen Serverversionen, die der Assistent prüft, stehen in kernel/setup/ezsetupcommon.php (MySQL 4.1.1, PostgreSQL 8.0, SQLite 3.0.1, MongoDB 4.0, Oracle 19); die praktischen Mindestversionen, die die aktuellen Treiber brauchen, liegen höher (SQLite 3.33, PostgreSQL 13, MongoDB 6.0), siehe Datenbankunterstützung. Exponential läuft auf fast jedem Betriebssystem mit PHP 8.0 oder neuer (PHP 7.4 ohne Support nutzbar): siehe Unterstützung von Betriebssystemen.

Webserver #

Einer der folgenden, gewählt in Abschnitt 8:

• Exponential Velocity, der empfohlene Anwendungsserver: Er liefert HTTP und HTTPS selbst aus, mit eigenen Zertifikaten, und benötigt keinen weiteren Webserver.
• Apache mit mod_rewrite und PHP-FPM (oder mod_php). Die Rewrite-Regeln werden in .htaccess_root mitgeliefert.
• Jeder andere Server, der eine URL auf index.php umschreiben kann (nginx, LiteSpeed, Caddy und andere, aufgeführt in der README). Diese Anleitung enthält keine Konfiguration für sie.

3. Den Code beschaffen #

Vollständiges Kapitel: 03-getting-the-code

Wählen Sie einen Weg. Alle ergeben dieselbe Installation. Das installiert Exponential 6; die Symfony-basierten Distributionen (Exponential Platform Legacy, Nexus und DXP) und die Site-Pakete zur Auswahl vergleicht Distributionen von Exponential.

Git-Klone mit Historie (empfohlen für alle, die Websites bauen): Der Kernel und jede se7enxweb-Extension kommen als Git-Klone an, sodass Sie sehen, was sich geändert hat, die Entwicklung verfolgen, eigene Änderungen auf einem Branch halten und Korrekturen als Pull Requests zurückschicken können. Mit Git entwickeln erklärt es Schritt für Schritt.

composer config --global 'preferred-install.se7enxweb/*' source
git clone https://github.com/se7enxweb/exponential.git
cd exponential
git switch -c my-site
composer install

Die erste Zeile ist einmal pro Benutzerkonto nötig: Sie veranlasst Composer, jedes se7enxweb/*-Paket zu klonen, statt sein Release-Archiv herunterzuladen.

Composer-Projekt (am schnellsten für eine Website, die Sie nur betreiben; Release-Archive ohne Historie):

cd www_root_directory
composer create-project se7enxweb/exponential exponential
cd exponential

Fügen Sie eine Version hinzu, um ein Release festzulegen, zum Beispiel composer create-project se7enxweb/exponential:v6.0.14 exponential. Fügen Sie --prefer-source --keep-vcs hinzu, um auch mit create-project Git-Klone zu erhalten.

Composer require in ein leeres Verzeichnis (das Paket von Packagist):

mkdir exponential
cd exponential
composer require se7enxweb/exponential

Prüfen Sie anschließend, ob die Konsole läuft:

php bin/php/console --version

Die erste Zeile nennt die Version, zum Beispiel console (Exponential) 6.0.15stable.

Exponential Velocity. composer.json verlangt es in ~0.0.4.57, sodass composer install es auf jedem unterstützten PHP installiert, auch auf 8.0. Bis zu seinem Release 0.0.4.54 brauchte es PHP 8.1 und wurde nur vorgeschlagen; eine in dieser Zeit erstellte Installation fügt es hinzu mit:

composer require se7enxweb/exponential-velocity:~0.0.4.57

4. Eine Installationsmethode wählen #

Vollständiges Kapitel: 04-choosing-an-install-method

Alle drei Methoden führen dieselben Einrichtungsschritte aus (kernel/setup/steps/) und erzeugen dieselbe Art von Installation.

Wie die Website ausgeliefert wird, wählen Sie getrennt davon (Abschnitt 8):

5. Installation mit dem Einrichtungsassistenten #

Vollständiges Kapitel: 05-setup-wizard

Wie er startet #

settings/site.ini wird mit [SiteAccessSettings] CheckValidity=true ausgeliefert. Solange der Wert true ist, wird jede Anfrage statt an die Website an den Einrichtungsassistenten geschickt (Modul setup, Funktion init). Der letzte Schritt schreibt CheckValidity=false in settings/override/site.ini.append.php, und von da an wird die Website ausgeliefert.

1. Liefern Sie die Installation mit einem Webserver aus (Abschnitt 8), zum Beispiel mit php bin/php/console exp:velocity start --engine=php.
2. Öffnen Sie die Adresse der Website in einem Browser. Die erste Seite des Assistenten erscheint.

Während der Assistent läuft, kommt nur der Browser durch, der ihn gestartet hat (er trägt das Cookie exp_setup_wizard); jeder andere Besucher sieht eine Seite „The site is being set up" (HTTP 503). Diese Sperre endet mit der letzten Seite des Assistenten oder 30 Minuten nach seiner letzten Anfrage (expMaintenance::WIZARD_LEASE).

Liegt eine kickstart.ini im Wurzelverzeichnis der Installation, liest der Assistent sie: Schritte, deren Abschnitt Continue=true enthält, werden übersprungen, die anderen sind vorausgefüllt (Abschnitt 6). Entfernen oder verschieben Sie kickstart.ini, wenn Sie jede Seite selbst beantworten möchten.

Die Schritte #

Die Reihenfolge ist die Schritttabelle in kernel/setup/steps/ezstep_data.php.

Der Assistent protokolliert seinen Fortschritt in var/log/setup.log. Mehr dazu: Einrichtungsassistent und Siteaccess editor, Standardwerte einer sauberen Installation, Installer-Protokolle und Startdaten.

6. Installation mit dem Kickstarter #

Vollständiges Kapitel: 06-kickstarter

Der Kickstarter (bin/php/kickstarter.php, Konsole exp:kickstarter) führt die Schritte des Einrichtungsassistenten ohne Browser aus und liest jede Antwort aus kickstart.ini im Wurzelverzeichnis der Installation. Die kommentierte Vorlage ist kickstart.ini-dist.

Die Befehle #

php bin/php/console exp:kickstarter ini            # write kickstart.ini in an interactive editor
php bin/php/console exp:kickstarter ini --yes      # write it with the built-in defaults, no questions
php bin/php/console exp:kickstarter run --dry-run  # check kickstart.ini, the database and the packages
php bin/php/console exp:kickstarter run --apply --force    # install

php bin/php/kickstarter.php akzeptiert dieselben Unterbefehle und Optionen.

Während run --apply die Datenbank neu aufbaut, beantwortet die Website jeden Besucher mit der Wartungsseite; ein bereits geöffnetes Wartungsfenster bleibt bestehen, und nach einem fehlgeschlagenen Schritt bleibt die Seite stehen, bis Sie erneut ausführen oder php bin/php/maintenance.php off aufrufen. Jeder Lauf wird mit maskierten Passwörtern in var/log/kickstart.log protokolliert (frühere Läufe werden als kickstart.log.1 bis .9 aufbewahrt; EXP_KICKSTART_LOG=0 schaltet das Protokoll ab). Das Site-Paket wird aus var/storage/packages/ genommen, wenn es dort bereits importiert ist; andernfalls wird es mit den Paketen, die es benötigt, aus dem in settings/package.ini konfigurierten Paketindex heruntergeladen.

kickstart.ini #

Ein Abschnitt pro Schritt des Assistenten. Lassen Sie vor einem Abschnitt oder einem Schlüssel keine Leerzeichen. Continue=true überspringt den Schritt und verwendet die Werte; Continue=false (oder kein Continue) zeigt den Schritt vorausgefüllt an. Ein vollständiges Beispiel für MySQL:

[email_settings]
Continue=true
Type=mta

[database_choice]
Continue=true
Type=mysqli

[database_init]
Continue=true
Server=localhost
Port=
Database=exponential
User=exponential
Password=CHANGE_ME
Socket=

[language_options]
Continue=true
Primary=eng-GB
Languages[]=eng-US

[site_types]
Continue=true
Site_package=sevenx_multisite

[site_access]
Continue=true
Access=url

[site_details]
Continue=true
Title=My Exponential site
URL=https://www.example.com
Access=site
AdminAccess=admin
EditorAccess=editor
Database=exponential
DatabaseAction=remove

[site_admin]
Continue=true
FirstName=Site
LastName=Administrator
Email=[email protected]
Password=

[security]
Continue=true

[registration]
Continue=true
Send=false

Jede Sprache muss eine Locale in share/locale haben, sonst bricht der Lauf in LanguageOptions ab und nennt die Sprache. Sprachen des Site-Pakets, die Sie nicht aufgeführt haben, werden als eigene Sprachen angelegt, sodass ihre Inhalte erreichbar bleiben.

DatabaseAction: Lesen Sie dies vor dem Ausführen #

Warnung. DatabaseAction=remove leert die angegebene Datenbank und installiert in sie hinein. Alles in dieser Datenbank geht verloren. Lassen Sie Database auf eine Datenbank zeigen, die nichts enthält, was Sie brauchen, und erstellen Sie vorher eine Sicherung.

Erneut ausführen #

• Führen Sie mit derselben kickstart.ini erneut aus, um eine identische Installation zu erhalten. Mit DatabaseAction=remove ersetzt dies die Datenbank erneut.
• Beheben Sie nach einem Fehler die Ursache (der fehlgeschlagene Schritt und seine Meldung stehen in der Ausgabe und in var/log/setup.log) und führen Sie die gesamte Folge erneut aus; mit DatabaseAction=remove ersetzt der zweite Lauf, was der erste hinterlassen hat.
• ini und run löschen die zwischengespeicherten Dateien var/cache/ini/kickstart-*.php selbst. Wenn Sie kickstart.ini von Hand bearbeiten und alte Werte sehen, löschen Sie diese Dateien.
• Wenn Sie auf eine andere Datenbank-Engine installieren als die, die die Installation zuvor verwendet hat, setzen Sie zuerst DatabaseImplementation in settings/override/site.ini.append.php auf die neue Engine: Der Installer behält den Wert, den er dort vorfindet.
• kickstart.ini enthält das Datenbankpasswort. Halten Sie die Datei aus der Versionsverwaltung heraus, und entfernen oder verschieben Sie sie nach der Installation, wenn der Web-Assistent sie nicht lesen darf.

Vollständige Referenz: Kickstarter CLI, Kickstarter.

7. Installation mit einem Konsolenbefehl #

Vollständiges Kapitel: 07-console-install

exp:install (bin/php/install.php) erstellt die Kickstart-Konfiguration aus seinen Optionen, führt dieselben Schritte im selben Prozess aus und stellt eine vorher vorhandene kickstart.ini wieder her. Alles hat einen Standardwert, sodass allein dieser Befehl das Paket sevenx_multisite auf SQLite mit dem Benutzer admin und einem erzeugten Passwort installiert:

php bin/php/console exp:install --apply

Andere Datenbanken (halten Sie das Passwort mit EXP_INSTALL_DB_PASSWORD aus der Shell-Historie heraus):

EXP_INSTALL_DB_PASSWORD='secret' php bin/php/console exp:install --apply --db=mysql --db-host=127.0.0.1 \
    --db-name=mysite --db-user=mysite --url=https://www.example.com --random-password

Die Zusammenfassung am Ende nennt die Adressen der Website, der Admin-Anmeldung und des Redakteurszugangs sowie Benutzer und Passwort. Die verwendete Konfiguration wird mit maskierten Passwörtern in var/log/exp-install-<date>.ini aufbewahrt. Mehr dazu: Installation mit einem Befehl.

8. Die Website ausliefern: Webserver, HTTPS und Berechtigungen #

Vollständige Kapitel: 08-serving-the-site und 13-security-hardening

Das Document Root ist immer das Wurzelverzeichnis der Installation.

Option A: Exponential Velocity (empfohlen) #

Velocity ist ein Anwendungsserver, der für Exponential mitgeliefert wird. Er lädt die Anwendung einmal, hält sie in persistenten Workern und hat einen eigenen Antwort-Cache. Er liefert HTTP und HTTPS selbst aus, mit eigenen Zertifikaten, sodass weder Apache noch nginx noch PHP-FPM nötig sind. Installieren Sie ihn mit Composer (Abschnitt 3), dann:

php bin/php/console exp:velocity config set --apply ServerSettings Engine qbix
php bin/php/console exp:velocity start
php bin/php/console exp:velocity status

config set schreibt settings/override/velocity.ini.append.php; die mitgelieferten Standardwerte bleiben in settings/velocity.ini. Die mitgelieferte Standard-Engine ist php (Entwicklung); setzen Sie für jede echte Website qbix. Die Engine qbix liefert einfaches HTTP auf [ServerSettings] Port (8088) und HTTPS auf HTTPSPort (8080) aus, gebunden an Host (127.0.0.1). Um ins Netzwerk auszuliefern:

php bin/php/console exp:velocity config set --apply ServerSettings Host 0.0.0.0
php bin/php/console exp:velocity config set --apply ServerSettings Port 80
php bin/php/console exp:velocity config set --apply ServerSettings HTTPSPort 443
php bin/php/console exp:velocity restart

Ports unter 1024 benötigen root. Als root gestartet, behält der Serverprozess root, um die Ports zu binden und das Zertifikat zu lesen, und die Worker laufen als [ServerSettings] User und Group (wenn leer: VC_RUN_USER und VC_RUN_GROUP aus der Umgebung oder aus /etc/vc/envvars, sonst der Eigentümer des Document Root). Worker laufen nie als root, außer bei AllowRootWorkers=enabled.

HTTPS mit einem vorhandenen Zertifikat (eine PEM-Datei kann beides enthalten):

php bin/php/console exp:velocity config set --apply HTTPSSettings Certificate /etc/ssl/example.com/fullchain.pem
php bin/php/console exp:velocity config set --apply HTTPSSettings Key /etc/ssl/example.com/privkey.pem
php bin/php/console exp:velocity config set --apply HTTPSSettings Enabled true
php bin/php/console exp:velocity restart
php bin/php/console exp:velocity ssl show

HTTPS ist eingeschaltet, wenn Enabled den Wert true hat und beide Dateien existieren. Das Zertifikat wird vor der Verwendung geprüft (lässt sich parsen, ist nicht abgelaufen, der Schlüssel passt); ein selbstsigniertes Zertifikat springt ein, solange das echte unbrauchbar ist (fallback, Standard self-signed), und ein erneuertes Zertifikat wird ohne Neustart eingewechselt. Das Zertifikatssubsystem der Engine bezieht und erneuert außerdem Zertifikate von Let's Encrypt (oder jeder ACME-CA) und liest Archive und PKCS#12-Bündel; es wird unter Q.web.https konfiguriert und in Velocity: HTTPS und Zertifikate beschrieben. [HTTPSSettings] HSTSMaxAge (ausgeliefert mit 0, aus; 300 zum Einstieg) setzt Strict-Transport-Security; erhöhen Sie den Wert erst, wenn jeder Name der Website dauerhaft auf HTTPS läuft.

Konfigurationsaufbau. Die Konfiguration von Velocity folgt Debians /etc/apache2: /etc/vc/vc.conf, ports.conf, envvars sowie sites-available/sites-enabled, conf-available/conf-enabled, mods-available/mods-enabled (eine Überlagerung über /etc/qbix der Engine, das ebenfalls gelesen wird). Die Site-Datei sites-available/<site>.conf wird bei jedem start und restart oder mit exp:velocity layout migrate aus velocity.ini erzeugt. Schalten Sie Sites, Snippets und Module wie mit a2ensite um:

php bin/php/console exp:velocity layout                 # show every file the server uses
php bin/php/console exp:velocity site enable --apply <name>
php bin/php/console exp:velocity site disable --apply <name>

Im Alltag:

Worker halten die Anwendung im Speicher: Starten Sie nach einer Änderung an einer Klasse oder einer Einstellung neu (oder verwenden Sie deploy); das Leeren der Caches allein erreicht sie nicht. Velocity hat keinen Befehl, um einen Systemdienst für den Bootvorgang zu installieren; das Engine-Paket liefert eine beispielhafte systemd-Unit in vendor/se7enxweb/exponential-velocity/service/ mit. Wenn Velocity die Website allein ausliefert, setzen Sie [DeploySettings] PhpFpmService auf disabled.

Mehr dazu: Velocity-Engines, Aufbau auf der Festplatte, persistente Worker, Deployment.

FrankenPHP ist die produktionsreife alternative Engine, die mit denselben Befehlen gesteuert wird: exp:velocity config set ServerSettings Engine frankenphp, exp:velocity install (lädt das Binärprogramm herunter und prüft es), exp:velocity start. Sie liefert standardmäßig HTTPS aus ([FrankenPHPSettings] HTTPS=enabled, Port 8444), mit Ihrem [HTTPSSettings] Certificate und Key oder einem selbstsignierten Zertifikat, das sie selbst erstellt und erneuert.

Option B: Apache mit PHP-FPM #

Aktivieren Sie die mitgelieferten Rewrite-Regeln:

./console exp:setup:htaccess --apply      # oder von Hand: cp .htaccess_root .htaccess

Der Befehl kopiert .htaccess_root nach .htaccess mit dem Modus der Vorlage (und, als root mit --allow-root-user, mit ihrem Eigentümer), zeigt einen Diff und lehnt ab, wenn bereits eine abweichende .htaccess vorhanden ist, und sichert die alte Datei, bevor --force --apply sie ersetzt. --static kopiert stattdessen .htaccess_root_static. Ebenso legt ./console exp:setup:config --apply die Datei config.php-RECOMMENDED als config.php an; siehe .htaccess und config.php von der Konsole aus einrichten.

Sie schalten den Virtual-Host-Modus auf Basis von .htaccess ein: Punktdateien, .git und Skripte unterhalb der Front-Controller antworten mit 404, /api/ geht an index_rest.php, statische Design-Dateien werden direkt ausgeliefert, und alles andere geht an index.php. Entfernen Sie daraus keine Sicherheitsregeln, um etwas zum Laufen zu bringen. Ein minimaler Virtual Host:

<VirtualHost *:80>
    ServerName example.com
    DocumentRoot /var/www/example.com
    DirectoryIndex index.php

    <Directory /var/www/example.com>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    <FilesMatch \.php$>
        SetHandler "proxy:unix:/run/php-fpm/www.sock|fcgi://localhost"
    </FilesMatch>
</VirtualHost>

mod_rewrite, mod_proxy und mod_proxy_fcgi müssen geladen sein. Prüfen Sie mit apachectl configtest und laden Sie Apache neu. Für HTTPS fügen Sie einen Virtual Host *:443 mit SSLEngine on, SSLCertificateFile und SSLCertificateKeyFile hinzu, sowie ein Zertifikat aus Ihrem üblichen Werkzeug. Laden Sie nach einer PHP-Änderung das PHP-FPM neu, das die Website ausliefert; auf Servern mit mehreren PHP-Versionen ist das nicht immer dasjenige namens php-fpm ([DeploySettings] PhpFpmService=auto lässt exp:velocity deploy es finden). Einzelheiten: Deployment.

Berechtigungen #

Der Benutzer, unter dem der Webserver oder die Velocity-Worker laufen, muss in diese Verzeichnisse schreiben können (die Setup-Prüfung directory_permissions in settings/setup.ini): design, extension, settings, settings/override, settings/siteaccess, var und alles darunter, was Exponential schreibt (var/cache, var/log, var/storage, var/autoload). Die Systemprüfung gibt die Befehle für Ihren Rechner in dieser Form aus:

sudo chmod -R ug+rwx design extension settings var
sudo chown -R <web user>:<web group> design extension settings var

Wenn Kommandozeilenskripte und Cronjobs unter einem anderen Benutzer laufen als der Webserver, geben Sie ihnen eine gemeinsame Gruppe, die dieselben Dateien schreiben darf.

Hinter einem Reverse Proxy oder Load Balancer #

Weitergeleiteten Headern (X-Forwarded-For, X-Forwarded-Proto, X-Forwarded-Host) wird nur von den Adressen in site.ini [HTTPHeaderSettings] TrustedProxies[] vertraut, standardmäßig 127.0.0.1 und ::1. Ein Proxy auf einem anderen Rechner muss dort hinzugefügt werden (zum Beispiel TrustedProxies[]=10.0.0.0/8 in settings/override/site.ini.append.php), sonst erzeugt die Website hinter einem HTTPS-Proxy http://-Links und sieht mit ClientIpByCustomHTTPHeader=X-Forwarded-For die Adresse des Proxys statt der des Besuchers. Einzelheiten: Kapitel 8 und Weitergeleiteten Headern wird nur von konfigurierten Proxys vertraut.

9. SQLite im Produktivbetrieb #

Vollständiges Kapitel: 09-databases

SQLite ist nicht nur zum Ausprobieren von Exponential da. Der Kernel-Treiber (lib/ezdb/classes/ezsqlite3db.php, Klasse eZSQLite3DB) ist für eine Website unter Last gebaut.

Was der Treiber tut:

Einstellungen (settings/site.ini, Block [DatabaseSettings]; Überschreibung in settings/override/site.ini.append.php):

[DatabaseSettings]
DatabaseImplementation=sqlite3
# a name under var/storage/sqlite3/, or an absolute path
Database=exponential.db
# seconds a transaction waits for the writers ahead of it (default 25);
# keep it below the request timeout: Velocity's Q.webserver.requestTimeout
# (30 s unless changed), or PHP-FPM's request_terminate_timeout
SQLiteTransactionWait=25
# PRAGMAs over the driver's defaults, one per line as name=value
SQLitePragmas[]
#SQLitePragmas[]=cache_size=-131072

Leeren Sie nach einer Änderung den INI-Cache: php bin/php/ezcache.php --clear-tag=ini.

Was die Last trägt. Die meisten Anfragen erreichen die Datenbank nie: der Cache der Inhaltsansichten, der Template-Block-Cache und, mit Velocity, der Antwort-Cache, der eine wiederholte Anfrage beantwortet, ohne die Anwendung zu starten. Unter den persistenten Workern von Velocity hält jeder Worker die Anwendung geladen und teilt sich die eine Datenbankdatei; Lesezugriffe laufen nebeneinander, und Schreibzugriffe reihen sich an der Schreibsperre ein (der Treiber öffnet die Sperre in jedem geforkten Worker neu). In Lasttests dieses Treibers skalierten parallele Leser mit der Zahl der Prozesse, kurze Schreibzugriffe blieben bei 16 parallelen Schreibern mit der seriellen Rate fehlerfrei, und lange Transaktionen, die mit dem 5-Sekunden-Limit des früheren Treibers scheiterten, wurden fehlerfrei abgeschlossen und warteten lediglich länger. Ein Team, in dem viele Redakteure im selben Moment große Änderungen veröffentlichen, ist mit MySQL, MariaDB oder PostgreSQL dennoch besser bedient.

Eigentümer und Berechtigungen. SQLite muss die Datenbankdatei, die Dateien -wal und -shm daneben und das Verzeichnis, das sie enthält, schreiben können; der Treiber legt var/storage/sqlite3/ mit dem Modus 0775 an, setzt aber weder Modus noch Eigentümer der Dateien, sodass diese die umask des erzeugenden Prozesses erhalten. Wenn Apache/PHP-FPM, Velocity-Worker und Cronjobs unter verschiedenen Benutzern laufen, geben Sie ihnen eine Gruppe, die var/storage/sqlite3/ und jede Datei darin lesen und schreiben darf. Ein von einem anderen Benutzer erzeugtes .writer-lock funktioniert trotzdem: Der Treiber öffnet es nur lesend, wenn er es nicht zum Schreiben öffnen kann. Liefern Sie die Datenbankdatei niemals über HTTP aus; prüfen Sie das mit curl -sI https://www.example.com/var/storage/sqlite3/exponential.db (alles außer 200 ist richtig).

Sicherungen. Verwenden Sie die Online-Sicherung von SQLite, niemals eine einfache Kopie einer Datei, die gerade in Benutzung ist:

sqlite3 var/storage/sqlite3/exponential.db ".backup backup.db"

Stellen Sie wieder her, indem Sie backup.db zurückkopieren, während die Website im Wartungsmodus ist (php bin/php/maintenance.php on, danach off). Führen Sie nach einer Installation oder einem großen Import einmal ANALYZE aus, damit der Query-Planer Statistiken hat (sqlite3 var/storage/sqlite3/exponential.db ANALYZE).

Mehr dazu: SQLite-Datenbankunterstützung, SQLite-3-Treiber, SQLite-Transaktionen.

10. Nach der Installation #

Vollständiges Kapitel: 10-after-installing

1. Melden Sie sich unter der Admin-Adresse, die der Installer ausgegeben hat (zum Beispiel /admin/user/login), als admin an. Ändern Sie das Passwort (Passwort ändern im Benutzermenü) und löschen Sie var/log/initial-admin-password. Ein verlorenes Passwort wird als root mit php bin/php/resetuserpassword.php --allow-root-user -u admin -g zurückgesetzt (ohne root autorisieren Sie sich mit einem anderen Administrator: -a <login> -ap <password>).

2. Prüfen Sie die Startseite und die Protokolle. Öffnen Sie die Adresse der Website. Lesen Sie bei einem Fehler var/log/error.log und Eine Installation reparieren.

3. Richten Sie die Cronjobs ein. Sie veröffentlichen geplante Inhalte, versenden Benachrichtigungen und Newsletter und räumen auf. Listen Sie die Teile auf und fügen Sie sie dann der Crontab des Website-Benutzers hinzu:

   php runcronjobs.php --list

   */5 * * * * cd /path/to/installation && php runcronjobs.php --siteaccess=site frequent >> var/log/cron-frequent.log 2>&1
   17 * * * *  cd /path/to/installation && php runcronjobs.php --siteaccess=site infrequent >> var/log/cron-infrequent.log 2>&1

   Verwenden Sie den Namen Ihres öffentlichen Siteaccess. Dieselben Teile finden Sie im Admin unter Setup > Cronjobs, und der Scheduler von Velocity kann sie ohne den System-Cron ausführen.

4. Kennen Sie die Cache-Befehle. Leeren Sie das Kleinste, das das Problem behebt:

   Sie haben geändert	Befehl
   eine Einstellung (.ini)	php bin/php/ezcache.php --clear-tag=ini
   ein Template (.tpl)	php bin/php/ezcache.php --clear-tag=template
   Inhalte wirken veraltet	php bin/php/ezcache.php --clear-tag=content
   ein Template oder eine Extension hinzugefügt	php bin/php/ezcache.php --clear-id=template-override
   unsicher	php bin/php/ezcache.php --clear-all

   Mit Velocity zusätzlich php bin/php/console exp:velocity cache clear --apply; nach einer Änderung an einer Klasse oder einer INI-Datei erledigt exp:velocity deploy all dies in der richtigen Reihenfolge.

5. Erzeugen Sie die Autoloads neu, nachdem Sie in einer Extension eine Klasse hinzugefügt oder umbenannt haben: php bin/php/ezpgenerateautoloads.php -e (-k für den Kernel).

6. Sichern Sie die Datenbank sowie var/storage, settings/override, settings/siteaccess (Eine Website betreiben).

7. Die Handbücher der Hilfe. Der Kickstarter und exp:install haben den Aufbau der Handbücher aus der Markdown-Hilfe in die Warteschlange gestellt (die letzten Zeilen ihrer Ausgabe): Ein Hintergrundjob legt sie in den folgenden 20 bis 30 Minuten an, und ./console exp:help:content report -s admin zeigt "Handbücher werden erstellt (n von 52)", bis er fertig ist. Führen Sie nach dem Setup-Assistenten, oder wenn das Einreihen ein Problem gemeldet hat, ./console exp:help:content build-manuals --apply -s admin --queue aus. Führen Sie ./console exp:help:content build-manuals --apply -s admin --release nach jeder Aktualisierung aus (Handbücher aus der Markdown-Hilfe).

8. Optional: die Job-Warteschlange und Exponential Intelligence. composer.json bringt die Job-Warteschlange expqueue und den Schreibassistenten expai nach extension/, beide inaktiv. Um sie zu verwenden:

   # settings/override/site.ini.append.php: the job queue, for every siteaccess
   [ExtensionSettings]
   ActiveExtensions[]=expqueue

   # settings/siteaccess/<each admin siteaccess>/site.ini.append.php: the assistant, for the administration only
   [ExtensionSettings]
   ActiveAccessExtensions[]=expai

   ./console ext:expqueue:install-schema
   php extension/expai/bin/php/expaischema.php --install -s admin
   php bin/php/ezpgenerateautoloads.php -e
   php bin/php/console exp:velocity deploy --packer    # or clear the caches and reload PHP-FPM

   Tragen Sie den Schlüssel des Anbieters in settings/override/expai.ini.append.php ein ([AISettings] Enabled=true, ApiKey=...; niemals in die Versionsverwaltung), geben Sie Redakteuren die Richtlinie expai/write und fügen Sie zwei Cron-Zeilen hinzu, beide mit dem Admin-Siteaccess, weil expai nur dort aktiv ist:

   * * * * *   cd /path/to/installation && php runcronjobs.php -q -s admin expqueue
   */5 * * * * cd /path/to/installation && php runcronjobs.php -q -s admin expai

   Was sie tun und jeden weiteren Schritt finden Sie unter Exponential Intelligence und die Job-Warteschlange.

Fahren Sie dann mit den Anleitungen fort:

• Exponential 6.0 konfigurieren: wo Einstellungen liegen und welche Datei gewinnt, Siteaccesses, Sprachen, E-Mail, Caches, Sicherheit, Extensions und Logs.
• Exponential 6.0 erweitern: Extensions, Module und Ansichten, Templates, Datentypen, Workflow-Ereignisse, Cronjob-Teile, Befehle, Tests und Veröffentlichungen.
• Mit Exponential 6.0 integrieren: die APIs, die Anmeldung von Maschinen, Inhalte und Ereignisse hinein und hinaus, Single Sign-on, Frontends und Sicherheit für Integrationen.
• Distributionen von Exponential: jede Distribution von Exponential, ihre PHP-Versionen und Datenbanken und welche Sie wählen.
• Erste Schritte: erste Anmeldung, erste Inhalte, erste Template-Änderung.
• Das Inhaltsmodell und das Bearbeiten von Inhalten: Klassen, Objekte, der Online-Editor, der Papierkorb und Inhalts-Jobs.
• Templates und Design: das Template finden, das eine Seite geschrieben hat, es überschreiben, das Admin-Design wechseln.
• Extensions: eine Extension finden, installieren, konfigurieren, bauen und veröffentlichen.
• Entfernte Dienste und Apps: Exponential aus der Shell, aus Python und mit einem API-Token aufrufen.
• Deployment: die Website mit Apache und PHP-FPM, Velocity oder FrankenPHP über HTTPS ausliefern.
• Eine Website betreiben: Caches, Cronjobs, Sicherungen, Protokolle und Reparaturen.
• Sicherheit und Prüfprotokoll: die Härtung prüfen, Rollen und Richtlinien, das Prüfprotokoll.
• Alle Anleitungen: der Lernpfad.

11. Aktualisierung von einer älteren Version #

Vollständiges Kapitel: 11-upgrading

Führen Sie den Installer nicht über einer bestehenden Website aus. Folgen Sie Aktualisieren: von 4.x, 5.x oder einer früheren 6.0.x auf die aktuelle Linie, mit der Datenbankaktualisierung und den Checklisten pro Release. Eine Installation von 6.0 bringen Sie mit dem kurzen Vorgehen von Exponential 6.0 aktualisieren auf den aktuellen Stand. Vergleichen Sie nach jeder Aktualisierung .htaccess und config.php mit den neuen Vorlagen: ./console exp:setup:status, ./console exp:setup:htaccess (der Diff) und ./console exp:config:list (Einstellungen, die neu in config.php-RECOMMENDED sind, erscheinen als (not set)). Um eine Website umzuziehen oder zu entfernen, exportieren Sie zuerst alles mit Exponential 6.0 deinstallieren.

Das Online-Handbuch enthält weitere Hinweise zur Installation: https://exponential.doc.exponential.earth/Exponential/Technical-manual/6.x/Installation.html

12. Fehlerbehebung #

Vollständiges Kapitel: 12-troubleshooting

Wenn die Tabelle nicht weiterhilft, zeigt Unterstützung erhalten, wo Sie fragen: von den Gemeinschaften von PHP und der Datenbank bis zur Exponential-Gemeinschaft und 7x.

Mehr dazu: Eine Installation reparieren, Wartungsmodus.

Öffentliche Demos: Demo-Modus #

Eine öffentliche Demo, deren Administrator-Anmeldung veröffentlicht ist, läuft mit der Umgebungsvariable EXP_DEMO_MODE=1. Jeder Installer (Einrichtungsassistent, Kickstarter, exp:install) installiert dann das veröffentlichte Administratorpasswort so, wie es angegeben ist, auch ein allgemein bekanntes oder kurzes wie publish oder publishing (niemals ein leeres), und danach kann niemand ein Administratorpasswort ändern oder zurücksetzen, solange die Variable gesetzt ist. Setzen Sie sie niemals für eine echte Website. Siehe Demo-Modus und die Beispiele zum Demo-Modus.