Outils PHP

Gérer vos dépendances avec Composer

Comment installer Composer

Décrit l’installation de l’outil PHP Composer.

Composer est un logiciel de gestion de dépendances pour les projets en PHP. Il permet donc d’installer et configurer les bibliothèques utiles à un projet. Il permet par exemple, de récupérer depuis des dépôts sur internet des librairies pour les intégrer automatiquement à ces projets PHP.

Un autre intérêt d’utiliser composer dans ces projets PHP est qu’il automatise la gestion de l’autoload de ces propres classes sans avoir à programmer son autoloader.

Sommaire

Présentation

Nous allons voir comment installer le logiciel Composer sur son ordinateur quelque soit l’OS.

Composer est un programme écrit en PHP et distribué au format PHAR (PHP Archive), l’équivalent des .jar (java archive) pour le langage Java.

Il suffit donc :

que PHP soit installé,
récupérer le fichier composer.phar et
de le recopier dans un répertoire /usr/local/bin pour rendre la commande accessible

Vous trouverez sur Internet plusieurs méthodes pour installer Composer en fonction de l’OS. Sous Linux, soit Composer est disponible dans votre gestionnaire de paquet soit, vous pouvez utiliser la méthode décrite sur le site officiel ici :

Nous allons voir quelques exemples d’installation.

Exemple d’installation sous Linux et MacOS

Voyons voir maintenant la méthode décrite sur le site officiel. Personnellement, je l’ai testée sous Linux (Debian et Ubuntu) ainsi que sous macOS Mojave.

Bien sur, la première chose à faire est de vérifier que PHP est bien installé sur nos machines avant d’installer Composer :

$ php --version
PHP 7.0.33-0+deb9u1 (cli) (built: Dec  7 2018 11:36:49) ( NTS )
Copyright (c) 1997-2017 The PHP Group
Zend Engine v3.0.0, Copyright (c) 1998-2017 Zend Technologies
	with Zend OPcache v7.0.33-0+deb9u1, Copyright (c) 1999-2017, by Zend Technologies

Puis, comme indiqué sur le site, j’exécute les commandes suivante à partir d’un répertoire quelconque. Pour ne pas risquer de polluer un de mes dossier, je me met dans un répertoire temporaire vide.

$ cd temp

Je peux maintenant exécuter les commandes spécifiées. Il s’agit d’exécuter des lignes de codes en PHP.

La première commande recopie un installateur dans le répertoire courant.

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

ls -l
total 260
-rw-r--r-- 1 christophe christophe 263790 févr. 12 14:05 composer-setup.php

La commande suivante vérifie que le téléchargement n’est pas corrompu.

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

La commande suivante va exécuter le programme chargé de récupérer la dernière version de Composer.

$ php composer-setup.php
All settings correct for using Composer
Downloading...

Composer (version 1.8.4) successfully installed to: /home/christophe/Documents/temp/composer.phar
Use it: php composer.phar

La commande suivante supprime le fichier d’installation :

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

On se retrouve donc uniquement avec notre fichier composer.phar.

$ ls -l
total 1868
-rwxr-xr-x 1 christophe christophe 1909682 févr. 12 14:06 composer.phar

La commande suivante sera chargée de déplacer le fichier composer.phar dans /usr/local/bin et de supprimer son extension pour disposer de la commande quelque soit le répertoire dans lequel on se trouvera.

ATTENTION : Ne pas oublier de passer en mode administrateur avant d’exécuter la commande.

$ su
Mot de passe :


# mv composer.phar /usr/local/bin/composer

Remarque : Sous ubuntu et macOS, vous pouvez taper directement la commande précédente en la préfixant par sudo.

Le répertoire courant devrait être maintenant vide.

# ls -l
total 0

On peut maintenant quitter le mode root.

#exit

Vérifions que la commande est disponible :

$ composer
   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                	/_/
Composer version 1.8.4 2019-02-11 10:52:10

Usage:
  command [options] [arguments]

...

Installation à partir du gestionnaire de paquets

Sur Ubuntu 18.04, j’ai utilisé le gestionnaire de paquet pour installer Composer.

A partir d’une console, test de l’installation de PHP

$ php --version
PHP 7.3.9-1+ubuntu18.04.1+deb.sury.org+1 (cli) (built: Sep  2 2019 12:54:24) ( NTS )
Copyright (c) 1997-2018 The PHP Group
Zend Engine v3.3.9, Copyright (c) 1998-2018 Zend Technologies
	with Zend OPcache v7.3.9-1+ubuntu18.04.1+deb.sury.org+1, Copyright (c) 1999-2018, by Zend Technologies

Ok pour PHP. Vérifions que Composer n’est pas installé :

$ composer

La commande « composer » n'a pas été trouvée, mais peut être installée avec :

sudo apt install composer

Le système me propose bien une installation via le gestionnaire de paquets. Lançons cette installation.

$ sudo apt-get install composer
[sudo] Mot de passe de leppf :
Lecture des listes de paquets... Fait
Construction de l'arbre des dépendances  	 
Lecture des informations d'état... Fait
Les paquets supplémentaires suivants seront installés :
  git git-man jsonlint liberror-perl php-cli-prompt php-composer-ca-bundle php-composer-semver php-composer-spdx-licenses php-json-schema php-psr-log php-symfony-console php-symfony-debug
  php-symfony-filesystem php-symfony-finder php-symfony-polyfill-mbstring php-symfony-process
Paquets suggérés :
  fossil mercurial subversion php-zip git-daemon-run | git-daemon-sysvinit git-doc git-el git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn php-symfony-event-dispatcher php-symfony-lock
  php-mbstring
Les NOUVEAUX paquets suivants seront installés :
  composer git git-man jsonlint liberror-perl php-cli-prompt php-composer-ca-bundle php-composer-semver php-composer-spdx-licenses php-json-schema php-psr-log php-symfony-console php-symfony-debug
  php-symfony-filesystem php-symfony-finder php-symfony-polyfill-mbstring php-symfony-process
0 mis à jour, 17 nouvellement installés, 0 à enlever et 61 non mis à jour.
Il est nécessaire de prendre 5 319 ko dans les archives.
Après cette opération, 37,4 Mo d'espace disque supplémentaires seront utilisés.
Souhaitez-vous continuer ? [O/n] O

Nous voyons que le système installe plusieurs paquets supplémentaires. Testons que Composer est maintenant installé.

$ composer
   ______
  / ____/___  ____ ___  ____  ____  ________  _____
 / /   / __ \/ __ `__ \/ __ \/ __ \/ ___/ _ \/ ___/
/ /___/ /_/ / / / / / / /_/ / /_/ (__  )  __/ /
\____/\____/_/ /_/ /_/ .___/\____/____/\___/_/
                	/_/
Composer 1.6.3 2018-01-31 16:28:17

Usage:
  command [options] [arguments]

Options:
  -h, --help                 	Display this help message
  -q, --quiet                	Do not output any message
  -V, --version              	Display this application version
  	--ansi                 	Force ANSI output
 
...

La différence principale, lorsque l’on effectue une installation à partir de paquets est que la version est généralement plus ancienne ce que l’on peut vérifier ici.

Installation sous Windows

Je n’ai pas testé pour l’instant sous Windows mais vous trouverez sur le site officiel un setup d’installation graphique.

Conclusion

Nous venons de voir comment installer Composer et vous pourrez donc l’utiliser dans vos projets. Nous verrons dans un autre article des exemples d’utilisation de cet outil indispensable à tout développeur PHP. Vous pourrez également aller sur The PHP Package Repository pour vous faire une idée des bibliothèques de programmes disponibles.

Voir en ligne : Site officiel

Développement

Article n° 143

Crée par: chris

Créé le: 19 septembre 2019

Modifié le: 19 septembre 2019

Nombre de visites: 141

Popularité: 19 %

Popularité absolue: 1

PHP

Mots clés de cet article

intermédiaire12
PHP11