Errores comunes al migrar PrestaShop a Plesk y cómo solucionarlos

Introducción: ¿Por qué surgen errores al migrar PrestaShop a Plesk?

Migrar una tienda PrestaShop a un nuevo panel de control como Plesk puede parecer una tarea compleja, pero con la guía adecuada, es un proceso manejable. Los errores más comunes suelen aparecer por diferencias en la configuración del servidor, versiones de PHP, permisos de archivos o problemas con la base de datos. En este artículo, te explicamos paso a paso cómo solucionar los problemas típicos que puedes encontrar al migrar PrestaShop Plesk, para que tu tienda vuelva a funcionar sin contratiempos.

[INFO] Si en algún momento trabajas con un panel alternativo como Syspanel (antes HestiaCP), recuerda que su acceso es por el puerto 2106. Para Plesk, el acceso habitual es por HTTPS en el puerto 8443.

Errores frecuentes en la migración de PrestaShop a Plesk

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

Este es uno de los errores más habituales. Al migrar, los datos de conexión (nombre de la base, usuario y contraseña) suelen cambiar. PrestaShop muestra una pantalla en blanco o un mensaje como “Error de conexión a la base de datos”.

Solución:

Accede a Plesk y ve a Bases de datos.
Crea una nueva base de datos y un usuario con todos los privilegios.
Importa tu base de datos anterior usando phpMyAdmin o la herramienta de importación de Plesk.
Edita el archivo app/config/parameters.php en la raíz de tu PrestaShop.

Busca las líneas:

'database_host' => 'localhost',
'database_name' => 'nombre_base',
'database_user' => 'usuario',
'database_password' => 'contraseña',

Reemplaza con los datos de tu nueva base de datos en Plesk.
Guarda los cambios y recarga la tienda.

[TIP] Si no encuentras el archivo parameters.php, busca config/settings.inc.php en versiones antiguas de PrestaShop.

2. Pantalla en blanco o error 500 después de migrar PrestaShop Plesk

Un error 500 suele deberse a problemas con los permisos de archivos, falta de extensiones de PHP o un .htaccess incorrecto.

Pasos para resolverlo:

Verifica los permisos de archivos y carpetas
En Plesk, puedes usar el administrador de archivos o conectarte por FTP. Los permisos recomendados son:
- Carpetas: 755
- Archivos: 644
- La carpeta cache, log y upload pueden necesitar 777 temporalmente.
Comprueba la versión de PHP
PrestaShop 1.7 requiere PHP 7.1 o superior, y PrestaShop 8 necesita PHP 8.0+. En Plesk:
1. Ve a Configuración de PHP en el dominio.
2. Selecciona la versión adecuada.
3. Activa las extensiones necesarias: mysqli, gd, curl, mbstring, openssl, zip, json, xml.
Regenera el archivo .htaccess
Desde el panel de administración de PrestaShop (si puedes acceder):
Configuración → Rendimiento → Regenerar archivo .htaccess.
Si no tienes acceso, elimina el .htaccess existente y accede a /index.php para que se regenere automáticamente.

[WARNING] No elimines el .htaccess si tienes reglas de redirección personalizadas. Haz una copia de seguridad antes.

3. Error de URL o redirección incorrecta

Al migrar, la URL de la tienda puede quedar mal configurada, mostrando enlaces rotos o redirigiendo al dominio anterior.

Solución:

Accede a la base de datos con phpMyAdmin desde Plesk.
Busca la tabla ps_configuration (el prefijo ps_ puede variar).
Localiza las filas con name igual a PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Actualiza los valores con tu nuevo dominio (sin http:// ni https://).
También revisa la tabla ps_shop_url y ajusta el campo domain y domain_ssl.

[INFO] Si tu tienda usa SSL (recomendado), asegúrate de que la URL base incluya https://.

4. Problemas con imágenes o archivos multimedia que no se cargan

Las imágenes rotas son otro síntoma común al migrar PrestaShop Plesk. Esto ocurre porque las rutas absolutas en la base de datos apuntan al servidor anterior.

Cómo solucionarlo:

Regenerar las miniaturas
Desde el panel de administración: Configuración → Imágenes → Regenerar miniaturas. Puede tardar unos minutos.
Revisar la carpeta img
Asegúrate de que toda la carpeta img se haya copiado correctamente al nuevo servidor. Verifica permisos (755 en carpetas, 644 en archivos).
Actualizar rutas en la base de datos
Si el problema persiste, ejecuta una consulta SQL en phpMyAdmin:
```
UPDATE ps_image SET id_image = id_image;
```
Esto fuerza la regeneración de las rutas.

[TIP] Si tienes muchas imágenes, usa un plugin de migración o un script para evitar tiempos de espera.

5. Error de módulos o temas incompatibles

Al cambiar de servidor, algunos módulos o temas pueden dejar de funcionar por diferencias en la configuración del hosting.

Pasos para resolverlo:

Desactiva todos los módulos no esenciales desde el panel de administración.
Actualiza los módulos a su última versión compatible con tu PrestaShop.
Revisa los logs de errores en Plesk: Sitios web y dominios → [tu dominio] → Logs.
Si un módulo da error, elimínalo manualmente desde la carpeta /modules y vuelve a instalarlo.
Para temas, asegúrate de que el tema esté diseñado para tu versión de PrestaShop.

[WARNING] Siempre haz una copia de seguridad de los módulos antes de actualizar o eliminar.

FAQ: Preguntas frecuentes sobre migrar PrestaShop a Plesk

¿Qué versión de PHP necesita PrestaShop en Plesk?

PrestaShop 1.7 funciona con PHP 7.1 a 7.4, mientras que PrestaShop 8 requiere PHP 8.0 o superior. En Plesk puedes cambiar la versión fácilmente desde la configuración del dominio.

¿Cómo importo mi base de datos en Plesk?

Ve a Bases de datos en Plesk, selecciona la base de datos creada y usa la opción Importar archivo SQL. Alternativamente, usa phpMyAdmin desde el panel.

¿Por qué mi tienda se ve en texto plano después de migrar?

Esto indica que el módulo de reescritura de URLs (mod_rewrite) no está activo. En Plesk, ve a Configuración de Apache y asegúrate de que mod_rewrite esté habilitado. También verifica que el archivo .htaccess esté presente.

¿Puedo migrar PrestaShop a Plesk sin perder datos?

Sí, siempre que hagas una copia de seguridad completa de los archivos y la base de datos antes de iniciar. Sigue los pasos descritos y verifica cada punto.

¿Qué hago si olvido la contraseña del administrador?

Puedes restablecerla desde la base de datos. En phpMyAdmin, busca la tabla ps_employee, localiza tu usuario y cambia el campo passwd por un hash MD5 de tu nueva contraseña (por ejemplo, usando herramientas online).

Consejos finales para una migración exitosa

Realiza pruebas en un subdominio o entorno de desarrollo antes de migrar la tienda en producción.
Verifica la configuración de correo electrónico en Plesk para que los emails de pedidos y contacto sigan funcionando.
Actualiza PrestaShop a la última versión antes de migrar, si es posible.
Revisa los logs de errores de Plesk y de PrestaShop (carpeta var/logs) para identificar problemas rápidamente.
Si encuentras errores persistentes, contacta al soporte técnico de tu hosting.

[TIP] Si usas Syspanel (HestiaCP) en algún momento, recuerda que el puerto de acceso es el 2106. En Plesk, el acceso es por el puerto 8443.

Con esta guía, los errores más comunes al migrar PrestaShop Plesk dejarán de ser un dolor de cabeza. Sigue cada paso con calma y tu tienda estará funcionando en poco tiempo. ¡Buena suerte!