Extension Builder para TYPO3

El Extension Builder es la herramienta de scaffolding sin la que ningún desarrollador TYPO3 se vuelve realmente productivo

El Extension Builder es desde hace más de diez años la herramienta oficial con la que las desarrolladoras crean en TYPO3 nuevas extensiones desde cero. Quien necesita una extensión Extbase con modelo de dominio, repositorio, controlador y módulo backend obtiene a través del Extension Builder un editor visual que, a partir de un diagrama de dominio tipo UML, genera todo el código boilerplate: configuración TCA, schema SQL, ext_localconf, stubs de controlador, plantillas Fluid, language files. Para agencias y equipos de producto que entregan regularmente extensiones propias, la herramienta sigue siendo el camino más rápido desde el concepto hasta el primer prototipo funcional.

El público son equipos de desarrollo TYPO3 en agencias y en el ámbito interno que, más allá de los sitepackages, quieren plasmar lógica de negocio propia en TYPO3. Son típicas las extensiones para catálogos de producto, gestión de eventos, portales de empleo, portales de cliente o estructuras de datos específicas de sector. Sin Extension Builder, cada una de esas extensiones tendría que crecer a mano desde un directorio vacío, con el riesgo de que la estructura se aleje del schema del núcleo TYPO3 y se rompa en el siguiente upgrade.

Escenarios típicos de uso

Un primer escenario es el prototipo para un portal de cliente. Un fabricante de maquinaria con 2.000 piezas de recambio necesita una extensión que haga disponibles en el backend familias de producto, productos y documentación como estructuras de datos propias. El Extension Builder genera en menos de 30 minutos el gerüste completo: TCA, repositorios, controladores, vista de lista y detalle. El equipo empieza de inmediato con la lógica de negocio en lugar de con el boilerplate.

Un segundo escenario es la situación de formación y onboarding. Un desarrollador que construye por primera vez una extensión TYPO3 aprende a través del scaffold generado las convenciones del framework sin perderse en la documentación. El código generado no es perfecto, pero es idiomático y muestra cómo está pensado Extbase.

Un tercer escenario es la migración de estructuras de datos existentes. Quien debe montar, a partir de una exportación CSV antigua, una nueva extensión TYPO3 con diez entidades, puede clicar el modelo de dominio en el Extension Builder, exportarlo y rellenar luego el código generado con un comando de importación. Eso ahorra varios días-persona frente a una construcción manual.

Un cuarto escenario es la estandarización en un pool de agencia. Un proveedor con 15 desarrolladores TYPO3 quiere asegurarse de que cada nueva extensión tenga la misma estructura base. El Extension Builder fuerza esa estructura mediante la generación, y plantillas propias para el generador de código aseguran que estilo de código, cabeceras de licencia y estructura de directorios queden idénticas a lo largo de los proyectos.

Arquitectura técnica

El Extension Builder es una extensión backend TYPO3 clásica con interfaz propia. En el backend aparece un módulo en el que se crea el modelo de dominio mediante una interfaz drag and drop: entidades como cajas, propiedades como campos, relaciones como líneas. Al exportar se persiste un schema JSON a partir del cual el generador escribe todo el código de la extensión.

La instalación se realiza clásicamente mediante Composer (friendsoftypo3/extension-builder). La extensión no tiene relevancia para producción, pertenece al entorno de desarrollo y no debería estar activada siquiera en producción. Al generar, el Builder recurre a plantillas tipo Twig que pueden adaptarse a cada proyecto si hace falta, por ejemplo para forzar estilos de código propios o cabeceras de licencia distintas.

Es importante que el Extension Builder no domina el roundtrip: quien genera una vez y luego amplía el código a mano puede abrir la extensión en el Builder, pero en ningún caso debe volver a generar, porque el Builder sobrescribiría partes de la lógica añadida manualmente. En la práctica el Builder se usa como paso de scaffold único y, después, la extensión vive en el repositorio Git.

Problemas frecuentes y soluciones

El primer problema es la trampa de la sobrescritura tras la primera pasada de generación. Los equipos que arrancan el Builder por segunda vez para añadir un campo pierden los cambios de código propios. La solución es una regla clara en el equipo: el Extension Builder se usa una vez, el resto es trabajo manual. Los cambios posteriores de campos se hacen manualmente en TCA, SQL y modelo.

El segundo problema es la compatibilidad con convenciones PHP modernas. El generador sigue produciendo código apoyado en versiones de PHP más antiguas y en convenciones Extbase más antiguas. La solución es una pasada de cleanup inmediatamente tras la generación: añadir type declarations, fijar return types, introducir readonly properties, sustituir los comentarios de anotación obsoletos por atributos nativos.

El tercer problema es el uso irreflexivo como milagro de código. Algunos equipos esperan que el Extension Builder entregue una aplicación lista para producción. No lo hace: entrega un gerüste. Toda la lógica de negocio, toda la validación, todo el concepto de seguridad sigue siendo tarea de la desarrolladora.

Un cuarto problema son los patrones de backend obsoletos en el código generado. Los controladores que trae utilizan a veces todavía patrones Extbase deprecated que generan warnings en el TYPO3 actual. La solución es un paso de lint justo tras la generación que revise el código frente a los estándares de codificación actuales y marque las declaraciones de tipo ausentes o las anotaciones obsoletas. Los pipelines modernos combinan ese paso con la reescritura automática de código mediante Rector para mantener el esfuerzo de cleanup lo más pequeño posible.

Migración y compatibilidad de versiones

El Extension Builder está oficialmente disponible para TYPO3 v11 y v12 y lo siguen manteniendo los Friends of TYPO3. Para TYPO3 v13 existe una versión actualizada que sigue las nuevas convenciones Extbase. Los equipos que actualizan extensiones existentes, por regla general, ya no necesitan el Builder: el upgrade corre mediante Upgrade Wizards en el Install Tool y ajustes manuales.

Más interesante es la mirada estratégica: en una época en la que la IA generativa puede crear gerüstes completos de extensión con lógica de negocio a partir de un prompt, el builder visual pierde parte de su ventaja original. Gosign combina ambos mundos: para scaffolds estándar con muchas entidades el Builder sigue siendo eficiente, para extensiones exigentes con lógica específica de dominio generamos el código directamente a partir de un briefing técnico con apoyo de IA, ahorrando frente a la construcción manual clásica hasta el 80 por ciento del tiempo de desarrollo con una calidad de código simultáneamente superior.