Solucionar errores de PrestaShop en cPanel: Guía práctica

Si tienes una tienda online con PrestaShop, es probable que en algún momento te hayas encontrado con algún error. No te preocupes, es normal. La mayoría de estos problemas se pueden solucionar directamente desde el panel de control de tu hosting, ya sea cPanel o Syspanel (antes conocido como HestiaCP). En esta guía, te explicaré paso a paso cómo resolver los errores más comunes de PrestaShop desde cPanel, de forma sencilla y sin necesidad de ser un experto en programación.

¿Por qué ocurren los errores en PrestaShop?

Antes de empezar, es útil entender que muchos errores en PrestaShop están relacionados con la configuración del servidor, la memoria disponible, los permisos de archivos o la versión de PHP. Al acceder a cPanel, tienes herramientas para ajustar estos parámetros y solucionar la mayoría de los problemas sin tener que contactar con soporte técnico.

Error 500 o Pantalla Blanca en PrestaShop

Este es uno de los errores PrestaShop cPanel más frecuentes. Una pantalla en blanco o un error 500 suele deberse a un problema de memoria, un módulo conflictivo o un archivo corrupto.

Solución desde cPanel:

Aumenta el límite de memoria PHP:
- En cPanel, busca la sección Seleccionar versión de PHP (o MultiPHP Manager).
- Haz clic en Opciones o Switch to PHP Options.
- Busca la opción memory_limit y cámbiala a 256M o 512M.
- Guarda los cambios.
Verifica los permisos de archivos:
- Ve a Administrador de archivos en cPanel.
- Navega hasta la carpeta raíz de tu tienda (normalmente public_html).
- Selecciona todos los archivos y carpetas.
- Haz clic derecho y elige Cambiar permisos.
- Pon 755 para carpetas y 644 para archivos. Esto es seguro y evita errores de escritura.
Desactiva módulos problemáticos:
- Si puedes acceder al back office, desactiva el último módulo que instalaste.
- Si no puedes acceder, renombra la carpeta modules desde Administrador de archivos a modules_old. Esto desactivará todos los módulos. Luego, ve renombrándolos de uno en uno para identificar el culpable.

[TIP] Si el error persiste, revisa el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Así verás el error exacto en pantalla.

Error de conexión a la base de datos

Este error aparece cuando PrestaShop no puede conectar con MySQL. Puede deberse a que las credenciales son incorrectas o la base de datos está caída.

Solución desde cPanel:

Verifica las credenciales en el archivo de configuración:
- Abre el Administrador de archivos.
- Busca el archivo app/config/parameters.php (en PrestaShop 1.7) o config/settings.inc.php (en PrestaShop 1.6).
- Ábrelo para editarlo y comprueba que los datos (database_host, database_name, database_user, database_password) sean correctos.
Repara la base de datos desde phpMyAdmin:
- En cPanel, busca el icono de phpMyAdmin.
- Selecciona la base de datos de tu tienda.
- Marca la casilla Seleccionar todo y, en el menú desplegable, elige Reparar tabla.
Comprueba que el servicio MySQL esté activo:
- Si usas un VPS o servidor dedicado, desde cPanel ve a Servicios o MySQL y asegúrate de que esté corriendo.

[WARNING] Nunca compartas tu contraseña de base de datos en foros públicos. Si sospechas que ha sido comprometida, cámbiala desde cPanel en Bases de datos MySQL.

Error de memoria insuficiente (Allowed memory size exhausted)

Este error es muy común al instalar módulos o temas pesados. Aparece un mensaje como Allowed memory size of X bytes exhausted.

Solución desde cPanel:

Aumenta el límite de memoria PHP (como vimos antes, pero también puedes hacerlo desde un archivo):
- Crea o edita el archivo php.ini en la raíz de tu tienda.
- Agrega la línea: memory_limit = 256M
- Guarda y sube el archivo.
Aumenta el límite de ejecución:
- En el mismo php.ini, añade: max_execution_time = 300
Usa el gestor de PHP de cPanel:
- Ve a Seleccionar versión de PHP y luego a Opciones.
- Cambia memory_limit y max_execution_time a valores más altos.

[INFO] Si tu hosting es compartido, el límite puede estar restringido por el proveedor. En ese caso, contacta con soporte para que lo aumenten.

Error de compatibilidad de PHP (PrestaShop no funciona tras actualizar PHP)

PrestaShop requiere una versión específica de PHP. Si actualizas PHP y la tienda deja de funcionar, es probable que sea por incompatibilidad.

Solución desde cPanel:

Cambia la versión de PHP:
- En cPanel, busca Seleccionar versión de PHP.
- Elige una versión compatible con tu PrestaShop. Por ejemplo:
  - PrestaShop 1.6: PHP 5.6 o 7.0 (mejor 5.6).
  - PrestaShop 1.7: PHP 7.1 a 7.4.
  - PrestaShop 8: PHP 8.0 o superior.
Verifica extensiones PHP necesarias:
- En la misma pantalla, asegúrate de que las extensiones como mysqli, gd, curl, mbstring y openssl estén activadas.
Prueba en un entorno de desarrollo:
- Si tienes dudas, crea una copia de tu tienda en un subdominio y prueba la nueva versión de PHP allí.

[TIP] Siempre haz una copia de seguridad completa antes de cambiar la versión de PHP.

Error al subir imágenes o productos (límite de subida)

Cuando intentas subir imágenes grandes o muchos productos, puede aparecer un error de límite de archivo.

Solución desde cPanel:

Aumenta el límite de subida de archivos:
- En el archivo php.ini (como vimos antes), añade:
  - upload_max_filesize = 64M
  - post_max_size = 64M
  - max_execution_time = 300
Configura el límite desde cPanel:
- Ve a Seleccionar versión de PHP > Opciones y ajusta los mismos valores.
Comprime las imágenes antes de subirlas:
- Usa herramientas como TinyPNG para reducir el peso de las imágenes sin perder calidad.

[WARNING] Si tu hosting tiene límites muy bajos, considera contratar un plan superior o usar un CDN para imágenes.

Error de caché o de compilación de plantillas

A veces los cambios no se ven reflejados en la tienda porque la caché está desactualizada.

Solución desde cPanel:

Limpia la caché de PrestaShop:
- Desde el back office, ve a Parámetros avanzados > Rendimiento y haz clic en Limpiar caché.
Borra la caché manualmente:
- En Administrador de archivos de cPanel, elimina el contenido de las carpetas:
  - var/cache/ (PrestaShop 1.7)
  - cache/ (PrestaShop 1.6)
  - themes/tu_tema/cache/
Desactiva la caché temporalmente:
- En la misma sección de Rendimiento, desactiva la Caché y la Compilación de plantillas mientras haces pruebas.

[INFO] La caché de cPanel no afecta a PrestaShop directamente, pero si usas un plugin de caché como LiteSpeed, límpialo también.

Error de URL amigable (404 en todas las páginas)

Si después de activar las URLs amigables todo da error 404, es porque el archivo .htaccess no se ha generado bien.

Solución desde cPanel:

Regenera el archivo .htaccess:
- En el back office, ve a Parámetros avanzados > SEO y URLs.
- Haz clic en Guardar sin cambiar nada. Esto regenera el archivo.
Si no puedes acceder al back office:
- En Administrador de archivos, busca el archivo .htaccess en la raíz.
- Si no existe, crea uno nuevo con este contenido básico:
```
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
```
Verifica los permisos del archivo:
- Asegúrate de que .htaccess tenga permisos 644.

[TIP] Si usas Syspanel (HestiaCP), el puerto de acceso es el 2106. Desde allí también puedes editar archivos.

Preguntas Frecuentes (FAQ)

¿Qué hago si no puedo acceder al back office de PrestaShop?

Puedes desactivar módulos renombrando la carpeta modules desde Administrador de archivos en cPanel. También puedes restaurar una copia de seguridad.

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

Revisa los requisitos en la documentación oficial de PrestaShop. En general, PrestaShop 1.7 funciona bien con PHP 7.4.

¿Es seguro modificar archivos desde cPanel?

Sí, siempre que hagas una copia de seguridad antes. cPanel es una herramienta segura si tienes cuidado con los permisos.

¿Puedo solucionar errores PrestaShop cPanel sin experiencia?

Sí, siguiendo los pasos de esta guía. Si tienes dudas, consulta a tu proveedor de hosting o a un técnico especializado.

¿Qué hago si el error persiste después de todo?

Contacta con el soporte de tu hosting. A veces el problema está en el servidor, no en tu tienda. Si usas Syspanel, recuerda que el acceso es por el puerto 2106.

Conclusión

Solucionar errores PrestaShop cPanel no tiene por qué ser complicado. Con las herramientas que ofrece cPanel (o Syspanel), puedes aumentar la memoria, ajustar PHP, reparar la base de datos y limpiar la caché sin necesidad de conocimientos avanzados. La clave está en identificar el error, aplicar la solución adecuada y, sobre todo, hacer copias de seguridad periódicas.

Espero que esta guía te haya sido útil. Recuerda que cPanel es tu mejor aliado para mantener tu tienda online errores bajo control. Si tienes alguna duda, déjala en los comentarios o contacta con tu proveedor de hosting. ¡Buena suerte con tu tienda!