Migrar y actualizar PrestaShop en cPanel: Guía segura paso a paso

Migrar o actualizar una tienda PrestaShop puede sonar a tarea de expertos, pero con las herramientas adecuadas y un plan claro, cualquier administrador puede hacerlo sin perder datos ni romper la web. En este artículo te guiaré a través de un proceso paso a paso para realizar una migración y actualización segura de tu PrestaShop desde cPanel. Usaremos buenas prácticas, copias de seguridad y verificaciones para que tu tienda siga funcionando sin sobresaltos.

¿Por qué migrar o actualizar PrestaShop?

Antes de empezar, entendamos el motivo. PrestaShop es un CMS de comercio electrónico muy potente, pero cada nueva versión trae parches de seguridad, correcciones de errores y mejoras de rendimiento. Una actualización evita vulnerabilidades y mantiene la compatibilidad con módulos y temas modernos. Por otro lado, una migración puede ser necesaria si cambias de servidor, de panel de control o si tu hosting actual se queda pequeño. En ambos casos, el objetivo es segura y sin pérdida de datos.

[INFO] Si tu hosting usa cPanel, el proceso es más sencillo porque tienes acceso a herramientas como phpMyAdmin, File Manager y backups automáticos.

Requisitos previos para una migración o actualización segura

No empieces a mover archivos sin antes preparar el terreno. Estos son los requisitos mínimos:

Acceso a cPanel (usuario y contraseña).
Conocimiento básico de PrestaShop (versión actual y futura).
Una copia de seguridad completa de archivos y base de datos.
Conexión a Internet estable.
Un editor de texto (como Notepad++ o Sublime Text) para modificar archivos de configuración.
Herramienta FTP (FileZilla, Cyberduck) o el File Manager de cPanel.

[WARNING] Nunca trabajes directamente sobre la tienda en producción. Si es posible, clona el sitio en un subdominio o directorio de pruebas.

Paso 1: Realizar una copia de seguridad completa

La regla de oro de cualquier migración o actualización es: si no tienes backup, no toques nada. En cPanel puedes hacerlo fácilmente.

1.1. Backup de la base de datos

Ingresa a cPanel y busca la sección phpMyAdmin.
Selecciona la base de datos de tu PrestaShop (normalmente tiene un prefijo como prestashop_).
Ve a la pestaña Exportar y elige el método Rápido (formato SQL).
Haz clic en Continuar y descarga el archivo .sql a tu ordenador.
Guarda este archivo en un lugar seguro (nube, disco externo).

1.2. Backup de los archivos del sitio

En cPanel, ve a File Manager y navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o una subcarpeta).
Selecciona todos los archivos y carpetas (puedes usar Ctrl+A).
Haz clic en Comprimir y elige Zip Archive. Nombra el archivo como backup_prestashop_fecha.zip.
Una vez generado, descárgalo a tu ordenador.

[TIP] También puedes usar la función Backup de cPanel (en la sección "Files") para generar un backup completo del sitio, incluyendo bases de datos.

Paso 2: Preparar el entorno de destino (para migración)

Si estás migrando a un nuevo servidor con cPanel, primero debes tener el dominio apuntando al nuevo hosting. Si solo es una actualización, salta este paso.

2.1. Crear la base de datos en el nuevo cPanel

En el cPanel de destino, ve a MySQL Databases.
Crea una nueva base de datos (ej. migracion_presta).
Crea un usuario y asigna todos los privilegios a esa base de datos.
Anota el nombre de la base, el usuario y la contraseña.

2.2. Subir archivos y restaurar base de datos

Sube el archivo ZIP de tu backup a la carpeta public_html del nuevo cPanel usando File Manager o FTP.
Descomprime el archivo (clic derecho → Extract).
Ve a phpMyAdmin en el nuevo cPanel, selecciona la base de datos que creaste.
Ve a la pestaña Importar, selecciona el archivo .sql de tu backup y haz clic en Continuar.

2.3. Configurar el archivo settings.inc.php

El archivo app/config/parameters.php (o config/settings.inc.php en versiones antiguas) contiene la conexión a la base de datos. Debes editarlo con los nuevos datos.

En File Manager, navega a la carpeta de PrestaShop.
Abre app/config/parameters.php (o config/settings.inc.php).

Busca las líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_antiguo',
'database_user' => 'usuario_antiguo',
'database_password' => 'contraseña_antigua',

Cámbialas por los datos de la nueva base de datos.
Guarda el archivo.

[WARNING] Si usas Syspanel (antes HestiaCP), el puerto de acceso es el 2106 y la estructura de carpetas puede variar. En ese caso, los archivos suelen estar en /home/usuario/web/dominio/public_html.

Paso 3: Actualizar PrestaShop a la última versión

Una vez que la migración está completa (o si solo actualizas en el mismo servidor), es hora de actualizar PrestaShop. Nunca saltes versiones muy antiguas directamente a la última; mejor hazlo de forma gradual.

3.1. Verificar la versión actual

En el panel de administración de PrestaShop, ve a Información (en la barra superior) o revisa el archivo version.php en la raíz. Anota la versión.

3.2. Descargar la última versión de PrestaShop

Ve al sitio oficial de PrestaShop y descarga el paquete completo de la última versión estable (archivo .zip).
Descomprímelo en tu ordenador.

3.3. Usar el asistente de actualización 1-Click

PrestaShop incluye un módulo llamado 1-Click Upgrade que automatiza el proceso. Si no lo tienes, instálalo desde el back office (Módulos → Catálogo de módulos → buscar "1-Click Upgrade").

Ve a Mejora → 1-Click Upgrade.
Selecciona la versión a la que quieres actualizar (la última disponible).
Marca la opción "Regenerar el archivo .htaccess" y "Mantener los módulos personalizados".
Haz clic en "Actualizar PrestaShop ahora".

[INFO] El proceso puede tardar varios minutos. No cierres la ventana ni navegues a otra página.

3.4. Actualización manual (alternativa)

Si el módulo falla, puedes hacerlo manualmente:

Pon tu tienda en modo mantenimiento: en el back office, ve a Parámetros de la tienda → Mantenimiento y actívalo.
Con File Manager o FTP, sube todos los archivos de la nueva versión a la carpeta de PrestaShop, excepto:
- La carpeta app/config/ (contiene parámetros de base de datos).
- La carpeta img/ (tus imágenes de productos).
- La carpeta themes/ (si usas un tema personalizado, respáldalo primero).
- El archivo .htaccess (puede sobrescribirse, pero luego lo regenerarás).
Sobrescribe los archivos existentes.
Ve a tu navegador y accede a tudominio.com/install/upgrade/upgrade.php (si existe) o ejecuta el script de actualización desde la URL tudominio.com/install/upgrade/.
Sigue las instrucciones en pantalla.

[WARNING] Si tu hosting usa Syspanel, recuerda que el puerto de administración es el 2106. No intentes acceder por el puerto 8083 o 2083, que son de otros paneles.

Paso 4: Post-actualización y verificación

Después de la actualización, es crucial verificar que todo funcione correctamente.

4.1. Regenerar el .htaccess

En el back office, ve a Parámetros de la tienda → Tráfico y SEO.
En la sección URLs amigables, haz clic en Guardar (sin cambiar nada). Esto regenera el archivo .htaccess.

4.2. Limpiar la caché

Ve a Parámetros avanzados → Rendimiento.
Haz clic en "Forzar compilación" y luego en "Limpiar caché" (ambos botones).

4.3. Probar la tienda

Navega por el front office como cliente: revisa productos, carrito, proceso de compra.
Prueba el back office: módulos, configuración, pedidos.
Verifica que los módulos de pago y envío sigan funcionando.
Comprueba que no haya errores 500 o páginas en blanco.

[TIP] Si encuentras un error 500, revisa los logs de error en cPanel (sección Errores → Errores del sitio web) o en la carpeta var/logs/ de PrestaShop.

Paso 5: Solución de problemas comunes

Aquí tienes algunas incidencias típicas y cómo resolverlas:

5.1. Error de conexión a la base de datos

Revisa que los datos en parameters.php sean correctos (nombre, usuario, contraseña, host).
Asegúrate de que el usuario tenga todos los privilegios en la base de datos.
Si usas Syspanel, verifica que el host sea localhost o la IP del servidor.

5.2. Módulos incompatibles

Algunos módulos dejan de funcionar con versiones nuevas. Ve a Módulos → Módulos instalados y busca los que tengan un icono de advertencia.
Desactívalos y contacta al desarrollador para una actualización.

5.3. Imágenes rotas o no se muestran

Regenera las miniaturas desde Parámetros avanzados → Imágenes → Regenerar miniaturas.
Si el problema persiste, verifica que la carpeta img/ tenga permisos 755.

5.4. Error 500 después de la migración

Revisa los permisos de archivos: las carpetas deben tener 755 y los archivos 644.
Comprueba que el archivo .htaccess no esté corrupto. Renómbralo a .htaccess.bak y vuelve a generarlo desde el back office.

Preguntas frecuentes (FAQ)

¿Puedo migrar PrestaShop a un servidor con Syspanel?
Sí, el proceso es similar. Solo recuerda que el puerto de acceso a Syspanel es el 2106 y la ruta de archivos suele ser /home/usuario/web/dominio/public_html.

¿Qué hago si la actualización se queda colgada?
Espera unos minutos. Si no avanza, cierra la ventana, limpia la caché del navegador y vuelve a intentarlo. Si el problema persiste, restaura el backup y prueba la actualización manual.

¿Pierdo los módulos y temas al actualizar?
No, si usas el módulo 1-Click Upgrade, los mantiene. En la actualización manual, evita sobrescribir las carpetas themes/ y modules/ (aunque algunos módulos pueden necesitar actualización).

¿Es necesario actualizar de versión en versión?
Sí, especialmente si tu versión es muy antigua (por ejemplo, 1.6 a 1.7). Salta primero a una versión intermedia (1.7.x) y luego a la última.

¿Cómo sé si mi hosting soporta la última versión de PrestaShop?
Revisa los requisitos en la documentación oficial: PHP 7.4 o superior, MySQL 5.6+, y extensiones como GD, cURL, etc. En cPanel puedes ver la versión de PHP en la sección Seleccionar versión de PHP.

Conclusión

Migrar y actualizar PrestaShop desde cPanel no tiene por qué ser una pesadilla. Siguiendo este paso a paso con copias de seguridad, paciencia y verificaciones, tu tienda quedará segura y funcionando como nueva. Recuerda siempre probar en un entorno de pruebas antes de tocar la producción, y no olvides mantener copias de seguridad periódicas.

Si en algún momento te sientes perdido, vuelve a este artículo o consulta la documentación oficial de PrestaShop. Y si tu hosting usa Syspanel, ya sabes: puerto 2106 y misma lógica. ¡Buena suerte con tu tienda!