Actualizar PrestaShop en cPanel: guía segura paso a paso

Actualizar tu tienda PrestaShop es una tarea fundamental para mantener la seguridad, el rendimiento y la compatibilidad con las últimas funcionalidades. Sin embargo, el proceso puede parecer intimidante, especialmente si no tienes experiencia técnica. En esta guía extensa y detallada, te explicaré paso a paso cómo realizar una actualización PrestaShop segura desde tu panel de control cPanel, minimizando el riesgo de errores y pérdida de datos. Sigue cada instrucción al pie de la letra y, si tienes dudas, consulta la sección de preguntas frecuentes al final.

¿Por qué es importante mantener PrestaShop actualizado?

Antes de comenzar, es esencial entender los motivos para realizar esta tarea. Una versión desactualizada puede exponer tu tienda a vulnerabilidades de seguridad, problemas de compatibilidad con módulos y temas, y una experiencia de usuario deficiente. Además, cada nueva versión incluye mejoras de rendimiento y correcciones de errores que pueden optimizar la velocidad de carga y la estabilidad de tu sitio.

Requisitos previos antes de empezar

Para que la actualización PrestaShop cPanel sea exitosa, debes cumplir con los siguientes requisitos:

Acceso a cPanel: Necesitas las credenciales de tu hosting.
Acceso a FTP o al administrador de archivos de cPanel: Para subir y modificar archivos.
Copia de seguridad completa: Fundamental para restaurar tu tienda en caso de cualquier problema.
Tiempo suficiente: El proceso puede tomar entre 30 minutos y 2 horas, dependiendo del tamaño de tu tienda.
Conocimientos básicos: Saber navegar por cPanel y usar un cliente FTP (como FileZilla) es suficiente.

[WARNING] No intentes actualizar sin una copia de seguridad. Cualquier error puede dejar tu tienda inaccesible.

Paso 1: Realiza una copia de seguridad completa de tu tienda

Este es el paso más crítico. Una copia de seguridad te permite restaurar tu tienda al estado anterior si algo sale mal. Debes respaldar dos cosas: los archivos y la base de datos.

1.1. Respaldar archivos desde cPanel

Inicia sesión en tu cPanel (normalmente accedes mediante tudominio.com/cpanel).
Busca la sección Archivos y haz clic en Administrador de archivos.
Selecciona la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta si instalaste PrestaShop en un subdirectorio).
Marca todos los archivos y carpetas (Ctrl+A) y haz clic en Comprimir > Zip Archive.
Nombra el archivo como backup-prestashop-[fecha].zip y haz clic en Crear archivo comprimido.
Una vez creado, descárgalo a tu computadora usando el botón Descargar.

1.2. Respaldar la base de datos desde cPanel

En cPanel, ve a la sección Bases de datos y haz clic en phpMyAdmin.
En el panel izquierdo, selecciona la base de datos de tu tienda (el nombre suele ser algo como usuario_prestashop).
Haz clic en la pestaña Exportar en la parte superior.
Asegúrate de que esté seleccionado el método Rápido y el formato SQL.
Haz clic en Continuar y guarda el archivo .sql en tu computadora.

[TIP] Guarda ambas copias en una ubicación segura, como una carpeta en tu disco duro o en la nube.

Paso 2: Verifica los requisitos del sistema para la nueva versión

Antes de descargar la actualización, asegúrate de que tu servidor cumple con los requisitos de la versión más reciente de PrestaShop. Puedes consultar la documentación oficial, pero los requisitos comunes incluyen:

PHP: Versión 7.4 o superior (recomendado PHP 8.0+).
MySQL: Versión 5.6 o superior (o MariaDB 10.1+).
Memoria: Al menos 256 MB de memoria PHP.
Extensiones: GD, cURL, JSON, XML, etc.

Cómo verificar tu versión de PHP desde cPanel

En cPanel, busca la sección Software y haz clic en Seleccionar versión de PHP.
Si tu versión es inferior a la requerida, cámbiala a una compatible (por ejemplo, PHP 7.4 u 8.0). Si no ves opciones, contacta a tu proveedor de hosting.

[INFO] Si usas Syspanel (anteriormente HestiaCP), accede al panel a través del puerto 2106 (ejemplo: tudominio.com:2106) y busca la sección de configuración de PHP.

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

Ve al sitio oficial de PrestaShop y descarga el paquete completo de la última versión estable. No uses versiones beta o release candidates en un sitio en producción.

URL oficial: https://www.prestashop.com/en/download
Descarga el archivo .zip que contiene todos los archivos de PrestaShop.

Paso 4: Prepara tu tienda para la actualización

Antes de subir los archivos, es necesario poner tu tienda en modo mantenimiento para evitar que los clientes accedan durante el proceso.

4.1. Activar el modo mantenimiento

Accede a tu panel de administración de PrestaShop (ejemplo: tudominio.com/admin1234).
Ve a Parámetros de la tienda > Mantenimiento.
Activa la opción Activar el modo mantenimiento.
Opcionalmente, añade una dirección IP de confianza (la tuya) para poder seguir accediendo al front-office mientras pruebas.

4.2. Desactiva módulos y temas no compatibles

Ve a Módulos > Módulos y servicios y desactiva todos los módulos de terceros.
Cambia temporalmente a un tema predeterminado (como Classic) desde Diseño > Temas.

[WARNING] Los módulos y temas no actualizados pueden causar errores graves durante la actualización. Es mejor desactivarlos temporalmente.

Paso 5: Sube los archivos de la nueva versión

Ahora viene la parte técnica. Debes reemplazar los archivos antiguos con los nuevos, pero sin sobrescribir algunos archivos importantes como la configuración y las imágenes.

5.1. Descomprime el archivo de PrestaShop

Descomprime el archivo .zip que descargaste en tu computadora. Obtendrás una carpeta llamada prestashop (o similar) que contiene todos los archivos.

5.2. Elimina archivos innecesarios antes de subir

Dentro de la carpeta descomprimida, elimina las siguientes carpetas y archivos para no sobrescribir tu configuración:

config/settings.inc.php (si existe)
img/ (contiene tus imágenes de productos)
download/ (archivos descargables)
upload/ (archivos subidos)
themes/ (a menos que quieras sobrescribir temas predeterminados)
modules/ (a menos que quieras sobrescribir módulos predeterminados)

[TIP] Si no estás seguro, solo sube los archivos sin eliminar nada, pero luego deberás tener cuidado al sobrescribir.

5.3. Sube los archivos mediante FTP o Administrador de archivos

Opción A: Usando FTP (recomendado para archivos grandes)

Conéctate a tu servidor usando un cliente FTP (como FileZilla) con las credenciales de cPanel.
Navega a la carpeta raíz de tu tienda (ejemplo: public_html).
Arrastra todos los archivos de la carpeta descomprimida a la carpeta remota.
Cuando te pregunte si deseas sobrescribir archivos, selecciona Sobrescribir o Reemplazar para todos.

Opción B: Usando el Administrador de archivos de cPanel

En cPanel, ve a Archivos > Administrador de archivos y navega a la carpeta raíz.
Haz clic en Subir y selecciona el archivo .zip de la nueva versión.
Una vez subido, selecciona el archivo y haz clic en Extraer.
Confirma la extracción y sobrescribe los archivos existentes.

[INFO] Si tu tienda es grande, la subida por FTP puede ser más rápida. El Administrador de archivos de cPanel tiene un límite de tamaño (generalmente 2 GB).

Paso 6: Ejecuta el proceso de actualización

Una vez que los archivos están en su lugar, es hora de ejecutar el script de actualización.

6.1. Accede al script de actualización

Abre tu navegador y escribe la siguiente URL:

https://tudominio.com/install/upgrade/upgrade.php

Si tu tienda está en un subdirectorio, ajusta la ruta (ejemplo: https://tudominio.com/tienda/install/upgrade/upgrade.php).

6.2. Sigue los pasos del asistente

El asistente de actualización te guiará a través de varios pasos:

Bienvenida: Lee la información y haz clic en Siguiente.
Comprobación de requisitos: El script verificará que tu servidor cumple con los requisitos. Si hay errores, corrígelos antes de continuar.
Selección de versión: Elige la versión a la que quieres actualizar (normalmente la más reciente).
Configuración de la base de datos: El script detectará automáticamente tu base de datos. Solo confirma que los datos sean correctos.
Proceso de actualización: El script comenzará a migrar los datos. No cierres la ventana ni interrumpas el proceso.
Finalización: Una vez terminado, verás un mensaje de éxito.

[WARNING] Si el proceso se detiene o muestra errores, anota el mensaje y consulta la sección de solución de problemas más abajo.

Paso 7: Verifica y limpia después de la actualización

La actualización no ha terminado. Debes realizar algunas comprobaciones y limpiezas.

7.1. Elimina la carpeta `install`

Por seguridad, elimina la carpeta install del servidor. Si no lo haces, cualquiera podría reinstalar tu tienda.

Usando FTP o el Administrador de archivos, elimina la carpeta install de la raíz de tu tienda.

7.2. Reactiva módulos y temas

Accede al panel de administración (la URL puede haber cambiado, pero normalmente sigue siendo la misma).
Ve a Módulos > Módulos y servicios y reactiva los módulos que desactivaste.
Ve a Diseño > Temas y reactiva tu tema personalizado.
Si algún módulo o tema da error, verifica si hay actualizaciones disponibles o contacta al desarrollador.

7.3. Desactiva el modo mantenimiento

Ve a Parámetros de la tienda > Mantenimiento y desactiva el modo mantenimiento.
Verifica que tu tienda se vea correctamente en el front-office.

7.4. Limpia la caché

En el panel de administración, ve a Parámetros avanzados > Rendimiento.
Haz clic en Limpiar caché.
También puedes eliminar la carpeta var/cache manualmente mediante FTP.

Solución de errores comunes

A continuación, algunos problemas típicos y cómo resolverlos:

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

Verifica que los datos de conexión en app/config/parameters.php sean correctos.
Asegúrate de que la base de datos no esté corrupta. Puedes repararla desde phpMyAdmin.

Error: "Tiempo de ejecución excedido"

Aumenta el límite de tiempo de ejecución de PHP en cPanel (sección Seleccionar versión de PHP > Opciones > max_execution_time a 300).
También puedes editar el archivo .htaccess añadiendo: php_value max_execution_time 300.

Error: "Versión de PHP no compatible"

Cambia la versión de PHP en cPanel a una compatible (7.4 o superior).

Error: "No se encuentra la clase"

Esto suele ocurrir por módulos o temas obsoletos. Desactívalos temporalmente y vuelve a intentar la actualización.

[TIP] Si después de varios intentos no logras actualizar, considera contratar a un profesional o usar un servicio de migración.

Preguntas frecuentes (FAQ)

¿Puedo actualizar desde versiones muy antiguas (ej. 1.6 a 1.7)?

Sí, pero se recomienda hacerlo en varios pasos (por ejemplo, 1.6 -> 1.7.0 -> 1.7.8 -> última). También puedes usar el módulo 1-Click Upgrade para facilitar el proceso.

¿Qué hago si el panel de administración no carga después de la actualización?

Limpia la caché del navegador y verifica que la URL de administración sea correcta. Si el problema persiste, restaura desde la copia de seguridad.

¿Necesito actualizar también los módulos y temas?

Sí, es recomendable. Los módulos y temas desactualizados pueden causar incompatibilidades. Busca actualizaciones en el marketplace o contacta a los desarrolladores.

¿Cuánto tiempo tarda la actualización?

Depende del tamaño de tu tienda y la velocidad de tu servidor. En promedio, entre 30 minutos y 2 horas.

¿Puedo usar Syspanel para la actualización?

Si tu hosting usa Syspanel (anteriormente HestiaCP), el proceso es similar. Accede al panel a través del puerto 2106 (ejemplo: tudominio.com:2106) y busca las opciones de archivos y bases de datos. Los pasos de copia de seguridad y subida de archivos son equivalentes.

Conclusión

Actualizar PrestaShop a la última versión desde cPanel es un proceso que, con la preparación adecuada, puede realizarse sin errores. La clave está en hacer una copia de seguridad completa, seguir los pasos en orden y tener paciencia. Recuerda que la seguridad de tu tienda y la satisfacción de tus clientes dependen de mantener el software actualizado.

Si has seguido esta guía, ahora deberías tener una tienda funcionando con la última versión de PrestaShop. Si encuentras algún problema, no dudes en consultar la documentación oficial o contactar a tu proveedor de hosting. ¡Buena suerte!