Actualizar PrestaShop en Syspanel: Paso a paso seguro

Mantener tu tienda PrestaShop actualizada es fundamental para garantizar la seguridad, el rendimiento y la compatibilidad con los módulos más recientes. Si gestionas tu hosting a través de Syspanel (el panel de control basado en HestiaCP, accesible por el puerto 2106), el proceso es sencillo y seguro si sigues los pasos adecuados.

En esta guía extensa, te explicaré cómo realizar una actualización de PrestaShop a la última versión en Syspanel de forma manual, paso a paso. Cubriremos desde la preparación hasta la verificación final, incluyendo consejos para evitar errores comunes.

Antes de empezar: preparativos esenciales

Antes de lanzarte a hacer el update PrestaShop Syspanel, es crucial que realices una copia de seguridad completa. Una actualización mal ejecutada puede dejar tu tienda inaccesible, así que no te saltes este paso.

1. Haz una copia de seguridad de tu tienda

Desde Syspanel, puedes respaldar tanto los archivos como la base de datos. Sigue estos pasos:

Accede a Syspanel usando tu navegador: https://tudominio.com:2106 (o la IP de tu servidor seguida de :2106).
Inicia sesión con tus credenciales de administrador.
Ve a la sección "Backup" o "Copias de seguridad".
Selecciona tu dominio o cuenta de hosting donde está instalada PrestaShop.
Marca las opciones para incluir archivos del sitio y base de datos.
Haz clic en "Crear copia de seguridad" y espera a que finalice.

[WARNING] No confíes solo en una copia de seguridad automática. Descarga también una copia local de los archivos (vía FTP) y de la base de datos (desde phpMyAdmin en Syspanel). Así tendrás un respaldo extra.

2. Verifica los requisitos del sistema

Cada nueva versión de PrestaShop puede requerir versiones específicas de PHP, MySQL y extensiones. Antes de actualizar PrestaShop Syspanel, comprueba que tu servidor cumple con lo necesario:

En Syspanel, ve a "Advanced" > "PHP Settings" y anota la versión de PHP que tienes.
Consulta los requisitos oficiales de la última versión de PrestaShop (por ejemplo, PHP 8.1 o superior para versiones recientes).
Si tu versión de PHP es inferior, actualízala desde Syspanel: en "Web" > "Proxy Template" puedes cambiar la versión de PHP para tu dominio.

[INFO] Si tu hosting tiene PHP 7.4 y la nueva versión de PrestaShop requiere PHP 8.1, deberás actualizar PHP primero. Hazlo con cuidado y prueba tu tienda antes de proceder.

3. Desactiva la tienda temporalmente

Para evitar que usuarios accedan mientras actualizas, pon tu tienda en modo mantenimiento:

Ve al panel de administración de PrestaShop (tu-dominio.com/adminXXXX).
En "Parámetros de la tienda" > "Mantenimiento", activa el modo mantenimiento.
Guarda los cambios. Así nadie verá errores durante el proceso.

Paso a paso: cómo actualizar PrestaShop a la última versión en Syspanel

Ahora que tienes todo listo, vamos a realizar la actualización manual. Este método es el más fiable porque te permite controlar cada paso.

1. Descarga la última versión de PrestaShop

Ve al sitio oficial de PrestaShop y descarga el archivo ZIP de la última versión estable (por ejemplo, 8.1.x).
No descargues versiones beta o de desarrollo, solo las etiquetadas como "Stable".

2. Sube los archivos a tu servidor a través de Syspanel

Puedes usar el administrador de archivos integrado en Syspanel o un cliente FTP (como FileZilla). Aquí te explico con el administrador de archivos:

En Syspanel, ve a "File Manager".
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o web).
Sube el archivo ZIP de PrestaShop que descargaste.
Una vez subido, haz clic derecho sobre él y selecciona "Extraer". Se creará una carpeta con el nombre de la versión (ej. prestashop_8.1.0).

3. Reemplaza los archivos antiguos con los nuevos

Este es el paso más delicado. Debes copiar los archivos de la nueva versión a la carpeta principal, pero sin sobrescribir ciertos archivos importantes:

Accede a la carpeta extraída (ej. prestashop_8.1.0).
Selecciona todos los archivos y carpetas dentro de ella (Ctrl+A).
Cópialos (Ctrl+C).
Ve a la carpeta raíz de tu tienda (public_html o web).
Pega los archivos (Ctrl+V) y cuando te pregunte si quieres sobrescribir, responde "Sobrescribir todo".

[WARNING] No copies la carpeta install si ya existe una en tu tienda. Si la copias, borra la carpeta install después de pegar. Además, nunca sobrescribas el archivo settings.inc.php ni la carpeta modules (aunque en versiones recientes esto es menos crítico).

4. Ejecuta el script de actualización

Una vez que los archivos están en su lugar, es hora de ejecutar la actualización desde el navegador:

Abre tu navegador y ve a https://tudominio.com/install/upgrade/upgrade.php.
Si no existe la carpeta install en tu tienda, créala temporalmente copiando la carpeta install de la nueva versión a la raíz.
El script te pedirá que confirmes la actualización. Haz clic en "Siguiente" o "Actualizar".
El proceso puede tardar varios minutos. No cierres la ventana ni recargues la página.

[TIP] Si ves errores de permisos, desde Syspanel ve a "Advanced" > "File Manager" y cambia los permisos de la carpeta install a 755. También asegúrate de que el usuario del servidor tenga permisos de escritura en las carpetas config, cache y log.

5. Verifica que la actualización se completó

Al finalizar, el script mostrará un mensaje de éxito. Luego:

Elimina la carpeta install de tu servidor por seguridad (desde el administrador de archivos de Syspanel).
Accede al panel de administración de PrestaShop. Primero puede que te pida que regeneres el caché o que inicies sesión de nuevo.
Ve a "Parámetros avanzados" > "Información" y comprueba que la versión mostrada es la nueva.

Solución de problemas comunes durante el update PrestaShop Syspanel

A veces las cosas no salen como esperamos. Aquí tienes las incidencias más frecuentes y cómo resolverlas.

Error de compatibilidad de PHP

Si ves un mensaje como "Se requiere PHP 8.1 o superior", significa que tu versión de PHP es antigua.

En Syspanel, ve a "Web" > "Proxy Template" y selecciona una versión de PHP más reciente (como 8.1 o 8.2).
Guarda los cambios y espera unos segundos. Luego vuelve a ejecutar el script de actualización.

La tienda muestra una página en blanco

Esto suele deberse a un error de caché o a un módulo incompatible.

Desde el administrador de archivos de Syspanel, borra la carpeta var/cache (o cache en versiones antiguas) dentro de la raíz de tu tienda.
Si no funciona, desactiva temporalmente los módulos no oficiales desde la base de datos (usando phpMyAdmin en Syspanel, busca la tabla ps_module y cambia active a 0 para módulos problemáticos).

Error "No se puede conectar a la base de datos"

Esto ocurre si los datos de conexión han cambiado o si el archivo settings.inc.php se ha corrompido.

Desde el administrador de archivos, abre app/config/parameters.php (o config/settings.inc.php en versiones antiguas).
Verifica que los datos de la base de datos (host, usuario, contraseña, nombre) sean correctos. Puedes obtenerlos desde Syspanel en "Databases".
Si todo está bien, revisa que el servicio MySQL esté activo en Syspanel (ve a "Server" > "Services" y asegúrate de que MySQL esté en verde).

El script de actualización no arranca

Asegúrate de que la carpeta install esté presente y tenga permisos 755. También verifica que no haya un archivo install.lock en la raíz (si existe, bórralo).

Preguntas frecuentes (FAQ) sobre actualizar PrestaShop Syspanel

¿Puedo saltarme versiones intermedias al actualizar PrestaShop?

No es recomendable. Lo ideal es actualizar de una versión a la siguiente (por ejemplo, de 1.7.8 a 8.0, luego a 8.1). Si intentas saltar varias versiones, es probable que encuentres errores de compatibilidad. Si estás muy atrasado, hazlo por pasos.

¿Qué pasa si mi hosting en Syspanel tiene recursos limitados?

La actualización puede consumir bastante CPU y memoria. Si tu plan es básico, considera hacerla en horas de bajo tráfico o contactar con tu proveedor para un aumento temporal de recursos.

¿Pierdo mis módulos y temas al hacer el update PrestaShop Syspanel?

No, los módulos y temas se conservan, pero algunos pueden no ser compatibles con la nueva versión. Antes de actualizar, verifica que tus módulos principales tengan actualizaciones disponibles. Si algún módulo crítico no es compatible, mejor espera a que el desarrollador lo actualice.

¿Cómo sé qué versión de PrestaShop tengo actualmente?

En el panel de administración, ve a "Parámetros avanzados" > "Información". Allí verás el número de versión. También puedes mirar el archivo VERSION en la raíz de tu tienda (acceso vía FTP o File Manager de Syspanel).

¿Es necesario desinstalar los módulos antes de actualizar?

No, pero es buena práctica desactivar módulos de terceros que no sean esenciales. Si algún módulo da error, puedes desactivarlo desde la base de datos temporalmente.

Consejos finales para un update exitoso

Prueba en un entorno de staging antes de hacer la actualización en producción. Syspanel permite crear subdominios o copias de tu tienda para pruebas.
Revisa los logs después de la actualización. En Syspanel, ve a "Advanced" > "Logs" para ver errores del servidor.
Actualiza los módulos y el tema justo después de actualizar PrestaShop. Muchos desarrolladores lanzan parches de compatibilidad.
Vuelve a activar la tienda quitando el modo mantenimiento desde el panel de administración.

[TIP] Si no te sientes seguro haciendo todo esto manualmente, algunos módulos como "1-Click Upgrade" pueden automatizar el proceso. Sin embargo, siempre es mejor tener un backup y saber qué estás haciendo.

Actualizar PrestaShop a la última versión en Syspanel no tiene por qué ser un dolor de cabeza. Siguiendo esta guía, mantendrás tu tienda segura, rápida y preparada para crecer. ¡Manos a la obra!