k3n_dvemoji para TYPO3: Emoji-Support & UTF-8mb4-Migration

Los emojis como signos de interrogación no son un problema de visualización, sino un error de configuración de base de datos

Cuando en un backend TYPO3 un redactor introduce un emoji y en el frontend aparece un signo de interrogación o un cuadro vacío, el problema no está en el navegador ni en TYPO3. Está en la base de datos MySQL o MariaDB, que está configurada con el juego de caracteres utf8 en lugar de utf8mb4. La diferencia: utf8 almacena un máximo de 3 bytes por carácter, los emojis necesitan 4 bytes. k3n_dvemoji es una extensión TYPO3 que aborda este problema ampliando la configuración de la base de datos con soporte UTF-8mb4. Desde TYPO3 v10, el Core está preparado para utf8mb4, por lo que la extensión solo es necesaria en instalaciones antiguas o mal configuradas.

Escenarios de uso habituales

El escenario más frecuente es una instalación TYPO3 v8 o v9 que lleva años funcionando y cuya base de datos aún está configurada en utf8. Aproximadamente el 30% de todas las instalaciones TYPO3 configuradas antes de 2018 tienen este problema. Segundo escenario: migraciones de bases de datos entre servidores donde el juego de caracteres puede perderse por un comando mysqldump incorrecto. Tercer escenario: sitios web internacionales con idiomas asiáticos que requieren parcialmente 4 bytes.

Arquitectura técnica

k3n_dvemoji trabaja en dos niveles: análisis y conversión. En modo análisis, la extensión escanea todas las tablas TYPO3 y verifica el juego de caracteres de cada columna. En modo conversión genera sentencias ALTER TABLE para cada columna afectada y las ejecuta. Adicionalmente, la configuración TYPO3 en LocalConfiguration.php debe declarar el juego de caracteres utf8mb4.

Problemas frecuentes

Problema uno: restricción de longitud de índice MySQL. Con InnoDB en formato Compact antiguo, la longitud máxima de índice es 767 bytes. Un varchar(255) con utf8mb4 necesita 1.020 bytes de espacio de índice. Solución: cambiar ROW_FORMAT a DYNAMIC. Problema dos: respaldo antes de la conversión, ya que ALTER TABLE en tablas grandes bloquea la tabla. Problema tres: columnas inconsistentes tras conversión parcial.

Migración y compatibilidad de versiones

A partir de TYPO3 v10, la extensión es innecesaria si la base de datos está correctamente configurada. La extensión sigue siendo relevante para instalaciones que migran de v7, v8 o v9 a v12 o v13 y cuya base de datos nunca fue convertida. Gosign resuelve esto de forma automática en cada migración TYPO3: escaneo de base de datos asistido por IA, conversión completa y verificación de consistencia como parte del proceso estándar de actualización.