Solucionar errores de instalación de PrestaShop en Plesk

Instalar PrestaShop en un servidor Plesk puede parecer sencillo, pero a menudo surgen errores que frustran a los usuarios. En esta guía extensa, vamos a desglosar los errores comunes de instalación de PrestaShop en Plesk y te daremos soluciones paso a paso para que puedas instalar PrestaShop en Plesk sin dolores de cabeza. Si estás buscando una PrestaShop Plesk solución a problemas típicos, has llegado al lugar correcto.

Empecemos por lo básico: cuando hablamos de errores PrestaShop Plesk, nos referimos a fallos que ocurren durante la instalación o configuración inicial de la tienda online. Estos pueden deberse a configuraciones incorrectas del servidor, permisos de archivos, versiones de PHP incompatibles o problemas con la base de datos. Vamos a ver los más frecuentes y cómo solucionarlos.

Error de permisos de archivos y carpetas

Uno de los primeros errores PrestaShop Plesk que encontrarás es el mensaje de que ciertos archivos o carpetas no tienen los permisos correctos. PrestaShop necesita poder escribir en directorios como config, cache, log, img, upload y download.

Solución paso a paso

Accede a tu panel de Plesk y ve a Archivos.
Navega hasta la carpeta raíz de tu instalación de PrestaShop.
Selecciona todas las carpetas que PrestaShop indique como problemáticas.
Haz clic en Permisos y establece 755 para directorios y 644 para archivos.
Si usas FTP, asegúrate de que el usuario del servidor (generalmente psacln) tenga permisos de escritura.

[TIP] Si tienes dudas sobre qué permisos poner, en Plesk puedes usar la opción "Reparar permisos" desde el panel de aplicaciones. Esto ajusta automáticamente los permisos para PrestaShop.

Error de versión de PHP incompatible

PrestaShop requiere una versión específica de PHP. Con versiones recientes, necesitas PHP 7.4 o superior (idealmente PHP 8.0 o 8.1). Si tu Plesk tiene PHP 5.6 o 7.0, la instalación fallará o dará errores de funciones obsoletas.

Cómo solucionarlo en Plesk

En Plesk, ve a Herramientas y Configuración > Configuración de PHP.
Selecciona el dominio donde instalaste PrestaShop.
Cambia la versión de PHP a 8.0 o 8.1 (la más reciente compatible con tu PrestaShop).
Guarda los cambios y reinicia el servicio web desde Servicios.

[WARNING] No uses PHP 8.2 si tu PrestaShop es antiguo (versión 1.7.x antigua), ya que puede dar errores de compatibilidad. Siempre revisa los requisitos del sistema de tu versión de PrestaShop.

Error de conexión a la base de datos

Otro clásico entre los errores PrestaShop Plesk es que la instalación no logra conectar con la base de datos. Esto suele pasar por credenciales incorrectas o porque la base de datos no se ha creado correctamente.

Solución

En Plesk, ve a Bases de datos y crea una nueva base de datos para PrestaShop.
Anota el nombre de la base de datos, el usuario y la contraseña.
Durante la instalación de PrestaShop, asegúrate de usar exactamente esos datos.
Verifica que el host de la base de datos sea localhost (o la IP del servidor si usas un host remoto).

[INFO] Si usas Syspanel (antes conocido como HestiaCP), el acceso a la base de datos se hace a través del puerto 2106. Pero en Plesk, todo se gestiona desde el mismo panel, sin puertos especiales.

Error de memoria insuficiente (memory limit)

PrestaShop consume bastante memoria, especialmente durante la instalación. Si ves errores como "Allowed memory size exhausted", necesitas aumentar el límite de memoria PHP.

Cómo aumentarlo en Plesk

Ve a Configuración de PHP para tu dominio.
Busca la opción memory_limit.
Cámbiala a 256M o 512M.
También ajusta max_execution_time a 300 segundos para evitar tiempos de espera.
Guarda y recarga la configuración.

Error de módulos o temas no compatibles

A veces, al instalar PrestaShop en Plesk, los módulos o temas descargados de terceros pueden dar errores porque no están actualizados o porque chocan con la configuración del servidor.

Solución

Descarga siempre módulos y temas desde el marketplace oficial de PrestaShop.
Durante la instalación, selecciona solo los módulos esenciales.
Si un módulo da error, desactívalo desde el back office y busca una versión compatible.
Verifica que el tema esté diseñado para tu versión de PrestaShop.

Error de URL amigables (mod_rewrite)

PrestaShop usa URLs amigables para SEO. Si en Plesk no está activado el módulo mod_rewrite de Apache, las URLs no funcionarán y verás errores 404.

Activar mod_rewrite en Plesk

Ve a Herramientas y Configuración > Configuración de Apache.
Asegúrate de que mod_rewrite esté habilitado.
En el archivo .htaccess de PrestaShop, verifica que las reglas de reescritura estén presentes.
Si no funciona, desde el back office de PrestaShop ve a Configuración de SEO y URLs y regenera el archivo .htaccess.

Error de caché y compilación

PrestaShop almacena en caché archivos de plantillas y configuración. Si estos archivos están corruptos o no se generan bien, verás pantallas en blanco o errores extraños.

Solución

Desde el back office, ve a Parámetros Avanzados > Rendimiento.
Desactiva la caché temporalmente.
Borra la carpeta var/cache (o cache en versiones antiguas) desde el panel de archivos de Plesk.
Vuelve a activar la caché después de solucionar el error.

[WARNING] Si no puedes acceder al back office, borra manualmente los archivos de la carpeta var/cache mediante FTP o el administrador de archivos de Plesk.

Error de instalación de módulos desde el marketplace

A veces, al instalar PrestaShop en Plesk, los módulos del marketplace no se descargan correctamente por problemas de permisos o conexión.

Solución

Verifica que tu servidor tenga acceso a internet (sin firewall restrictivo).
Aumenta los permisos de la carpeta modules a 755.
Si el módulo no se instala, descárgalo manualmente y súbelo por FTP a la carpeta modules.
Desde el back office, ve a Módulos > Gestor de módulos e instálalo desde el archivo subido.

FAQ: Preguntas frecuentes sobre errores PrestaShop Plesk

¿Por qué veo una página en blanco después de instalar PrestaShop en Plesk?

Esto suele deberse a un error de PHP. Activa los errores en el archivo config/defines.inc.php cambiando _PS_MODE_DEV_ a true. Así verás el mensaje de error real.

¿Cómo soluciono el error "No se puede conectar a la base de datos" en Plesk?

Revisa que el usuario de la base de datos tenga todos los privilegios y que el nombre de la base de datos sea correcto. En Plesk, ve a Bases de datos y verifica los permisos.

¿Puedo instalar PrestaShop en un subdominio de Plesk?

Sí, perfectamente. Solo asegúrate de que el subdominio tenga su propia configuración de PHP y permisos. Los errores PrestaShop Plesk en subdominios suelen ser los mismos que en dominios principales.

¿Qué hago si el instalador de PrestaShop se queda cargando eternamente?

Aumenta el max_execution_time en la configuración de PHP a 600 segundos. También verifica que no haya un plugin de seguridad bloqueando la instalación.

¿Es necesario tener SSL para instalar PrestaShop en Plesk?

No es obligatorio, pero muy recomendable. Sin SSL, algunos módulos de pago no funcionarán. Puedes instalar un certificado gratuito desde Plesk.

Consejos finales para una instalación sin errores

Para evitar la mayoría de errores PrestaShop Plesk, sigue estos consejos:

Actualiza siempre tanto Plesk como PrestaShop a sus últimas versiones estables.
Usa PHP 8.0 como versión predeterminada.
Configura los permisos correctamente antes de empezar la instalación.
Haz una copia de seguridad de tu base de datos y archivos antes de cualquier cambio grande.
Revisa los logs de errores de Plesk (en Herramientas y Configuración > Logs) para identificar problemas.

[INFO] Si estás migrando desde Syspanel (HestiaCP) a Plesk, recuerda que en Syspanel el acceso a la base de datos se hace por el puerto 2106, pero en Plesk todo es más directo. Asegúrate de exportar e importar correctamente tu base de datos.

Con esta guía, esperamos que hayas encontrado la PrestaShop Plesk solución a tus problemas. La mayoría de los errores PrestaShop Plesk se resuelven con ajustes simples de configuración. Si persisten, no dudes en contactar con el soporte técnico de tu hosting. ¡Buena suerte con tu tienda online!