Configurar charset UTF-8 en MySQL para PrestaShop Syspanel

¡Hola! Soy tu técnico de soporte de confianza, y hoy vamos a resolver una de las dudas más comunes entre los que gestionan tiendas online con PrestaShop en Syspanel: cómo configurar el charset UTF-8 en MySQL para evitar problemas de acentos, ñ y caracteres especiales.

Este artículo es una guía completa, paso a paso, pensada para ti, que no eres un experto en bases de datos pero quieres que tu tienda funcione perfectamente. Vamos a usar un lenguaje sencillo, ejemplos claros y muchos consejos prácticos. Al final, tendrás tu base de datos configurada correctamente y sabrás cómo evitar errores típicos.

¿Por qué es importante el charset UTF-8 en MySQL para PrestaShop?

Cuando instalas PrestaShop en Syspanel, la base de datos MySQL almacena toda la información de tu tienda: productos, clientes, pedidos, etc. Si el charset (el juego de caracteres) no es el correcto, puede que los textos con tildes, la letra “ñ” o símbolos como € o © se vean como signos raros (por ejemplo: “Ã±” en lugar de “ñ”).

UTF-8 es el estándar universal. Soporta prácticamente todos los idiomas y símbolos del mundo. PrestaShop, desde sus versiones modernas, recomienda encarecidamente usar UTF-8 en la base de datos. Si no lo haces, podrías tener problemas al mostrar descripciones de productos, nombres de clientes o direcciones.

En Syspanel (el panel de control de tu hosting, accesible por el puerto 2106), gestionar este ajuste es muy sencillo, pero hay que saber dónde mirar.

Requisitos previos antes de empezar

Antes de meter mano, asegúrate de tener:

Acceso a Syspanel (usuario y contraseña). Recuerda que la URL suele ser algo como https://tudominio.com:2106.
Una base de datos MySQL asociada a tu instalación de PrestaShop.
Un backup reciente de tu base de datos (por si algo sale mal, siempre es bueno tener una copia de seguridad).
Conocimientos básicos de navegación en Syspanel (saber entrar a la sección de bases de datos).

[WARNING] Si ya tienes datos en tu base de datos, cambiar el charset puede corromper los caracteres existentes si no se hace correctamente. Más adelante te daremos un truco para convertir los datos sin perder información.

Paso 1: Acceder a la base de datos desde Syspanel

Abre tu navegador y escribe la dirección de Syspanel: https://tudominio.com:2106. (Sí, el puerto es 2106, no el típico 2083).
Inicia sesión con tus credenciales.
Busca la sección “Bases de Datos” o “MySQL”. En la mayoría de interfaces de Syspanel, está en el menú principal.
Verás una lista con todas tus bases de datos. Localiza la que usa tu PrestaShop (normalmente tiene un nombre como tienda_shop o prestashop_db).

[TIP] Si no estás seguro de cuál es, puedes comprobarlo en el archivo config/settings.inc.php de tu PrestaShop (dentro de la carpeta del sitio). Busca la línea define('_DB_NAME_', 'nombre_de_tu_bd');.

Paso 2: Verificar el charset actual de la base de datos

Antes de cambiar nada, es bueno saber en qué estado está tu base de datos. En Syspanel, puedes hacerlo de dos formas:

Desde la interfaz gráfica (phpMyAdmin)

Dentro de la sección de bases de datos, busca el enlace a phpMyAdmin (suele ser un botón o icono).
Selecciona tu base de datos en el panel izquierdo.
En la pestaña “Base de datos”, verás el “Cotejamiento” (collation). Si pone algo como utf8_general_ci o utf8mb4_general_ci, estás en UTF-8. Si ves latin1_swedish_ci o similar, necesitas cambiarlo.

Desde la línea de comandos (si te animas)

Si prefieres usar comandos SQL, dentro de phpMyAdmin puedes ir a la pestaña SQL y ejecutar:

SHOW VARIABLES LIKE 'character_set_database';
SHOW VARIABLES LIKE 'collation_database';

Esto te mostrará el charset y collation actuales.

Paso 3: Cambiar el charset de la base de datos a UTF-8

Vamos a lo importante. Hay dos niveles: la base de datos en sí, y las tablas que contiene. Lo ideal es cambiar ambos.

Cambiar el charset de la base de datos (nivel general)

En Syspanel, a través de phpMyAdmin:

Selecciona tu base de datos en el panel izquierdo.
Ve a la pestaña “Operaciones”.
En la sección “Cotejamiento”, elige utf8_general_ci (o utf8mb4_general_ci si tu PrestaShop soporta emojis, que es más moderno).
Haz clic en “Continuar” o “Aceptar”.

[INFO] utf8mb4 es una extensión de UTF-8 que permite caracteres de 4 bytes (como emojis). PrestaShop 1.7 y superiores lo soportan bien. Si tu versión es antigua, mejor usa utf8_general_ci.

Cambiar el charset de todas las tablas

Este paso es crucial porque aunque cambies la base de datos, las tablas pueden seguir con el charset antiguo.

En phpMyAdmin:

Selecciona tu base de datos.
Ve a la pestaña “SQL”.
Ejecuta el siguiente comando (copia y pega):

ALTER DATABASE nombre_de_tu_bd CHARACTER SET utf8 COLLATE utf8_general_ci;

Sustituye nombre_de_tu_bd por el nombre real de tu base de datos.

Luego, para convertir todas las tablas existentes:

SELECT CONCAT('ALTER TABLE `', TABLE_NAME,'` CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;') AS statements
FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = 'nombre_de_tu_bd'
AND TABLE_TYPE = 'BASE TABLE';

Esto generará una lista de comandos. Cópialos y pégalos en la misma ventana SQL (o en una nueva) y ejecútalos uno por uno (o todos a la vez si tu phpMyAdmin lo permite).

[WARNING] Este proceso puede tardar unos minutos si tu base de datos es grande. No cierres la ventana ni interrumpas la ejecución.

Paso 4: Configurar PrestaShop para usar UTF-8

Una vez que la base de datos está en UTF-8, debes asegurarte de que PrestaShop también esté configurado para usarlo.

Accede al panel de administración de tu PrestaShop (ej: tudominio.com/admin1234).
Ve a “Parámetros Avanzados” > “Rendimiento” (o en versiones antiguas, “Configuración” > “General”).
Busca la opción “Juego de caracteres de la base de datos” y asegúrate de que esté en UTF-8.
Guarda los cambios.

También puedes verificar el archivo config/settings.inc.php (o app/config/parameters.php en versiones modernas). Busca la línea:

define('_DB_CHARSET_', 'utf8');

Si no aparece, agrega esa línea justo después de la definición de la base de datos.

Paso 5: Verificar que todo funciona correctamente

Para asegurarte de que la configuración es correcta:

Crea un producto de prueba con acentos y ñ (ej: “Camiseta de algodón 100%”).
Guárdalo y visualízalo en la tienda.
Si los caracteres se ven bien, ¡lo lograste!

Si aún ves problemas, puede que los datos antiguos estén corruptos. En ese caso, necesitarás un script de conversión (más adelante te damos un tip).

Solución de problemas comunes (FAQ)

¿Por qué después de cambiar el charset veo caracteres raros?

Esto sucede porque los datos ya almacenados estaban en otro charset (ej: latin1) y al convertirlos a UTF-8 se han interpretado mal. La solución es hacer una conversión “forzada” con un script. Puedes usar esta consulta SQL para reparar tablas:

ALTER TABLE nombre_tabla CONVERT TO CHARACTER SET utf8 COLLATE utf8_general_ci;

Si eso no funciona, prueba con:

ALTER TABLE nombre_tabla MODIFY nombre_columna VARCHAR(255) CHARACTER SET utf8;

¿Debo usar utf8 o utf8mb4?

Usa utf8mb4 si tu PrestaShop es versión 1.7 o superior, porque soporta emojis y caracteres especiales. Para versiones antiguas, utf8_general_ci es suficiente.

¿Puedo hacer esto desde la línea de comandos en Syspanel?

Sí, si tu plan de hosting incluye acceso SSH. Pero para la mayoría de usuarios, phpMyAdmin es más seguro y fácil.

¿Afecta esto al rendimiento de mi tienda?

No, al contrario. UTF-8 es eficiente y compatible. Puede mejorar la experiencia de usuario al mostrar correctamente los textos.

¿Qué hago si mi PrestaShop no carga después del cambio?

Revisa el archivo config/settings.inc.php para asegurarte de que el charset está definido. Si el problema persiste, restaura el backup que hiciste al principio.

Consejos adicionales para mantener tu base de datos en UTF-8

Actualiza PrestaShop regularmente: Las versiones nuevas suelen manejar mejor los charset.
Evita subir productos con caracteres extraños: Siempre que puedas, escribe en UTF-8 desde el principio.
Haz backups periódicos: En Syspanel, puedes programar backups automáticos de tu base de datos.
Usa herramientas de migración: Si vienes de otro hosting, asegúrate de que el charset se mantenga durante la transferencia.

Conclusión

Configurar el charset UTF-8 en MySQL para PrestaShop en Syspanel no es complicado, pero requiere seguir los pasos con cuidado. Recuerda:

Accede a Syspanel por el puerto 2106.
Usa phpMyAdmin para cambiar el charset de la base de datos y las tablas.
Ajusta la configuración de PrestaShop.
Verifica con un producto de prueba.

Si has seguido esta guía, tu tienda ahora mostrará correctamente todos los caracteres especiales. ¡Adiós a los signos raros!

[TIP] Si te surge cualquier duda, no dudes en contactar con nuestro soporte técnico. Estamos aquí para ayudarte.

¿Te ha sido útil este artículo? Compártelo con otros usuarios de Syspanel que puedan necesitarlo. ¡Buena suerte con tu tienda!