Solucionar problemas de PrestaShop en Plesk: guía práctica

¿Acabas de instalar PrestaShop en tu servidor Plesk y te encuentras con pantallazos blancos, errores de conexión a la base de datos o mensajes de incompatibilidad? No te preocupes, es una situación muy común. Plesk es un panel de control potente, pero a veces la configuración por defecto no está optimizada para las necesidades específicas de PrestaShop, especialmente en lo que respecta a la versión de PHP, los límites de memoria o las extensiones necesarias.

En esta guía extensa y práctica, te explicaré paso a paso cómo resolver los problemas más frecuentes de instalación y configuración de PrestaShop en Plesk. Vamos a cubrir desde los requisitos previos hasta la optimización final, todo en un lenguaje claro y con ejemplos concretos. Al final, tendrás tu tienda funcionando sin sobresaltos.

Requisitos Previos: Lo que Necesitas Saber Antes de Empezar

Antes de lanzarte a la instalación, asegúrate de que tu servidor Plesk cumple con los requisitos mínimos de PrestaShop. Esto te ahorrará muchos dolores de cabeza.

Versión de PHP Compatible

PrestaShop 8.x (la versión más reciente) requiere PHP 7.3 o superior, siendo altamente recomendable PHP 8.0 o 8.1. Plesk te permite gestionar múltiples versiones de PHP por dominio, lo cual es una gran ventaja.

Para verificar y cambiar la versión de PHP en Plesk:

Inicia sesión en Plesk.
Ve a Websites & Domains (Sitios web y dominios).
Haz clic en PHP Settings (Configuración de PHP) para el dominio donde instalarás PrestaShop.
En el desplegable PHP version (Versión de PHP), selecciona una versión compatible (por ejemplo, 8.1 o 8.2). Si no ves estas opciones, es posible que necesites instalar el componente de PHP correspondiente desde Tools & Settings > PHP Settings > Install a new PHP version.

[TIP] Si tu PrestaShop es antiguo (versión 1.6 o 1.7), puede que necesite PHP 7.1 o 7.2. Consulta la documentación de tu versión concreta.

Extensiones PHP Esenciales

PrestaShop depende de varias extensiones de PHP. La falta de alguna de ellas es una de las causas más comunes de errores PrestaShop durante la instalación o el funcionamiento.

Las extensiones críticas son:

mysqli (para conectar con la base de datos MySQL/MariaDB).
gd (para procesar imágenes, miniaturas, etc.).
curl (para comunicaciones con servicios externos, módulos de pago, etc.).
mbstring (para manejo de cadenas de texto con caracteres especiales, como tildes o eñes).
xml y simplexml (para procesar archivos XML, común en módulos y temas).
zip (para instalar módulos y temas desde archivos comprimidos).
openssl (para conexiones seguras HTTPS y otras funcionalidades de seguridad).
json (para intercambio de datos con la interfaz moderna de PrestaShop).
fileinfo (para detectar el tipo MIME de los archivos subidos).
intl (para internacionalización, aunque no siempre es obligatoria, sí muy recomendable).

En Plesk, puedes habilitar estas extensiones desde la misma pantalla de PHP Settings. Busca la sección Additional directives (Directivas adicionales) o, en versiones más modernas, directamente una lista de extensiones que puedes activar/desactivar con checkboxes. Si no las ves, puedes añadirlas manualmente en el campo Additional configuration directives (Directivas de configuración adicionales) usando líneas como extension=mysqli.so (para Linux) o extension=php_mysqli.dll (para Windows). Lo más habitual en Plesk/Linux es que ya estén compiladas y solo haya que asegurarse de que están activas.

Configuración de la Base de Datos

PrestaShop necesita una base de datos MySQL o MariaDB. Plesk facilita mucho este paso.

Para crear la base de datos y el usuario:

En Plesk, ve a Databases (Bases de datos) dentro de tu dominio.
Haz clic en Add Database (Añadir base de datos).
Dale un nombre (ej. tienda_db).
Marca la opción Create a database user (Crear un usuario de base de datos) y establece una contraseña segura. Guarda bien estos datos, los necesitarás durante la instalación de PrestaShop.

[WARNING] No uses caracteres especiales ni espacios en el nombre de la base de datos o del usuario. Limítate a letras, números y guiones bajos.

Problemas Comunes de Instalación PrestaShop en Plesk y Cómo Solucionarlos

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

Error 1: Pantalla Blanca o Error 500 al Acceder a la Instalación

Este es uno de los errores PrestaShop más frustrantes. Sucede justo después de subir los archivos y tratar de acceder a la URL de instalación.

Causa principal: Permisos incorrectos en los archivos y carpetas de PrestaShop.

Solución:

Conéctate a tu servidor por FTP (FileZilla, Cyberduck, etc.) o usa el Administrador de Archivos de Plesk.
Navega hasta la carpeta raíz de tu dominio (normalmente httpdocs o public_html).
Ajusta los permisos de las carpetas a 755. Esto significa: el propietario tiene todos los permisos (lectura, escritura, ejecución), y los grupos y otros solo lectura y ejecución.
Ajusta los permisos de los archivos a 644 (propietario lectura/escritura, grupos y otros solo lectura).
Presta especial atención a las carpetas config, cache, log, img, mails, modules, themes, translations, upload, download y el archivo settings.inc.php (si existe de una instalación previa). Estas suelen necesitar permisos de escritura para el servidor web. En muchos casos, basta con 755 para las carpetas.

[TIP] En Plesk, puedes hacer esto fácilmente desde el Administrador de Archivos. Selecciona todos los archivos y carpetas, haz clic en Change Permissions (Cambiar permisos) y establece 644 y 755 respectivamente. Para las carpetas especiales, asegúrate de que el checkbox Allow executing file (Permitir ejecución de archivos) esté marcado.

Error 2: “No se puede conectar a la base de datos” o “Error de conexión MySQL”

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

Causas posibles:

Credenciales incorrectas: El nombre de usuario, la contraseña o el nombre de la base de datos son erróneos.
Servidor de base de datos incorrecto: El host de la base de datos no es el correcto.
El usuario no tiene permisos sobre la base de datos.

Solución:

Verifica las credenciales: Revisa cuidadosamente el nombre de la base de datos, el usuario y la contraseña que creaste en Plesk. Un error tipográfico es muy común.
Confirma el servidor de base de datos: Normalmente, el servidor es localhost. Sin embargo, en algunos servidores compartidos o configuraciones específicas de Plesk, puede ser la IP del servidor (ej. 127.0.0.1) o incluso un nombre como localhost:/tmp/mysql.sock. Si no estás seguro, consulta con tu proveedor de hosting o revisa la configuración en Tools & Settings > Database Servers en Plesk.
Reasigna el usuario a la base de datos: En Plesk, ve a Databases, haz clic en el nombre de tu base de datos y luego en Add User to Database (Añadir usuario a base de datos). Asegúrate de que el usuario que creaste esté añadido y tenga todos los privilegios (normalmente con un check en "All" o seleccionando todos los privilegios uno por uno).

Error 3: “El archivo settings.inc.php no se puede escribir”

Este error indica que el servidor web no tiene permisos de escritura en el archivo de configuración principal de PrestaShop.

Causa: Permisos insuficientes en la carpeta config o en el archivo settings.inc.php.

Solución:

Temporalmente, durante la instalación, otorga permisos de escritura al archivo settings.inc.php. Puedes establecerlo en 644 o incluso 666 (aunque no es recomendable dejarlo así permanentemente). La forma más segura es dar permisos de escritura al grupo del servidor web.
En Plesk, ve al Administrador de Archivos, navega a la carpeta config, selecciona el archivo settings.inc.php (si existe) o la carpeta config y cambia sus permisos a 755 (para la carpeta) y 644 o 755 (para el archivo). Si el archivo no existe, la carpeta config debe tener permisos 755 para que PrestaShop pueda crearlo.
Una vez completada la instalación, es muy importante que reviertas los permisos del archivo settings.inc.php a 644 o incluso 444 (solo lectura) por seguridad.

Error 4: Problemas con la Memoria PHP (Memory Limit)

Durante la instalación o al intentar acceder al back office, puede aparecer un mensaje como "Fatal error: Allowed memory size of X bytes exhausted".

Causa: El límite de memoria PHP es demasiado bajo. PrestaShop, especialmente con muchos módulos o catálogos grandes, necesita un límite generoso.

Solución:

En Plesk, ve a PHP Settings de tu dominio.
Busca la directiva memory_limit.
Auméntala a un valor como 512M o incluso 1024M (1GB) si tu servidor tiene suficiente RAM. El valor por defecto suele ser 128M o 256M, que puede ser insuficiente.
También es recomendable aumentar otros límites como max_execution_time (a 300 segundos o más) y upload_max_filesize (a 64M o 128M para subir temas y módulos grandes).

[INFO] Estos cambios se aplican solo al dominio seleccionado, no afectan a otros sitios en el mismo servidor Plesk.

Configuración PHP Avanzada para PrestaShop en Plesk

Una vez superada la instalación, es hora de afinar la configuración PHP para un rendimiento óptimo. Aquí tienes las directivas clave que deberías revisar en PHP Settings de Plesk.

Parámetros Recomendados

memory_limit: 512M (mínimo), 1024M (recomendado para tiendas grandes).
max_execution_time: 300 (segundos). Necesario para procesos largos como importación de productos o generación de miniaturas.
max_input_time: 300 (segundos).
upload_max_filesize: 64M (para subir imágenes de productos, temas, módulos).
post_max_size: 68M (debe ser ligeramente superior a upload_max_filesize).
max_input_vars: 5000 (aumenta este valor si tienes productos con muchas combinaciones o atributos, ya que el valor por defecto de 1000 puede ser insuficiente).
allow_url_fopen: On (necesario para muchos módulos y actualizaciones).
date.timezone: Establécelo a tu zona horaria (ej. Europe/Madrid o America/Argentina/Buenos_Aires).

Cómo Añadir Directivas Personalizadas

Si no ves alguna de estas opciones en la interfaz gráfica de Plesk, puedes añadirlas manualmente en el campo Additional configuration directives (Directivas de configuración adicionales). Simplemente escribe cada directiva en una línea nueva, por ejemplo:

memory_limit = 1024M
max_execution_time = 300
max_input_vars = 5000

[WARNING] Ten cuidado al modificar estos valores. Un memory_limit excesivamente alto puede consumir todos los recursos del servidor si tienes un fallo de memoria. Auméntalo gradualmente.

Preguntas Frecuentes (FAQ) sobre PrestaShop y Plesk

P: ¿Puedo instalar PrestaShop automáticamente desde Plesk?
R: Sí, muchos proveedores de hosting que usan Plesk incluyen un instalador de aplicaciones (como Softaculous o el instalador de Plesk). Ve a Websites & Domains y busca el icono Install Applications (Instalar aplicaciones) o WordPress Toolkit (algunos incluyen PrestaShop). Es la forma más rápida y suele configurar la base de datos y los permisos automáticamente.

P: Después de instalar, el back office (admin) me da error 500. ¿Qué hago?
R: Es muy probable que sea un problema de permisos o de memoria PHP. Primero, aumenta el memory_limit como te expliqué arriba. Si el error persiste, revisa los permisos de la carpeta admin (o el nombre que le hayas dado a tu carpeta de administración) y sus archivos. También puedes mirar los logs de error de Plesk en Tools & Settings > Logs > Error Log para obtener más detalles.

P: ¿Cómo puedo cambiar la versión de PHP de mi tienda PrestaShop sin romperla?
R: En Plesk, ve a PHP Settings de tu dominio y selecciona la nueva versión. Antes de hacer el cambio, verifica que PrestaShop sea compatible con esa versión. Te recomiendo hacer una copia de seguridad completa (archivos y base de datos) antes de probar. Si algo falla, siempre puedes revertir al PHP anterior desde la misma pantalla.

P: Mi instalación de PrestaShop en Plesk va muy lenta. ¿Qué puedo optimizar?
R: Además de la configuración PHP, activa la caché de PrestaShop (en Advanced Parameters > Performance). También considera usar un sistema de caché como Redis o Memcached, que puedes instalar como extensión en Plesk. Por último, asegúrate de que tu servidor tenga suficientes recursos (RAM, CPU) y que la base de datos esté optimizada.

P: ¿Qué hago si el instalador de PrestaShop no me deja continuar porque falta la extensión intl?
R: En Plesk, ve a PHP Settings y busca la opción de Extensions. Activa la extensión intl. Si no aparece en la lista, puedes intentar añadirla manualmente con la directiva extension=intl.so en el campo de directivas adicionales. Si aún así no funciona, es posible que tu proveedor de hosting no la tenga instalada en el servidor; deberás contactar con su soporte técnico.

[INFO] Si tu instalación es en un servidor con Syspanel (HestiaCP), recuerda que el acceso al panel se realiza a través del puerto 2106 (ej. https://tudominio.com:2106). El proceso de instalación y configuración es similar, aunque la interfaz para gestionar PHP y bases de datos puede variar ligeramente.

Conclusión y Próximos Pasos

Instalar y configurar PrestaShop en Plesk puede parecer un desafío al principio, pero siguiendo esta guía paso a paso, la mayoría de los problemas comunes tienen una solución clara y directa. Recuerda siempre:

Verificar los requisitos de PHP y extensiones antes de empezar.
Ajustar los permisos de archivos y carpetas correctamente.
Configurar la memoria PHP con valores generosos.
Revisar los logs de error de Plesk cuando te enfrentes a un error desconocido.

Una vez que tu tienda esté funcionando, no olvides mantener todo actualizado: PrestaShop, los módulos, el tema y la versión de PHP. La seguridad y el rendimiento de tu negocio online dependen de ello.

¡Espero que