Installer Composer sur son hébergement

Ce guide suit la page de téléchargement de Composer, relue le 15 octobre 2026, qui annonce la version 2.10.3.

Ce qu'il faut avant de commencer

• Un accès SSH : sur les offres Sérénité et Business, autorisez-le dans Plesk, rubrique « Accès SSH », en choisissant le shell complet /bin/bash plutôt que l'environnement isolé. Ce dernier ne voit pas les versions de PHP installées par Plesk, qu'il faut pour lancer Composer. Le chemin du réglage est dans Se connecter à son hébergement en SFTP.
• La version de PHP de votre site : elle se lit et se change dans Plesk, voir Changer la version de PHP. Pour un nouveau projet, prenez PHP 8.3.

Sur l'offre Départ, il n'y a pas de SSH, et Composer n'est pas disponible : les actions de déploiement Git y tournent dans un environnement isolé, sans Composer. Une parade est de déployer le dossier vendor déjà construit sur votre ordinateur.

Le bon PHP

Plesk installe chaque version de PHP dans son propre dossier, sous /opt/plesk/php/, avec son binaire dans bin/php. Une simple commande php dans le terminal ne lance pas forcément la version de votre site. Appelez donc PHP par son chemin complet. Pour PHP 8.3 :

/opt/plesk/php/8.3/bin/php -v

La réponse doit commencer par PHP 8.3. Remplacez 8.3 par la version de votre site si elle diffère.

Installer Composer dans votre espace

1. Connectez-vous en SSH : ssh [email protected], avec l'utilisateur système de votre abonnement. Vous arrivez dans votre dossier personnel.
2. Ouvrez getcomposer.org/download et copiez les quatre lignes d'installation, placées en tête de la page. La deuxième vérifie l'empreinte de l'installeur, qui change à chaque version : c'est pourquoi Composer demande de toujours reprendre ces lignes sur sa page, sans les recopier d'ailleurs.
3. Dans ces lignes, remplacez chaque php du début par /opt/plesk/php/8.3/bin/php, puis lancez-les une à une dans votre terminal. La deuxième doit répondre « Installer verified ».
4. Le fichier composer.phar apparaît dans votre dossier personnel. Vérifiez-le :

/opt/plesk/php/8.3/bin/php ~/composer.phar --version

L'installeur accepte l'option --install-dir pour choisir le dossier, et --filename pour nommer le fichier autrement : par exemple /opt/plesk/php/8.3/bin/php composer-setup.php --install-dir=bin --filename=composer. Sans droits d'administrateur, vous ne pouvez pas le placer dans les dossiers du système, et ce n'est pas nécessaire.

Utiliser Composer dans un projet

1. Placez-vous dans le dossier de votre projet, celui qui contient composer.json :

cd ~/httpdocs

2. Installez les dépendances décrites par composer.json et composer.lock :

/opt/plesk/php/8.3/bin/php ~/composer.phar install --no-dev

3. Pour ajouter une bibliothèque, par exemple PHPMailer :

/opt/plesk/php/8.3/bin/php ~/composer.phar require phpmailer/phpmailer

L'option --no-dev laisse de côté les outils de développement, inutiles sur le site en ligne. Pour ne pas répéter le chemin de PHP, un alias dans le fichier ~/.bashrc fait l'affaire :

alias composer='/opt/plesk/php/8.3/bin/php ~/composer.phar'

Rouvrez la session SSH : la commande composer suffit ensuite.

Dans un déploiement Git

Plesk peut récupérer un dépôt Git et lancer des commandes après chaque déploiement. D'après la documentation de Plesk, sans accès SSH complet ces commandes tournent dans un environnement isolé, où Composer n'est pas disponible : une commande composer install y fonctionne donc à partir de Sérénité, une fois le shell complet /bin/bash activé. La mise en place est dans Déploiement Git : mettre son site en ligne.

Ce que l'hébergement ne permet pas

Composer installe des bibliothèques PHP dans votre projet, pas des logiciels sur le serveur. Une bibliothèque qui exige une extension PHP absente, ou une version de PHP que nous ne proposons pas, refusera de s'installer : Composer le dit dans son message d'erreur. Les versions et extensions disponibles sont listées dans Spécificités techniques. Les réglages de PHP, comme la mémoire, se changent sur demande : voir Limites de PHP.

Questions fréquentes