Errores comunes al instalar PrestaShop en Plesk y cómo solucionarlos

Introducción: El desafío de instalar PrestaShop en Plesk

Instalar PrestaShop en un servidor con Plesk puede parecer sencillo, pero a menudo surgen errores que frustran a los usuarios menos experimentados. Desde problemas con los requisitos del sistema hasta conflictos con la configuración del servidor, es común encontrarse con pantallas en blanco, errores de conexión a la base de datos o mensajes de incompatibilidad. Este artículo está diseñado para guiarte paso a paso en la solución de los errores más frecuentes durante la instalación de PrestaShop en Plesk. No importa si eres un principiante: aquí encontrarás explicaciones claras, listas de verificación y trucos prácticos para que tu tienda online funcione sin contratiempos.

Requisitos previos para una instalación exitosa

Antes de sumergirnos en los errores, es crucial que verifiques que tu servidor Plesk cumple con los requisitos mínimos de PrestaShop. Muchos problemas se evitan simplemente con una configuración correcta.

Versiones de PHP compatibles

PrestaShop 8.x requiere PHP 7.4 o superior, siendo 8.1 la versión recomendada. En Plesk, puedes cambiar la versión de PHP por dominio o por directorio.

Pasos para configurar PHP en Plesk:

Inicia sesión en Plesk.
Ve a Sitios web y dominios.
Selecciona el dominio donde instalarás PrestaShop.
Haz clic en Configuración de PHP.
Elige la versión 8.1 o superior en el menú desplegable.
Guarda los cambios.

[TIP] Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106 y la configuración de PHP se encuentra en la sección de Ajustes del servidor.

Extensiones de PHP necesarias

PrestaShop necesita varias extensiones de PHP para funcionar. Las más importantes son:

PDO_MySQL (para la conexión a la base de datos)
GD (para manipulación de imágenes)
CURL (para conexiones externas)
JSON (para manejo de datos)
OpenSSL (para seguridad)
Mbstring (para caracteres especiales)
Zip (para compresión)
Intl (para internacionalización)

Cómo verificar las extensiones en Plesk:

Ve a Sitios web y dominios > tu dominio.
Haz clic en Configuración de PHP.
En la sección Extensiones, asegúrate de que todas las anteriores estén habilitadas (marcadas con un check verde).

[WARNING] Si alguna extensión está deshabilitada, actívala desde el mismo panel. Si no aparece, contacta con tu proveedor de hosting para que la instale.

Permisos de archivos y carpetas

PrestaShop necesita escribir en ciertos directorios (como config, cache, log, img, upload, etc.). En Plesk, los permisos suelen estar bien configurados por defecto, pero es bueno verificarlos.

Permisos recomendados:

Directorios: 755
Archivos: 644

Cómo ajustar permisos desde Plesk:

Ve a Sitios web y dominios.
Haz clic en Administrador de archivos.
Navega hasta la carpeta de instalación de PrestaShop.
Selecciona la carpeta raíz y haz clic en Permisos.
Ajusta a 755 para directorios y 644 para archivos.

Errores comunes durante la instalación

Aquí tienes los errores más frecuentes que reportan los usuarios al instalar PrestaShop en Plesk, junto con sus soluciones.

Error 1: “Página en blanco” o “Error 500”

Este es el error más temido. Puede deberse a varias causas, pero la más común es un problema de memoria PHP o de archivos corruptos.

Soluciones:

Aumenta el límite de memoria PHP:
- En Plesk, ve a Configuración de PHP de tu dominio.
- Busca memory_limit y cámbialo a 256M o 512M.
- Guarda y prueba de nuevo.
Verifica los archivos de instalación:
- Descarga PrestaShop nuevamente desde el sitio oficial.
- Sube los archivos limpios a tu servidor mediante FTP o el Administrador de archivos de Plesk.
Revisa los logs de error:
- En Plesk, ve a Sitios web y dominios > Registro de errores.
- Busca mensajes como "Allowed memory size exhausted" o "Fatal error".

[INFO] Si el error persiste, prueba con la versión 1.7 de PrestaShop, que es más compatible con configuraciones antiguas.

Error 2: “No se puede conectar a la base de datos”

Este error suele aparecer durante el asistente de instalación, en el paso de configuración de la base de datos.

Causas comunes:

Nombre de usuario o contraseña incorrectos.
La base de datos no existe.
El usuario no tiene permisos sobre la base de datos.

Pasos para solucionarlo:

Crea la base de datos en Plesk:
- Ve a Sitios web y dominios > Bases de datos.
- Haz clic en Agregar base de datos.
- Asigna un nombre (ej: prestashop_db).
- Crea un usuario con contraseña segura.
- Asigna todos los privilegios.
Verifica los datos en el asistente:
- Durante la instalación de PrestaShop, asegúrate de usar:
  - Servidor de base de datos: localhost (o el que te indique tu hosting).
  - Nombre de base de datos: El que creaste.
  - Usuario: El que creaste.
  - Contraseña: La que asignaste.
Prueba la conexión manualmente:
- Usa un script PHP simple como <?php phpinfo(); ?> para verificar que PDO_MySQL está activo.

[WARNING] No uses caracteres especiales en el nombre de la base de datos ni en el usuario. Solo letras, números y guiones bajos.

Error 3: “Versión de PHP no compatible”

PrestaShop 8 no funciona con PHP 7.3 o inferior. Si ves este mensaje, debes actualizar PHP.

Cómo actualizar PHP en Plesk:

Ve a Herramientas y configuraciones > Configuración de PHP.
Selecciona la versión más reciente (8.1 o 8.2).
Aplica los cambios al dominio específico.

Si tu hosting no ofrece versiones recientes:

Contacta a tu proveedor para que actualice el servidor.
Considera migrar a un hosting que soporte PHP 8.

Error 4: “El directorio no tiene permisos de escritura”

PrestaShop es muy estricto con los permisos. Si ves este error, es porque algún directorio no es escribible.

Solución paso a paso:

Identifica el directorio problemático: El mensaje de error suele indicarlo (ej: cache, log, config).
Cambia permisos desde Plesk:
- Usa el Administrador de archivos para navegar al directorio.
- Haz clic derecho > Permisos.
- Ajusta a 755.
Si usas FTP: Conéctate y ejecuta chmod -R 755 directorio_problematico.

[TIP] Algunos directorios como config pueden necesitar permisos 777 temporalmente durante la instalación. Recuerda volver a 755 al terminar.

Error 5: “El servidor no permite la sobreescritura de URLs amigables”

PrestaShop usa archivos .htaccess para las URLs amigables. Si Plesk no permite la sobreescritura, verás este error.

Solución:

Habilita AllowOverride en Plesk:
- Ve a Sitios web y dominios > Configuración de Apache y nginx.
- En la sección de Directivas adicionales de Apache, agrega:
```
<Directory /var/www/vhosts/tudominio.com/httpdocs>
    AllowOverride All
</Directory>
```
- Reemplaza la ruta por la de tu dominio.
Reinicia el servicio web:
- Ve a Herramientas y configuraciones > Reiniciar servicios.
- Selecciona Apache y nginx.

Error 6: “Error al enviar el formulario de instalación”

A veces, el asistente de instalación se queda atascado al enviar datos. Esto puede deberse a un timeout o a un problema con las cookies.

Soluciones:

Aumenta el tiempo de ejecución de PHP:
- En Configuración de PHP, cambia max_execution_time a 300.
Limpia las cookies del navegador:
- Cierra sesión en Plesk y vuelve a iniciar.
- Usa una ventana de incógnito para la instalación.
Desactiva temporalmente el firewall:
- Si tienes un firewall en Plesk (como ModSecurity), desactívalo durante la instalación.

Preguntas frecuentes (FAQ)

¿Puedo instalar PrestaShop en Plesk sin usar el asistente?

Sí, puedes hacer una instalación manual. Sube los archivos, crea la base de datos manualmente y ejecuta el script de instalación desde el navegador. Es más controlable.

¿Qué hago si después de la instalación la tienda no carga correctamente?

Revisa los logs de error de Plesk (en Registro de errores). También verifica que las URLs amigables estén activadas y que el archivo .htaccess exista en la raíz.

¿PrestaShop funciona con nginx en Plesk?

Sí, pero necesitas configurar reglas de reescritura específicas. En Plesk, ve a Configuración de Apache y nginx y agrega las reglas de reescritura de PrestaShop en la sección de nginx.

¿Cómo migro PrestaShop de otro panel a Plesk?

Exporta la base de datos desde el panel anterior, importa los archivos y la base de datos en Plesk, y ajusta el archivo settings.inc.php con los nuevos datos de conexión.

¿Qué hacer si veo “Error de conexión SSL” al instalar?

Asegúrate de que el certificado SSL esté instalado en Plesk. Ve a Sitios web y dominios > Certificados SSL y asigna uno a tu dominio.

Consejos finales para una instalación sin problemas

Usa siempre la última versión estable de PrestaShop y la versión de PHP recomendada.
Haz una copia de seguridad de tu base de datos y archivos antes de cualquier cambio.
Prueba la instalación en un subdominio primero para evitar afectar tu sitio principal.
Mantén Plesk actualizado para evitar conflictos de compatibilidad.
Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106 y la configuración de PHP se maneja de manera similar.

[INFO] La mayoría de los errores de instalación en Plesk se deben a configuraciones incorrectas de PHP o permisos. Siguiendo esta guía, resolverás el 90% de los problemas.

Si después de todo esto el error persiste, no dudes en contactar al soporte técnico de tu hosting. Proporciónales los logs de error y los pasos que ya seguiste. ¡Buena suerte con tu tienda PrestaShop!