Section courante

A propos

Section administrative du site

Fiche technique
Prérequis : PHP 5.3.2+
Auteur : Nils Adermann, Jordi Boggiano
Catégorie : Gestion de dépendance

Introduction

Le projet Composer est un outil de gestion de la dépendance en PHP. Il vous permet de déclarer les bibliothèques dont dépend votre projet et il les gérera (installera et mettra à jour) pour vous. Il peut être installer avec des cadres d'applications comme Symfony par exemple ou de façon autonome. Le projet Composer n'est pas un gestionnaire de paquets au même sens que yum ou apt-get sous Linux. Oui, bien sure, il s'agit de paquets ou de bibliothèques, mais il les gère projet par projet, en les installant dans un répertoire (par exemple, en les classant par le fournisseur) de votre projet. Par défaut, rien ne s'installe globalement. Il s'agit donc d'un gestionnaire de dépendances. Il supporte cependant un projet «global» pour plus de commodité via la commande globale. Cette idée n'est pas nouvelle et Composer s'inspire fortement de l'emballeur de noeuds npm et de Ruby.

Fonctionnement

De façon concrète, on pourrait expliquer le fonctionnement du projet Composer de la façon suivante. Vous avez un projet dépendant de plusieurs bibliothèques. Certaines de ces bibliothèques dépendent de d'autres bibliothèques. Alors le Composer, vous permet de déclarer les bibliothèques dont vous dépendez. Ensuite, il détermine quelles versions des paquetages peuvent et doivent être installés et les installe (par conséquent, ils les téléchargera dans votre projet).

Configuration requise

Le projet Composer nécessite PHP 5.3.2+ pour fonctionner. Quelques ajustements de PHP sont sensibles et des drapeaux de compilation sont également requis, mais lors de l'utilisation du programme d'installation, des messages d'avertissement vous avertiront des incompatibilités potentielles.

Pour installer des paquets à partir de sources plutôt que de simples archives zip, vous aurez besoin de dépôt dans un contrôle de version comme git, svn, fossil ou hg. En théorie, le projet Composer est multiplateforme, donc il doit pouvoir être installés sont Windows, Linux, Mac OS X,...

Installation sous Linux, Unix ou Mac OS X

Le projet Composer propose un programme d'installation que vous pouvez exécuter directement à partir de la ligne de commande. Il y a deux manières d'installer Composer. Soit localement dans le cadre de votre projet ou globalement en tant qu'exécutable à l'échelle du système.

Localement

Pour installer Composer localement, exécutez le programme d'installation dans le répertoire de votre projet. Le programme d'installation vérifiera quelques configuration de PHP, puis télécharger «composer.phar» dans votre répertoire de travail. Ce fichier est le binaire de Composer. C'est un PHAR (archive PHP), étant un format d'archive pour PHP pouvant être exécuté en ligne de commande, entre autres. Maintenant, lancez en ligne de commande suivante afin de lancer l'outil Composer :

php composer.phar

Vous pouvez installer Composer dans un répertoire spécifique à l'aide de l'option --install-dir. Vous pouvez également le renommer à l'aide du paramètre --filename. Vous exécutez ainsi la commande suivante :

php composer-setup.php --install-dir=bin --filename=composer

Finalement, lancez la commande suivante pour lancer Composer :

php bin/composer



Dernière mise à jour : Mardi, le 5 mars 2019