cPanel #

Diese Seite ist für Hosting-Anbieter, die Server mit cPanel betreiben und Exponential darauf anbieten möchten. Sie beantwortet, was die Quellen von Exponential über cPanel sagen, was das in der Praxis bedeutet und wie Sie es testen, bevor Sie es verkaufen. Das Projekt hat Exponential nicht auf cPanel laufen sehen; diese Seite trennt daher sorgfältig, was die Quellen sagen, von allgemeinen Ratschlägen.

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.

Hinweis Die Quellen von Exponential beschreiben keine Bildschirme oder Menüs von cPanel. Wo diese Seite eine Funktion des Panels nennt, tut sie es allgemein („die PHP-Auswahl des Panels“, „die Cron-Seite des Panels“); lesen Sie die Namen und Schritte Ihrer Version in der Dokumentation von cPanel nach.

Inhalt #

1. Was die Quellen sagen
2. Was es in der Praxis bedeutet
3. Ein Konto einrichten (allgemein)
4. Composer auf cPanel
5. Velocity auf cPanel
6. Ein Testplan
7. Checkliste

Was die Quellen sagen #

Das ist alles, was die Quellen speziell über cPanel sagen.

Was es in der Praxis bedeutet #

Die Anforderungen von Exponential hängen nicht vom Panel ab. Ein cPanel-Konto, das Folgendes bietet, führt Exponential aus, nach derselben Überlegung, die cPanel in Stufe 3 einordnet:

• PHP 8.0 oder später (PHP 7.4 ohne Support nutzbar) für das Konto, mit den erforderlichen Erweiterungen: dom, libxml, simplexml, xsl, mbstring, iconv, intl, pcre, json, session, zlib, eine Datenbankerweiterung, gd oder ImageMagick (2.3 PHP-Erweiterungen). xsl und intl sind kritische Tests des Setup-Assistenten und fehlen am häufigsten in einem Standard-Build von PHP.
• Die php.ini-Werte, die der Assistent prüft (2.5).
• Apache (oder LiteSpeed), das .htaccess liest, mit mod_rewrite.
• Eine Datenbank: 1. SQLite 3 braucht keine; sonst einer der Server in der offiziellen Reihenfolge, 2. PostgreSQL · 3. MongoDB · 4. MariaDB · 5. Oracle · 6. MySQL (Microsoft SQL Server ist derzeit bekanntermaßen mit zusätzlicher Arbeit möglich). Auf einem typischen cPanel-Server ist das der Server für MariaDB oder MySQL, den das Panel verwaltet.
• Ein Cronjob für runcronjobs.php.

Ein Konto einrichten (allgemein) #

Das Folgende ist ein allgemeiner Ratschlag, abgeleitet aus den Anforderungen von Exponential, nicht aus der Dokumentation von cPanel:

1. Wählen Sie PHP 8.x für das Konto in der PHP-Auswahl des Panels, und aktivieren Sie die erforderlichen Erweiterungen in den Einstellungen für Erweiterungen des Panels. Nutzen Sie dieselbe Version für die Kommandozeile, wenn das Konto eine Shell hat.
2. Richten Sie den Document Root der Domain auf das Wurzelverzeichnis der Installation (das Verzeichnis mit index.php).
3. Kopieren Sie die Rewrite-Regeln: cp .htaccess_root .htaccess (oder laden Sie .htaccess_root als .htaccess hoch) (8.5.1). Mit dem Terminal von cPanel (oder SSH) erledigt das die Konsole, als Benutzer des Kontos: php bin/php/console exp:setup:htaccess --apply, und php bin/php/console exp:setup:config --apply für config.php. Ohne Shell kopieren Sie die Dateien im File Manager (er blendet Punktdateien aus, bis Sie „Show Hidden Files“ einschalten) (.htaccess und config.php von der Konsole einrichten).
4. Legen Sie die Datenbank und ihren Benutzer im Panel an, wenn nicht SQLite. Für MariaDB oder MySQL nutzen Sie utf8mb4 (9.3). Seit 6.0.15 braucht der Assistent nur Rechte auf diese Datenbank (Eine saubere Installation, die zu Shared Hosting passt).
5. Laden Sie den Code mit vendor/ hoch, oder führen Sie Composer in einer Shell aus, wenn es eine gibt (nächster Abschnitt).
6. Öffnen Sie den Setup-Assistenten im Browser und folgen Sie seiner Systemprüfung (Kapitel 5).
7. Fügen Sie die Cron-Zeile auf der Cron-Seite des Panels hinzu, mit dem PHP des Kontos (Cron und Shell-Zugang).
8. Installieren Sie das Zertifikat mit der Zertifikatsverwaltung des Panels und leiten Sie HTTP auf HTTPS um (TLS-Zertifikate in Panels).

Warnung Löschen Sie keine Regeln aus .htaccess, damit etwas funktioniert. Die Regeln entscheiden, welche Dateien Apache ausliefern darf; alles andere geht an index.php, was settings/*.ini und die SQLite-Datenbank privat hält (13.2).

Composer auf cPanel #

• Mit einer Shell: Führen Sie composer install mit der PHP-Version des Kontos aus, damit Composer Pakete für das PHP auflöst, das sie ausführen wird (Kommandozeile und Web-PHP).
• In der Administration: Die Erweiterung ezupdate durchsucht unter ihren Standardorten für Composer /opt/cpanel/composer/bin/ und kann mit Get Composer ein per SHA-256 geprüftes composer.phar nach var/ezupdate/ herunterladen. Aktualisieren und Installieren aus dem Browser sind aus, bis [UpdateSettings] AllowUpdate und AllowInstall eingeschaltet sind (ezupdate).
• Ohne beides: Bauen Sie den Baum mit composer install anderswo, auf derselben PHP-Version, und laden Sie ihn hoch.

Velocity auf cPanel #

Velocity ist ein lang laufender Prozess. Auf geteilten cPanel-Konten ist es womöglich nicht erlaubt; die Antwort der Quellen ist Apache oder LiteSpeed mit .htaccess. Auf einem cPanel-Server, auf dem Sie als Hoster die Maschine kontrollieren, könnte Velocity neben dem Apache des Panels laufen wie auf dem Plesk-Server des Projekts, aber diese Kombination ist in den Quellen nicht beschrieben. Wenn Sie es versuchen, lesen Sie Velocity neben Apache oder nginx und halten Sie die Regel eines Benutzers für var/ ein (8.7.2).

Ein Testplan #

Verwandeln Sie Stufe 3 auf Ihrer eigenen Plattform in einen Beleg, bevor Kunden davon abhängen:

Wenn alles besteht, möchte das Projekt davon hören: Wenn Sie Exponential auf einem System der Stufe 3 betreiben, teilen Sie es dem Projekt mit, und die Zeile rückt auf (Die vier Stufen).

Checkliste #

• To do: PHP 8.x mit xsl, intl und den anderen erforderlichen Erweiterungen für das Konto.
• To do: Document Root im Wurzelverzeichnis der Installation; .htaccess aus .htaccess_root.
• To do: Datenbank (oder SQLite) bereit; UTF-8.
• To do: vendor/ vorhanden; Weg für Composer entschieden.
• To do: Cron-Zeile mit dem PHP des Kontos.
• To do: Zertifikat und Umleitung auf HTTPS.
• To do: Der Testplan hat auf Ihrer Plattform bestanden.

Eine öffentliche Demo auf cPanel. Setzen Sie EXP_DEMO_MODE=1 nur für das Konto der Demo: SetEnv EXP_DEMO_MODE 1 in der .htaccess der Website (Apache oder LiteSpeed) und EXP_DEMO_MODE=1 in einer eigenen Zeile oben in den Cronjobs des Kontos. Demomodus für Hoster, Beispiele für den Demomodus.

Der Seiten-Cache von LiteSpeed unter cPanel. Mit LiteSpeed als Webserver beantwortet sein Seiten-Cache anonyme Besucher und Crawler ohne PHP. Schalten Sie ihn je Website mit dem auskommentierten Block aus .htaccess_root in der .htaccess des Kontos ein, oder als Include-Datei unter /etc/apache2/conf.d/userdata/ssl/2_4/<user>/<domain>/ (litespeed-page-cache.conf). Schritt für Schritt: Seiten-Caching mit LiteSpeed und OpenLiteSpeed.

Verwandte Seiten #

• Control Panels: Überblick, DirectAdmin
• Shared Hosting
• Der Setup-Assistent auf Shared Hosting
• .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.