Comment installer PHP Composer sur un hébergement partagé/virtuel : Un guide complet

PHP Composer est le gestionnaire de dépendances de facto pour PHP, permettant aux développeurs de déclarer, installer et gérer les bibliothèques dont leurs projets dépendent. Que vous construisiez une application Laravel, une API Symfony ou un projet PHP personnalisé, Composer est un outil indispensable dans votre flux de travail.

Ce guide complet vous guide à travers chaque étape de l’installation de PHP Composer sur un environnement d’hébergement virtuel ou partagé — de l’accès SSH à la configuration globale et à l’utilisation réelle.

Qu’est-ce que PHP Composer et pourquoi en avez-vous besoin ?

PHP Composer est un gestionnaire de paquets qui gère la gestion des dépendances au niveau du projet. Au lieu de télécharger manuellement les bibliothèques et de gérer le chargement automatique, Composer résout les dépendances automatiquement, télécharge les bonnes versions et génère un chargeur automatique optimisé.

Les avantages clés incluent :

• Résolution automatique des dépendances — Composer gère les conflits de version et les dépendances imbriquées.
• Builds reproductibles — Le fichier composer.lock garantit que chaque membre de l’équipe et chaque environnement de déploiement utilise des versions de paquets identiques.
• Écosystème vaste — Accès à plus de 350 000 paquets sur Packagist, le référentiel Composer par défaut.
• Chargement automatique PSR-4 — Élimine les déclarations manuelles require et include dans votre base de code.

Si vous exécutez des applications PHP sur Shared Web Hosting ou un environnement VPS Hosting, installer Composer est l’une des premières étapes vers un flux de travail de développement professionnel et maintenable.

Prérequis

Avant de commencer, confirmez que les exigences suivantes sont satisfaites :

> Remarque : Si vous êtes sur un plan d’hébergement partagé géré sans accès SSH, contactez votre fournisseur d’hébergement pour l’activer. Les plans Shared Web Hosting d’AlexHost incluent l’accès SSH, vous donnant le contrôle dont vous avez besoin.

Étape 1 : Connectez-vous à votre serveur via SSH

Ouvrez votre application terminal et établissez une connexion SSH à votre compte d’hébergement :

ssh username@yourdomain.com

Remplacez username par votre nom d’utilisateur SSH réel et yourdomain.com par votre nom de domaine ou adresse IP du serveur.

Exemple :

ssh john@203.0.113.45

Une fois authentifié, vous arriverez dans votre répertoire personnel (généralement /home/username/). Vous pouvez confirmer votre emplacement actuel avec :

pwd

Étape 2 : Vérifiez que PHP est disponible

Avant de télécharger Composer, confirmez que PHP est installé et accessible depuis la ligne de commande :

php -v

Vous devriez voir une sortie similaire à :

PHP 8.2.10 (cli) (built: Sep  5 2023 08:15:22) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies

Si PHP n’est pas trouvé, ou si la version est inférieure à 7.2, contactez votre fournisseur d’hébergement ou mettez à niveau votre environnement. Les utilisateurs d’un plan VPS Hosting ont un contrôle total pour installer ou mettre à jour les versions de PHP selon les besoins.

Vérifiez également que les extensions requises sont chargées :

php -m | grep -E 'openssl|phar|mbstring|json'

Les quatre extensions doivent apparaître dans la sortie.

Étape 3 : Téléchargez le programme d’installation de Composer

Composer fournit un script d’installation officiel basé sur PHP. Téléchargez-le à l’aide de la commande suivante :

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"

Cela télécharge le script d’installation composer-setup.php dans votre répertoire de travail actuel.

Étape 4 : Vérifiez l’intégrité du programme d’installation

Cette étape est critique pour la sécurité. Vérifiez toujours le hash SHA-384 du programme d’installation avant de l’exécuter pour vous assurer que le fichier n’a pas été altéré ou corrompu lors du téléchargement.

4a. Récupérez le hash attendu à partir de la page officielle des clés publiques de Composer :

Visitez https://composer.github.io/pubkeys.html pour récupérer le dernier hash du programme d’installation.

4b. Exécutez la commande de vérification :

HASH="$(php -r "echo hash_file('sha384', 'composer-setup.php');")"

Ensuite, comparez-le avec le hash publié :

php -r "if (hash_file('sha384', 'composer-setup.php') === '$HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Si vous voyez « Installer verified », continuez. Si vous voyez « Installer corrupt », arrêtez immédiatement, supprimez le fichier et téléchargez-le à nouveau.

Vous pouvez également utiliser la commande d’une seule ligne de la documentation officielle de Composer, en remplaçant EXPECTED_HASH par la valeur de la page des clés publiques :

php -r "if (hash_file('sha384', 'composer-setup.php') === 'EXPECTED_HASH') { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"

Étape 5 : Exécutez le programme d’installation de Composer

Avec le programme d’installation vérifié, exécutez-le pour installer Composer :

php composer-setup.php

Après une exécution réussie, vous verrez une sortie comme :

All settings correct for using Composer
Downloading...

Composer (version 2.x.x) successfully installed to: /home/username/composer.phar
Use it: php composer.phar

Un fichier composer.phar est maintenant créé dans votre répertoire actuel. À ce stade, vous pouvez déjà utiliser Composer en appelant php composer.phar, mais le rendre accessible globalement est beaucoup plus pratique.

Étape 6 : Nettoyez le script du programme d’installation

Supprimez le script de configuration car il n’est plus nécessaire :

php -r "unlink('composer-setup.php');"

Étape 7 : Installez Composer globalement

Pour exécuter Composer n’importe où sur votre système en utilisant simplement la commande composer, déplacez le binaire composer.phar vers un répertoire inclus dans le $PATH de votre système.

Sur un VPS ou serveur dédié (avec accès sudo) :

sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Sur un hébergement partagé (sans accès sudo) :

Si vous n’avez pas de privilèges sudo, installez Composer localement dans votre répertoire personnel :

mkdir -p ~/bin
mv composer.phar ~/bin/composer
chmod +x ~/bin/composer

Ensuite, ajoutez ~/bin à votre $PATH en ajoutant la ligne suivante à votre ~/.bashrc ou ~/.bash_profile :

export PATH="$HOME/bin:$PATH"

Rechargez la configuration du shell :

source ~/.bashrc

> Conseil professionnel : Si vous avez besoin d’un accès root complet et d’un meilleur contrôle sur votre environnement PHP, envisagez de passer à un plan VPS Hosting ou un Dedicated Server pour une configuration sans restriction au niveau du système.

Étape 8 : Vérifiez l’installation

Confirmez que Composer est installé et accessible globalement :

composer --version

Sortie attendue :

Composer version 2.x.x 2024-xx-xx xx:xx:xx

Pour un diagnostic complet de votre environnement, exécutez :

composer diagnose

Cette commande vérifie votre configuration PHP, la connectivité réseau et les paramètres de Composer, signalant tout problème potentiel.

Étape 9 : Utilisation de Composer pour gérer les dépendances PHP

Maintenant que Composer est installé, voici comment l’utiliser efficacement dans vos projets PHP.

9a. Initialisez un nouveau projet

Accédez à votre répertoire de projet et initialisez un nouveau projet Composer :

cd /path/to/your/project
composer init

L’assistant interactif vous demandera :

• Nom du paquet (par exemple, yourname/project)
• Description
• Informations sur l’auteur
• Stabilité minimale
• Dépendances requises

Cela génère un fichier composer.json — le cœur de la configuration des dépendances de votre projet.

9b. Installez un paquet

Pour ajouter une bibliothèque à votre projet, utilisez la commande require :

composer require vendor/package-name

Exemples réels :

# Install Guzzle HTTP client
composer require guzzlehttp/guzzle

# Install Carbon date library
composer require nesbot/carbon

# Install Monolog logging library
composer require monolog/monolog

Composer résoudra les dépendances, téléchargera les paquets dans le répertoire vendor/ et mettra à jour composer.json et composer.lock.

9c. Installez toutes les dépendances de composer.json

Lors du déploiement d’un projet ou du clonage d’un référentiel, installez toutes les dépendances déclarées avec :

composer install

Pour les environnements de production, utilisez le drapeau --no-dev pour ignorer les paquets de développement uniquement :

composer install --no-dev --optimize-autoloader

9d. Mettez à jour les dépendances

Pour mettre à jour tous les paquets vers leurs dernières versions autorisées :

composer update

Pour mettre à jour un paquet spécifique :

composer update vendor/package-name

9e. Chargement automatique

Composer génère automatiquement un chargeur automatique. Incluez-le en haut de votre point d’entrée PHP :

<?php
require 'vendor/autoload.php';

Cette seule ligne vous donne accès à tous les paquets installés et à tous les espaces de noms personnalisés que vous définissez dans composer.json.

Dépannage des problèmes courants

Gardez Composer à jour

Composer inclut un mécanisme de mise à jour automatique intégré. Exécutez la commande suivante périodiquement pour vous assurer que vous avez la dernière version :

composer self-update

Pour revenir à la version précédente si nécessaire :

composer self-update --rollback

Rester à jour vous permet de bénéficier des derniers correctifs de sécurité, corrections de bogues et améliorations de performance.

Choisir le bon environnement d’hébergement pour le développement PHP

L’environnement d’hébergement que vous choisissez a un impact significatif sur votre capacité à utiliser efficacement des outils comme Composer.