← Ecosistema

JoeCMS

joecms.it in produzione

Il CMS PHP su cui girano gli altri progetti, distribuito in open source e pubblicato su joecms.it: un motore fermo da anni riportato in vita su PHP 8, un pacchetto che si installa dal browser e un sito che ne pubblica manuale, changelog e download.

Il problema

Ogni progetto nuovo ripartiva dalle stesse fondamenta: utenti, permessi, email, lingue, cache, backend. Il motore su cui lavoravo da anni, VGallery, era fermo a PHP 7 e su PHP 8 non si avviava: costrutti rimossi dal linguaggio e centinaia di chiamate su valori nulli diventate errori fatali. Per anni è rimasto così, un fatto privato: lo usavano i miei progetti, e nessun altro.

Le alternative erano un CMS generico da piegare a ogni progetto o un framework su cui ricostruire tutto da capo. Ho scelto di recuperare il motore: una migrazione conservativa, che replica il comportamento di PHP 7 invece di riscriverlo, e un installer che da un archivio ZIP tira su un sito funzionante. Il passo successivo era farlo uscire di casa: un sito del prodotto con i pacchetti, il changelog e il manuale, e la licenza GPL-3 che era già nella storia di questo codice.

Come funziona

Struttura

I contenuti sono nodi tipizzati con campi dinamici: non esiste una tabella per ogni tipo di contenuto, e aggiungerne uno è configurazione, non codice. Intorno ci sono routing dichiarativo in XML, template a segnaposto e blocchi, e un backend con griglie e form generati dal database. Il resto lo porta il nucleo: pagine, email e notifiche nella lingua di chi le riceve, cache di pagina per utente, gruppo e lingua, code di job, cron e un'API con token Bearer.

Flusso d'uso

Si scompatta lo ZIP nella cartella del sito e si apre il browser. Un wizard in dieci passi controlla i requisiti, crea il database, prova l'invio email, raccoglie i dati aziendali e lascia un sito multilingua già popolato, con pagine legali, robots.txt e regole Apache legate al dominio vero. Il pacchetto si aggiorna caricando i file nuovi: dalla 1.6 il CMS gira sui MySQL e MariaDB recenti senza chiedere di allentare le loro impostazioni.

Scelte tecniche

Correzioni conservative invece di riscritture, su una base senza test: cast e controlli, e un lint dopo ogni modifica di massa. L'installer è indipendente dal framework, perché deve funzionare quando il CMS non si avvia ancora. Un errore fatale diventa una pagina 500 con un codice da cercare nei log, mai file e riga a video: le pagine di errore portano il marchio di chi installa e si sostituiscono da conf/cm/extras/.

Limiti noti

Nessun aggiornamento automatico: ogni versione esce come ZIP con il suo checksum, e chi ha già un sito installato aggiorna a mano, ricontrollando le poche regole Apache che il deploy non tocca. Resta poi un motore con quasi vent'anni di storia: convive con alcune classi duplicate del framework e con parti ereditate lasciate inerti.

Il sito del prodotto

joecms.it è costruito con JoeCMS stesso, nelle stesse quattro lingue del pacchetto: home, download delle versioni con il checksum, changelog preso dall'ultimo ZIP pubblicato e guida in quattordici capitoli.

Numeri

File PHP nel punto di partenza, circa 14.400
File corretti nella migrazione a PHP 8 913
Tabelle nello schema 218
Passi del wizard di installazione 10
Integrazioni di terze parti configurabili 31
Lingue nel pacchetto base 4
Versioni pubblicate 20
Capitoli della guida 14

Stack

  • PHP 8
  • MySQL / MariaDB
  • Apache
  • SCSS
  • JavaScript
  • XML / JSON
  • Linux
Schermata di JoeCMS
Il changelog pubblico di JoeCMS, con la storia delle versioni
La guida di JoeCMS pubblicata sul sito, capitolo per capitolo

JoeCMS deriva da VGallery (GPL-3) di Alessandro Stucchi.