Composer est devenu l’un des outils essentiels pour le développement en PHP. Avec sa capacité à gérer efficacement les dépendances des projets, Composer simplifie grandement le processus de développement, en permettant aux développeurs d’intégrer facilement des bibliothèques tierces et des composants dans leurs applications.
Qu’est-ce que Composer ?
Composer est un outil informatique utilisé par les développeurs travaillant avec le langage de programmation PHP. On peut le voir comme un assistant personnel ou un gestionnaire de colis : au lieu de chercher et de télécharger manuellement un par un tous les morceaux de code extérieurs (appelés « bibliothèques ») dont un site web a besoin, Composer fait tout le travail à votre place.
Il sert principalement à installer, mettre à jour et organiser ces morceaux de code de manière automatique. Si votre projet a besoin d’une fonctionnalité précise, comme un système de paiement ou l’envoi d’e-mails, Composer va chercher le code créé par d’autres, l’installe proprement dans votre projet et s’assure que toutes les pièces fonctionnent bien ensemble sans se perturber.

Dans des termes plus techniques, Composer est un gestionnaire de dépendances pour PHP. Il permet aux développeurs de spécifier les bibliothèques dont leur projet dépend et de les installer automatiquement, en s’occupant également de leurs dépendances respectives. Contrairement aux méthodes précédentes de gestion des dépendances en PHP, Composer utilise un fichier de configuration simple appelé composer.json pour déclarer les dépendances d’un projet.
En programmation, une « dépendance » est un morceau de code extérieur dont votre projet a besoin pour fonctionner. C’est un peu comme une brique indispensable fabriquée par quelqu’un d’autre que vous intégrez à votre travail.
Fonctionnalités Principales de Composer
Installation Simple : Composer s’installe rapidement via une ligne de commande ou via un gestionnaire de paquets. Une fois installé, il suffit d’exécuter composer install dans le répertoire du projet, depuis le terminal, pour télécharger et installer toutes les dépendances spécifiées dans le fichier composer.json.
Gestion des Dépendances : Composer gère les versions des bibliothèques et des composants, garantissant ainsi la compatibilité entre les différentes versions des dépendances d’un projet.
Autoloading Automatique : Composer génère automatiquement un fichier d’autoloading, permettant aux développeurs d’accéder facilement aux classes des dépendances sans avoir à les inclure manuellement dans leur code. Tout se fait tout seul.
Réseau Mondial de Paquets : Composer utilise Packagist, un référentiel en ligne qui répertorie des milliers de bibliothèques ou script PHP. Les développeurs peuvent rechercher et intégrer des paquets provenant de cette source ou d’autres référentiels personnalisés.
Mises à Jour Simplifiées : Composer facilite la mise à jour des dépendances. En exécutant composer update, il vérifie automatiquement les mises à jour disponibles et met à jour les dépendances en conséquence, tout en respectant les contraintes de version spécifiées.
Installation de Composer
Composer s’installe sur ma machine ou sur mon serveur ?
Composer est installé sur votre machine, pas sur votre serveur. Il s’agit d’un outil de ligne de commande que vous utilisez localement pour gérer les dépendances de vos projets PHP depuis votre terminal.
Une fois que vous avez installé Composer sur votre machine, vous pouvez l’utiliser pour créer et gérer des projets PHP sur n’importe quel serveur où vous développez ou déployez vos applications.
Lorsque vous exécutez des commandes Composer telles que composer install ou composer update, elles sont exécutées sur votre machine locale et non sur votre serveur. Composer télécharge les bibliothèques et les dépendances nécessaires à partir d’Internet et les installe dans le répertoire que vous nommerez /vendor de votre projet, qui est ensuite inclus dans votre code source.

Une fois que les dépendances sont installées sur votre machine locale, vous pouvez déployer votre application sur votre serveur en incluant le répertoire /vendor dans votre déploiement. Ainsi, votre application peut fonctionner sur le serveur sans avoir besoin d’installer Composer sur ce dernier.
Vérifier que PHP est bien installé sur votre machine
Pour vérifier si PHP est installé sur votre système, vous pouvez ouvrir le terminal (Mac) ou l’invite de commande (Windows) et exécuter la commande suivante :
php -v
Cela affichera la version de PHP installée sur votre système, ainsi que des informations sur la configuration PHP.
Si PHP n’est pas installé, la commande php ne sera pas reconnue et vous recevrez un message d’erreur indiquant que la commande n’a pas été trouvée. Il vous faudra alors commencer par installer php.
Installer Composer sur Windows
Téléchargez et installez Composer : Vous pouvez télécharger l’installateur Composer pour Windows à partir du site officiel de Composer (https://getcomposer.org/download/). Choisissez l’option « Windows Installer » et suivez les instructions d’installation.
Exécutez l’installateur Composer : Une fois le fichier d’installation téléchargé, double-cliquez dessus pour lancer l’installateur. Suivez les étapes d’installation en choisissant les options appropriées.
Vérifiez l’installation : Après avoir installé Composer, ouvrez une nouvelle fenêtre d’invite de commandes (CMD) et exécutez la commande suivante pour vérifier que Composer est correctement installé :
composer --version
Installer Composer sur Mac
Ouvrez le terminal et utilisez la commande suivante pour télécharger l’installateur Composer :
curl -sS https://getcomposer.org/installer | php
Déplacez l’installateur Composer dans un emplacement accessible à tous les utilisateurs en utilisant la commande suivante. Commencez par créer le répertoire /usr/local/bin :
sudo mkdir -p /usr/local/bin
Une fois le répertoire créé, vous pourrez déplacer le fichier composer.phar dedans en utilisant la commande mv :
sudo mv composer.phar /usr/local/bin/composer
Les commandes que vous avez fournies sont utilisées pour installer Composer sur votre système. Si vous avez déjà installé Composer, vous n’aurez pas besoin d’exécuter ces lignes de commandes à chaque fois que vous utiliserez Composer dans un projet.
Vous pouvez vérifier que Composer est correctement installé en exécutant la commande suivante dans votre terminal :
composer --version
Pour trouver le chemin /usr/local/bin/ dans le Finder sur un Mac, vous pouvez suivre ces étapes : Ouvrez une nouvelle fenêtre du Finder, dans la barre de menu en haut de l’écran, cliquez sur « Aller » puis sélectionnez « Aller au dossier… ». Entrez le chemin /usr/local/bin/ dans la zone de texte et appuyez sur « Aller ». Vous devriez maintenant voir les fichiers et répertoires contenus dans ce dossier… dont Composer.
Composer et son fichier JSON
Le fichier JSON (appelé composer.json) sert de carnet de route ou de carte d’identité pour votre projet. C’est lui qui liste tous les morceaux de code extérieurs dont vous avez besoin.
Il indique exactement à Composer de quels morceaux de code extérieurs (les dépendances) votre projet a besoin pour fonctionner, tout en notant les versions précises requises pour éviter les bugs. C’est grâce à lui que Composer sait quoi télécharger et installer sur votre ordinateur.

Même si vous n’avez pas à l’écrire entièrement à la main — vous pouvez le créer automatiquement avec une commande simple comme composer init —, ce fichier doit obligatoirement exister pour que Composer sache quoi télécharger et installer.
- Ce fichier
composer.jsonse trouve quasiment toujours à la racine de votre projet.
Le fichier composer.json est un simple fichier texte rédigé dans un format appelé JSON, ce qui signifie qu’il est structuré sous forme de listes d’éléments compréhensibles à la fois par l’ordinateur et par vous.
Ce qu’il contient
Il contient généralement plusieurs blocs d’informations clés :
- L’identité du projet : Le nom de votre projet, sa description et son auteur.
- Les dépendances (
require) : C’est la partie la plus importante. Elle liste tous les morceaux de code extérieurs (les bibliothèques) dont votre projet a besoin pour tourner, ainsi que les versions minimales acceptées. - Les dépendances de développement (
require-dev) : Des outils supplémentaires utilisés uniquement pendant que vous écrivez du code (comme des outils pour tester votre code), qui ne seront pas installés sur le serveur final de votre site. - L’autoloader (
autoload) : Des instructions qui disent à Composer comment charger automatiquement vos propres fichiers de code sans que vous ayez à écrire manuellement des lignes de chargement partout.
Comment le lire
Pour le lire, il suffit de l’ouvrir avec n’importe quel éditeur de texte (comme le Bloc-notes, VS Code, ou TextEdit).
Il se présente sous la forme de paires de clés et de valeurs entourées d’accolades { }. Par exemple, si vous lisez une ligne comme "mon-projet/site": "^1.0", cela signifie simplement que votre projet utilise la version 1.0 (ou une version compatible plus récente) d’un module particulier.
{
"name": "mon-nom/mon-projet",
"description": "Un projet de test avec Composer",
"require": {
"monolog/monolog": "^3.0"
}
}
"name": Le nom de votre projet (généralement sous la formenom-de-développeur/nom-du-projet)."description": Une courte phrase pour expliquer à quoi sert votre projet."require": C’est ici que vous listez les dépendances. Dans cet exemple, le projet a besoin de la bibliothèquemonolog/monolog(un outil très populaire pour enregistrer des messages de journal/logs) dans sa version 3.0 ou supérieure compatible.
Utiliser Composer dans un projet
Nous allons prendre un exemple concret pour comprendre comment utiliser Composer dans un projet. Nous allons utiliser la bibliothèque Parsedown qui est un analyseur Markdown en PHP.
C’est une bibliothèque PHP très populaire qui sert à transformer du texte écrit en Markdown (le format avec des symboles comme # pour les titres ou ** pour le gras) en code HTML lisible par un navigateur web.
Voici comment l’installer et l’utiliser pas à pas dans votre projet.
Étape 1 : Installer Parsedown avec Composer
Ouvrez votre terminal (ou invite de commande), placez-vous dans le dossier de votre projet, puis tapez la commande suivante :
composer require erusev/parsedown
Cette commande télécharge automatiquement Parsedown, l’ajoute dans votre dossier vendor et met à jour votre fichier composer.json.
Étape 2 : Créer votre fichier PHP
Dans le dossier de votre projet, créez un fichier nommé par exemple index.php.
Étape 3 : Écrire le code pour utiliser Parsedown
Ouvrez votre fichier index.php avec votre éditeur de texte et écrivez le code suivant :
<?php
// 1. Charger l'autoloader de Composer (indispensable)
require 'vendor/autoload.php';
// 2. Créer un objet Parsedown
$parsedown = new Parsedown();
// 3. Écrire du texte au format Markdown
$texteMarkdown = "# Mon super titre\nCeci est un paragraphe avec du **texte en gras**.";
// 4. Transformer le Markdown en HTML et l'afficher
echo $parsedown->text($texteMarkdown);
?>
Voici ce que fait chaque ligne brièvement :
require 'vendor/autoload.php';: Charge le système de Composer pour activer tous les outils installés, y compris Parsedown.$parsedown = new Parsedown();: Prépare l’outil en créant un objet que l’on va pouvoir utiliser.$texteMarkdown = ...;: Stocke un petit texte d’exemple écrit en Markdown.echo $parsedown->text($texteMarkdown);: Convertit le texte Markdown en HTML et l’affiche à l’écran.
Étape 4 : Tester le résultat
Lancez votre serveur local ou visualisez votre fichier index.php. Vous verrez que le texte brut en Markdown a été converti proprement en de vraies balises HTML (comme <h1> et <strong>) que le navigateur sait maintenant afficher.
Concrètement, le navigateur interprétera les balises générées de la manière suivante :
- Le titre
# Mon super titreapparaîtra en gros caractères gras (comme un titre de niveau 1). - La phrase avec
**texte en gras**affichera les mots concernés en gras, sans afficher les astérisques. - Le retour à la ligne (
\n) fera passer la suite sur un nouveau paragraphe.
👉 La liste complète des symboles utilisés en Markdown.
Mettre à jour vos dépendances
Pour mettre à jour les dépendances de votre projet lorsque les bibliothèques évoluent, Composer automatise presque tout. Voici les étapes simples à suivre :
Ouvrir le terminal dans votre projet. Rendez-vous dans le dossier racine de votre projet (celui qui contient votre fichier composer.json) à l’aide de votre terminal ou invite de commande.
Lancer la commande de mise à jour. Tapez la commande suivante et validez
composer update
Ce qui se passe : Composer va lire votre fichier composer.json, aller voir sur Internet si de nouvelles versions de vos bibliothèques sont sorties, les télécharger, puis mettre à jour automatiquement un fichier nommé composer.lock (qui enregistre les versions exactes installées).
Tester votre application. Ouvrez votre site ou vos scripts PHP dans votre navigateur pour vérifier que tout fonctionne toujours correctement. Parfois, une mise à jour majeure d’une bibliothèque peut modifier un détail dans le code, il est donc toujours prudent de tester après coup.
Liste des commandes principales pour Composer
Voici un tableau récapitulatif des commandes Composer les plus utilisées au quotidien, avec des explications simples :
| Commande | À quoi elle sert | Quand l’utiliser ? |
composer init | Crée le fichier composer.json pas à pas en posant quelques questions simples. | Au tout début d’un nouveau projet. |
composer require <nom> | Télécharge et installe une nouvelle bibliothèque, puis l’ajoute automatiquement au fichier composer.json. | Quand vous voulez ajouter un nouvel outil à votre projet (ex: composer require erusev/parsedown). |
composer install | Télécharge et installe exactement les versions des bibliothèques prévues pour le projet. | Quand vous récupérez le projet d’un collègue ou depuis Git pour la première fois. |
composer update | Recherche et installe les dernières versions disponibles de toutes vos bibliothèques. | Pour mettre à jour l’ensemble des dépendances de votre projet. |
composer update <nom> | Met à jour une seule bibliothèque spécifique sans toucher aux autres. | Quand vous souhaitez mettre à jour un outil précis sans risquer de perturber le reste. |
composer remove <nom> | Supprime proprement une bibliothèque de votre projet et la retire du fichier composer.json. | Quand vous n’avez plus besoin d’un outil particulier. |
composer dump-autoload | Régénère le fichier de chargement automatique (vendor/autoload.php). | Si vous avez ajouté de nouvelles classes ou modifié la structure de vos dossiers PHP. |
Installer Laravel avec composer
Voici les étapes simples pour installer un nouveau projet Laravel en utilisant Composer.
Laravel est l’un des frameworks (cadres de travail) PHP les plus populaires et puissants, et son installation passe presque entièrement par Composer.
Étape 1 : Ouvrir votre terminal
Rendez-vous dans le dossier de votre ordinateur où vous souhaitez créer votre projet (par exemple, votre dossier de serveurs locaux comme htdocs ou www, ou simplement votre bureau). Ouvrez votre terminal ou invite de commande à cet endroit.
Étape 2 : Lancer la commande de création du projet
Au lieu d’utiliser un fichier composer.json vide, Laravel propose une commande directe qui télécharge tout le nécessaire d’un coup. Tapez la commande suivante en remplaçant mon-projet par le nom que vous voulez donner à votre dossier :
composer create-project laravel/laravel mon-projet
Ce qui se passe : Composer va télécharger Laravel, créer un dossier nommé mon-projet, et installer automatiquement toutes les dépendances dont Laravel a besoin pour fonctionner. Cela peut prendre une petite minute selon votre connexion internet.
Étape 3 : Entrer dans le dossier du projet
Une fois l’installation terminée, déplacez-vous dans le nouveau dossier qui vient d’être créé en tapant :
cd mon-projet
Étape 4 : Lancer le serveur de test local
Laravel intègre un petit serveur de test très pratique pour voir votre site immédiatement sans configuration complexe. Lancez-le avec la commande :
php artisan serve
Étape 5 : Ouvrir votre projet dans le navigateur
Le terminal va vous afficher une adresse web locale (généralement [http://127.0.0.1:8000](http://127.0.0.1:8000)).
Copiez cette adresse, collez-la dans votre navigateur web, et vous devriez voir s’afficher la page d’accueil officielle de Laravel. Votre projet est prêt à être développé !
Composer, un outil essentiel pour le développement web
Composer offre une vaste bibliothèque de packages pour le développement web. Voici une liste de quelques packages populaires souvent utilisés dans le développement web, couvrant divers domaines tels que les frameworks PHP, les bibliothèques d’authentification, les outils de gestion de base de données, les bibliothèques frontend…
| Nom | Source | Description |
|---|---|---|
| Symfony Framework | symfony/framework-bundle | Framework PHP populaire pour le développement d’applications web. |
| Laravel Framework | laravel/laravel | Autre framework PHP populaire, connu pour sa simplicité et son élégance. |
| Zend Framework | zendframework/zendframework | Framework PHP robuste et extensible. |
| jQuery JavaScript Library | components/jquery | Bibliothèque JavaScript pour la manipulation du DOM et les interactions côté client. |
| Bootstrap CSS Framework | twbs/bootstrap | Une bibliothèque frontend CSS pour le développement web. |
| PHPMailer | phpmailer/phpmailer | Bibliothèque de messagerie PHP puissante et facile à utiliser. |
| PHP Markdown | cebe/markdown | Un parseur Markdown en PHP. |
| Respect Validation Library | respect/validation | Bibliothèque PHP pour la validation des données. |
| Phinx Database Migrations | phinx/phinx | Outil de migration de base de données pour PHP. |
| HTML Purifier | ezyang/htmlpurifier | Bibliothèque PHP pour nettoyer et filtrer le HTML. |
| PHPExcel | phpoffice/phpspreadsheet | Bibliothèque PHP pour la manipulation de fichiers Excel. |
| TCPDF PDF Library | tecnickcom/tcpdf | Bibliothèque PHP pour la création de fichiers PDF. |
Et bien d’autres encore …
Composer a révolutionné la gestion des dépendances en PHP, simplifiant considérablement le processus de développement et améliorant la qualité des projets. En permettant aux développeurs d’intégrer facilement des bibliothèques tierces, Composer favorise la réutilisabilité du code et accélère le développement des applications PHP. Grâce à sa facilité d’utilisation et à sa vaste communauté de développeurs, Composer reste l’outil de choix pour la gestion des dépendances en PHP.

Fondateur de l’agence Créa-troyes.
Affilié France Num
Intervenant en Freelance.
Contactez-moi
