JoeCMS
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
JoeCMS deriva da VGallery (GPL-3) di Alessandro Stucchi.