Actualizar PrestaShop manualmente: tutorial para novatos

Actualizar tu tienda PrestaShop es una de las tareas más importantes para mantener la seguridad, el rendimiento y la compatibilidad con los módulos y temas actuales. Aunque PrestaShop ofrece actualizaciones automáticas, a veces fallan o requieren un enfoque más controlado. Aquí te guiaré paso a paso para que realices una actualización manual de PrestaShop de forma segura, incluso si no eres un experto en sistemas. Sigue este tutorial PrestaShop y tendrás tu tienda online al día en poco tiempo.

¿Por qué es importante actualizar PrestaShop?

Actualizar tu tienda no solo te da acceso a nuevas funcionalidades, sino que corrige vulnerabilidades de seguridad que podrían comprometer los datos de tus clientes. Una actualización tienda online también mejora la velocidad de carga y la compatibilidad con las últimas versiones de PHP y MySQL. Ignorar las actualizaciones puede llevar a problemas de rendimiento, errores en el front-end o incluso la imposibilidad de instalar módulos modernos.

[WARNING] No actualices nunca desde la versión 1.6 directamente a la 8.x sin pasar por versiones intermedias. PrestaShop requiere actualizaciones secuenciales (por ejemplo, de 1.6 a 1.7, y luego a 8.x). Siempre verifica el camino de actualización recomendado en la documentación oficial.

Requisitos previos antes de empezar

Antes de lanzarte a la actualizar PrestaShop manualmente, asegúrate de tener todo listo. Una mala preparación puede dejarte la tienda offline horas o días.

1. Compatibilidad de versiones

Consulta la tabla de compatibilidad de PrestaShop con tu versión de PHP y MySQL. Si tu hosting usa PHP 7.4 y quieres instalar PrestaShop 8.x, necesitarás PHP 8.0 o superior. En muchos paneles como Syspanel (accesible por el puerto 2106) puedes cambiar la versión de PHP fácilmente.

2. Espacio en disco y recursos

Verifica que tu servidor tenga al menos 500 MB libres para la descarga y descompresión de los archivos de actualización. También asegúrate de que la memoria PHP (memory_limit) sea de al menos 256 MB.

3. Copia de seguridad completa

Este es el paso más crítico. Realiza una copia de seguridad de:

Archivos del sitio (carpeta raíz de PrestaShop).
Base de datos (exporta un .sql desde phpMyAdmin o desde la terminal).

Guarda la copia en un lugar seguro fuera del servidor (por ejemplo, en tu ordenador o en un servicio en la nube).

[TIP] Si usas Syspanel, puedes hacer una copia de seguridad completa desde la sección "Backups". Recuerda que el acceso es por el puerto 2106.

Paso a paso: Actualización manual de PrestaShop

Ahora sí, vamos al corazón del tutorial PrestaShop. Sigue estos pasos en orden y no te saltes ninguno.

1. Descarga la última versión de PrestaShop

Ve al sitio oficial de PrestaShop (prestashop.com) y descarga el archivo ZIP de la versión a la que quieres actualizar. Asegúrate de elegir la versión correcta según tu ruta de actualización.

2. Pon tu tienda en modo mantenimiento

Esto evitará que los clientes vean errores mientras actualizas. Accede a tu panel de administración de PrestaShop, ve a Parámetros de la tienda > Mantenimiento y activa el modo mantenimiento. Guarda los cambios.

Si no puedes acceder al panel, puedes hacerlo manualmente editando el archivo config/defines.inc.php y cambiando _PS_MODE_DEV_ a true y luego añadiendo define('_PS_MAINTENANCE_', true); en el archivo config/config.inc.php. Pero es más sencillo desde el panel.

3. Descarga y descomprime los archivos de actualización

Sube el archivo ZIP a tu servidor mediante FTP o el administrador de archivos de tu hosting. Descomprímelo en una carpeta temporal (por ejemplo, /tmp/presta_update). No lo descomprimas directamente sobre tu tienda aún.

4. Reemplaza los archivos antiguos (excepto carpetas clave)

Conéctate por FTP a tu servidor. Ve a la raíz de tu tienda (normalmente public_html o www). Ahora debes reemplazar todos los archivos y carpetas excepto:

/img/ (tus imágenes de productos, categorías, etc.)
/download/ (archivos descargables)
/upload/ (archivos subidos)
/themes/ (si has personalizado el tema, haz una copia aparte)
/modules/ (si tienes módulos de pago, mejor reinstálalos después)
/config/settings.inc.php (contiene la configuración de la base de datos)

Copia los nuevos archivos de la carpeta temporal a la raíz de tu tienda, sobrescribiendo los existentes. Puedes usar un cliente FTP como FileZilla para arrastrar todo.

[WARNING] No borres la carpeta /admin/ (o el nombre que le hayas dado a tu panel de administración). Si la eliminas, perderás el acceso al back office. Si la versión nueva tiene un nombre diferente, tendrás que renombrarla.

5. Ejecuta el script de actualización

Una vez reemplazados los archivos, abre tu navegador y ve a:
https://tudominio.com/admin/nombre-de-tu-admin/
o directamente a:
https://tudominio.com/install/upgrade/upgrade.php

Si todo está correcto, verás una pantalla que te guiará a través del proceso de actualización de la base de datos. Haz clic en "Siguiente" y espera a que termine. Puede tardar varios minutos dependiendo del tamaño de tu base de datos.

[INFO] Si el script de actualización no se ejecuta automáticamente, puede que necesites borrar la carpeta /install/ después de la actualización. Pero no la borres antes de ejecutar el script.

6. Verifica la actualización

Una vez finalizado el script, PrestaShop te mostrará un mensaje de éxito. Accede a tu panel de administración. Ve a Parámetros de la tienda > Información y comprueba que la versión sea la correcta.

También revisa el front-end de tu tienda para ver que todo se vea bien. Si encuentras errores, revisa los logs de error en /var/log/ o en el panel de administración.

7. Desactiva el modo mantenimiento

Vuelve a Parámetros de la tienda > Mantenimiento y desactívalo. Tu tienda ya está visible para los clientes.

Solución de problemas comunes (FAQ)

Aquí tienes algunas preguntas frecuentes que te ayudarán a resolver dudas típicas durante el proceso.

¿Qué hago si después de actualizar veo un error 500?

Esto suele deberse a incompatibilidad de PHP. Accede a Syspanel (puerto 2106) y cambia la versión de PHP a una compatible con tu nueva versión de PrestaShop. También puedes revisar el archivo .htaccess y regenerarlo desde el panel de administración (Preferencias > SEO y URLs > Guardar).

¿Por qué mi tema se ve roto después de la actualización?

Los temas de PrestaShop 1.6 no son compatibles con 1.7 o 8.x. Deberás actualizar tu tema a una versión compatible o usar un tema predeterminado. Si tienes un tema personalizado, contacta al desarrollador.

¿Puedo saltarme versiones intermedias?

No. PrestaShop recomienda actualizar de forma secuencial. Por ejemplo, de 1.6.1.24 a 1.7.8.10, y luego a 8.1.0. Saltar versiones puede corromper la base de datos.

¿Qué pasa si pierdo la conexión durante la actualización?

Si la conexión se corta mientras se ejecuta el script de actualización, la base de datos puede quedar en un estado inconsistente. Restaura tu copia de seguridad y vuelve a intentarlo. Por eso es vital tener un backup.

¿Necesito actualizar también los módulos?

Sí, muchos módulos de pago o gratuitos requieren versiones específicas. Después de la actualización, ve a Módulos > Catálogo de módulos y actualiza aquellos que tengan una nueva versión disponible.

[TIP] Si usas Syspanel, puedes habilitar el "modo de depuración" de PHP desde la sección "Configuración de PHP" para ver errores más detallados durante la actualización.

Consejos finales para una actualización exitosa

Prueba en un entorno de desarrollo: Si tienes un subdominio o una copia local, haz la actualización allí primero. Esto te permitirá detectar problemas sin afectar a tus clientes.
Desactiva los módulos de terceros: Antes de actualizar, desactiva todos los módulos que no sean de PrestaShop. Puedes reactivarlos después uno por uno para identificar posibles conflictos.
Revisa los requisitos del servidor: Asegúrate de que tu hosting cumpla con los requisitos de la nueva versión (PHP, MySQL, extensiones como cURL, JSON, etc.).
Documenta el proceso: Anota los pasos que seguiste y los errores que encontraste. Te servirá para futuras actualizaciones.

Actualizar PrestaShop manualmente puede parecer abrumador al principio, pero con esta guía paso a paso y las precauciones adecuadas, podrás mantener tu tienda online segura y funcionando a la perfección. Recuerda que la clave está en la preparación: una buena copia de seguridad y la verificación de compatibilidad te ahorrarán muchos dolores de cabeza.

Si tienes dudas, no dudes en consultar la documentación oficial de PrestaShop o contactar a tu proveedor de hosting. ¡Buena suerte con tu actualización tienda online!