Problemas de caché en PrestaShop en DirectAdmin: soluciones

¿Tu tienda PrestaShop en un servidor con DirectAdmin va lenta, muestra productos desactualizados o cambios que no se reflejan? El culpable suele ser el sistema de caché. En este artículo extenso y práctico, te explicaré paso a paso cómo resolver los problemas de caché en PrestaShop en DirectAdmin, desde limpiar la caché interna hasta forzar la regeneración en el servidor.

Entender cómo funciona el caché PrestaShop DirectAdmin es clave para mantener tu tienda rápida y con contenido fresco. Vamos a desglosar todos los escenarios posibles, desde lo más básico hasta soluciones avanzadas, para que cualquier usuario, incluso sin experiencia técnica, pueda aplicar estas soluciones.

¿Por qué aparecen problemas de caché en PrestaShop?

La caché es un aliado para la velocidad, pero cuando no se gestiona bien, se convierte en un enemigo. PrestaShop almacena versiones estáticas de tus páginas, imágenes, CSS y JavaScript para servirlas más rápido. En un entorno con DirectAdmin, además, intervienen la caché del servidor web (Apache o LiteSpeed) y posiblemente un plugin de caché.

Los síntomas más comunes de problemas caché PrestaShop son:

Cambios en productos, categorías o módulos que no se ven en la tienda.
Imágenes que siguen mostrando versiones antiguas.
Errores 404 o 500 después de instalar un módulo.
La página de administración (back office) carga lentamente o muestra datos desactualizados.

[INFO] La mayoría de estos problemas se resuelven con una limpieza completa de la caché. Pero hay que saber qué capas de caché existen y cómo vaciarlas en el orden correcto.

Método 1: Limpiar la caché interna de PrestaShop (Back Office)

Este es el primer paso y el más sencillo. Desde el panel de administración de PrestaShop puedes regenerar la caché interna.

Paso a paso para limpiar caché PrestaShop desde el back office

Accede a tu panel de administración de PrestaShop (ej: tutienda.com/admin1234).
Ve al menú Parámetros de la tienda > Rendimiento (o Configuración avanzada > Rendimiento en versiones antiguas).
Busca la sección "Borrar caché" o "Cache".
Haz clic en el botón "Borrar la caché" (o el enlace que diga "Limpiar caché").
Espera unos segundos y recarga la tienda.

[TIP] Si no ves cambios, prueba también en Parámetros de la tienda > Mantenimiento y desactiva/activa el modo mantenimiento para forzar una regeneración completa.

¿Y si el botón no funciona?

En ocasiones, el botón de limpiar caché no responde debido a permisos de archivos o a que la caché está corrupta. En ese caso, puedes forzar la limpieza manualmente desde el servidor.

Método 2: Limpiar la caché manualmente desde DirectAdmin (File Manager)

Cuando el back office no responde o necesitas una limpieza más profunda, accede directamente a los archivos del servidor a través de DirectAdmin.

Acceder al File Manager de DirectAdmin

Inicia sesión en tu panel de DirectAdmin (normalmente tudominio.com:2222).
Busca el icono de "File Manager" (Administrador de archivos).
Navega hasta la carpeta raíz de tu tienda PrestaShop (normalmente public_html o domains/tudominio.com/public_html).

Archivos y carpetas clave para borrar la caché

Dentro de la raíz de PrestaShop, elimina o vacía las siguientes carpetas:

/var/cache/: Esta es la principal. Elimina todo su contenido (pero no la carpeta en sí). En versiones modernas de PrestaShop, la carpeta se llama /var/cache/prod/ y /var/cache/dev/. Vacíalas ambas.
/cache/smarty/: Contiene las plantillas compiladas. Vacía esta carpeta.
/themes/tutema/cache/: Si tu tema tiene su propia carpeta de caché, vacíala también.
/upload/: A veces los archivos temporales de imágenes se quedan aquí. No la vacíes entera, pero sí puedes eliminar archivos *.tmp.

[WARNING] No borres las carpetas en sí, solo su contenido. Si eliminas la carpeta /var/cache/, PrestaShop no podrá regenerarla y dará error. Si lo haces por error, crea una carpeta vacía con el mismo nombre y permisos 755.

Forzar la regeneración de la caché de clases

Además de las carpetas anteriores, PrestaShop genera un archivo de caché de clases llamado class_index.php. Para forzar su regeneración:

Ve a la carpeta /app/cache/ (o /var/cache/ según la versión).
Busca el archivo class_index.php y renómbralo (ej: class_index.php.old) o elimínalo.
Al recargar cualquier página, PrestaShop lo regenerará automáticamente.

Método 3: Desactivar la caché de PrestaShop desde la base de datos

Si los cambios no se reflejan ni siquiera después de limpiar manualmente, puede que la configuración de caché esté corrupta. Puedes resetearla desde la base de datos.

Acceder a phpMyAdmin en DirectAdmin

En DirectAdmin, busca el icono de "phpMyAdmin" (normalmente en la sección de Bases de Datos).
Selecciona la base de datos de tu PrestaShop.
Haz clic en la pestaña SQL y ejecuta las siguientes consultas:

TRUNCATE TABLE `ps_cache`;
TRUNCATE TABLE `ps_cache_lang`;
TRUNCATE TABLE `ps_cache_query`;

[INFO] El prefijo ps_ puede ser diferente si lo cambiaste al instalar PrestaShop. Revisa el nombre real de las tablas en tu base de datos.

Desactivar completamente la caché desde SQL

Si el problema persiste, puedes desactivar la caché por defecto:

UPDATE `ps_configuration` SET `value` = '0' WHERE `name` = 'PS_CACHE_ENABLED';
UPDATE `ps_configuration` SET `value` = '0' WHERE `name` = 'PS_SMARTY_CACHE';

Luego, desde el back office, vuelve a activarla y pruébala.

Método 4: Solucionar problemas de caché del servidor (Apache/LiteSpeed)

DirectAdmin utiliza Apache o LiteSpeed como servidor web. Estos también tienen su propia caché que puede interferir.

Limpiar la caché de Apache (mod_cache)

Si tu hosting tiene habilitado el módulo mod_cache de Apache:

En DirectAdmin, ve a "Custom HTTPD Config" o "Apache Configuration".
Busca la opción de "Cache" y desactívala temporalmente.
También puedes reiniciar Apache desde "Services" > "Apache" > "Restart".

[WARNING] Reiniciar Apache puede causar una interrupción breve (unos segundos). Hazlo en horas de bajo tráfico.

Si usas LiteSpeed (LSAPI)

LiteSpeed tiene su propia caché dinámica. Para limpiarla:

Accede a "LiteSpeed Web Admin" desde DirectAdmin (puerto 7080 o similar).
Ve a "Actions" > "Clear Cache".
Selecciona el dominio de tu tienda y haz clic en "Clear".

Método 5: Plugins de caché externos (ej: PrestaShop Cache Cleaner)

Si prefieres una solución automatizada, puedes instalar un módulo gratuito como "PrestaShop Cache Cleaner" desde el marketplace de PrestaShop. Este módulo te permite limpiar todas las capas de caché con un solo clic desde el back office.

Cómo usarlo

Descarga e instala el módulo.
Ve a "Módulos > Administrador de módulos".
Busca "Cache Cleaner" y haz clic en "Configurar".
Marca todas las opciones (caché de Smarty, de clases, de imágenes, etc.) y haz clic en "Limpiar todo".

Método 6: Forzar la regeneración de imágenes (problemas de caché visual)

Si los cambios en imágenes (productos, categorías, logotipos) no se ven, es porque PrestaShop guarda versiones en caché de las imágenes redimensionadas.

Regenerar miniaturas desde el back office

Ve a "Parámetros de la tienda > Imágenes".
Haz clic en el botón "Regenerar miniaturas".
Selecciona "Todos los tamaños" y confirma.

[TIP] Este proceso puede tardar varios minutos si tienes muchas imágenes. No cierres la página.

Si no funciona, borra manualmente las imágenes cacheadas

Desde el File Manager de DirectAdmin, ve a la carpeta /img/p/ y dentro de ella encontrarás subcarpetas con números (1, 2, 3...). Cada subcarpeta contiene las imágenes redimensionadas. Puedes eliminar todo el contenido de /img/p/ (excepto la carpeta raíz) y luego regenerar desde el back office.

Método 7: Deshabilitar la caché de terceros (CDN, plugins de caché de navegador)

Si usas un CDN como Cloudflare o un plugin de caché como "LiteSpeed Cache" o "WP Rocket" (aunque sea para PrestaShop), estos también almacenan versiones en caché.

Limpiar caché de Cloudflare

Inicia sesión en tu cuenta de Cloudflare.
Selecciona el dominio de tu tienda.
Ve a "Caching" > "Configuration".
Haz clic en "Purge Everything".

Desactivar temporalmente plugins de caché

Si tienes un plugin de caché instalado en PrestaShop (ej: "PrestaShop Cache" de algunos temas), desactívalo desde "Módulos > Administrador de módulos" y pruébalo.

Preguntas frecuentes (FAQ) sobre problemas de caché en PrestaShop

¿Por qué después de limpiar la caché mi tienda sigue mostrando datos antiguos?

Puede que la caché del navegador esté almacenando la versión anterior. Abre la tienda en una ventana de incógnito o borra la caché del navegador (Ctrl+Shift+Supr en Chrome). También puede ser que el servidor web (Apache/LiteSpeed) tenga su propia caché que no has limpiado (ver Método 4).

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

No hay una regla fija. Si haces cambios frecuentes (productos, precios, módulos), límpiala cada vez que actualices algo. Si tu tienda es estática, una vez al mes es suficiente. Pero si notas lentitud, límpiala inmediatamente.

¿Es seguro borrar la carpeta `/var/cache/`?

Sí, siempre que solo borres el contenido, no la carpeta en sí. Si la eliminas, PrestaShop no podrá regenerarla y dará error 500. Si ocurre, crea una carpeta vacía con permisos 755 y propietario el usuario del hosting.

¿Qué hago si el back office de PrestaShop no carga después de limpiar la caché?

Esto suele pasar si borraste la carpeta /var/cache/ o si el archivo class_index.php se corrompió. Solución: desde el File Manager, crea la carpeta /var/cache/ vacía y dale permisos 755. Luego, renombra o elimina el archivo class_index.php en /app/cache/ (o /var/cache/). Recarga la URL del back office.

¿El uso de Syspanel (anteriormente HestiaCP) afecta a la caché de PrestaShop?

Si tu servidor usa Syspanel (puerto 2106), ten en cuenta que este panel también puede tener su propia caché de sistema. Aunque no afecta directamente a PrestaShop, si realizas cambios en la configuración del servidor (ej: PHP, Apache) desde Syspanel, es recomendable reiniciar los servicios desde el panel (Services > Apache > Restart) para que los cambios surtan efecto.

¿Cómo saber si mi hosting tiene activada la caché de Apache?

Desde DirectAdmin, ve a "Apache Configuration" y busca la sección "Modules". Si ves mod_cache o mod_cache_disk listados, está activada. También puedes preguntar a tu proveedor de hosting.

Conclusión: Mantén tu tienda rápida y actualizada

Resolver problemas caché PrestaShop no es complicado si sabes dónde mirar. Sigue estos pasos en orden:

Back office: Limpia la caché interna.
DirectAdmin: Vacía las carpetas /var/cache/, /cache/smarty/ y elimina class_index.php.
Base de datos: Trunca las tablas de caché si lo anterior falla.
Servidor web: Limpia la caché de Apache/LiteSpeed.
CDN/Plugins: Purgar caché externa.

[INFO] Si después de todo esto los problemas persisten, contacta a tu proveedor de hosting. Puede que tengan configuraciones especiales de caché a nivel de servidor que requieran intervención manual.

Recuerda que una tienda con caché bien gestionada no solo es más rápida, sino que mejora tu SEO y la experiencia de usuario. ¡Pon en práctica estos consejos y verás la diferencia!