Installer composer pour développer avec spip

À 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

Voir Introduction - Composer

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…

2 « J'aime »