À ce jour, composer, comme git, n’est nécessaire que pour participer au développement de SPIP, contribuer à sa maintenance, ses évolutions internes.
Il est possible de s’en servir pour développer un plugin communautaire ou personnel, selon les besoins de chacun, mais ce n’est pas encore nécessaire : git, un fichier paquet.xml et pour aller au bout des automatismes spipiens, pousser ce dépôt git dans le groupe spip-contrib-extensions
de git.spip.net ainsi qu’un tag est suffisant.
La bonne version
Il existe plusieurs versions de composer:
- Une version 1 qui cessera complètement de fonctionner courant 2025.
- Une version LTS 2.2 qui offre encore le support de PHP5.3. Les versions maintenues de SPIP nécessitent au minimum PHP7.4 ou 8.2
- La version courante (2.8.4 au 10 janvier 2025) est celle qui est nécessaire pour la maintenance de SPIP4 et SPIP5
Pourquoi ?
SPIP bénéficie d’un plugin composer original qui traite les spécificités d’installation de SPIP et founit des commandes composer supplémentaires. Ces fonctionnalités nécessitent l’API de la version courante de composer.
Voir Flex : son role et sa fonction dans SPIP
générique et autonome
La méthode la plus efficace pour installer la version courante, quelque soit le système d’exploitation est décrite ici : Introduction - Composer.
C’est à faire « à la main », mais permet aux personnes qui installent et utilisent composer d’avoir un contrôle total sur celui-ci.
composer est aussi installable avec des méthodes alternatives :
docker
image officielle
La page du hub docker explique comment s’en servir : https://hub.docker.com/_/composer
spip/tools
Une image spécifique à SPIP, qui fournit tous les outils de dev et de tests à jour, dans plusieurs versions PHP
Elle n’est pas encore officialisée, mais elle sert sur la CI Gitlab et peut servir en local.
Voir https://hub.docker.com/r/spip/tools
Mac OS X
La version courante de composer peut être installée et mise à jour avec le gestionnaire de paquet système [brew->https://brew.sh]
brew install composer
Voir: composer — Homebrew Formulae
Les distributions Linux
debian
Voir Debian -- Package Search Results -- composer
Attention donc à la version de composer en fonction de la version de Debian
fedora
Voir composer - Fedora Packages
Attention aussi à la version de composer en fonction de la version de Fedora
Mettre à jour composer
Savoir où on en est, mettre à jour l’outil régulièrement.
composer --version
indique quelle version est utilisée.
composer diagnose
est très utile pour savoir ce qu’il sera possible de faire avec cette installation de composer. Quelque soit la méthode d’installation utilisée, il est pertinent de lancer cette commande juste après avoir installé l’outil.
composer self-update
pour mettre à jour.
Éventuellement avec sudo
selon le système d’exploitation et la méthode d’installation.
Info utile
composer help self-update
affiche les options possibles, et notamment :
--1 Force an update to the stable channel, but only use 1.x versions
--2 Force an update to the stable channel, but only use 2.x versions
--2.2 Force an update to the stable channel, but only use 2.2.x LTS versions
l’option --2
est à tester pour forcer la mise à jour vers la version courante…