JoeCMS
El CMS en PHP sobre el que funcionan los demás proyectos, publicado como código abierto en joecms.it: un motor parado durante años devuelto a la vida en PHP 8, un paquete que se instala desde el navegador y un sitio que publica su manual, su changelog y sus descargas.
El problema
Cada proyecto nuevo empezaba por los mismos cimientos: usuarios, permisos, correo, idiomas, caché, panel de administración. El motor con el que trabajaba desde hacía años, VGallery, se había quedado en PHP 7 y en PHP 8 ni siquiera arrancaba: construcciones eliminadas del lenguaje y cientos de llamadas sobre valores nulos convertidas en errores fatales. Durante años siguió así, como algo privado: lo usaban mis proyectos y nadie más.
Las alternativas eran un CMS genérico adaptado a la fuerza a cada proyecto o un framework sobre el que reconstruirlo todo. Elegí recuperar el motor: una migración conservadora, que reproduce el comportamiento de PHP 7 en lugar de reescribirlo, y un instalador que convierte un archivo ZIP en un sitio que funciona. El paso siguiente era sacarlo de casa: un sitio del producto con los paquetes, el changelog y el manual, y la licencia GPL-3 que ya formaba parte de la historia de este código.
Cómo funciona
Estructura
Los contenidos son nodos tipados con campos dinámicos: no hay una tabla por tipo de contenido, y añadir uno es configuración, no código. Alrededor hay enrutamiento declarativo en XML, plantillas con marcadores y bloques, y un panel con tablas y formularios generados a partir de la base de datos. El resto lo aporta el núcleo: páginas, correos y notificaciones en el idioma de quien los recibe, caché de página por usuario, grupo e idioma, colas de tareas, cron y una API con token Bearer.
Flujo de uso
Se descomprime el ZIP en la carpeta del sitio y se abre el navegador. Un asistente de diez pasos comprueba los requisitos, crea la base de datos, prueba el envío de correo, recoge los datos de la empresa y deja un sitio multilingüe ya poblado, con páginas legales, robots.txt y reglas de Apache ligadas al dominio real. El paquete se actualiza subiendo los archivos nuevos: desde la 1.6 el CMS funciona sobre MySQL y MariaDB recientes sin pedir que se relajen sus ajustes.
Decisiones técnicas
Correcciones conservadoras en lugar de reescrituras, sobre un código sin tests: conversiones de tipo y comprobaciones, y un lint después de cada cambio masivo. El instalador es independiente del framework, porque tiene que funcionar cuando el CMS todavía no arranca. Un error fatal se convierte en una página 500 con un código para buscar en los registros, nunca en archivo y línea en pantalla: las páginas de error llevan la marca de quien instala y se sustituyen desde conf/cm/extras/.
Límites conocidos
No hay actualización automática: cada versión se publica como ZIP con su checksum, y quien ya tiene un sitio instalado actualiza a mano, revisando otra vez las pocas reglas de Apache que el despliegue no toca. Y sigue siendo un motor con casi veinte años de historia: convive con algunas clases duplicadas del framework y con partes heredadas que se han dejado inertes.
El sitio del producto
joecms.it está construido con JoeCMS mismo, en los mismos cuatro idiomas del paquete: portada, descargas de las versiones con checksum, changelog tomado del último ZIP publicado y guía en catorce capítulos.
Números
| Archivos PHP en el punto de partida, aprox. | 14.400 |
|---|---|
| Archivos corregidos en la migración a PHP 8 | 913 |
| Tablas en el esquema | 218 |
| Pasos del asistente de instalación | 10 |
| Integraciones de terceros configurables | 31 |
| Idiomas en el paquete base | 4 |
| Versiones publicadas | 20 |
| Capítulos de la guía | 14 |
Stack
- PHP 8
- MySQL / MariaDB
- Apache
- SCSS
- JavaScript
- XML / JSON
- Linux
JoeCMS deriva de VGallery (GPL-3) de Alessandro Stucchi.