Contao Erweiterungen per Konsole installieren

SSH-Zugang

Um Erweiterungen über die Konsole zu installieren, benötigst du einen SSH-Zugang zu deinem Server. Die meisten Hoster bieten mittlerweile einen solchen Zugang an. Möglicherweise musst du dafür ein Add-On erwerben oder zu einem höheren Tarif wechseln.

In einigen Fällen muss der SSH-Zugang zuerst freigeschaltet werden. Überprüfe dafür die Einstellungen im Control Panel deines Hosters.

Außerdem benötigst du die entsprechenden Zugangsdaten. Diese setzen sich aus dem Servernamen, dem Benutzernamen, dem Passwort und dem Port zusammen, wenn dieser vom Standardport 22 abweicht.

SSH-Client-Software

Je nach Betriebssystem gibt es unterschiedliche Software. Suche am besten bei deiner Suchmaschine des Vertrauens nach SSH Client.

Ich kann dir folgende Tools empfehlen:

• MacOS: Terminal, iTerm2, CoreShell, Hyper
• Windows: PuTTY, Solar-PuTTY, Termius, Hyper

Im Folgenden zeige ich dir exemplarisch einmal PuTTY und einmal direkt über iTerm2.

Nachdem die Verbindung zum Server erfolgreich hergestellt ist, kannst du prüfen, ob Composer bereits auf dem Server installiert ist.

composer -V

Wenn Composer installiert ist, erhältst du eine Ausgabe, die ähnlich wie in folgendem Screenshot aussieht.

Ein häufiges Problem ist, dass Composer nicht mit der korrekten PHP-Version ausgeführt wird. Die PHP-Version muss mit der PHP-Version deines Webservers übereinstimmen, auf dem Contao läuft. Daher solltest du zunächst den Pfad von Composer herausfinden. Verwende dazu:

which composer

Danach kannst du die korrekte PHP-Version angeben und den absoluten Pfad für Composer verwenden. Für PHP 8.3 könnte das so aussehen:

php83 /usr/bin/composer -V

Wenn Composer bisher nicht auf deinem Server vorhanden ist oder du sicherstellen möchtest, dass du die aktuellste Composer-Version nutzt, empfehle ich dir, Composer herunterzuladen. Wie das funktioniert, erkläre ich dir im nächsten Punkt.

Es gibt mehrere Möglichkeiten, Composer zu installieren. Du kannst ihn global auf dem Server installieren oder nur die ausführbare Datei in deine Contao-Installation laden. Weitere Informationen findest du unter: https://getcomposer.org/download/

Bei einem Shared-Hosting kannst du in der Regel keine Software in den geschützten Systempfaden installieren. Daher laden wir die ausführbare Version von Composer manuell herunter.

Composer herunterladen

Im ersten Schritt wechseln wir in unser Contao-Verzeichnis. Als Hilfestellung kannst du im Hosting Control Panel nachsehen, wo sich der Document Root deiner Installation befindet.

Mit dem Befehl cd [Verzeichnisname] kannst du in ein Verzeichnis wechseln. Mit dem Befehl ls kannst du dir die Verzeichnisse anzeigen lassen. Mit pwd erfährst du, wo du dich gerade befindest.

Beispiel: cd public/cto_53/

Nun können wir Composer herunterladen:

wget https://getcomposer.org/download/latest-stable/composer.phar

Composer testen

Zum Schluss überprüfen wir, ob Composer korrekt funktioniert:

php composer.phar -V

Wenn nicht die passende PHP-Version ausgeführt wird, musst du möglicherweise eine andere PHP-Binary verwenden. Häufig wird dazu nur die Version angehängt. Je nach Hoster sieht das dann zum Beispiel so aus:

php83 composer.phar -V
php8.3 composer.phar -V

Wenn alles geklappt hat, sind wir bereit und können Composer nutzen.

Nach der erfolgreichen Installation der Pakete musst du oft noch die nötigen Datenbankänderungen durchführen. Dafür kannst du den folgenden Befehl ausführen:

php83 vendor/bin/contao-console contao:migrate

Nun sollte die Erweiterung installiert sein und in Contao verwendet werden.

Mit Composer kannst du natürlich auch Pakete entfernen, Updates durchführen und viele weitere Informationen erhalten. Hier eine kleine Auswahl:

Pakete entfernen
Um ein Paket zu entfernen, verwendest du den Befehl:
composer remove paketname

Alle Pakete aktualisieren
Um alle Pakete zu aktualisieren, gib diesen Befehl ein:
composer update

Alle installierten Pakete anzeigen
Um dir eine Übersicht über alle installierten Pakete anzusehen, führe folgenden Befehl aus:
composer show