Installation von Contao 4.5 Managed Edition bei STRATO
Die nachfolgende Installationsanleitung beschreibt die Installation von Contao 4.5 Managed Edition auf einem STRATO PowerWeb Basic Webhosting-Paket.
- STRATO Kunden-Login (Admin-Panel) > Datenbanken und Webspace > FTP-Zugänge verwalten: Sofern noch nicht geschehen, sollte für den "generellen FTP-Zugang" ein Masterpasswort festgelegt werden (siehe auch: Sicherheit > Passwörter festlegen > Masterpasswort).
- STRATO Kunden-Login (Admin-Panel) > Datenbanken und Webspace > PHP-Version einstellen: PHP 7.1 oder 7.2 (oder neuer) auswählen (globale Einstellung)
Hinweis: Die PHP-Version kann auch ordnerspezifisch via AddType Direktive in der web/.htaccess festgelegt werden:
Code:
AddType application/x-httpd-php71 .php
- Via SSH-Client (z. B. PuTTY) mit dem STRATO Webspace verbinden:
- Hostname: ssh.strato.de
- Port: 22
- Für den Shell-Zugang im Konsolenfenster SSH-Benutzername (= Bezeichnung des generellen FTP-Zugangs, z. B. example.com) und SSH-Passwort (= FTP-Masterpasswort) eingeben.
- Im Wurzelverzeichnis des Hostingpakets (= absoluter Pfad /home/strato/www/ex/www.example.com/htdocs/) den Installationsordner (z. B. example.com/) für die Contao-Installation erstellen:
Code:
$ mkdir example.com/
- Die jeweils aktuellste stabile Version des Composer-Skripts z. B. per wget ins Wurzelverzeichnis des Hostingpakets laden:
Code:
$ wget https://getcomposer.org/download/1.6.4/composer.phar
- PHP-Version abfragen:
Code:
$ /opt/RZphp72/bin/php-cli -v
PHP sollte in der Konsole über die CLI-Binary ausgeführt werden!
- Contao Managed Edition via Composer installieren:
Code:
$ /opt/RZphp72/bin/php-cli composer.phar create-project contao/managed-edition <ziel> '4.5.*'
Anstelle von <ziel> muss in der Befehlszeile der zuvor erstellte Installationsordner für die Contao-Installation (z. B. example.com/) angegeben werden:
Code:
$ /opt/RZphp72/bin/php-cli composer.phar create-project contao/managed-edition example.com/ '4.5.*'
- Nach Abschluss der Installation via Composer kann die composer.phar in das Installationsverzeichnis der Contao-Installation verschoben werden:
Code:
$ mv composer.phar example.com/
- Falls die Installation der Contao Managed Edition mit einer Fehlermeldung
Code:
An error occurred while executing the "contao:install-web-dir" command
oder
Code:
The command is already running in another process
abbricht (d. h. das web/ Unterverzeichnis ist leer und es wurden auch keine Symlinks erstellt), müsste man das temporäre Verzeichnis selbst festlegen (z. B. system/tmp). Dazu könnte man beispielsweise in der vendor/bin/contao-console nach declare(strict_types=1); die folgenden Anweisungen einfügen:
Code:
putenv('TMP=/home/strato/www/ex/www.example.com/htdocs/example.com/system/tmp');
putenv('TEMP=/home/strato/www/ex/www.example.com/htdocs/example.com/system/tmp');
putenv('TMPDIR=/home/strato/www/ex/www.example.com/htdocs/example.com/system/tmp');
(Der absolute Pfad des Webhostings (/home/strato/www/ex/www.example.com/htdocs/) sowie der Installationsordner der Contao-Installation (example.com/) müssen natürlich entsprechend angepasst werden.)
Nachdem ein temporäres Verzeichnis über die Umgebungsvariablen festgelegt wurde, können die Installationsroutinen erneut via
Code:
$ cd example.com/
$ /opt/RZphp72/bin/php-cli composer.phar update -o
aufgerufen werden.
- STRATO Kunden-Login (Admin-Panel) > Domains > Domainverwaltung > Domain verwalten > Einstellungen (Domain) > Umleitung einrichten > intern: Das DocumentRoot bzw. Basisverzeichnis der Domain muss auf den web/ Unterordner der Contao-Installation zeigen (z. B. /example.com/web/).
- STRATO Kunden-Login (Admin-Panel) > Datenbanken und Webspace > Datenbankverwaltung > Datenbank anlegen: Sofern noch keine Datenbank existiert, kann hier eine neue Datenbank angelegt und ein DB-Passwort zugewiesen werden.
- Aufruf des Contao Installtools: https://example.com/contao/install
Wenn die Domain korrekt auf den web/ Unterordner der Contao-Installation zeigt, sollte man an dieser Stelle das Contao Installtool aufrufen können. Hier folgt man wie gewohnt den einzelnen Installationsschritten des Tools. Wichtig ist jedenfalls bei der Eingabe der Datenbankzugangsdaten, dass als DB-Host rdbms.strato.de angegeben wird (und nicht localhost).
- Sofern gewünscht, kann der Contao Manager ebenfalls einfach und schnell via Konsole ins web/ Verzeichnis geladen werden:
Code:
$ curl -L https://download.contao.org/contao-manager.phar -o web/contao-manager.phar.php
- Aufruf des Contao Manager und Festlegen der Zugangsdaten: https://example.com/contao-manager.phar.php
(Hinweis: Für Paketinstallationen und/oder -aktualisierungen wird der zugeteilte Paketspeicher des Webhostings allerdings nicht ausreichend sein, da das Auflösen der Abhängigkeiten mitunter sehr speicherintensiv sein kann. Diese Tasks müsste man also vorzugsweise auf der Konsole ausführen.)
