Cómo solucionar errores de caché en PrestaShop (DirectAdmin y cPanel)

¿Por qué mi PrestaShop muestra errores de caché?

Si estás leyendo esto, probablemente has visto mensajes extraños en tu tienda, productos que no se actualizan, o una página en blanco que no hay manera de recuperar. Los errores caché PrestaShop son uno de los problemas más comunes cuando gestionas una tienda online, y la buena noticia es que, en la mayoría de los casos, tienen una solución sencilla.

La caché es como una "memoria rápida" que guarda versiones de tus páginas para que se carguen más rápido. El problema surge cuando esa memoria se queda obsoleta o se corrompe. Piensa en ello como una foto antigua de tu escaparate: aunque cambies los productos, los clientes siguen viendo la foto vieja.

En este artículo, te voy a explicar paso a paso cómo solucionar estos errores tanto si tu tienda está alojada en un panel de control DirectAdmin como en cPanel. No necesitas ser un experto en informática, solo seguir las instrucciones al pie de la letra.

Primeros auxilios: La limpieza desde el panel de administración de PrestaShop

Antes de tocar nada en el servidor, vamos a intentar la vía más sencilla. PrestaShop tiene su propia herramienta para gestionar la caché, y muchas veces es suficiente con usarla.

Accede a los parámetros de rendimiento

1. Inicia sesión en tu panel de administración de PrestaShop (normalmente en tudominio.com/admin).
2. En el menú lateral izquierdo, busca la sección Parámetros avanzados.
3. Dentro, haz clic en Rendimiento o Performance.

Desactiva y reactiva la caché

Esta es la técnica del "apaga y enciende", pero aplicada al software:

1. En la opción Combinar archivos JavaScript y Combinar archivos CSS, selecciona No.
2. Guarda los cambios.
3. Vuelve a seleccionar Sí en ambas opciones.
4. Guarda de nuevo.
5. Ahora, busca el botón que dice Vaciar la caché (o Clear cache). Haz clic en él.

[TIP] Si no ves el botón de vaciar caché, prueba a hacer una pequeña edición en un producto y guardarla. A veces eso fuerza a PrestaShop a regenerar la caché.

Activa el modo mantenimiento temporalmente

Si la página sigue fallando, activa el modo mantenimiento para que los clientes no vean los errores mientras trabajas:

1. Ve a Parámetros generales.
2. Activa Modo mantenimiento.
3. Guarda los cambios.
4. Vuelve a intentar la limpieza de caché.
5. Cuando todo funcione, desactiva el modo mantenimiento.

Limpiar caché PrestaShop DirectAdmin: Guía completa

Si el problema persiste, es hora de pasar a la acción directa sobre el servidor. DirectAdmin es un panel de control muy popular en el hosting compartido, y aunque puede parecer intimidante, los pasos son muy claros.

Accede al administrador de archivos

1. Entra en tu panel de DirectAdmin con tus credenciales de acceso.
2. Busca la sección Administrador de archivos o File Manager.
3. Te pedirá que elijas un directorio. Selecciona la carpeta domains y luego tudominio.com.
4. Dentro, busca la carpeta public_html. Ahí es donde vive tu tienda PrestaShop.

Localiza la carpeta var/cache

La caché de PrestaShop se guarda en una carpeta específica:

1. Dentro de public_html, busca la carpeta var.
2. Entra en ella y localiza la subcarpeta cache.
3. Dentro de var/cache, verás una o varias carpetas con nombres extraños como dev o prod. Estas son las carpetas de caché.

[WARNING] No borres la carpeta var entera. Solo necesitas borrar el contenido de las subcarpetas de caché.

Borra el contenido de la caché

1. Entra en la carpeta prod (o la que exista).
2. Selecciona todos los archivos que hay dentro (Ctrl+A o Cmd+A).
3. Haz clic derecho y elige Eliminar.
4. Confirma la eliminación.

Repite este proceso en la carpeta dev si existe. No te preocupes si no ves estas carpetas, a veces solo hay una.

Verifica los permisos de la carpeta cache

A veces el error no es que la caché esté llena, sino que PrestaShop no puede escribir en ella:

1. Vuelve a la carpeta cache.
2. Haz clic derecho sobre ella y selecciona Cambiar permisos.
3. Asegúrate de que el permiso sea 755 o 775.
4. Si tienes la opción de "recursivo", actívala para que se aplique a todas las subcarpetas.

[INFO] Los permisos 755 significan que el propietario puede leer, escribir y ejecutar, y el resto solo leer y ejecutar. Es el estándar para estas carpetas.

Usa SSH si tienes acceso (opcional avanzado)

Si tu plan de hosting incluye acceso SSH, puedes hacer la limpieza mucho más rápido:

cd public_html/var/cache
rm -rf prod/*

Este comando borra todo el contenido de la carpeta prod. Asegúrate de estar en el directorio correcto antes de ejecutarlo.

Caché PrestaShop cPanel: Solución paso a paso

cPanel es otro de los paneles más comunes, y el proceso es muy similar pero con algunas diferencias en la interfaz.

Entra al administrador de archivos de cPanel

1. Inicia sesión en cPanel.
2. Busca la sección Archivos y haz clic en Administrador de archivos.
3. Se abrirá una ventana. Asegúrate de marcar la casilla Mostrar archivos ocultos (dotfiles) antes de continuar.
4. Navega hasta public_html.

Limpia la caché manualmente

1. Dentro de public_html, localiza la carpeta var.
2. Entra en var y luego en cache.
3. Ahora verás las carpetas dev y prod.
4. Entra en prod y selecciona todos los archivos.
5. Haz clic en Eliminar en la barra superior.

[TIP] En cPanel, puedes usar la función Seleccionar todo en la esquina superior derecha del administrador de archivos para no perderte ningún archivo.

Comprueba el uso de espacio

A veces la caché ocupa tanto espacio que llena el disco. Puedes verificarlo:

1. En el administrador de archivos, navega hasta var/cache.
2. Haz clic derecho sobre la carpeta prod y selecciona Calcular tamaño.
3. Si es enorme (más de 500 MB), eso explica los problemas.

Utiliza el terminal de cPanel

cPanel tiene un terminal integrado que es muy útil:

1. En el buscador de cPanel, escribe Terminal.
2. Se abrirá una ventana de línea de comandos.
3. Escribe:

cd public_html/var/cache
rm -rf prod/*

[WARNING] Ten mucho cuidado con el comando rm -rf. Asegúrate de que estás en la carpeta correcta. Si lo ejecutas en la raíz del servidor, podrías borrar todo tu hosting.

La caché de tu navegador y del servidor: No te olvides de ellas

A veces el problema no está solo en PrestaShop, sino en otras capas de caché que se acumulan.

Caché del navegador

Tu propio navegador puede estar mostrando una versión antigua de la página:

1. En Chrome o Firefox, presiona Ctrl + Shift + Supr (Windows) o Cmd + Shift + Supr (Mac).
2. Selecciona Imágenes y archivos en caché.
3. Haz clic en Borrar datos.

Caché de Cloudflare o CDN

Si usas Cloudflare u otro CDN, también tienen su propia caché:

1. Entra en tu panel de Cloudflare.
2. Ve a Caching o Caché.
3. Haz clic en Purge Everything (Purgar todo).

Caché de PHP (OPcache)

La caché de PHP es otra capa que puede causar problemas:

1. En cPanel, busca Select PHP Version o MultiPHP Manager.
2. Si tienes acceso a la configuración de OPcache, desactívala temporalmente.
3. Si no sabes cómo hacerlo, contacta con tu proveedor de hosting.

Errores específicos y sus soluciones

Error: "El archivo no se puede escribir"

Este error suele aparecer cuando los permisos de la carpeta cache son incorrectos:

1. Cambia los permisos de var/cache a 777 temporalmente.
2. Limpia la caché desde el panel de PrestaShop.
3. Vuelve a cambiar los permisos a 755.

[WARNING] Nunca dejes los permisos en 777 permanentemente. Es un riesgo de seguridad grave. Cámbialos de vuelta después de la limpieza.

Error: "Página en blanco" (White Screen of Death)

Si ves una página completamente blanca:

1. Activa el modo debug de PrestaShop. Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true.
2. Esto mostrará el error real en pantalla.
3. Anota el error y busca su solución específica.
4. Cuando termines, vuelve a poner false.

Error: "El carrito no se actualiza"

Este es un clásico de los errores de caché:

1. Ve a Parámetros avanzados > Rendimiento.
2. En Cache de plantillas, selecciona Forzar compilación.
3. Guarda y luego vuelve a seleccionar Recompilar los archivos de plantillas.
4. Guarda de nuevo.

Prevención: Cómo evitar futuros errores de caché

La mejor solución es la prevención. Aquí tienes algunos consejos para minimizar estos problemas:

Programa la limpieza automática

1. En PrestaShop, ve a Parámetros avanzados > Mantenimiento.
2. Activa la opción Vaciar la caché automáticamente.
3. Establece un intervalo, por ejemplo, cada 24 horas.

Actualiza PrestaShop regularmente

Las versiones antiguas tienen más bugs relacionados con la caché:

1. Siempre mantén tu PrestaShop actualizado a la última versión.
2. Actualiza también los módulos y el tema.

Configura correctamente la caché

No uses todas las opciones de caché al máximo si no las necesitas:

1. En Rendimiento, no combines JavaScript y CSS si tu servidor es modesto.
2. Usa la caché de Memcached o APCu solo si tu hosting lo soporta.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo tarda en funcionar la limpieza de caché?

Normalmente, los efectos son inmediatos. Si no ves cambios, espera 5-10 minutos y recarga la página con Ctrl + F5.

¿Perderé mis datos si limpio la caché?

No. La caché solo guarda archivos temporales. Tus productos, clientes y pedidos están en la base de datos y no se ven afectados.

¿Puedo borrar la carpeta var/cache entera?

Técnicamente sí, pero PrestaShop la recreará automáticamente. Si tienes dudas, borra solo el contenido de las subcarpetas, no las carpetas en sí.

¿Qué hago si después de todo esto sigue fallando?

Si has seguido todos los pasos y el problema persiste, es hora de contactar con tu proveedor de hosting. Puede haber un problema en el servidor que no puedas resolver tú mismo.

¿Es normal que la caché se llene rápidamente?

Depende del tráfico de tu tienda. Si tienes muchos visitantes, es normal que la caché se regenere rápido. Lo importante es que el sistema funcione correctamente.

Conclusión: No temas a los errores de caché

Los errores caché PrestaShop son un dolor de cabeza común, pero como has visto, tienen solución. Tanto si usas DirectAdmin como cPanel, el proceso es bastante similar y accesible para cualquier persona sin conocimientos técnicos avanzados.

Recuerda el orden lógico: primero intenta la limpieza desde el panel de PrestaShop, luego pasa a los archivos del servidor, y solo si es necesario, toca la configuración avanzada. Y si te sientes perdido, no dudes en contactar con tu proveedor de hosting. Para eso están.

Espero que esta guía te haya sido útil. Ahora ve y pon tu tienda en marcha. Tu caché y tus clientes te lo agradecerán.