Migrar PrestaShop de MySQL a MariaDB en Syspanel | Tutorial

¿Por qué migrar de MySQL a MariaDB en PrestaShop?

Si estás leyendo esto, probablemente te hayas preguntado si vale la pena dar el salto de MySQL a MariaDB para tu tienda PrestaShop. La respuesta corta es: sí, casi siempre merece la pena. MariaDB es un fork directo de MySQL creado por los desarrolladores originales, y ofrece mejoras notables en rendimiento, velocidad de consultas y compatibilidad con motores de almacenamiento avanzados como InnoDB y Aria.

Para que te hagas una idea, MariaDB suele ser entre un 10% y un 30% más rápido en cargas de trabajo típicas de comercio electrónico. Además, es completamente compatible con las consultas y estructuras de PrestaShop, por lo que no tendrás que tocar ni una sola línea de código de tu tienda. En Syspanel, esta migración es un proceso sencillo si sigues los pasos que te explicamos a continuación, incluso si no tienes experiencia técnica avanzada.

Antes de empezar, ten en cuenta que migrar base de datos es una operación delicada. Por eso, vamos a dividir el proceso en fases claras: preparación, exportación, importación y verificación. Sigue cada paso con calma y, ante cualquier duda, consulta las secciones de preguntas frecuentes al final del artículo.

Preparación antes de migrar PrestaShop a MariaDB

Haz una copia de seguridad completa

Este es el paso más importante de todo el proceso. No migres jamás sin una copia de seguridad reciente. Una mala migración puede corromper los datos de tu tienda, y sin un respaldo podrías perder pedidos, clientes o catálogo entero.

Para hacer la copia desde Syspanel, sigue estos pasos:

Accede a tu panel de control Syspanel a través del puerto 2106 (por ejemplo: https://tu-servidor:2106).
Ve a la sección Bases de Datos y localiza la base de datos de tu PrestaShop.
Haz clic en el botón Exportar o Descargar copia. Elige el formato SQL.
Guarda el archivo .sql en tu ordenador y también en un lugar seguro en la nube (Google Drive, Dropbox, etc.).

[WARNING] No confíes solo en la copia que hace Syspanel automáticamente. Descarga tu propia copia manual antes de tocar nada. La seguridad nunca está de más.

Comprueba la versión de PrestaShop y los requisitos

Antes de migrar PrestaShop MariaDB, verifica que tu versión de PrestaShop es compatible con MariaDB. La práctica totalidad de versiones de PrestaShop 1.6, 1.7 y 8.x funcionan perfectamente con MariaDB 10.x. Si usas una versión muy antigua (1.5 o inferior), puede haber problemas de compatibilidad con funciones SQL obsoletas.

También es recomendable anotar los datos de conexión de tu base de datos actual:

Nombre de la base de datos.
Usuario y contraseña.
Host (normalmente localhost).

Estos datos los encontrarás en el archivo app/config/parameters.php de tu instalación de PrestaShop. Ábrelo con un editor de texto y anota los valores de database_host, database_name, database_user y database_password.

Exportar la base de datos desde MySQL

Accede a phpMyAdmin en Syspanel

Syspanel incluye phpMyAdmin para gestionar tus bases de datos de forma gráfica. Para acceder:

Entra en Syspanel por el puerto 2106.
Ve a la sección Bases de Datos.
Haz clic en el botón phpMyAdmin junto a tu base de datos.

Una vez dentro, asegúrate de que la base de datos seleccionada es la correcta (debería aparecer en el menú lateral izquierdo).

Exporta la base de datos en formato SQL

En phpMyAdmin, sigue estos pasos:

Haz clic en la pestaña Exportar en el menú superior.
Selecciona el método Rápido (exporta todas las tablas).
En formato, elige SQL.
Marca la opción COMPRIMIDO con gzip si el archivo es muy grande (más de 100 MB). Esto facilitará la descarga.
Haz clic en Continuar o Exportar.

Se descargará un archivo .sql o .sql.gz. Guárdalo en una carpeta fácil de localizar.

[TIP] Si tu base de datos es enorme (más de 1 GB), la exportación desde phpMyAdmin puede fallar por límites de tiempo. En ese caso, usa la línea de comandos SSH: mysqldump -u usuario -p nombre_bd > backup.sql. Syspanel permite acceso SSH a tu servidor.

Crear la nueva base de datos MariaDB en Syspanel

Accede al gestor de bases de datos de Syspanel

Ahora necesitamos crear una base de datos nueva que usará MariaDB. En Syspanel, el proceso es muy visual:

Ve a Syspanel por el puerto 2106.
Entra en Bases de Datos.
Haz clic en Añadir base de datos o Crear nueva.

Configura los datos de la nueva base

Rellena los campos:

Nombre de la base: por ejemplo, prestashop_mariadb.
Usuario: elige un usuario nuevo o uno existente.
Contraseña: genera una contraseña segura y guárdala.

Asegúrate de que el motor de la base de datos sea MariaDB. En Syspanel, esto suele venir configurado por defecto, ya que el panel usa MariaDB como motor nativo. Si ves la opción, selecciona utf8mb4 como cotejamiento (collation) para evitar problemas con caracteres especiales y emojis.

Importar la base de datos a MariaDB

Sube el archivo SQL a la nueva base

Ahora viene el momento de importar los datos. Vuelve a abrir phpMyAdmin, pero esta vez seleccionando la base de datos nueva que acabas de crear.

Haz clic en la pestaña Importar.
Haz clic en Elegir archivo y selecciona el .sql (o .sql.gz) que exportaste antes.
Deja el resto de opciones por defecto.
Haz clic en Continuar.

La importación puede tardar varios minutos si la base es grande. No cierres la pestaña del navegador mientras se ejecuta. Verás un mensaje de éxito al final.

Solución de errores comunes al importar

Si aparece un error de "duplicado de clave primaria", significa que la base ya contenía datos. En ese caso, elimina las tablas de la base nueva antes de importar (puedes marcar todas las tablas y elegir "Vaciar" o "Eliminar").

Si el error es de "formato de archivo no reconocido", asegúrate de que el archivo termina en .sql o .sql.gz. Si lo has descargado como .zip, descomprímelo antes.

Configurar PrestaShop para usar la nueva base MariaDB

Modifica el archivo de configuración de PrestaShop

Ahora debes indicarle a PrestaShop que use la nueva base de datos MariaDB. Esto se hace editando el archivo app/config/parameters.php.

Accede a tu servidor por FTP o a través del administrador de archivos de Syspanel. Localiza el archivo y edítalo con un editor de texto plano (nunca con Word o editores que añadan formato).

Busca las líneas que empiezan por 'database_' y cámbialas:

'database_host' => 'localhost' (normalmente no cambia).
'database_name' => 'prestashop_mariadb' (pon el nombre de tu nueva base).
'database_user' => 'tu_usuario' (el usuario que creaste).
'database_password' => 'tu_contraseña' (la contraseña nueva).

Guarda el archivo y súbelo de nuevo al servidor, reemplazando el original.

[WARNING] Antes de modificar el archivo, descarga una copia del original por si necesitas revertir los cambios. Un error de escritura puede dejar tu tienda inaccesible.

Limpia la caché de PrestaShop

Después de cambiar la configuración, es imprescindible limpiar la caché. Si no lo haces, PrestaShop seguirá intentando conectar con la base antigua.

Accede al panel de administración de PrestaShop (por ejemplo, tu-dominio.com/admin123).
Ve a Parámetros avanzados > Rendimiento.
Haz clic en Vaciar la caché (tanto la de Smarty como la de Symfony, si está disponible).

Si no puedes acceder al panel de administración, borra manualmente la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en PrestaShop 1.6). Usa el administrador de archivos de Syspanel para borrar el contenido de esas carpetas.

Verificar que la migración fue exitosa

Comprueba el front office y el back office

Abre tu tienda en una ventana de incógnito (para evitar caché del navegador). Revisa:

Que la página principal carga correctamente.
Que puedes ver productos, categorías y precios.
Que el carrito añade productos sin errores.
Que el panel de administración inicia sesión sin problemas.

Revisa los logs de errores

Si algo falla, revisa los logs de error de PrestaShop. Están en la carpeta var/logs (PrestaShop 1.7 y 8) o log (PrestaShop 1.6). Los errores típicos de conexión aparecen como SQLSTATE[HY000] [1045] Access denied. Eso significa que las credenciales son incorrectas.

Preguntas frecuentes sobre migrar PrestaShop a MariaDB

¿Perderé mis pedidos o clientes al migrar?

No, si la exportación e importación se hacen correctamente, todos los datos (pedidos, clientes, productos, módulos) se transfieren íntegramente. La clave está en no borrar la base original hasta verificar que la nueva funciona.

¿Puedo volver a MySQL si algo falla?

Sí, siempre que conserves la base original. Simplemente restaura el archivo de configuración parameters.php con los datos antiguos y vuelve a limpiar la caché. La migración es reversible.

¿Syspanel usa MariaDB por defecto?

Sí, Syspanel (basado en la tecnología de HestiaCP) utiliza MariaDB como motor de base de datos predeterminado en sus servidores. Esto facilita la migración, ya que no necesitas instalar nada adicional.

¿Cuánto tarda la migración?

Depende del tamaño de tu base de datos. Una tienda pequeña (menos de 500 MB) puede migrar en 10-15 minutos. Bases de varios GB pueden requerir 1-2 horas. La mayor parte del tiempo se consume en la exportación e importación.

¿Afecta la migración al SEO de mi tienda?

No, la migración de base de datos no afecta al SEO. Tus URLs, contenidos y estructura se mantienen intactos. Eso sí, asegúrate de que no haya errores 500 durante el proceso, ya que los buscadores penalizan las caídas prolongadas.

Consejos finales para una migración sin sustos

Migra en horas de baja afluencia: preferiblemente de madrugada o en días festivos.
Avisa a tus clientes: si tu tienda va a estar inaccesible durante un rato, publica un aviso en la portada o en redes sociales.
Prueba todo: después de migrar, haz un pedido de prueba, crea un cliente de prueba y modifica un producto. Asegúrate de que todo funciona.
No borres la base antigua: consérvala al menos durante un mes. Si surge algún problema, podrás revertir fácilmente.

Migrar PrestaShop MariaDB desde MySQL en Syspanel es un proceso que, con esta guía, está al alcance de cualquier persona con nociones básicas de gestión web. La mejora de rendimiento que notarás en tu tienda merece la pena, y ahora que sabes cómo hacerlo, puedes realizarlo con confianza y seguridad.

Si te surge cualquier duda durante el proceso, no dudes en consultar la documentación de Syspanel o contactar con su soporte técnico. ¡Buena suerte con tu migración!