Errores comunes en PrestaShop en cPanel: Soluciones rápidas

Introducción: ¿Por qué aparecen errores en PrestaShop en cPanel?

Si tienes una tienda online con PrestaShop alojada en un servidor con cPanel, es probable que en algún momento te enfrentes a algún error inesperado. No te preocupes, es algo común. La combinación de PrestaShop (un software complejo y lleno de funcionalidades) con cPanel (un panel de control muy potente pero que requiere ciertos ajustes) puede generar conflictos. Este artículo está diseñado para que, paso a paso, puedas solucionar los errores más comunes en PrestaShop desde cPanel sin necesidad de ser un experto en programación.

Vamos a desglosar los problemas típicos: desde el temido error de conexión a la base de datos, hasta pantallas en blanco, problemas de memoria o conflictos con módulos. Todo explicado de forma clara, con instrucciones que puedes seguir desde tu propio panel de control.

[TIP] Antes de empezar, te recomiendo hacer una copia de seguridad completa de tu tienda (archivos y base de datos) desde cPanel. Así, si algo sale mal, podrás restaurar todo rápidamente.

## Error de conexión a la base de datos en PrestaShop desde cPanel

Este es, sin duda, uno de los errores PrestaShop cPanel más frecuentes. Tu tienda se vuelve inaccesible y ves un mensaje como "Error al conectar con la base de datos" o "Link to database cannot be established". Las causas suelen ser sencillas de resolver.

### ¿Por qué ocurre?

Cambiaste la contraseña de la base de datos desde cPanel (MySQL Databases).
Moviste la tienda a otro servidor y no actualizaste los datos de conexión.
El usuario de la base de datos perdió los privilegios.
El archivo app/config/parameters.php está dañado o tiene información incorrecta.

### Solución paso a paso

Accede a cPanel y busca la sección "Bases de datos MySQL".
Verifica el usuario y la base de datos: Asegúrate de que el usuario de la base de datos existe y está asignado a la base de datos correcta. Si no es así, créalo o reasígnale los privilegios (marca "Todos los privilegios").
Localiza el archivo de configuración: Usa el Administrador de Archivos de cPanel. Navega a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta). Busca la ruta: app/config/parameters.php.
Edita el archivo: Haz clic derecho y selecciona "Editar". Busca estas líneas:
```
'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
```
Asegúrate de que los datos coincidan exactamente con los que ves en cPanel. Si cambiaste la contraseña, actualízala aquí.
Guarda los cambios y cierra el editor. Luego, recarga tu tienda.

[WARNING] Si el error persiste, verifica que el servidor de base de datos no sea localhost sino algo como mysql.tudominio.com. Esto es común en algunos planes de hosting. Revisa la información en "Bases de datos MySQL" en cPanel.

## Pantalla blanca o error 500 en PrestaShop (WSOD)

La temida "pantalla blanca de la muerte" (White Screen of Death) es otro de los errores PrestaShop cPanel que te deja sin pistas visuales. El servidor no puede procesar la petición y muestra una página en blanco o un error 500.

### Causas principales

Límite de memoria PHP excedido: PrestaShop necesita un mínimo de 128 MB, aunque 256 MB es recomendable.
Módulo o tema incompatible: Una actualización o instalación reciente puede estar causando el conflicto.
Permisos de archivos incorrectos: Archivos con permisos demasiado restrictivos o demasiado abiertos.
Error en el archivo .htaccess: Reglas de reescritura mal configuradas.

### Cómo solucionarlo desde cPanel

Aumenta el límite de memoria PHP:
- Ve a "Seleccionar versión de PHP" (o "MultiPHP Manager").
- Haz clic en "Opciones" o "Switch to PHP Options".
- Busca memory_limit y cámbialo a 256M o 512M. También ajusta max_execution_time a 300 y upload_max_filesize a 64M.
- Guarda los cambios.
Desactiva todos los módulos y temas no esenciales:
- Si puedes acceder al back office (a veces sí, aunque la tienda esté en blanco), ve a Módulos > Gestor de módulos y desactiva los módulos que hayas instalado recientemente.
- Si no puedes acceder, deberás hacerlo manualmente desde cPanel:
  - En el Administrador de Archivos, ve a modules (dentro de la raíz de PrestaShop).
  - Renombra la carpeta del módulo sospechoso añadiendo _old al final. Por ejemplo, ps_banner a ps_banner_old. Esto lo desactivará.
- Haz lo mismo con la carpeta themes si sospechas del tema activo. Renombra la carpeta del tema a tema_old y PrestaShop usará el tema por defecto.
Restaura el archivo .htaccess:
- En el Administrador de Archivos, busca el archivo .htaccess en la raíz. Si está corrupto, renómbralo a .htaccess_old.
- Ve al back office (si puedes acceder) y ve a Configuración > SEO y URLs. Haz clic en "Guardar" sin cambiar nada. Esto regenerará el .htaccess.
- Si no puedes acceder al back office, puedes generar un .htaccess básico temporal (pide ayuda a tu hosting o busca en foros).

[INFO] A veces, una simple actualización de la versión de PHP desde cPanel (por ejemplo, de 7.4 a 8.0 o 8.1) resuelve la pantalla blanca. Ve a "Seleccionar versión de PHP" y prueba con una versión más reciente.

## Error de "No se puede escribir en la carpeta cache" o "No se puede escribir en la carpeta log"

PrestaShop necesita permisos de escritura en ciertas carpetas para funcionar correctamente. Si ves errores relacionados con cache, log, upload o download, es un problema de permisos.

### Solución desde cPanel

Accede al Administrador de Archivos.
Navega a la raíz de tu tienda (normalmente public_html).
Corrige los permisos de las siguientes carpetas (debes darles permisos 755):
- /cache
- /log
- /img
- /mails
- /modules
- /themes
- /translations
- /upload
- /download
- /config (a veces también necesita 755)
Cómo hacerlo: Haz clic derecho en la carpeta, selecciona "Cambiar permisos". Marca las casillas:
- Propietario: Lectura, Escritura, Ejecución (7).
- Grupo: Lectura, Ejecución (5).
- Otros: Lectura, Ejecución (5).
- Haz clic en "Cambiar permisos".
Repite para todas las carpetas mencionadas.

[TIP] Si usas un hosting compartido, a veces el propietario de los archivos no es tu usuario de cPanel. En ese caso, contacta al soporte técnico para que te ayuden a cambiar el propietario (chown) de las carpetas.

## Error al instalar o actualizar un módulo en PrestaShop

Este es un problema común que suele venir acompañado de mensajes como "Error al descargar el módulo" o "No se puede conectar con el servidor de Addons".

### Causas y soluciones

Problema de conexión con los servidores de PrestaShop: A veces el firewall de tu hosting bloquea la conexión saliente.
- Solución: Desde cPanel, ve a "Administrador de archivos temporales" o "IP Blocker" y asegúrate de que no haya bloqueos. También puedes probar a instalar el módulo manualmente:
  1. Descarga el módulo desde el sitio oficial en tu PC.
  2. Ve a Módulos > Gestor de módulos en el back office.
  3. Haz clic en "Subir un módulo" (botón azul arriba).
  4. Selecciona el archivo .zip desde tu computadora.
Permisos de la carpeta modules: Como vimos antes, la carpeta modules debe tener permisos 755. Si no, no podrás instalar ni actualizar.
Límite de subida de archivos (upload_max_filesize): Si el módulo pesa más de lo permitido, fallará la subida.
- Solución: Aumenta el upload_max_filesize a 64M o 128M desde las opciones de PHP en cPanel (como explicamos en el paso del límite de memoria).

## Error al enviar correos desde PrestaShop (formulario de contacto, pedidos, etc.)

PrestaShop utiliza la función mail() de PHP por defecto, pero muchos servidores la tienen desactivada o mal configurada. Esto provoca que los correos de confirmación de pedidos o consultas no lleguen.

### Solución desde cPanel

Cambia el método de envío de correo:
- Ve al back office de PrestaShop: Parámetros avanzados > Rendimiento.
- Busca la opción "Enviar correos" o "Mail method". Cámbiala de "Usar la función mail de PHP" a "Configurar SMTP".
- Si no ves esta opción, puede estar en Parámetros de la tienda > Contacto > Configuración de correo electrónico.
Configura SMTP con los datos de tu hosting:
- Necesitarás los datos SMTP de tu proveedor (suelen estar en cPanel, en la sección "Email Deliverability" o "Mail Configuration").
- Un ejemplo típico:
  - Servidor SMTP: mail.tudominio.com o smtp.tudominio.com
  - Puerto: 465 (SSL) o 587 (TLS)
  - Autenticación: Sí
  - Usuario: tu@email.com
  - Contraseña: La de tu correo electrónico.
- Guarda la configuración y prueba enviando un correo de prueba desde PrestaShop.

[WARNING] Si usas servicios como Gmail o Outlook para enviar correos desde tu tienda, asegúrate de permitir "aplicaciones menos seguras" o generar una contraseña específica para la aplicación. Si no, el envío fallará.

## Error "No se puede cargar la clase" o "Class not found" en PrestaShop

Este error suele aparecer después de una actualización o al instalar un módulo. Indica que PrestaShop no encuentra un archivo de clase necesario.

### Solución

Limpia la caché de PrestaShop:
- Desde el back office: Parámetros avanzados > Rendimiento. Haz clic en "Limpiar caché" (tanto de Smarty como de Symfony).
- Si no puedes acceder al back office, hazlo manualmente desde cPanel:
  - En el Administrador de Archivos, ve a /var/cache y elimina todo su contenido.
  - También puedes renombrar la carpeta /cache a /cache_old y crear una nueva carpeta vacía llamada /cache con permisos 755.
Verifica que el archivo de clase existe:
- Si el error menciona una clase específica (ej: Class 'Product' not found), busca el archivo correspondiente en la carpeta /classes de PrestaShop. Si falta, deberás subir el archivo desde una copia limpia de PrestaShop de la misma versión.
Reinstala el módulo o tema conflictivo:
- Si el error apareció después de instalar algo, desinstálalo y vuelve a instalarlo. Si no, contacta al desarrollador.

## Preguntas Frecuentes (FAQ) sobre errores PrestaShop cPanel

### ¿Por qué mi tienda PrestaShop se ve sin estilos (CSS) en cPanel?

Es un problema de URLs amigables o de permisos en la carpeta themes. Ve a Configuración > SEO y URLs en el back office y guarda de nuevo. Si no funciona, desde cPanel, ve a Administrador de Archivos, busca la carpeta /themes/tu_tema/assets/css y verifica que los archivos tengan permisos 644 y la carpeta 755.

### ¿Cómo puedo ver los errores reales de PHP en PrestaShop desde cPanel?

Activa el modo debug:

Edita el archivo config/defines.inc.php en la raíz de PrestaShop.
Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a true.
Guarda el archivo. Ahora verás los errores PHP en pantalla. Recuerda volver a ponerlo en false cuando termines de depurar, o tu tienda mostrará información sensible a los visitantes.

### ¿Qué hago si el error es "No se puede conectar con la base de datos" después de migrar a otro hosting?

Es el error más común al migrar. Sigue los pasos del primer punto de este artículo: edita el archivo app/config/parameters.php con los nuevos datos de la base de datos de tu nuevo cPanel. Asegúrate de que el usuario tenga todos los privilegios.

### Mi PrestaShop es muy lento, ¿puede ser un error de configuración en cPanel?

Sí, a menudo se debe a la configuración de PHP o a la falta de caché. Desde cPanel:

Aumenta el memory_limit y max_execution_time.
Activa la caché de PrestaShop en Parámetros avanzados > Rendimiento.
Habilita la compresión gzip y la caché de páginas si tu hosting lo permite (puedes usar Cloudflare o módulos como "Super Cache").

### ¿Cómo soluciono el error "500 Internal Server Error" en PrestaShop desde cPanel?

Revisa los logs de error del servidor: En cPanel, ve a "Errores" o "Logs de errores" (a veces en la sección "Métricas"). Busca la línea que te dé una pista.
Aumenta la memoria PHP (como se explicó antes).
Desactiva módulos recientes renombrando sus carpetas.
Si todo falla, restaura un backup reciente.

## Conclusión: Resuelve tus errores PrestaShop cPanel con paciencia

La mayoría de los errores PrestaShop cPanel tienen solución y no requieren ser un experto en desarrollo. Con las herramientas que te ofrece cPanel (Administrador de Archivos, Bases de Datos MySQL, MultiPHP Manager), puedes diagnosticar y arreglar problemas de conexión, permisos, memoria o módulos.

Recuerda siempre:

Haz copias de seguridad antes de modificar archivos críticos.
Lee los mensajes de error con atención; a menudo te dan la pista exacta.
Si usas Syspanel (el panel de control alternativo que algunos llaman HestiaCP), recuerda que el puerto de acceso es el 2106 y la estructura es similar, pero los nombres de las secciones pueden variar.
No tengas miedo de pedir ayuda a tu proveedor de hosting si el error persiste. Ellos tienen acceso a los logs del servidor y pueden darte una solución más rápida.

Con esta guía, esperamos que puedas solucionar problemas PrestaShop cPanel de forma autónoma y mantener tu tienda online funcionando sin contratiempos. ¡Mucho éxito con tu negocio!