← Ecosistema

JoeCMS

joecms.it en producción

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
Captura de JoeCMS
El changelog público de JoeCMS, con la historia de las versiones
La guía de JoeCMS publicada en el sitio, capítulo a capítulo

JoeCMS deriva de VGallery (GPL-3) de Alessandro Stucchi.