← Écosystème

JoeCMS

joecms.it en production

Le CMS PHP sur lequel tournent les autres projets, publié en open source sur joecms.it : un moteur à l'arrêt depuis des années remis en marche sous PHP 8, un paquet qui s'installe depuis le navigateur et un site qui publie son manuel, son changelog et ses téléchargements.

Le problème

Chaque nouveau projet repartait des mêmes fondations : utilisateurs, droits, e-mails, langues, cache, back-office. Le moteur sur lequel je travaillais depuis des années, VGallery, était resté à PHP 7 et ne démarrait même pas sous PHP 8 : des constructions retirées du langage et des centaines d'appels sur des valeurs nulles devenus des erreurs fatales. Pendant des années, il en est resté là, une affaire privée : mes projets l'utilisaient, personne d'autre.

Les alternatives étaient un CMS générique plié à chaque projet, ou un framework sur lequel tout reconstruire. J'ai choisi de récupérer le moteur : une migration prudente, qui reproduit le comportement de PHP 7 au lieu de le réécrire, et un installateur qui transforme une archive ZIP en un site qui fonctionne. L'étape suivante était de le faire sortir de la maison : un site produit avec les paquets, le changelog et le manuel, et la licence GPL-3 qui faisait déjà partie de l'histoire de ce code.

Comment ça marche

Structure

Les contenus sont des nœuds typés avec des champs dynamiques : il n'y a pas une table par type de contenu, et en ajouter un relève de la configuration, pas du code. Autour, un routage déclaratif en XML, des gabarits à balises et à blocs, et un back-office dont les grilles et formulaires sont générés à partir de la base de données. Le reste vient du noyau : pages, e-mails et notifications dans la langue du destinataire, cache de page par utilisateur, groupe et langue, files de tâches, cron et une API à jeton Bearer.

Parcours d'usage

On décompresse le ZIP dans le dossier du site et on ouvre le navigateur. Un assistant en dix étapes vérifie les prérequis, crée la base de données, teste l'envoi d'e-mails, recueille les informations de l'entreprise et laisse un site multilingue déjà rempli, avec pages légales, robots.txt et règles Apache liées au vrai domaine. Le paquet se met à jour en téléversant les nouveaux fichiers : depuis la 1.6, le CMS tourne sur des MySQL et MariaDB récents sans demander d'assouplir leurs réglages.

Choix techniques

Des corrections prudentes plutôt que des réécritures, sur un code sans tests : conversions de type et contrôles, et un lint après chaque modification de masse. L'installateur est indépendant du framework, car il doit fonctionner quand le CMS ne démarre pas encore. Une erreur fatale devient une page 500 avec un code à chercher dans les journaux, jamais un fichier et une ligne à l'écran : les pages d'erreur portent la marque de l'installateur et se remplacent depuis conf/cm/extras/.

Limites connues

Pas de mise à jour automatique : chaque version sort en ZIP avec son checksum, et qui a déjà un site installé met à jour à la main, en revérifiant les quelques règles Apache que le déploiement ne touche pas. Et c'est toujours un moteur qui a presque vingt ans d'histoire : il cohabite avec quelques classes dupliquées du framework et des parties héritées laissées inertes.

Le site produit

joecms.it est construit avec JoeCMS lui-même, dans les mêmes quatre langues que le paquet : page d'accueil, téléchargements des versions avec checksum, changelog tiré du dernier ZIP publié et guide en quatorze chapitres.

Chiffres

Fichiers PHP au point de départ, environ 14 400
Fichiers corrigés lors de la migration vers PHP 8 913
Tables du schéma 218
Étapes de l'assistant d'installation 10
Intégrations tierces configurables 31
Langues du paquet de base 4
Versions publiées 20
Chapitres du guide 14

Stack

  • PHP 8
  • MySQL / MariaDB
  • Apache
  • SCSS
  • JavaScript
  • XML / JSON
  • Linux
Capture d'écran de JoeCMS
Le changelog public de JoeCMS, avec l'histoire des versions
Le guide de JoeCMS publié sur le site, chapitre par chapitre

JoeCMS dérive de VGallery (GPL-3) d'Alessandro Stucchi.