Solucionar errores comunes en PrestaShop con Plesk

¿Tu tienda PrestaShop está dando errores y no sabes por dónde empezar? Es frustrante, lo sabemos. Pero no te preocupes, la mayoría de los problemas comunes tienen solución y no requieren ser un experto en programación. En esta guía, te explicaremos paso a paso cómo solucionar los errores PrestaShop Plesk más frecuentes, usando las herramientas que Plesk pone a tu alcance. Vamos a ello.

¿Por qué ocurren errores en PrestaShop con Plesk?

Antes de lanzarnos a solucionar, es importante entender las causas. Los errores PrestaShop Plesk suelen venir de:

• Problemas de permisos de archivos: PrestaShop necesita permisos específicos para escribir en ciertas carpetas (como cache, img, modules). Si estos permisos se pierden (por ejemplo, al mover el sitio), aparecen errores de escritura o pantallas en blanco.
• Configuración incorrecta de PHP: La versión de PHP, los límites de memoria o las extensiones requeridas pueden no ser las adecuadas.
• Errores en el archivo .htaccess: Un archivo mal generado o corrupto puede provocar errores 500 o bucles de redirección.
• Problemas con la base de datos: Tablas corruptas o configuraciones de conexión erróneas.
• Caché o sesiones corruptas: Archivos temporales que se acumulan y causan conflictos.

Herramientas de Plesk para solucionar problemas PrestaShop

Plesk es un panel de control potente. Para solucionar errores PrestaShop Plesk, estas son las herramientas clave que usarás:

1. El administrador de archivos

Accede a Archivos > Administrador de archivos en Plesk. Aquí podrás:

• Ver y editar archivos de configuración (.htaccess, config/settings.inc.php, etc.).
• Cambiar permisos de carpetas (clic derecho > Permisos).
• Subir o reemplazar archivos.

[TIP] Para editar archivos sensibles, usa el editor de texto integrado de Plesk. Evita editarlos directamente con bloc de notas de Windows, ya que puede cambiar el formato de salto de línea.

2. Gestor de bases de datos (phpMyAdmin)

En Bases de datos, selecciona tu base de datos y haz clic en phpMyAdmin. Te permite:

• Reparar tablas corruptas.
• Ejecutar consultas SQL para solucionar errores de actualización.
• Verificar la estructura de la base de datos.

3. Configuración de PHP

En Configuración de PHP (dentro de tu dominio), puedes:

• Cambiar la versión de PHP (recomendamos 8.0 o 8.1 para PrestaShop 8).
• Aumentar los límites de memoria (memory_limit), tiempo de ejecución (max_execution_time) y tamaño de subida (upload_max_filesize).
• Activar/desactivar extensiones como curl, gd, mbstring, openssl, pdo_mysql, etc.

4. Logs de errores

En Registros > Registro de errores (o en la ruta /var/log/plesk-php/), puedes ver los errores PHP en tiempo real. Esto es oro puro para solucionar problemas PrestaShop.

Errores comunes y soluciones paso a paso

Error 500 Internal Server Error

Este es uno de los errores PrestaShop Plesk más temidos. Normalmente se debe a un .htaccess corrupto, falta de memoria o problemas con módulos.

Pasos para solucionarlo:

1. Renombrar el .htaccess temporalmente:

   • Ve al Administrador de archivos de tu dominio.
   • Busca el archivo .htaccess en la raíz (donde está index.php).
   • Cámbiale el nombre a .htaccess_old.
   • Recarga tu tienda. Si funciona, el problema está en ese archivo.

2. Regenerar el .htaccess:

   • Accede al panel de administración de PrestaShop (si puedes).
   • Ve a Configuración avanzada > Rendimiento.
   • En la pestaña URL y SEO, haz clic en Guardar (sin cambiar nada). Esto regenera el .htaccess.
   • Si no puedes acceder al panel, sube un .htaccess limpio (puedes descargar uno de una instalación nueva de PrestaShop o usar el que generamos al final de este artículo).

3. Aumentar la memoria PHP:

   • En Configuración de PHP, cambia memory_limit a 256M o 512M.
   • Guarda y recarga la página.

4. Desactivar módulos problemáticos:

   • Si el error apareció tras instalar un módulo, renombra la carpeta del módulo en /modules (por ejemplo, moduloproblema_old). Esto lo desactiva forzosamente.

[WARNING] Si renombras el .htaccess, tu tienda puede quedar sin URL amigables. No te preocupes, es temporal. Una vez regeneres el archivo, volverán a funcionar.

Pantalla en blanco (White Screen of Death)

La temida pantalla en blanco suele deberse a un error PHP que no se muestra por tener la visualización de errores desactivada.

Pasos para solucionarlo:

1. Activar la visualización de errores:

   • En el Administrador de archivos, edita el archivo /config/defines.inc.php.
   • Busca la línea define('_PS_MODE_DEV_', false); y cambia false por true.
   • Guarda el archivo. Ahora la pantalla mostrará el error real (por ejemplo, "Fatal error: Allowed memory size exhausted").

2. Según el error, actúa:

   • Memoria insuficiente: Aumenta memory_limit en Configuración de PHP.
   • Error de clase no encontrada: Puede ser un módulo corrupto. Desactívalo renombrando su carpeta.
   • Error de sintaxis: Revisa el archivo mencionado en el error (suele ser un tema o módulo).

3. Desactivar el modo desarrollo:

   • Una vez solucionado, vuelve a cambiar define('_PS_MODE_DEV_', true); a false para no exponer información sensible.

[INFO] Si no encuentras el archivo defines.inc.php, puede que tu PrestaShop sea muy antiguo. En versiones recientes está en /app/config/ si usas la estructura de Symfony. En PrestaShop 1.6 y anteriores, está en /config/.

Error de conexión a la base de datos

Este error suele aparecer como "Cannot connect to database" o "Error de conexión a la base de datos".

Pasos para solucionarlo:

1. Verificar credenciales:

   • En el Administrador de archivos, abre /app/config/parameters.php (PrestaShop 8) o /config/settings.inc.php (PrestaShop 1.6-1.7).
   • Comprueba que los datos (database_host, database_name, database_user, database_password) coinciden con los que tienes en Bases de datos de Plesk.

2. Probar la conexión manualmente:

   • Ve a Bases de datos en Plesk.
   • Haz clic en phpMyAdmin.
   • Intenta iniciar sesión con el usuario y contraseña de la base de datos. Si no funciona, restablece la contraseña desde Plesk (en la misma sección, haz clic en el usuario y luego en Cambiar contraseña).

3. Reparar tablas corruptas:

   • En phpMyAdmin, selecciona todas las tablas de tu base de datos (marcando la casilla superior).
   • En el menú desplegable "Con seleccionadas", elige Reparar tabla.
   • Esto arregla tablas dañadas que impiden la conexión.

4. Verificar el servidor de base de datos:

   • Plesk suele usar localhost como host. Si cambiaste algo, asegúrate de que el servidor MySQL está corriendo (en Herramientas y ajustes > Servicios).

Error de caché o sesiones

Si tu tienda se ve extraña (productos que no se actualizan, carrito que falla, etc.), puede ser la caché o las sesiones.

Pasos para solucionarlo:

1. Limpiar la caché de PrestaShop:

   • Accede al panel de administración (si puedes).
   • Ve a Configuración avanzada > Rendimiento.
   • Haz clic en Limpiar caché (tanto la de Smarty como la de Symfony si existe).

2. Si no puedes acceder al panel:

   • Desde el Administrador de archivos, elimina todo el contenido de la carpeta /var/cache (PrestaShop 1.7+) o /cache (PrestaShop 1.6). No borres la carpeta en sí, solo los archivos dentro.
   • También elimina los archivos de sesión en /tmp (si existe) o en /var/sessions.

3. Regenerar el índice de la caché:

   • En phpMyAdmin, ejecuta la consulta: TRUNCATE TABLE ps_cache; (reemplaza ps_ por tu prefijo de tabla). Esto vacía la tabla de caché en la base de datos.

[TIP] Si tu tienda usa Redis o Memcached para caché, también debes vaciarlos desde Plesk (en Configuración de PHP > Extensiones o usando comandos SSH). Pero para usuarios básicos, lo más seguro es limpiar la caché de archivos.

Error de actualización de PrestaShop

Actualizar PrestaShop puede dar errores como "El módulo no se puede instalar" o "Error en la migración".

Pasos para solucionarlo:

1. Verificar los requisitos:

   • Antes de actualizar, asegúrate de que tu versión de PHP y extensiones cumplen con los requisitos de la nueva versión (consulta la documentación oficial de PrestaShop).

2. Aumentar límites de PHP:

   • Durante la actualización, PrestaShop necesita más memoria y tiempo. Aumenta temporalmente:
     • memory_limit a 512M
     • max_execution_time a 300
     • max_input_time a 300

3. Reparar la base de datos antes de actualizar:

   • En phpMyAdmin, ejecuta la consulta: REPAIR TABLE ps_shop; (cambia el prefijo). Repara todas las tablas si es posible.

4. Forzar la regeneración de clases:

   • Si la actualización se queda atascada, elimina el archivo /config/xml/themes.xml y /cache/class_index.php (si existe). Luego vuelve a intentar la actualización.

5. Usar el modo mantenimiento:

   • Durante la actualización, activa el modo mantenimiento desde Plesk (en Configuración del sitio web > Modo mantenimiento) para que los usuarios no vean errores.

Preguntas frecuentes (FAQ)

¿Cómo sé qué versión de PHP necesita mi PrestaShop?

Revisa la documentación oficial de tu versión de PrestaShop. En general:

• PrestaShop 1.6: PHP 5.6 a 7.1
• PrestaShop 1.7: PHP 7.1 a 8.0
• PrestaShop 8: PHP 7.4 a 8.1 (recomendado 8.0 o 8.1)

En Plesk, ve a Configuración de PHP y selecciona la versión adecuada.

¿Puedo usar Syspanel en lugar de Plesk para solucionar errores?

Si estás usando Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106. Los pasos son similares: usa el administrador de archivos, phpMyAdmin y la configuración de PHP que ofrece Syspanel. Sin embargo, esta guía está enfocada en Plesk, que tiene una interfaz más amigable para estos fines.

¿Qué hago si no puedo acceder al panel de administración?

Si el error te impide entrar al back-office, usa las soluciones desde Plesk:

• Edita archivos de configuración desde el Administrador de archivos.
• Desactiva módulos problemáticos renombrando sus carpetas.
• Limpia la caché manualmente.
• Activa el modo mantenimiento desde Plesk para evitar que los usuarios vean errores.

¿Cómo restauro una copia de seguridad?

Plesk hace copias de seguridad automáticas (si las configuraste). Ve a Herramientas y ajustes > Administrador de copias de seguridad. Puedes restaurar archivos, bases de datos o todo el sitio. Si no tienes copia, puedes descargar los archivos por FTP y la base de datos por phpMyAdmin antes de hacer cambios.

Consejos finales para evitar errores PrestaShop Plesk

• Mantén todo actualizado: PrestaShop, módulos, temas y la versión de PHP.
• Haz copias de seguridad frecuentes: Antes de cualquier cambio grande (actualización, instalación de módulos), descarga una copia de archivos y base de datos.
• Usa un tema y módulos de fuentes confiables: Los módulos gratuitos de fuentes dudosas suelen ser la causa de muchos errores.
• Revisa los logs regularmente: En Registros > Registro de errores de Plesk, puedes ver si hay avisos que puedan convertirse en problemas mayores.

[INFO] Si después de seguir estos pasos el error persiste, puede ser un problema más complejo (como conflictos de módulos o errores en el servidor). En ese caso, contacta con tu proveedor de hosting y proporciona los logs de error que hayas obtenido.

Esperamos que esta guía te haya ayudado a solucionar los errores PrestaShop Plesk más comunes. Recuerda que la paciencia y el método (probar una solución a la vez) son tus mejores aliados. ¡Buena suerte con tu tienda!