Installer PHP Composer dans l'hébergement Web IONOS
Veuillez utiliser la fonction « Imprimer » au bas de la page pour créer un PDF.
PHP Composer est un gestionnaire de paquets pour PHP. Il vous aide à intégrer des modules de code externes (bibliothèques) dans vos propres projets. Composer veille automatiquement à ce que tous les programmes d'arrière-plan qui ont besoin de ces modules (ce que l'on appelle les dépendances) soient téléchargés dans la bonne version.
Dans ce guide, vous apprendrez comment télécharger et installer Composer sur votre espace Web IONOS et comment le lancer pour la première fois.
Condition préalable
- Vous disposez d'un pack d'hébergement Web IONOS avec accès SSH.
Si votre pack ne supporte pas l'accès SSH, vous pouvez passer à un autre contrat d'hébergement Web.
Remarques importantes sur l'exécution des commandes
Pour pouvoir utiliser Composer sur votre espace Web, vous devez exécuter des scripts PHP via la ligne de commande (PHP-CLI). Avant de copier les commandes de ce guide, veuillez impérativement tenir compte de ces deux points :
1. Votre version PHP active (IMPORTANT)
Les exemples de code suivants utilisent X.X. Vous devez impérativement remplacer X.X dans toutes les commandes qui contiennent l'expression comme phpX.X par la version de PHP que vous utilisez pour votre projet Web concret (par exemple php8.3 ou php8.4).
Attention
Si vous utilisez ici la mauvaise version, Composer risque de télécharger des blocs de code incompatibles qui pourraient engendrer des pannes sur votre site Web.
2. La date de votre contrat
La structure exacte de la commande dépend en outre de la date à laquelle vous avez commandé votre contrat d'hébergement Web. Toutes les commandes de ce guide sont donc indiquées dans deux variantes :
- Contrats jusqu'au 17/09/2025 : Vous avez besoin du complément -cli (exemple pour PHP 8.4 : php8.4-cli).
- Contrats à partir du 18/09/2025 : L'ajout n'est pas nécessaire (exemple pour PHP 8.4 : php8.4).
Remarque
N'utilisez pas la simple commande php sans numéro de version, sinon le script sera exécuté avec une version PHP obsolète. Pour une liste complète des versions de PHP disponibles, consultez l'article du Centre d'Assistance PHP-CLI : Exécuter des fichiers PHP via la ligne de commande.
Instructions pas à pas
Étape 1 : Établir une connexion SSH
Démarrez votre client SSH et connectez-vous à votre espace Web. Vous trouverez des instructions pour différents systèmes d'exploitation dans la catégorie Configurer et gérer les accès SSH du Centre d'Assistance.
Conseil
Dès que la connexion est établie, vous voyez la fenêtre de saisie de votre terminal. Pour éviter les erreurs de frappe, il est préférable de copier les commandes des boîtes de code suivantes et de les coller dans votre terminal. Appuyez ensuite sur la touche Entrée (Enter) après chaque commande pour l'exécuter.
Étape 2 : Préparer le répertoire d'installation
Le répertoire dans lequel Composer sera installé dépend de votre contrat.
Contrats jusqu'au 17/09/2025 :
Pour les contrats plus anciens, votre répertoire d'accueil (~) est également le répertoire htdocs. Celui-ci sert de "Document Root", c'est-à-dire de répertoire principal de votre site Web. Cela signifie que les fichiers de ce répertoire peuvent en principe être consultés par n'importe qui via Internet.
Pour des raisons de sécurité, créez donc un sous-répertoire spécifique pour Composer et protégez-le des accès externes par un fichier .htaccess. La commande suivante crée le dossier et bloque immédiatement l'accès via le navigateur Web :
mkdir ~/composer
echo "Require all denied" > ~/composer/.htaccess
cd ~/composer
Attention
Sans le fichier .htaccess, composer.phar serait potentiellement accessible via le navigateur. Assurez-vous que le fichier .htaccess est bien présent dans le répertoire.
Contrats à partir du 18/09/2025 :
Pour les contrats plus récents, le répertoire d'accueil n'est pas accessible au public. Rendez-vous dans votre répertoire d'accueil :
cd ~
Étape 3 : Télécharger le fichier d'installation de Composer
Téléchargez le fichier d'installation sur le site officiel de Composer.
Contrats jusqu'au 17/09/2025 :
phpX.X-cli -r "copy('https://getcomposer.org/installer', 'composer-setup.php') ;"
Contrats à partir du 18/09/2025 :
phpX.X -r "copy('https://getcomposer.org/installer', 'composer-setup.php') ;"
Étape 4 : Comparer la somme de contrôle (contrôle de sécurité)
Comparez la somme de contrôle (également appelée "empreinte digitale numérique") du fichier téléchargé. Vous vous assurez ainsi que le fichier n'a pas été endommagé ou manipulé pendant le transfert et qu'il s'agit bien du fichier original. Comme la somme de contrôle change à chaque mise à jour, nous récupérons le hash actuel de l'infrastructure Composer de manière automatisée.
Exécutez les deux lignes l'une après l'autre :
Contrats jusqu'au 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 ;"
Contrats à partir du 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 ;"
Remarque
Si le terminal affiche Installer Verified, le fichier est sûr et vous pouvez poursuivre l'installation. Si Installer Corrupt est affiché, le fichier a été automatiquement supprimé car il était erroné ou compromis. Dans ce cas, téléchargez à nouveau le fichier.
Étape 5 : Installer Composer
Exécutez le fichier d'installation.
Contrats jusqu'au 17/09/2025 :
phpX.X-cli composer-setup.php
Contrats à partir du 18/09/2025 :
phpX.X composer-setup.php
Après l'installation, le fichier composer.phar se trouve dans le répertoire vers lequel vous avez basculé à l'étape 2. L'extension .phar signifie PHP Archive - vous pouvez vous l'imaginer comme un fichier de programme exécutable pour PHP.
Étape 6 : Supprimer le fichier d'installation (nettoyage)
Le fichier composer-setup.php n'est maintenant plus nécessaire. Pour garder votre espace Web propre, vous devriez le supprimer.
Contrats jusqu'au 17/09/2025 :
phpX.X-cli -r "unlink('composer-setup.php') ;"
Contrats à partir du 18/09/2025 :
phpX.X -r "unlink('composer-setup.php') ;"
Étape 7 : Vérifier l'installation
Testez l'installation en exécutant directement Composer. Assurez-vous que vous vous trouvez bien dans le répertoire où se trouve composer.phar (voir étape 2).
Contrats jusqu'au 17/09/2025 :
phpX.X-cli composer.phar
Contrats à partir du 18/09/2025 :
phpX.X composer.phar
Le résultat est un aperçu de toutes les commandes Composer disponibles.
Étape 8 : Configurer un alias (raccourci) (facultatif)
Pour ne pas devoir toujours accéder à Composer via le long chemin d'accès complet au fichier, vous pouvez créer ce que l'on appelle un alias. Il s'agit d'un raccourci clavier défini par l'utilisateur pour la ligne de commande.
Avec la commande suivante, vous inscrivez le raccourci composer de manière fixe dans votre fichier de configuration personnel (.bash_profile) :
Contrats jusqu'au 17/09/2025 :
echo "alias composer='phpX.X-cli ~/composer/composer.phar'" >> ~/.bash_profile
Contrats à partir du 18/09/2025 :
echo "alias composer='phpX.X ~/composer.phar'" >> ~/.bash_profile
Cet alias prendra automatiquement effet lors de votre prochaine connexion SSH. Pour l'activer immédiatement dans la fenêtre actuelle, rechargez la configuration avec cette commande :
source ~/.bash_profile
Ensuite, il suffit d'utiliser la commande composer pour lancer Composer à partir de n'importe quel répertoire.
Vérifier le résultat
L'installation a réussi si, après avoir exécuté Composer, une liste des commandes disponibles et la version de Composer installée s'affichent.
Pour maintenir Composer à jour, utilisez la commande self-update. Si vous avez configuré l'alias de l'étape 8, vous pouvez utiliser composer self-update. Dans le cas contraire, exécutez la commande directement dans le répertoire d'installation :
Contrats jusqu'au 17/09/2025 :
phpX.X-cli composer.phar self-update
Contrats à partir du 18/09/2025 :
phpX.X composer.phar self-update
Dépannage
Le terminal affiche le message d'erreur "command not found" (ou "commande introuvable")
Vous avez probablement copié la commande littéralement, y compris le caractère générique (par exemple phpX.X-cli). Veuillez remplacer le X.X dans la commande par la version PHP réelle de votre projet Web (par exemple php8.2-cli ou php8.4-cli) et exécutez à nouveau la commande.La commande "composer" est introuvable
Le raccourci composer n'est disponible que si vous avez configuré l'alias de l'étape 8. Vérifiez avec la commande cat ~/.bash_profile si l'alias est correctement enregistré. Ensuite, connectez-vous à nouveau via SSH ou exécutez source ~/.bash_profile pour charger les modifications. Sans alias, accédez à Composer directement via la commande PHP-CLI et composer.phar (voir étape 8).La somme de contrôle ne correspond pas ("Installer Corrupt")
Le fichier téléchargé était erroné ou compromis et a été automatiquement supprimé. Veuillez simplement exécuter à nouveau l'étape 3 (téléchargement) et l'étape 4 (vérification).Messages d'erreur PHP lors de l'exécution de Composer
Assurez-vous que vous n'avez pas utilisé par inadvertance une mauvaise version de PHP dans la commande. Vous devez indiquer exactement la version de PHP utilisée par votre projet Web (voir la section "Remarques importantes sur l'exécution des commandes"). Vérifiez également que vous utilisez la commande PHP CLI correcte pour la date de votre contrat(-cli pour les contrats plus anciens).