Bitte verwenden sie die "Drucken" Funktion am Seitenende, um ein PDF zu erstellen.
PHP Composer ist ein Paketmanager für PHP. Er hilft Ihnen dabei, externe Code-Bausteine (Bibliotheken) in Ihre eigenen Projekte einzubinden. Composer sorgt automatisch dafür, dass auch alle Hintergrundprogramme, die diese Bausteine benötigen (die sogenannten Abhängigkeiten), in der richtigen Version heruntergeladen werden.
In dieser Anleitung erfahren Sie, wie Sie Composer auf Ihrem IONOS Webspace herunterladen, installieren und das erste Mal starten.
Voraussetzungen
- Ein IONOS Webhosting-Paket mit SSH-Zugriff
Falls Ihr Paket keinen SSH-Zugriff unterstützt, können Sie in einen anderen Webhosting-Vertrag wechseln.
Wichtige Hinweise zur Ausführung von Befehlen
Um Composer auf Ihrem Webspace nutzen zu können, müssen Sie PHP-Skripte über die Kommandozeile (PHP-CLI) ausführen. Bevor Sie die Befehle in dieser Anleitung kopieren, beachten Sie bitte zwingend diese zwei Punkte:
1. Ihre aktive PHP-Version (WICHTIG)
Die folgenden Code-Beispiele verwenden X.X. Sie müssen X.X in allen Befehlen, die den Ausdruck wie phpX.X enthalten, zwingend durch die PHP-Version ersetzen, die Sie für Ihr konkretes Webprojekt nutzen (zum Beispiel php8.3 oder php8.4).
Achtung
Wenn Sie hier die falsche Version verwenden, lädt Composer möglicherweise inkompatible Code-Bausteine herunter, die im schlimmsten Fall zu Ausfällen auf Ihrer Website führen.
2. Ihr Vertragsdatum
Der genaue Aufbau des Befehls hängt zusätzlich davon ab, wann Sie Ihren Webhosting-Vertrag bestellt haben. Alle Befehle in dieser Anleitung sind daher in zwei Varianten angegeben:
- Verträge bis 17.09.2025: Sie benötigen den Zusatz -cli (Beispiel für PHP 8.4: php8.4-cli).
- Verträge ab 18.09.2025: Der Zusatz entfällt (Beispiel für PHP 8.4: php8.4).
Hinweis
Verwenden Sie nicht den simplen Befehl php ohne Versionsnummer, da das Skript sonst mit einer veralteten PHP-Version ausgeführt wird. Eine vollständige Liste aller verfügbaren PHP-Versionen finden Sie im Artikel PHP-CLI: Ausführen von PHP-Dateien über die Kommandozeile.
Schritt-für-Schritt-Anleitung
Schritt 1: SSH-Verbindung herstellen
Starten Sie Ihren SSH-Client und verbinden Sie sich mit Ihrem Webspace. Anleitungen für verschiedene Betriebssysteme finden Sie in der Kategorie SSH-Zugänge einrichten und verwalten im Hilfe-Center.
Tipp
Sobald die Verbindung hergestellt ist, sehen Sie das Eingabefenster Ihres Terminals. Um Tippfehler zu vermeiden, kopieren Sie die Befehle aus den folgenden Code-Boxen am besten heraus und fügen Sie diese in Ihr Terminal ein. Drücken Sie anschließend nach jedem Befehl die Eingabetaste (Enter), um ihn auszuführen.
Schritt 2: Installationsverzeichnis vorbereiten
Das Verzeichnis, in dem Composer installiert wird, hängt von Ihrem Vertrag ab.
Verträge bis 17.09.2025:
Bei älteren Verträgen ist Ihr Home-Verzeichnis (~) gleichzeitig das Verzeichnis htdocs. Dieses dient als sogenannter Document Root, also das Hauptverzeichnis Ihrer Website. Das bedeutet, dass Dateien in diesem Verzeichnis prinzipiell von jedem über das Internet aufgerufen werden können.
Erstellen Sie daher aus Sicherheitsgründen daher ein eigenes Unterverzeichnis für Composer und schützen Sie es per .htaccess-Datei vor externen Zugriffen. Der folgende Befehl erstellt den Ordner und blockiert sofort den Zugriff über den Webbrowser:
mkdir ~/composer
echo "Require all denied" > ~/composer/.htaccess
cd ~/composer
Achtung
Ohne die .htaccess-Datei wäre composer.phar potenziell über den Browser abrufbar. Stellen Sie sicher, dass die .htaccess-Datei im Verzeichnis vorhanden ist.
Verträge ab 18.09.2025:
Bei neueren Verträgen ist das Home-Verzeichnis nicht öffentlich erreichbar. Wechseln Sie in Ihr Home-Verzeichnis:
cd ~
Schritt 3: Composer-Installationsdatei herunterladen
Laden Sie die Installationsdatei von der offiziellen Composer-Website herunter.
Verträge bis 17.09.2025:
phpX.X-cli -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
Verträge ab 18.09.2025:
phpX.X -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
Schritt 4: Prüfsumme abgleichen (Sicherheitscheck)
Vergleichen Sie die Prüfsumme (auch „digitaler Fingerabdruck” genannt) der heruntergeladenen Datei. So stellen Sie sicher, dass die Datei während der Übertragung nicht beschädigt oder manipuliert wurde und es sich um die Originaldatei handelt. Da sich die Prüfsumme mit jedem Update ändert, rufen wir den aktuellen Hash automatisiert von der Composer-Infrastruktur ab.
Führen Sie die beiden Zeilen nacheinander aus:
Verträge bis 17.09.2025:
EXPECTED_CHECKSUM="$(phpX.X-cli -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
phpX.X-cli -r "if (hash_file('sha384', 'composer-setup.php') === '$EXPECTED_CHECKSUM') { echo 'Installer Verified'; } else { echo 'Installer Corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
Verträge ab 18.09.2025:
EXPECTED_CHECKSUM="$(phpX.X -r 'copy("https://composer.github.io/installer.sig", "php://stdout");')"
phpX.X -r "if (hash_file('sha384', 'composer-setup.php') === '$EXPECTED_CHECKSUM') { echo 'Installer Verified'; } else { echo 'Installer Corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
Hinweis
Wenn im Terminal Installer Verified ausgegeben wird, ist die Datei sicher und Sie können mit der Installation fortfahren. Steht dort Installer Corrupt, wurde die Datei automatisch gelöscht, da sie fehlerhaft oder kompromittiert war. Laden Sie die Datei in diesem Fall erneut herunter.
Schritt 5: Composer installieren
Führen Sie die Installationsdatei aus.
Verträge bis 17.09.2025:
phpX.X-cli composer-setup.php
Verträge ab 18.09.2025:
phpX.X composer-setup.php
Nach der Installation liegt die Datei composer.phar in dem Verzeichnis, in das Sie in Schritt 2 gewechselt sind. Die Endung .phar steht für PHP Archive – Sie können sich das wie eine ausführbare Programmdatei für PHP vorstellen.
Schritt 6: Installationsdatei entfernen (Aufräumen)
Die Datei composer-setup.php wird nun nicht mehr benötigt. Um Ihren Webspace sauber zu halten, sollten Sie sie löschen.
Verträge bis 17.09.2025:
phpX.X-cli -r "unlink('composer-setup.php');"
Verträge ab 18.09.2025:
phpX.X -r "unlink('composer-setup.php');"
Schritt 7: Installation prüfen
Testen Sie die Installation, indem Sie Composer direkt ausführen. Stellen Sie sicher, dass Sie sich im Verzeichnis befinden, in dem composer.phar liegt (siehe Schritt 2).
Verträge bis 17.09.2025:
phpX.X-cli composer.phar
Verträge ab 18.09.2025:
phpX.X composer.phar
Als Ergebnis wird eine Übersicht aller verfügbaren Composer-Kommandos angezeigt.
Schritt 8: Alias (Kurzbefehl) einrichten (optional)
Um Composer nicht immer mit dem vollständigen, langen Dateipfad aufrufen zu müssen, können Sie einen sogenannten Alias anlegen. Dabei handelt es sich um ein benutzerdefiniertes Tastenkürzel für die Kommandozeile.
Mit dem folgenden Befehl tragen Sie das Kürzel composer fest in Ihre persönliche Konfigurationsdatei (.bash_profile) ein:
Verträge bis 17.09.2025:
echo "alias composer='phpX.X-cli ~/composer/composer.phar'" >> ~/.bash_profile
Verträge ab 18.09.2025:
echo "alias composer='phpX.X ~/composer.phar'" >> ~/.bash_profile
Dieser Alias wird automatisch bei Ihrer nächsten SSH-Anmeldung wirksam. Um ihn sofort im aktuellen Fenster zu aktivieren, laden Sie die Konfiguration mit diesem Befehl neu:
source ~/.bash_profile
Danach genügt der Befehl composer, um Composer von jedem Verzeichnis aus zu starten.
Ergebnis prüfen
Die Installation war erfolgreich, wenn nach dem Ausführen von Composer eine Liste der verfügbaren Befehle und die installierte Composer-Version angezeigt werden.
Um Composer auf dem neuesten Stand zu halten, verwenden Sie den Befehl self-update. Wenn Sie den Alias aus Schritt 8 eingerichtet haben, können Sie composer self-update verwenden. Führen Sie den Befehl andernfalls direkt im Installationsverzeichnis aus:
Verträge bis 17.09.2025:
phpX.X-cli composer.phar self-update
Verträge ab 18.09.2025:
phpX.X composer.phar self-update
Fehlerbehebung
Das Terminal zeigt die Fehlermeldung “command not found” (oder “Kommando nicht gefunden”)
Sie haben wahrscheinlich den Befehl wörtlich mitsamt dem Platzhalter kopiert (z. B. phpX.X-cli). Bitte ersetzen Sie das X.X in dem Befehl durch die tatsächliche PHP-Version Ihres Web-Projekts (z. B. php8.2-cli oder php8.4-cli) und führen Sie den Befehl erneut aus.Der Befehl “composer” wird nicht gefunden
Der Kurzbefehl composer steht nur zur Verfügung, wenn Sie den Alias aus Schritt 8 eingerichtet haben. Prüfen Sie mit dem Befehl cat ~/.bash_profile ober der Alias korrekt eingetragen ist. Melden Sie sich anschließend erneut per SSH an oder führen Sie source ~/.bash_profile aus, damit die Änderungen geladen werden. Ohne Alias rufen Sie Composer direkt über den PHP-CLI-Befehl und composer.phar auf (siehe Schritt 8).Die Prüfsumme stimmt nicht überein ("Installer Corrupt")
Die heruntergeladene Datei war fehlerhaft oder kompromittiert und wurde automatisch gelöscht. Bitte führen Sie Schritt 3 (Download) und Schritt 4 (Prüfung) einfach erneut aus.PHP-Fehlermeldungen bei der Ausführung von Composer
Stellen Sie sicher, dass Sie nicht versehentlich eine falsche PHP-Version im Befehl verwendet haben. Sie müssen genau die PHP-Version angeben, die auch Ihr Web-Projekt nutzt (siehe Abschnitt “Wichtige Hinweise zur Ausführung von Befehlen”). Prüfen Sie außerdem, ob Sie den korrekten PHP-CLI-Befehl für Ihr Vertragsdatum verwenden (-cli bei älteren Verträgen).