JoeCMS
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
JoeCMS dérive de VGallery (GPL-3) d'Alessandro Stucchi.