Erste Schritte: Exponential installieren und in wenigen Minuten eine funktionierende Site haben #

Diese Anleitung richtet sich an alle, die mit Exponential beginnen: an Redakteure, die eine Site zum Ausprobieren möchten, an Entwickler und an Betreiber. Vorkenntnisse brauchen Sie keine. Am Ende haben Sie eine installierte Site, sind an der Administrationsoberfläche angemeldet, haben einen ersten Inhalt veröffentlicht und ein Template geändert und die Änderung auf der Site gesehen. Rechnen Sie mit zehn bis fünfzehn Minuten. Die Installation selbst dauert mit SQLite etwa eine Minute.

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 console, index.php und settings/ enthält). Befehle, die mit ./console beginnen, sind dieselben Programme wie php bin/php/<name>.php.

1. Was Sie brauchen #

Prüfen Sie das PHP, das Sie verwenden werden:

php -v

Erwartet: eine Zeile, die mit PHP 8. beginnt.

2. Die Dateien beschaffen #

Wählen Sie einen Weg. Alle drei ergeben dieselbe Installation.

A. Git-Klone mit Historie (empfohlen, wenn Sie eine Website bauen): Der Kernel und jede se7enxweb-Extension kommen als Git-Klone an, sodass Sie sehen, was sich geändert hat, der Entwicklung folgen und Korrekturen zurückschicken können. Mit Git entwickeln erklärt, warum und wie.

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

B. Composer-Projekt (der schnellste Weg zu einer Site, die Sie nur ausprobieren oder betreiben möchten):

cd /var/www
composer create-project se7enxweb/exponential exponential
cd exponential

C. Pakete. Einzelne Ergänzungen (Inhalte, Klassen, Templates, Dateien) sind .ezpkg-Archive, die Sie nach der Basisinstallation mit ezpm installieren, siehe ezpm und Pakete vergleichen und importieren. Das Installationsprogramm in Schritt 3 installiert selbst ein Site-Paket (Standard sevenx_multisite), für eine erste Site brauchen Sie also nichts weiter.

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

./console --version

Erwartet: Die erste Zeile lautet console (Exponential) 6.0.15stable (oder die Version, die Sie installiert haben), und der Text endet mit Written by the Exponential Foundation and 7x (se7enx.com). Wenn Sie als root arbeiten, ergänzen Sie --allow-root-user bei den Skripten, die danach verlangen. Die Meldung des Skripts sagt es Ihnen.

3. Installieren #

3.1 Der eine Befehl #

./console exp:install --apply --random-password --url=http://localhost:8087

Dieser Befehl installiert das Multisite-Site-Paket auf SQLite, in eng-US, mit den Siteaccesses site (der öffentlichen Site) und admin, die am ersten Teil der Adresse unterschieden werden. Das Administratorpasswort wird erzeugt (24 Zeichen), einmal am Ende angezeigt und außerdem in var/log/initial-admin-password geschrieben; --random-password verlangt das ausdrücklich. Ein eigenes Passwort mit --password=... wird so übernommen, wie Sie es angeben, wenn es mindestens 10 Zeichen hat und kein allgemein bekanntes wie publish oder admin ist; andernfalls ersetzt es ein erzeugtes, und die Zusammenfassung weist darauf hin. Die Installation verweigert es, über eine bestehende Installation zu installieren, sofern Sie nicht --force angeben, und --help listet alle Optionen auf.

Erwartet am Ende (die Werte weichen ab):

================================================================
  Exponential is installed
================================================================
  Installed:     <date> (<seconds>s)
  Site:          http://localhost:8087/site/
  Admin login:   http://localhost:8087/admin/user/login
  Username:      admin
  Password:      <the generated password>
  ...
================================================================

Kopieren Sie jetzt die Zeilen Admin, Username und Password. Eine Kopie der verwendeten Konfiguration, mit maskierten Passwörtern, liegt in var/log/; den Fortschritt der Installation finden Sie in var/log/setup.log (was die Protokolle Ihnen sagen).

3.2 Andere Datenbanken #

EXP_INSTALL_DB_PASSWORD='YOUR_PASSWORD' ./console exp:install --apply --db=mysql --db-host=127.0.0.1 \
    --db-name=mysite --db-user=root --db-action=remove --random-password --url=http://localhost:8087

--db-action=remove leert zuerst die angegebene Datenbank; verwenden Sie also eine Datenbank, die nichts enthält, was Sie noch brauchen. Die Standardports und -namen jeder Datenbank-Engine stehen in Installation mit einem Befehl.

3.3 Aus einer Datei (wiederholbare Installationen) #

Für dieselbe Installation auf mehreren Servern schreiben Sie die Antworten einmal auf und führen sie aus:

php bin/php/console exp:kickstarter ini        # writes kickstart.ini after a few questions
php bin/php/console exp:kickstarter run --dry-run
php bin/php/console exp:kickstarter run --apply --force

--dry-run prüft die Antworten und die Pakete und schreibt nichts. Siehe Kickstarter und, für jeden Schlüssel, Kickstarter-CLI. Halten Sie Ihre kickstart.ini aus der Versionsverwaltung heraus; sie enthält das Datenbankpasswort.

3.4 Der Assistent im Browser #

Öffnen Sie die Adresse der Site in einem Browser, bevor eine Installation existiert, und der Setup-Assistent startet. SQLite steht an erster Stelle und die mitgelieferte Site ist vorausgewählt; wenn Sie also bei jedem Schritt Weiter drücken, wird die Standard-Site installiert. Siehe den Setup-Assistenten und die Standardwerte einer Neuinstallation.

4. Die Site ansehen #

Sie brauchen einen Webserver, der unter der angegebenen Adresse antwortet. Für einen ersten Blick verwenden Sie den, den Exponential mitliefert:

./console exp:velocity start --engine=php
./console exp:velocity status --engine=php

Die Engine php ist der eigene Server von PHP und lauscht standardmäßig auf Port 8087 (velocity.ini [PHPServerSettings] Port); deshalb hat Schritt 3 --url=http://localhost:8087 verwendet. Öffnen Sie http://localhost:8087/site/ in einem Browser: Sie sehen die Startseite der installierten Site. Halten Sie den Server mit ./console exp:velocity stop --engine=php wieder an.

Wenn Sie Schritt 3 mit einer anderen --url ausgeführt haben, verwenden Sie die Site-Adresse, die das Installationsprogramm ausgegeben hat.

Für den Produktivbetrieb verwenden Sie Apache mit PHP-FPM oder die eigenen Engines qbix oder frankenphp von Velocity: Velocity-Engines. Apache braucht die mitgelieferten Rewrite-Regeln als .htaccess: ./console exp:setup:htaccess --apply kopiert sie, und ./console exp:setup:status zeigt, wie es um .htaccess und config.php steht (.htaccess und config.php von der Konsole aus einrichten). Wenn eine Seite einen Fehler zeigt, verbirgt der Cache noch nichts; lesen Sie var/log/error.log und siehe Eine Installation reparieren.

5. Erste Anmeldung #

1. Öffnen Sie die Admin-Anmeldeadresse aus Schritt 3, zum Beispiel http://localhost:8087/admin/user/login.
2. Benutzername admin und das Passwort, das das Installationsprogramm ausgegeben hat.
3. Sie landen auf dem Dashboard der Administrationsoberfläche.
4. Verwenden Sie den Link Passwort ändern im Benutzermenü der Administration und wählen Sie ein eigenes Passwort. Wenn das Installationsprogramm var/log/initial-admin-password geschrieben hat, löschen Sie diese Datei anschließend.

Das Erste, was Sie über die Menüs wissen sollten: Eine Person sieht nur die Einträge, die ihre Rollen erlauben. admin ist in der Rolle Administrator und sieht alles.

6. Erster Inhalt #

1. Öffnen Sie in der Administration den Reiter Inhalt, Inhaltsstruktur.
2. Wählen Sie den obersten Knoten (den Ordner der Startseite) und wählen Sie Hier erstellen mit der Klasse Artikel (oder Ordner), dann Erstellen.
3. Füllen Sie im Editor den Titel und den Text aus und drücken Sie dann Zur Veröffentlichung schicken.
4. Öffnen Sie http://localhost:8087/site/ (neu laden) und suchen Sie Ihren Eintrag. Die Adresse seiner eigenen Seite zeigt die Administration unter Orte.

Klassennamen und Felder hängen vom installierten Site-Paket ab; das Inhaltsmodell wird in Inhaltsmodell und Bearbeitung erklärt.

Wenn ein Eintrag veröffentlicht ist, aber in einer Liste fehlt, leeren Sie einmal den Inhalts-Cache:

php bin/php/ezcache.php --clear-tag=content --allow-root-user

Der Cache-Befehl und seine Gruppen: ./console exp:cache --help; einen Probelauf jedes Leerens erhalten Sie mit --dry-run.

7. Erste Template-Änderung #

Ein Template ist eine .tpl-Datei. Die Site zeigt das Design, das der öffentliche Siteaccess nennt; fragen Sie Exponential, welches es ist:

./console exp:ini where site/DesignSettings/SiteDesign site

Erwartet: die Dateien, die es setzen, in Ladereihenfolge, und In effect: mit dem Namen des Designs (beim Multisite-Paket lautet die letzte Zeile SiteDesign=media oder ähnlich; verwenden Sie den Namen, der Ihnen angezeigt wird).

Über die Oberfläche (sicher, ohne Dateien) #

1. Menü der Administration: Design > Template-Editor.
2. Wählen Sie ein Template Ihres Designs, zum Beispiel das für die Vollansicht eines Artikels, und öffnen Sie es.
3. Fügen Sie eine sichtbare Zeile hinzu, zum Beispiel <p>Hello from my template</p>, und speichern Sie.
4. Laden Sie den Eintrag auf der Site neu: Die Zeile ist da.

Wie der Editor Overrides anlegt, ordnet und bearbeitet: Template-Editor.

Über Dateien (was Sie in die Versionsverwaltung aufnehmen) #

1. Suchen Sie das Template, das darstellt, was Sie ändern möchten. Schalten Sie die Template-Pfad-Kommentare ein, um es im Seitenquelltext zu sehen: siehe Template-Pfad-Kommentare.
2. Kopieren Sie die Datei von ihrem Ort (zum Beispiel design/standard/templates/) unter denselben relativen Pfad im Verzeichnis Ihres Designs design/<design>/templates/ (oder dessen override/templates/) und bearbeiten Sie die Kopie.
3. Wenn Sie einen neuen Template-Pfad hinzugefügt statt eine bestehende Datei geändert haben, leeren Sie einmal die Template-Caches: php bin/php/ezcache.php --clear-all --allow-root-user.

In welcher Reihenfolge Designs und Overrides versucht werden, steht in Reihenfolge der Template-Overrides und Ladereihenfolge der Extensions.

8. Wenn etwas schiefgeht #

Siehe auch #