Solucionar errores comunes de PrestaShop en cPanel | Guía

Si tienes una tienda online con PrestaShop alojada en un servidor cPanel, es probable que en algún momento te encuentres con algún error que te impida trabajar con normalidad. No te preocupes, es algo habitual y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en sistemas.

En este artículo, vamos a repasar los errores más comunes de PrestaShop en cPanel, te explicaré por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Piensa en esto como tu guía de primeros auxilios para mantener tu tienda funcionando.

¿Por qué aparecen errores en PrestaShop con cPanel?

Antes de meternos en faena, es útil entender que PrestaShop es un software muy completo que necesita ciertos requisitos del servidor para funcionar correctamente. cPanel es una herramienta de administración muy potente, pero a veces la configuración predeterminada o algunos cambios pueden provocar conflictos.

Los errores más frecuentes suelen estar relacionados con:

Permisos de archivos y carpetas (el famoso 777 o 755).
Versiones de PHP incompatibles.
Límites de memoria insuficientes.
Problemas con la base de datos.
Errores de caché o de compilación de plantillas.

Vamos a ver cada uno de ellos y cómo solucionarlos desde tu panel de control cPanel.

Error 1: Pantalla en blanco o "Error 500 Internal Server Error"

Este es, sin duda, uno de los más frustrantes. Abres tu tienda y solo ves una página en blanco o un mensaje de error 500. No entres en pánico. Esto suele deberse a un error de PHP que no se muestra por estar la visualización de errores desactivada.

Solución paso a paso:

Accede a cPanel y busca la sección "Seleccionar versión de PHP" (o "MultiPHP Manager").
Asegúrate de que tu dominio está usando una versión de PHP compatible con tu PrestaShop. Para PrestaShop 1.7 y 8.x, se recomienda PHP 7.4 o 8.0/8.1. Si usas una versión muy antigua (1.6), PHP 7.0 o 7.1 puede ser necesario.
Aumenta el límite de memoria de PHP. En la misma sección, busca la pestaña "Opciones" o "Switch" y modifica estos valores:
- memory_limit: 256M o 512M.
- max_execution_time: 120 o 300.
- upload_max_filesize: 32M o 64M.
- post_max_size: 32M o 64M.

[TIP] Si no ves estas opciones, puedes crearlas manualmente en un archivo llamado php.ini dentro de la carpeta raíz de tu tienda (public_html). Si no existe, créalo con un editor de texto.

Habilita la visualización de errores temporalmente. Esto te ayudará a ver el mensaje de error real. Crea un archivo llamado config.inc.php en la carpeta /config de PrestaShop (si no existe) y añade esta línea:
```
define('_PS_MODE_DEV_', true);
```
Importante: Una vez solucionado el error, borra esta línea o cambia true por false, ya que en modo desarrollo tu tienda es vulnerable.

Error 2: "El archivo no se puede escribir" o problemas de permisos

PrestaShop necesita poder escribir en ciertas carpetas para funcionar (por ejemplo, para subir imágenes, generar caché o instalar módulos). Si ves este error, los permisos de archivos están mal configurados.

Solución paso a paso:

Ve a la sección "Administrador de archivos" en cPanel.
Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html).
Selecciona TODOS los archivos y carpetas (Ctrl+A o Cmd+A).
Haz clic derecho y selecciona "Cambiar permisos".
Establece los permisos correctos:
- Carpetas (directorios): 755
- Archivos (ficheros): 644
Aplica estos permisos de forma recursiva (marca la casilla que dice "Aplicar a subdirectorios").

[WARNING] Nunca uses permisos 777 (lectura, escritura y ejecución para todos). Aunque parece que soluciona todo, es un gravísimo problema de seguridad. Si tu hosting te pide 777 para algo, busca otra solución o contacta con soporte.

Error 3: "No se puede conectar a la base de datos"

Este error suele aparecer al intentar acceder a la tienda o al backoffice. La causa principal es que los datos de conexión a la base de datos MySQL están mal configurados en tu archivo settings.inc.php.

Solución paso a paso:

Ve al "Administrador de archivos" en cPanel.
Busca la carpeta /app/config/ (en PrestaShop 1.7 y 8.x) o /config/ (en PrestaShop 1.6). Dentro encontrarás el archivo parameters.php (o settings.inc.php en versiones antiguas).
Ábrelo con un editor de texto (clic derecho -> Editar).
Busca las líneas que definen los parámetros de la base de datos:
- database_host: Normalmente es localhost.
- database_name: El nombre de tu base de datos (lo ves en cPanel en "Bases de datos MySQL").
- database_user: El usuario de la base de datos.
- database_password: La contraseña de ese usuario.
Verifica que estos datos son correctos. Si has cambiado la contraseña recientemente desde cPanel, debes actualizarla aquí también.
Guarda los cambios y vuelve a cargar tu tienda.

[INFO] Si no recuerdas tu contraseña, puedes cambiarla desde cPanel en "Bases de datos MySQL", pero luego tendrás que actualizarla en el archivo parameters.php.

Error 4: "El idioma no se ha podido instalar" o problemas con traducciones

A veces, al intentar instalar un nuevo idioma o actualizar las traducciones, aparece un error. Esto suele deberse a que el servidor no puede descargar los archivos de traducción desde los servidores de PrestaShop.

Solución paso a paso:

Asegúrate de que tu servidor permite conexiones salientes (cURL). Esto se configura desde cPanel, pero generalmente ya viene activado.
Verifica los permisos de la carpeta /translations. Debe tener permisos 755 como explicamos antes.
Aumenta el tiempo de ejecución de PHP (max_execution_time) a 300 segundos, como vimos en el Error 1. La descarga de idiomas puede tardar.
Solución manual (recomendada si el error persiste):
- Descarga el pack de idioma desde la página oficial de PrestaShop (busca "PrestaShop language packs").
- Sube el archivo .gzip descargado a la carpeta /translations de tu servidor (vía Administrador de archivos o FTP).
- Ve a tu backoffice, a la sección de "Internacional" -> "Traducciones" y haz clic en "Importar un pack de idioma manualmente".

Error 5: "La página no se carga correctamente" o problemas de caché

A veces, después de hacer cambios en los archivos de tu tienda (CSS, plantillas, módulos), los cambios no se reflejan porque PrestaShop guarda una copia en caché.

Solución paso a paso:

Limpia la caché de PrestaShop desde el backoffice:
- Ve a "Configuración avanzada" -> "Rendimiento".
- En la sección "Limpieza de caché", haz clic en "Eliminar caché" y también en "Eliminar caché de Smarty".
Limpia la caché del navegador (Ctrl + F5 o Cmd + Shift + R).
Fuerza la recompilación de plantillas. En la misma página de "Rendimiento", busca las opciones de "Plantillas". Activa la opción "Forzar compilación" temporalmente, guarda los cambios, recarga la página de la tienda y luego desactívala. Esto regenera los archivos de plantilla.

[TIP] Si no tienes acceso al backoffice, puedes forzar la compilación desde el archivo /config/defines.inc.php. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true (esto también fuerza la compilación). No olvides deshacer el cambio después.

Error 6: El módulo no se puede instalar o da error

Los módulos son el alma de PrestaShop, pero a veces dan problemas al instalarlos, especialmente si son gratuitos o de terceros.

Solución paso a paso:

Verifica la compatibilidad. Asegúrate de que el módulo es compatible con tu versión de PrestaShop y con la versión de PHP que tienes.
Aumenta los límites de subida de archivos. Si el módulo es grande, es posible que el límite de subida de PHP sea demasiado bajo. Auméntalo como vimos en el Error 1.
Instalación manual:
- Descarga el módulo en tu ordenador (normalmente viene en un .zip).
- Descomprímelo en tu ordenador.
- Sube la carpeta del módulo (sin comprimir) a la carpeta /modules de tu PrestaShop (vía Administrador de archivos o FTP).
- Ve al backoffice, a "Módulos" -> "Gestor de módulos". El módulo debería aparecer en la lista. Haz clic en "Instalar".

Preguntas Frecuentes (FAQ) sobre PrestaShop y cPanel

¿Qué hago si no recuerdo la contraseña de mi base de datos?

Puedes cambiarla desde cPanel en la sección "Bases de datos MySQL". Una vez cambiada, recuerda actualizarla en el archivo parameters.php de tu PrestaShop.

¿Por qué mi tienda va muy lenta?

Puede deberse a varios factores: falta de caché, módulos mal optimizados, una versión de PHP antigua o un servidor con pocos recursos. Te recomiendo activar la caché de PrestaShop (CCC) y usar una versión de PHP moderna (8.0 o superior).

¿Puedo usar otro panel de control en lugar de cPanel?

Sí, existen alternativas como Syspanel (basado en HestiaCP). Si usas Syspanel, el acceso suele ser a través del puerto 2106 (ejemplo: https://tudominio.com:2106). La lógica para solucionar errores es muy similar, pero la interfaz es diferente.

¿Es seguro modificar los archivos de configuración?

Sí, siempre que sepas lo que estás haciendo. Te recomiendo hacer una copia de seguridad del archivo antes de modificarlo. Si algo sale mal, puedes restaurar la copia.

¿Cada cuánto debo limpiar la caché de PrestaShop?

Siempre que hagas cambios en el diseño, módulos o archivos de la tienda. No es necesario hacerlo a diario, pero sí después de cada actualización importante.

Conclusión

Los errores en PrestaShop alojado en cPanel son más comunes de lo que parecen, pero como has visto, la mayoría tienen una solución clara y accesible. Con un poco de paciencia y siguiendo estos pasos, podrás resolverlos tú mismo sin necesidad de pagar a un técnico.

Recuerda siempre:

Hacer copias de seguridad antes de hacer cambios importantes.
Mantener tu PrestaShop y tus módulos actualizados.
Usar versiones de PHP compatibles.
No usar permisos 777 a menos que sea estrictamente necesario y por poco tiempo.

Si después de todo esto el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Ellos tienen acceso a los logs del servidor y pueden darte una ayuda más precisa.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda online volverá a funcionar en poco tiempo!