Der Setup-Assistent auf Shared Hosting #

Diese Seite ist für Hoster, deren Kunden Exponential selbst im Browser installieren, typischerweise auf Shared Hosting ohne Shell-Zugang, und für die Support-Mitarbeitenden, die ihnen helfen. Sie beantwortet: was der Hoster vorbereiten muss, was der Kunde sieht und wie der Assistent die Website schützt, während er läuft. Die Referenz Seite für Seite ist Kapitel 5.

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.

Inhalt #

1. Wann der Assistent die richtige Wahl ist
2. Was der Hoster vorbereitet
3. Was der Kunde tut
4. Während er läuft
5. Nach dem Assistenten
6. Seiten mit kickstart.ini vorfüllen

Wann der Assistent die richtige Wahl ist #

Das Installationsbuch empfiehlt ihn für Shared Hosting ohne Shell-Zugang: Er braucht nur einen Browser und FTP-Zugang (4.5). Er ist außerdem die einzige Methode, die jede Entscheidung auf einer Seite mit einer Erklärung zeigt. Wenn Sie für den Kunden Befehle ausführen können, ist exp:install schneller und skriptfähig.

Was der Hoster vorbereitet #

Tipp Wenn .htaccess fehlt, verlangt die Seite Seitensicherheit des Assistenten sie mit cp .htaccess_root .htaccess und dem Hinweis, dass Sie die Datei ohne Shell-Zugang mit einem FTP-Client kopieren oder Ihren Hosting-Anbieter darum bitten müssen (5.3.13). Legen Sie sie vorab an, dann wird die Seite übersprungen.

Die Bereitstellung des Hosters kann das mit der Konsole erledigen, bevor der Kunde den Assistenten öffnet. Als root braucht die Kopie --allow-root-user und sollte dem Benutzer des Kontos gegeben werden:

cd /path/to/the/installation
php bin/php/console exp:setup:htaccess --apply --allow-root-user --owner=<konto-benutzer>:<konto-gruppe>
php bin/php/console exp:setup:config --apply --allow-root-user --owner=<konto-benutzer>:<konto-gruppe>   # optional

Ohne --owner erhält eine neue Datei den Eigentümer der Vorlage, aus der sie kopiert wird, niemals root. Einzelheiten: .htaccess und config.php von der Konsole einrichten.

Was der Kunde tut #

1. Er öffnet die Adresse der Website. Solange [SiteAccessSettings] CheckValidity=true gilt (der mitgelieferte Wert), erscheint die erste Seite des Assistenten, welchen Pfad man auch öffnet (5.1).
2. Er geht die Seiten durch: Willkommen, Systemtest, Mail, Datenbank, Sprachen, Seitenpaket, Siteaccesses, Details der Website, Administrator und die Installation selbst (5.3).
3. Er wählt ein Administratorpasswort. Der Assistent lehnt ein kurzes oder bekanntes ab (Das Standard-Administratorpasswort).
4. Er erreicht die Seite Beendet mit den Adressen der neuen Website.

Wenn der Systemtest scheitert, gibt er Ursache und Abhilfe aus, bei Berechtigungen die genauen Befehle chmod und chown; auf Shared Hosting kann diese oft nur der Hoster ausführen.

Während er läuft #

Der Assistent hält die Website für den Browser fest, der ihn gestartet hat (5.2):

• Der erste abgeschickte Schritt schreibt var/maintenance.json mit einer Frist von 15 Minuten, die jeder weitere Schritt erneuert.
• Jeder andere Besucher erhält HTTP 503 mit dem Hinweis, dass die Website eingerichtet wird.
• Die Seite Beendet beendet das Festhalten; ein verlassener Assistent hält die Website nicht vom Netz: Sobald die Frist abgelaufen ist, zählt die Markierung nicht mehr.

Nach dem Assistenten #

• CreateSites schreibt CheckValidity=false nach settings/override/site.ini.append.php; von da an wird die Website normal ausgeliefert, und der Assistent ist nicht mehr erreichbar.
• Auf einer installierten Website zeigt setup/init nur „Diese Website ist bereits installiert“ und schreibt nichts (5.2).
• Richten Sie die Crontab für den Kunden ein, wenn Ihr Panel ihn das nicht tun lässt (Cron und Shell-Zugang).
• Gehen Sie die Checkliste für den Start durch.

Seiten mit kickstart.ini vorfüllen #

Der Assistent liest kickstart.ini im Wurzelverzeichnis der Installation: Wenn er einen Abschnitt für einen Schritt findet, füllt er diese Seite vor oder überspringt sie, wenn der Abschnitt Continue=true sagt (4.1). Ein Hoster kann so die Datenbankseite mit der Datenbank füllen, die er angelegt hat, sodass der Kunde das Datenbankpasswort nie sieht. Entfernen Sie die Datei nach der Installation; sie enthält Passwörter im Klartext.

Eine öffentliche Demo über den Assistenten. Der Setup-Assistent liest EXP_DEMO_MODE=1 aus dem PHP des Webservers (zum Beispiel SetEnv in .htaccess); seine Seite Administrator der Seite zeigt dann einen Hinweis Demo-Modus und akzeptiert das veröffentlichte Passwort, auch publish. Demomodus für Hoster.

Verwandte Seiten #

• Ein-Klick-Installer
• Shared Hosting
• Apache mit PHP-FPM
• .htaccess und config.php von der Konsole einrichten
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.