Guía para actualizar PrestaShop desde cPanel manualmente

Actualizar PrestaShop es una tarea fundamental para mantener tu tienda online segura, rápida y con las últimas funcionalidades. Aunque el panel de administración de PrestaShop ofrece opciones de actualización automática, hacerlo manualmente desde cPanel te da un control total sobre el proceso y evita posibles conflictos con módulos o temas personalizados. Esta guía está diseñada para que, incluso si no eres un experto técnico, puedas realizar la actualización paso a paso sin riesgos.

¿Por qué actualizar PrestaShop manualmente desde cPanel?

Antes de comenzar, es importante entender los beneficios de una actualización manual. A diferencia de la automática, este método te permite:

• Hacer una copia de seguridad completa de archivos y base de datos antes de tocar nada.
• Probar la actualización en un entorno de pruebas si lo deseas (aunque aquí nos centraremos en producción).
• Resolver problemas de compatibilidad con módulos o temas que podrían romperse con la nueva versión.
• Evitar tiempos de inactividad prolongados al tener control sobre cuándo y cómo se realiza el proceso.

Además, si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), recuerda que accedes a tu panel de control a través del puerto 2106 (ejemplo: tudominio.com:2106). Esto es relevante porque algunas funciones de cPanel que mencionaremos (como el administrador de archivos) pueden tener equivalentes en Syspanel, pero el flujo general es el mismo.

Requisitos previos antes de actualizar PrestaShop

Antes de ejecutar cualquier cambio, asegúrate de cumplir con estos requisitos:

• Acceso a cPanel (o Syspanel en puerto 2106) con credenciales de administrador.
• Acceso FTP o SFTP (como FileZilla) para transferir archivos si es necesario.
• Conocimiento básico de la estructura de PrestaShop: carpetas como /admin, /modules, /themes, etc.
• Versión actual de PrestaShop: identifícala desde el panel de administración (Información del servidor) o revisando el archivo config/defines.inc.php.
• Versión a la que deseas actualizar: descárgala desde PrestaShop Downloads (elige la última versión estable).

[WARNING] No intentes saltar varias versiones mayores (ej: de 1.6 a 8.0) sin antes hacer actualizaciones intermedias. Cada versión tiene requisitos de PHP y base de datos. Consulta la documentación oficial de PrestaShop para rutas de actualización seguras.

Paso 1: Realizar una copia de seguridad completa

Este es el paso más crítico. Sin una copia de seguridad, cualquier error podría dejar tu tienda inaccesible. Haz lo siguiente:

1.1. Copia de seguridad de la base de datos

1. Accede a cPanel y busca la sección phpMyAdmin.
2. Selecciona la base de datos de tu PrestaShop (generalmente tiene un prefijo como prestashop_).
3. Ve a la pestaña Exportar y elige el método Rápido con formato SQL.
4. Guarda el archivo .sql en tu computadora con un nombre descriptivo, por ejemplo: backup_prestashop_2025-03-28.sql.

[TIP] Si usas Syspanel, busca la opción "Bases de datos" y luego "phpMyAdmin". El proceso es idéntico.

1.2. Copia de seguridad de los archivos

1. En cPanel, ve a Administrador de archivos y navega hasta la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta como tienda).
2. Selecciona todos los archivos y carpetas (puedes marcar la casilla superior para seleccionar todo).
3. Haz clic en Comprimir y elige Zip. Esto creará un archivo como archive.zip.
4. Descarga ese archivo a tu computadora. Si es muy grande (más de 500 MB), considera usar FTP para mayor estabilidad.

[INFO] Una copia de seguridad completa te permite restaurar todo en segundos si algo sale mal. No la omitas.

Paso 2: Preparar el entorno de actualización

Antes de subir los nuevos archivos, debes asegurarte de que tu servidor cumpla con los requisitos de la nueva versión de PrestaShop.

2.1. Verificar la versión de PHP

1. En cPanel, busca Seleccionar versión de PHP (o MultiPHP Manager).
2. Comprueba la versión actual. PrestaShop 8.x requiere PHP 7.4 o superior (recomendado PHP 8.0 o 8.1).
3. Si es necesario, cambia la versión. Importante: anota la versión anterior por si necesitas revertir.

2.2. Desactivar la tienda temporalmente

Para evitar que los clientes vean errores durante la actualización:

1. Accede al panel de administración de PrestaShop.
2. Ve a Parámetros de la tienda > Mantenimiento.
3. Activa la opción Sí, la tienda está desactivada y guarda los cambios. Esto mostrará un mensaje de mantenimiento.

[WARNING] Si no puedes acceder al panel, edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a false para forzar el modo mantenimiento desde el código.

Paso 3: Descargar y subir los archivos de la nueva versión

Ahora viene la parte manual. Sigue estos pasos con cuidado:

3.1. Descargar la última versión de PrestaShop

1. Ve a PrestaShop Downloads y descarga el archivo ZIP de la versión completa (no la versión "light" o "blank").
2. Extrae el contenido en tu computadora. Obtendrás una carpeta con todos los archivos de PrestaShop.

3.2. Subir los archivos al servidor (excepto la carpeta admin y config)

Aquí viene el truco: nunca sobrescribas la carpeta /admin (que contiene tu panel personalizado) ni /config (que tiene configuraciones de base de datos). Tampoco debes sobrescribir /themes si tienes un tema personalizado, ni /modules si has instalado módulos de pago.

1. Conéctate por FTP o usa el Administrador de archivos de cPanel.
2. Navega a la carpeta raíz de tu tienda.
3. Elimina las carpetas que serán reemplazadas (excepto las mencionadas). Una lista segura para eliminar:
   • /classes
   • /controllers
   • /docs
   • /download (solo si no tienes productos digitales)
   • /img (si no tienes imágenes personalizadas, pero mejor conservar)
   • /js
   • /localization
   • /mails
   • /override
   • /pdf
   • /src
   • /tools
   • /translations
   • /vendor
   • Archivos sueltos como index.php, init.php, etc.
4. Sube los archivos de la nueva versión (la carpeta extraída) a la raíz, permitiendo que sobrescriban los existentes. No subas las carpetas admin y config de la nueva versión.

[TIP] Si tienes dudas sobre qué eliminar, mejor no borres nada. Simplemente sube los archivos nuevos y deja que sobrescriban los antiguos. Pero asegúrate de no sobrescribir admin ni config.

Paso 4: Ejecutar el proceso de actualización

Una vez subidos los archivos, es hora de correr el script de actualización.

4.1. Acceder al script de actualización

1. En tu navegador, escribe la URL de tu tienda seguida de /install/upgrade/upgrade.php. Por ejemplo: https://tutienda.com/install/upgrade/upgrade.php.
2. Si todo está correcto, verás una interfaz que te guiará. Importante: si aparece un error de permisos, asegúrate de que la carpeta /install tenga permisos 755.

4.2. Seguir los pasos del asistente

El asistente de actualización te pedirá:

• Seleccionar la versión de origen: elige la que tenías antes (la que identificaste al inicio).
• Confirmar la base de datos: verifica que los datos sean correctos.
• Ejecutar las migraciones: el script modificará la base de datos para adaptarla a la nueva versión.

[WARNING] No cierres el navegador ni interrumpas el proceso. Puede tardar varios minutos dependiendo del tamaño de tu base de datos.

4.3. Finalizar y eliminar la carpeta /install

Una vez que el asistente termine, verás un mensaje de éxito. Inmediatamente:

1. Elimina la carpeta /install del servidor (desde cPanel o FTP). Si no lo haces, tu tienda será vulnerable.
2. Vuelve a activar la tienda desde el panel de administración (Parámetros > Mantenimiento > desactivar mantenimiento).

Paso 5: Verificar la actualización y solucionar problemas comunes

Después de la actualización, realiza estas comprobaciones:

5.1. Revisar el front-end y back-end

• Accede a tu tienda como cliente: ¿se ve correctamente? ¿Los productos, categorías y carritos funcionan?
• Inicia sesión en el panel de administración (la URL puede haber cambiado si la carpeta admin se renombró automáticamente). Ve a Información del servidor para confirmar la nueva versión.

5.2. Probar módulos y temas

• Ve a Módulos > Catálogo de módulos y verifica que los módulos estén actualizados. Muchos módulos de terceros requieren actualizaciones específicas.
• Si tu tema personalizado da errores, consulta con el desarrollador. A veces es necesario regenerar los archivos de plantilla.

5.3. Errores comunes y soluciones

• Error 500 (Internal Server Error): Revisa los logs de error en cPanel (Sección "Errores" o "Registros de errores"). Suele ser por incompatibilidad de PHP o archivos corruptos. Vuelve a subir los archivos de la nueva versión.
• Base de datos no actualizada: Ejecuta nuevamente el script de actualización. Si persiste, restaura la copia de seguridad.
• Módulos desactivados: Actívalos manualmente desde el panel. Si alguno no funciona, búscalo en el marketplace.

[INFO] Si usas Syspanel, los logs de error los encuentras en la sección "Registros" del panel. Recuerda que el acceso es por puerto 2106.

Preguntas frecuentes (FAQ) sobre actualizar PrestaShop desde cPanel

¿Puedo actualizar PrestaShop sin cPanel?

Sí, usando FTP o SSH. Pero cPanel facilita la gestión de archivos y bases de datos. Si tu hosting usa Syspanel, el proceso es similar.

¿Qué hago si no recuerdo mi versión actual de PrestaShop?

Revisa el archivo config/defines.inc.php (línea _PS_VERSION_) o el panel de administración en "Información del servidor".

¿Es necesario eliminar la carpeta /install después de actualizar?

Sí, es obligatorio por seguridad. Si no la eliminas, cualquiera podría reinstalar PrestaShop y borrar tu tienda.

¿Pierdo mis productos, clientes o pedidos al actualizar?

No, si sigues los pasos correctamente. La actualización solo modifica la estructura de la base de datos y los archivos del núcleo. Tus datos se conservan.

¿Qué hago si la actualización falla a mitad del proceso?

Restaura tu copia de seguridad: sube los archivos antiguos y la base de datos desde phpMyAdmin. Luego, intenta nuevamente, pero primero verifica los requisitos de PHP y la compatibilidad de módulos.

¿Puedo actualizar desde PrestaShop 1.6 directamente a 8.0?

No. Debes hacerlo por pasos: 1.6 -> 1.7 -> 8.0. Cada salto mayor requiere su propio script de actualización. Descarga las versiones intermedias desde el sitio oficial.

Conclusión

Actualizar PrestaShop manualmente desde cPanel es un proceso que, aunque requiere cuidado, te da control total sobre tu tienda. Siguiendo esta guía, has aprendido a hacer copias de seguridad, preparar el entorno, subir archivos, ejecutar el script de actualización y verificar que todo funcione. Recuerda siempre mantener copias de seguridad actualizadas y probar en un entorno de desarrollo si es posible.

Si encuentras algún problema, no dudes en consultar la documentación oficial de PrestaShop o contactar a tu proveedor de hosting. Con práctica, este proceso se volverá rutinario y tu tienda estará siempre al día. ¡Buena suerte!