Guía técnica: Cómo migrar de PrestaShop 1.7 a PrestaShop 9 sin romper tu tienda

Cómo migrar de PrestaShop 1.7 a PrestaShop 9

¿Por qué migrar a PrestaShop 9?

PrestaShop 9 no es una actualización incremental más. Es una reconstrucción profunda de la plataforma que afecta al core tecnológico, la arquitectura del back office, la API, el sistema de temas y la forma en que los módulos interactúan con el sistema. Seguir en PrestaShop 1.7 supone trabajar sobre una base tecnológica que dejará de recibir soporte y actualizaciones de seguridad, lo que expone a tu tienda a vulnerabilidades crecientes.

Las razones principales para dar el salto son claras: Symfony 6.4 LTS como framework base (con soporte hasta 2027), compatibilidad con PHP 8.1 a 8.4, una nueva Admin API basada en API Platform, un back office completamente reconstruido con Symfony y Twig, y mejoras de rendimiento que en nuestras pruebas alcanzan hasta un 20% de reducción en tiempos de carga.

Pero la migración no es trivial, y hacerla mal puede significar semanas de tienda offline, pérdida de datos o un sistema inestable. En este artículo compartimos nuestra experiencia real migrando tiendas de clientes desde PrestaShop 1.7 a la versión 9, con todos los riesgos, decisiones técnicas y pasos críticos que debes conocer.

Antes de empezar: auditoría técnica de tu tienda actual

Inventario de módulos y compatibilidad

El primer paso, y probablemente el más importante, es realizar un inventario exhaustivo de todos los módulos instalados en tu tienda PrestaShop 1.7. Para cada módulo necesitas determinar si existe una versión compatible con PrestaShop 9, si el desarrollador ha confirmado que habrá actualización, o si necesitas buscar una alternativa.

En nuestra experiencia, los módulos que más problemas generan en la migración son los de pasarela de pago, los de transporte y logística, y los que implementan overrides del core. Los módulos que usan hooks estándar y siguen las buenas prácticas de desarrollo de PrestaShop suelen adaptarse con menos fricción.

Recomendamos crear una hoja de cálculo con tres columnas: módulo, estado de compatibilidad (compatible, pendiente de actualización, sin soporte) y alternativa disponible. Este documento será tu guía durante todo el proceso.

Análisis de overrides y personalizaciones

Los overrides son uno de los puntos más críticos en cualquier migración de PrestaShop. Si tu tienda 1.7 utiliza overrides de clases o controladores del core, es muy probable que estos dejen de funcionar en PrestaShop 9 debido a los cambios en la arquitectura Symfony.

PrestaShop 9 ha migrado gran parte del back office a controladores Symfony, lo que significa que los overrides basados en el legacy controller system simplemente no aplican. Cada override necesita ser evaluado individualmente y, en muchos casos, reescrito como un módulo que utilice hooks o servicios Symfony.

Este es el área donde más tiempo se invierte en una migración real. No subestimes esta fase.

Estado del servidor y requisitos técnicos

PrestaShop 9 requiere como mínimo PHP 8.1, aunque recomendamos PHP 8.3 por rendimiento. Verifica también la versión de MySQL (mínimo 5.7, recomendado 8.0), la configuración de Nginx o Apache, y asegúrate de tener suficientes recursos de servidor para ejecutar el proceso de migración, que puede ser intensivo en CPU y memoria.

El proceso de migración paso a paso

Paso 1: Crear un entorno de staging completo

Nunca, bajo ninguna circunstancia, ejecutes la migración directamente en producción. Crea una réplica exacta de tu tienda en un entorno de staging: misma versión de PHP, misma configuración de servidor, misma base de datos (copia completa) y mismos módulos instalados.

Este entorno será donde pruebes toda la migración antes de tocar producción. En Keliam configuramos entornos de staging automatizados que se actualizan diariamente con datos de producción para que las pruebas sean lo más realistas posible.

Paso 2: Actualizar primero a la última versión de PrestaShop 1.7

Antes de saltar a PrestaShop 9, asegúrate de estar en la última versión estable de 1.7 (1.7.8.x). Esto resuelve posibles inconsistencias en la base de datos y garantiza que partes del estado de partida sea lo más limpio posible.

Paso 3: Usar el Update Assistant (antiguo 1-Click Upgrade)

PrestaShop ha rediseñado completamente su herramienta de actualización, ahora llamada Update Assistant. La nueva versión ofrece una interfaz paso a paso con generación automática de backups, detección de errores antes de iniciar el proceso, soporte para CLI (ideal para tiendas grandes) y registros detallados de cada fase.

El Update Assistant guía el proceso de migración de la base de datos, la actualización de archivos del core y la verificación de integridad post-migración. Sin embargo, no migra automáticamente los overrides ni adapta los módulos incompatibles — eso es trabajo manual.

Paso 4: Verificación post-migración

Una vez completada la migración técnica, la fase de verificación es crítica. Necesitas comprobar:

  • Catálogo: Que todos los productos, categorías, atributos, combinaciones e imágenes se han migrado correctamente.
  • Clientes: Que las cuentas de cliente, direcciones y grupos funcionan correctamente.
  • Pedidos: Que el historial de pedidos es accesible y consistente.
  • Proceso de compra: Realizar pedidos de prueba completos con diferentes métodos de pago y envío.
  • Back office: Verificar todas las secciones del nuevo panel de administración basado en Symfony.
  • Integraciones: Comprobar que las conexiones con ERP, CRM, plataformas de marketing y servicios de logística funcionan correctamente.
  • SEO: Verificar que las URLs, meta tags y redirecciones se mantienen para no perder posicionamiento.

Paso 5: Planificar el go-live

El paso a producción debe planificarse en un momento de bajo tráfico (idealmente un domingo por la noche o lunes por la mañana temprano). Prepara un plan de rollback claro por si algo falla, con backups completos de la base de datos y los archivos de la versión anterior.

Los riesgos reales que debes conocer

Incompatibilidad de módulos de pago

Los módulos de pasarela de pago son especialmente sensibles. Si tu módulo de pago no es compatible con PrestaShop 9, tu tienda no puede procesar ventas. Verifica la compatibilidad con tu proveedor de pagos semanas antes de la migración y ten siempre un plan B.

Pérdida de personalizaciones del tema

Si tu tema actual de PrestaShop 1.7 está muy personalizado, necesitarás reconstruir esas personalizaciones sobre el nuevo tema Hummingbird o sobre un tema compatible con PrestaShop 9. El tema Classic de 1.7 no es compatible directamente.

Tiempo de inactividad

Dependiendo del tamaño del catálogo y la complejidad de la tienda, la migración puede llevar desde unas horas hasta varios días. Planifica un período de mantenimiento adecuado y comunícalo a tus clientes con antelación.

Nuestra recomendación: no migrar solo

La migración de PrestaShop 1.7 a 9 es un proyecto técnico que requiere experiencia, planificación y conocimiento profundo tanto de la versión origen como de la destino. Los riesgos de una migración mal ejecutada —pérdida de datos, tienda offline, problemas de rendimiento, pérdida de SEO— pueden tener un impacto directo en la facturación.

En Keliam hemos migrado decenas de tiendas PrestaShop a lo largo de los años y conocemos los problemas más comunes antes de que aparezcan. Si estás planificando la migración de tu tienda, contacta con nuestro equipo para una evaluación técnica de tu caso particular.

Scroll al inicio