Drupal auf Plesk installieren - Composer aktualisieren

Warum ist die Composer-Version auf Plesk wichtig?

Viele Webhoster liefern Plesk-Installationen mit einer veralteten Composer-Version aus – oft Version 2.2.5 aus dem Jahr 2022. Die aktuelle Version (Stand: April 2025) ist jedoch 2.8.8. Für Drupal und insbesondere für den neuen Projekt Browser ist eine aktuelle Composer-Version essenziell, da ältere Versionen zu Fehlern oder Inkompatibilitäten führen können.

Composer auf Plesk aktualisieren – so geht’s

Um Composer zu aktualisieren, benötigst du Root-Zugriff auf deinen Server. Das ist meist bei einem eigenen V-Server oder Root-Server der Fall. Falls du nur ein Plesk-Konto bei einem Hoster hast, der den Server verwaltet, musst du den Support bitten, Composer für dich zu aktualisieren.

1. Composer-Dateien finden

Öffne ein Terminal und wechsle ins Root-Verzeichnis:

cd /

Suche nach allen Composer-Dateien auf dem System:

find . -name "composer.phar" 

Typischerweise findest du mehrere Instanzen, z.B. unter:

• /opt/psa/var/modules/composer
• /opt/psa/admin/plib/modules/composer/resources/composer
• /usr/local/psa/admin/plib/modules/composer/resources/composer

Hinweis: Drupal sucht standardmäßig nach Composer im Verzeichnis /usr/bin oder /usr/local/bin. Dort liegen allerdings nur Skripte, die auf die Datei composer.phar in den oben angegebenen Verzeichnissen verweisen.

2. Die aktuelle Composer-Version prüfen

Image

Führe Composer mit PHP aus, um die aktuelle Version zu prüfen:

/opt/plesk/php/8.2/bin/php /usr/lib/plesk-9.0/composer.phar --version

Falls die Version veraltet ist, solltest du aktualisieren.

3. Composer aktualisieren (Self-Update)

Du kannst Composer an allen relevanten Stellen mit folgendem Skript aktualisieren:

/opt/plesk/php/8.2/bin/php /usr/lib/plesk-9.0/composer.phar --self-update

3.1 Composer automatisch aktualisieren

Untenstehend findest du ein Bashscript, dass es dir abnimmt alle vorkommenden Instanzen der Datei composer.phar auf deinem System manuell zu aktualisieren:

# Super User Warung unterdrücken.

export  COMPOSER_ALLOW_SUPERUSER=1 &&
# Compsoer automatisch aktualisieren.
/opt/plesk/php/8.2/bin/php /usr/lib/plesk-9.0/composer.phar self-update &&
/opt/plesk/php/8.2/bin/php  /opt/psa/admin/plib/modules/composer/resources/composer/composer.phar self-update && /opt/plesk/php/8.2/bin/php /opt/psa/var/modules/composer/composer.phar self-update && 
# Composer Version Überüüfen
/opt/plesk/php/8.2/bin/php /usr/lib/plesk-9.0/composer.phar --version &&
/opt/plesk/php/8.2/bin/php  /opt/psa/admin/plib/modules/composer/resources/composer/composer.phar --version && /opt/plesk/php/8.2/bin/php /opt/psa/var/modules/composer/composer.phar --version
# Umgebungsvariable entfernen um unterdrückte Warnung wieder zu aktivieren.
unset  COMPOSER_ALLOW_SUPERUSER

4. Manuelles Ersetzen der composer.phar

Alternativ kannst du die aktuelle composer.phar direkt von getcomposer.org herunterladen und die alte Datei ersetzen:

wget https://getcomposer.org/download/2.8.8/composer.phar -O /pfad/zur/composer.phar

Vergiss nicht, die Datei ausführbar zu machen:

chmod +x /pfad/zur/composer.phar

5. Backup und Rollback

Ein Vorteil der Self-Update-Methode: Composer legt automatisch ein Backup der alten Version unter /root/.local/share/composer an. Falls nach dem Update Probleme auftreten, kannst du mit folgendem Befehl zurückrollen

/opt/plesk/php/8.2/bin/php /usr/lib/plesk-9.0/composer.phar  self-update --rollback

Vergiss aber nicht, dass dass nur einmal klappt und dass du alle übrigen Instanzen von composer.phar ebenfalls downgraden musst, indem du die neue Version von Composer in allen oben genannten Verzeichnissen mit der Originalversion ersetzt z. B. so:

 cp -R composer.phar /opt/psa/var/modules/composer/ && cp -R composer.phar /opt/psa/var/modules/composer/

6. Funktionstest in Drupal

Prüfe nach deinen Anpassungen, ob das Modul Automatic Updates und andere Funktionen wieder wie erwartet laufen. In unserem Beispiel war nach dem Update die Aktualisierungsseite des Moduls Automatic Updates  wieder problemlos nutzbar undauch neue Module ließen komfortabel auch über die UI des Moduls Project-Bowser installieren.

Fazit:
Mit wenigen Schritten kannst du Composer auf deinem Plesk-Server aktualisieren und so sicherstellen, dass Drupal und seine Module einwandfrei funktionieren. Der Root-Zugang ist dabei Voraussetzung – falls du diesen nicht hast, hilft nur der Weg über den Hoster-Support. Im nächsten Teil der Serie kümmern wir uns darum, dass du Drupal CMS direkt auf deutsch nutzen kannst, was dir den Einstieg in Drupal wesentlich erleichtern wird.

Bleib dran!