PrestaShop: Solucionar errores comunes de configuración en Plesk
Introducción: ¿Por qué ocurren errores de PrestaShop en Plesk?
Si estás leyendo esto, seguramente ya has instalado PrestaShop en tu servidor Plesk y te has topado con algún que otro error inesperado. No te preocupes, es más común de lo que parece. La combinación de Plesk (un panel de control potente pero con su propia lógica) y PrestaShop (una plataforma de ecommerce con requisitos técnicos específicos) puede generar conflictos de configuración que, aunque parezcan graves, tienen solución.
En esta guía, vamos a desglosar los errores más frecuentes que aparecen al configurar PrestaShop en Plesk, y te explicaré paso a paso cómo resolverlos. Hablaremos de problemas con los permisos de archivos, la configuración de PHP, la base de datos, las URLs amigables y otros fallos típicos. Al final, tendrás un checklist práctico para mantener tu tienda funcionando sin sobresaltos.
[INFO] Si en algún momento usas otro panel como Syspanel (HestiaCP), recuerda que su acceso es por el puerto 2106, pero aquí nos centraremos exclusivamente en Plesk.
1. Error de permisos de archivos y carpetas
Uno de los problemas más habituales al trabajar con PrestaShop errores Plesk es el tema de los permisos. PrestaShop necesita escribir en ciertas carpetas (como cache, log, img, upload, download, etc.) para funcionar correctamente. Si los permisos no son los adecuados, verás mensajes como:
- "Cannot write to the cache folder"
- "Error: Unable to write to the log file"
¿Cómo solucionarlo en Plesk?
- Accede al Administrador de archivos de Plesk (o usa FTP/SFTP).
- Ve a la raíz de tu instalación de PrestaShop.
- Selecciona todas las carpetas y archivos, luego haz clic en Permisos.
- Aplica los siguientes valores:
- Carpetas: 755 (lectura, escritura y ejecución para el propietario; lectura y ejecución para grupo y otros).
- Archivos: 644 (lectura y escritura para el propietario; solo lectura para grupo y otros).
- Si usas Plesk, asegúrate de que el propietario de los archivos sea el usuario del sistema correspondiente a tu suscripción (normalmente se ve en la pestaña "Archivos" > "Propiedades").
[TIP] No pongas permisos 777 nunca por seguridad. Si algún script te los pide, busca una alternativa más segura.
¿Y si el error persiste?
Puede que el problema sea que el usuario del servidor web (por ejemplo, apache o nginx) no tenga permisos sobre la carpeta. En Plesk, ve a Herramientas y ajustes > Usuarios del sistema y verifica que el usuario del dominio tenga acceso al directorio.
2. Error de configuración de PHP (versión, límites y extensiones)
PrestaShop es exigente con la versión de PHP y sus parámetros. Si ves errores como:
- "PrestaShop no se puede instalar: PHP no está actualizado"
- "Se ha producido un error interno" (sin más detalles)
- "Fatal error: Allowed memory size exhausted"
Lo más probable es que la configuración de PHP en Plesk no sea la adecuada.
Pasos para ajustar PHP en Plesk
- En el panel de Plesk, ve a tu dominio y haz clic en Configuración de PHP.
- Selecciona una versión de PHP compatible con tu PrestaShop (actualmente, PrestaShop 8.x funciona bien con PHP 8.1 o 8.2; versiones anteriores pueden necesitar PHP 7.4).
- Aumenta los límites típicos:
memory_limit: al menos 256M (recomendado 512M).max_execution_time: 300 segundos.max_input_time: 300 segundos.upload_max_filesize: 64M (o más si subes productos con imágenes grandes).post_max_size: 64M.
- Habilita las extensiones necesarias:
mysqli,gd,curl,openssl,mbstring,zip,json,xml,fileinfo,intl. - Guarda los cambios y reinicia el servicio PHP (Plesk suele hacerlo automáticamente).
[WARNING] Si cambias la versión de PHP, asegúrate de que tu tema y módulos de PrestaShop sean compatibles. Algunos módulos antiguos pueden dejar de funcionar.
3. Error de conexión a la base de datos
Otro clásico en Plesk PrestaShop problemas es la imposibilidad de conectar con la base de datos. Los síntomas típicos son:
- "No se puede conectar a la base de datos"
- "Error 500" al acceder a la tienda
- "Table 'ps_configuration' doesn't exist"
Causas y soluciones
a) Credenciales incorrectas
Revisa el archivo app/config/parameters.php (en PrestaShop 1.7+) o config/settings.inc.php (en versiones antiguas). Busca las líneas:
'database_host' => 'localhost',
'database_name' => 'nombre_bd',
'database_user' => 'usuario_bd',
'database_password' => 'contraseña',
Asegúrate de que coinciden con los datos que creaste en Plesk. Si no recuerdas la contraseña, puedes resetearla desde Bases de datos en Plesk.
b) El servidor de base de datos no acepta conexiones remotas
Si tu base de datos está en otro servidor, verifica que el host permita conexiones desde tu dominio. En la mayoría de los casos, usar localhost es suficiente.
c) El usuario no tiene todos los privilegios
En Plesk, ve a Bases de datos, selecciona tu base y haz clic en Usuarios. Asegúrate de que el usuario tenga marcados todos los permisos (especialmente SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
[INFO] Si estás migrando una tienda, recuerda que la base de datos debe importarse con la misma codificación (UTF-8) y sin errores de estructura.
4. Error de URLs amigables (mod_rewrite / SEO)
PrestaShop utiliza el archivo .htaccess para generar URLs limpias. Si ves que todas las páginas dan error 404 (excepto la principal), o que las URLs tienen parámetros extraños, el problema suele ser el mod_rewrite de Apache (o su equivalente en nginx).
Solución en Plesk
- Verifica que Apache tenga habilitado mod_rewrite. En Plesk, esto suele estar activo por defecto, pero puedes comprobarlo en Herramientas y ajustes > Ajustes de Apache.
- Regenera el .htaccess de PrestaShop:
- Accede a tu panel de administración de PrestaShop (ej:
tudominio.com/admin1234). - Ve a Configuración de la tienda > Parámetros generales > Configuración de URL.
- Desactiva y vuelve a activar URLs amigables.
- Guarda los cambios.
- Accede a tu panel de administración de PrestaShop (ej:
- Si no puedes acceder al panel, conecta por FTP y renombra el archivo
.htaccess(por ejemplo, a.htaccess_old). Luego, desde la URL de tu tienda, fuerza la regeneración añadiendo?regenerate_htaccess=1al final (ej:tudominio.com/?regenerate_htaccess=1). Después, vuelve a renombrarlo a.htaccess.
[WARNING] Si usas nginx como servidor web en Plesk, el
.htaccessno funciona. Debes configurar las reglas de reescritura directamente en el archivo de configuración de nginx (en Plesk: Apache y nginx > Añadir directivas). Copia las reglas que vienen en el.htaccesspero adaptadas a nginx.
5. Error de caché y compilación de temas
PrestaShop guarda archivos temporales (caché, compilación de plantillas) que a veces se corrompen o quedan obsoletos. Esto provoca:
- "La página se ve en blanco" (White Screen of Death)
- "Error de compilación de la plantilla"
- "El CSS/JS no se carga correctamente"
Cómo limpiar la caché en Plesk
- Desde el panel de administración (si puedes acceder):
- Ve a Mejorar > Rendimiento.
- Haz clic en Forzar compilación y luego en Vaciar caché.
- Manual por FTP:
- Borra el contenido de las carpetas:
var/cache(en PrestaShop 1.7+) ocache(en versiones anteriores). - También puedes eliminar
themes/NOMBREDELTEMA/cache/si existe.
- Borra el contenido de las carpetas:
- Desde Plesk: usa el Administrador de archivos para eliminar los archivos de caché directamente.
[TIP] Si después de limpiar la caché el error persiste, desactiva la caché de Smarty desde el archivo
config/defines.inc.php(en PrestaShop 1.6) oconfig/defines.inc.php(en 1.7+): cambia_PS_MODE_DEV_atruepara ver errores detallados.
6. Error de configuración de SSL/HTTPS
Si has activado SSL en tu dominio (algo muy recomendable para tiendas online), PrestaShop puede dar errores de contenido mixto (mixed content) o redirecciones infinitas.
Solución paso a paso
- Activar SSL en Plesk: ve a Alojamiento web > Configuración de SSL/TLS y asegúrate de que el certificado esté instalado y activo.
- Configurar PrestaShop para HTTPS:
- Accede al panel de administración.
- Ve a Configuración de la tienda > Parámetros generales > Configuración de URL.
- Cambia la URL base a
https://tudominio.com. - Activa Forzar SSL en todas las páginas.
- Regenerar el .htaccess (como en el punto 4) para que las reglas incluyan la redirección a HTTPS.
- Verificar que no hay contenido mixto: usa herramientas como el validador de SSL de tu navegador o servicios online.
[WARNING] Si después de esto la página no carga, revisa que tu hosting no tenga un proxy o CDN que esté forzando HTTP.
7. Error de límites de memoria o tiempo de ejecución en Plesk
Cuando tu tienda crece, puede que te topes con:
- "Fatal error: Maximum execution time of 30 seconds exceeded"
- "Allowed memory size of 134217728 bytes exhausted"
Ajustes globales en Plesk
- Ve a Herramientas y ajustes > Ajustes de PHP (a nivel de servidor) o Configuración de PHP (a nivel de dominio).
- Aumenta los valores como se indicó en la sección 2.
- Si el hosting compartido te limita, contacta con tu proveedor para que suba los límites.
También puedes crear un archivo php.ini personalizado en la raíz de tu dominio:
memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M
En Plesk, a veces es mejor usar la interfaz gráfica que un php.ini manual, porque el panel puede sobrescribirlo.
8. Error de módulos o temas incompatibles
Muchos errores comunes PrestaShop vienen de instalar módulos o temas que no son compatibles con la versión de PrestaShop o con la configuración de PHP de Plesk.
Síntomas
- La tienda deja de cargar después de instalar un módulo.
- Aparecen errores de tipo "Call to undefined function".
- La página de administración muestra un error 500.
Cómo solucionarlo
- Desactiva el módulo problemático:
- Conéctate por FTP y renombra la carpeta del módulo en
modules/(por ejemplo,moduloproblemaamoduloproblema_desactivado). - Si puedes acceder al panel, ve a Módulos > Gestor de módulos y desinstálalo.
- Conéctate por FTP y renombra la carpeta del módulo en
- Verifica los requisitos:
- Consulta la documentación del módulo: ¿qué versión de PrestaShop y PHP necesita?
- Asegúrate de que las extensiones de PHP necesarias estén habilitadas (ver punto 2).
- Actualiza todo: PrestaShop, módulos y tema a sus últimas versiones.
[INFO] Si el módulo es de pago, contacta al desarrollador. A veces ofrecen parches específicos para Plesk.
FAQ: Preguntas frecuentes sobre PrestaShop en Plesk
1. ¿Puedo instalar PrestaShop automáticamente desde Plesk?
Sí, muchos proveedores incluyen un instalador de aplicaciones (como Softaculous o Installatron). Busca "PrestaShop" en la sección Aplicaciones de Plesk. Si no aparece, puedes instalarlo manualmente.
2. ¿Qué hago si el instalador de PrestaShop se queda colgado?
Prueba a aumentar el max_execution_time en PHP (ver punto 2). Si sigue sin funcionar, instala PrestaShop manualmente: descarga el paquete, súbelo por FTP y ejecuta el instalador desde la URL.
3. ¿Cómo puedo saber la versión de PHP que usa mi dominio?
En Plesk, ve a tu dominio y haz clic en Configuración de PHP. Allí verás la versión activa.
4. ¿Por qué mi tienda carga lenta en Plesk?
Puede deberse a:
- Caché desactivada (actívala en PrestaShop).
- PHP con límites bajos (auméntalos).
- Módulos pesados (desactiva los que no uses).
- Falta de optimización de imágenes (usa un módulo de compresión).
5. ¿Es seguro usar Plesk para una tienda online?
Sí, siempre que mantengas actualizados tanto Plesk como PrestaShop, uses SSL, y sigas buenas prácticas de seguridad (contraseñas fuertes, permisos correctos, copias de seguridad).
Conclusión: Checklist final para evitar errores
Para terminar, aquí tienes una lista de verificación rápida que te ayudará a mantener tu PrestaShop funcionando sin problemas en Plesk:
- Permisos de archivos: carpetas 755, archivos 644.
- PHP: versión compatible (8.1 o 8.2 para PrestaShop 8.x), límites altos, extensiones habilitadas.
- Base de datos: credenciales correctas, usuario con todos los privilegios.
- URLs amigables: mod_rewrite activo, .htaccess regenerado.
- SSL/HTTPS: certificado instalado, URLs configuradas en PrestaShop.
- Caché: limpiar periódicamente, sobre todo después de actualizaciones.
- Módulos y temas: solo instalar los compatibles y actualizados.
Si sigues estos pasos, la mayoría de los PrestaShop errores Plesk desaparecerán. Recuerda que siempre puedes consultar los logs de error de Plesk (en Herramientas y ajustes > Registros o en el directorio var/logs de PrestaShop) para obtener pistas más precisas.
¡Espero que esta guía te haya sido de ayuda! Si te encuentras con un error que no aparece aquí, no dudes en buscar en foros especializados o contactar con el soporte de tu hosting. Ánimo con tu tienda online.
