Actualizar PrestaShop cPanel: paso a paso sin problemas

Introducción: ¿Por qué actualizar PrestaShop?

Actualizar tu tienda PrestaShop no es solo cuestión de tener la última versión; es una cuestión de seguridad, rendimiento y compatibilidad. Las versiones antiguas suelen tener vulnerabilidades conocidas que los hackers aprovechan para robar datos de clientes o inyectar malware. Además, cada actualización trae mejoras de velocidad, nuevas funcionalidades y correcciones de errores. Si usas cPanel, el proceso es más manejable de lo que parece, pero requiere seguir una serie de pasos con cuidado para evitar romper la tienda. En esta guía te explicaré cómo hacer una actualizar PrestaShop cPanel de forma segura, sin perder datos y sin errores. Vamos paso a paso.

Requisitos previos antes de actualizar

Antes de tocar cualquier archivo, asegúrate de cumplir con estos requisitos básicos. Si no los tienes, la actualización puede fallar o dejar tu tienda inaccesible.

Verifica la compatibilidad de tu hosting

PrestaShop 8.x requiere PHP 7.4 o superior (idealmente 8.0 o 8.1), MySQL 5.6+ y al menos 256 MB de memoria PHP. Desde cPanel, puedes revisar esto en la sección Seleccionar versión de PHP (dentro de Software). Si tu hosting no cumple, la guía actualizar PrestaShop incluye primero actualizar PHP.

Haz una copia de seguridad completa

Este paso es obligatorio. Una mala actualización puede borrar productos, pedidos o configuraciones. Desde cPanel, usa la herramienta Backup (dentro de Archivos) para descargar:

El directorio público (todo el contenido de public_html o la carpeta donde tengas PrestaShop).
La base de datos (opción "Descargar una copia de seguridad de la base de datos MySQL").

Guarda estos archivos en tu computadora y también en un almacenamiento externo (Google Drive, Dropbox). No confíes solo en una copia.

Pon la tienda en modo mantenimiento

Para que los clientes no vean errores durante la actualización, activa el modo mantenimiento. En el panel de administración de PrestaShop, ve a Parámetros de la tienda > Mantenimiento y marca la opción "Sí" en "Activar modo mantenimiento". También puedes añadir tu propia IP para seguir accediendo.

Método 1: Actualización automática usando el módulo 1-Click Upgrade

Este es el método más recomendado para la mayoría de usuarios, ya que el módulo oficial de PrestaShop automatiza gran parte del proceso. Sin embargo, debes usarlo con cuidado.

Paso 1: Descarga e instala el módulo

Desde el back office de tu tienda, ve a Módulos > Catálogo de módulos y busca "1-Click Upgrade". Si no lo ves, descárgalo desde la página de Addons de PrestaShop (gratuito) y súbelo manualmente desde Módulos > Subir módulo. Una vez instalado, actívalo.

Paso 2: Configura el módulo

Ve a Mejora > 1-Click Upgrade. Verás una interfaz con opciones. Lo más importante:

Canal de actualización: Selecciona "Estable" (no "RC" ni "Beta").
Versión destino: Elige la última versión estable (por ejemplo, 8.1.2 si estás en 1.7.x).
Opciones avanzadas: Marca "Guardar copia de seguridad automática" (aunque ya tengas una manual, por si acaso).

Paso 3: Ejecuta la actualización

Haz clic en Actualizar PrestaShop ahora. El proceso puede tardar varios minutos. No cierres la ventana del navegador ni apagues el ordenador. El módulo descargará los archivos nuevos, modificará la base de datos y aplicará los cambios.

Posibles errores comunes

Error de tiempo de ejecución: Si tu hosting tiene un límite de tiempo bajo (menos de 300 segundos), el proceso se corta. Puedes aumentarlo desde cPanel en Seleccionar versión de PHP > Opciones de PHP y subir max_execution_time a 600.
Error de memoria: Aumenta memory_limit a 256M o 512M en el mismo lugar.
Error de archivo no encontrado: Suele ocurrir si hay archivos corruptos. Entonces toca el método manual.

Método 2: Actualización manual paso a paso (para casos difíciles)

Si el módulo automático falla o prefieres tener control total, la actualización manual es la alternativa. Requiere más trabajo, pero es más fiable.

Paso 1: Descarga la última versión de PrestaShop

Ve a prestashop.com y descarga el paquete completo de la versión más reciente. Descomprímelo en tu computadora.

Paso 2: Sube los archivos por FTP o cPanel

Desde cPanel, usa el Administrador de archivos o un cliente FTP (como FileZilla). Navega a la carpeta donde tienes PrestaShop (normalmente public_html). Importante: No borres nada todavía. Simplemente sube el contenido de la nueva versión, sobrescribiendo los archivos existentes. Asegúrate de que los permisos de archivos sean 644 y carpetas 755.

Paso 3: Actualiza la base de datos

Una vez subidos los archivos, ve a tu navegador y accede a tudominio.com/install/upgrade/upgrade.php. Si no existe ese archivo, créalo con el contenido adecuado (puedes descargarlo de la documentación de PrestaShop). Este script modificará la base de datos para que coincida con la nueva versión. Sigue las instrucciones en pantalla.

Paso 4: Verifica y limpia

Después de la actualización, elimina la carpeta /install (por seguridad) y la carpeta /admin antigua si cambió. Luego, desde el back office, ve a Mejora > Rendimiento y limpia la caché.

Solución de problemas post-actualización

Incluso siguiendo los pasos, pueden surgir problemas. Aquí los más frecuentes y cómo resolverlos.

La tienda se ve en blanco (pantalla en blanco)

Esto suele ser por errores de PHP. Activa los errores editando el archivo /config/defines.inc.php y cambiando define('_PS_MODE_DEV_', false); a define('_PS_MODE_DEV_', true);. Así verás el mensaje de error. Luego, corrige según lo que aparezca (normalmente es por incompatibilidad de módulos o plantillas).

Los módulos o temas no funcionan

Muchos módulos dejan de ser compatibles con versiones nuevas. Ve a Módulos > Catálogo de módulos y busca actualizaciones para cada módulo. Si no hay, contacta al desarrollador. Los temas también pueden requerir ajustes; a veces toca modificar archivos .tpl o .css.

Errores en la base de datos

Si ves mensajes como "Error en la tabla", desde cPanel usa phpMyAdmin y repara las tablas dañadas (selecciona todas y elige "Reparar tabla"). También puedes ejecutar una consulta SQL desde el back office en Mejora > Base de datos.

Preguntas frecuentes (FAQ)

¿Puedo saltarme una versión (ej. de 1.6 a 8.0)?

No es recomendable. PrestaShop recomienda actualizar versión por versión (1.6 -> 1.7 -> 8.0). Saltar varias versiones puede causar conflictos en la base de datos. Si insistes, haz una copia de seguridad y prueba en un entorno de desarrollo.

¿Qué hago si pierdo el acceso al back office?

Puedes restaurar desde la copia de seguridad. Si solo es un error de login, intenta restablecer la contraseña desde la base de datos (tabla ps_employee). También puedes crear un nuevo administrador mediante un script SQL.

¿Cuánto tiempo tarda una actualización?

Depende del tamaño de la tienda y del hosting. Una tienda pequeña (menos de 1000 productos) puede tardar entre 10 y 30 minutos. Una grande puede llevar horas. No lo hagas en horario pico.

¿Necesito ayuda profesional?

Si tu tienda maneja mucho tráfico o tienes personalizaciones complejas, considera contratar a un desarrollador. Un error puede costarte ventas y datos de clientes.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero accedes al panel por el puerto 2106. Por ejemplo: https://tudominio.com:2106. Las herramientas de backup y archivos se llaman diferente, pero la lógica es la misma.

Consejos finales para una actualización exitosa

Prueba en un entorno de desarrollo: Si puedes, clona tu tienda en un subdominio o carpeta de prueba. Así verificas que todo funciona antes de tocar la tienda real.
Desactiva módulos no esenciales: Antes de actualizar, desactiva módulos de terceros que no sean críticos. Muchos causan conflictos.
Revisa los logs: Después de actualizar, revisa los logs de errores en cPanel (sección Errores > Error log) para detectar problemas ocultos.
Mantén todo actualizado: No solo PrestaShop, también los módulos, temas y la versión de PHP. Un ecosistema desactualizado es un blanco fácil.

Actualizar PrestaShop en cPanel puede parecer intimidante, pero con esta guía paso a paso y las precauciones adecuadas, lo harás sin errores. Recuerda: la copia de seguridad es tu mejor amiga. Si algo sale mal, siempre puedes volver atrás. ¡Manos a la obra y suerte con tu tienda!