Installer des dépendances PHP avec Composer sur l'hébergement

Composer installe les bibliothèques PHP dont un projet a besoin à partir de composer.json. Lorsque composer.lock existe, il peut reproduire les versions que vous avez testées. Il est disponible depuis SSH et le terminal de cPanel.

Vérifier l'environnement

Ouvrez le terminal et exécutez :

php -v
composer --version
php --ini

Ces commandes affichent le PHP de la ligne de commande, qui est généralement la version générale sélectionnée dans le sélecteur PHP de cPanel, avec ses modules, même si ce n'est pas toujours le cas. Si ce n'est pas la version de votre site, si le site a une autre version fixée pour son dossier ou si une commande en nécessite une autre, utilisez le chemin de son binaire, y compris pour Composer : /opt/alt/php84/usr/bin/php "$(command -v composer)" install. Avant d'installer, vérifiez les prérequis du projet et les extensions de l'interpréteur qu'utilisera Composer.

Si composer n'apparaît pas, vérifiez command -v composer et demandez à l'assistance le chemin disponible sur votre compte. Vous n'avez pas besoin de privilèges d'administrateur pour gérer les dépendances du projet.

Installer les versions testées

Travaillez dans le dossier qui contient composer.json et composer.lock, de préférence dans une nouvelle release ou un environnement de test :

cd /home/usuario/apps/mi-proyecto &&
composer install --no-dev --prefer-dist --no-interaction --optimize-autoloader &&
composer check-platform-reqs --no-dev

Remplacez le chemin par celui de votre projet. L'exemple omet les dépendances de développement pour une installation de production ; votre processus de test peut en avoir besoin. Si le fichier de verrouillage manque, préparez-en un et testez-le en développement avant de déployer.

composer update résout de nouvelles versions et modifie le fichier de verrouillage. Utilisez-le dans le cadre du processus de mise à jour en développement, examinez la modification et testez l'application avant de la publier. Pour installer une release déjà testée, utilisez install. Consultez la différence entre install et update.

Composer peut exécuter des scripts et des plugins du projet pendant l'installation. Utilisez du code de confiance et vérifiez quelles opérations il effectue ; installer des dépendances n'est pas forcément une opération sans effet sur l'application.

Résoudre une extension manquante

Un message comme celui-ci indique que le PHP de Composer n'a pas une extension requise :

requires ext-zip * -> the requested PHP extension zip is missing from your system

Vérifiez la version avec php -v et ses modules avec php -m. Activez zip pour cette même version dans le sélecteur de modules PHP, vérifiez à nouveau et relancez l'installation.

Si vous devez exécuter avec un autre interpréteur, utilisez son chemin absolu avec une installation PHP de Composer dont vous avez vérifié le chemin. Changer de PHP dans un .htaccess ne change pas l'interpréteur de cette commande.

Ne contournez pas un prérequis non satisfait avec --ignore-platform-reqs : l'installation pourrait se terminer et l'application échouer à l'exécution. S'il manque une bibliothèque système ou si l'extension n'est pas disponible, vérifiez la compatibilité avec l'assistance.

Vérifier le résultat

Vérifiez que Composer se termine sans erreur, que vendor/autoload.php existe et que check-platform-reqs valide l'environnement réel. Testez ensuite le site et ses tâches planifiées. Cette vérification ne remplace pas les tests fonctionnels et ne contrôle pas le PHP web s'il est différent de celui du terminal.

En cas d'erreur de mémoire ou d'espace, vérifiez les ressources de l'offre et la taille des dépendances. Vous pouvez préparer un artefact dans un environnement compatible, mais vous devez vérifier ses prérequis sur l'hébergement avant de le publier.