Cómo activar el modo depuración (debug) en PrestaShop desde el archivo config

¿Tu tienda PrestaShop se ha quedado en blanco y no sabes qué ha pasado? ¿Aparece un error genérico que no te dice nada? Este es uno de los momentos más frustrantes para cualquier administrador de una tienda online. Pero no te preocupes, porque existe una herramienta secreta que te va a ayudar a desvelar el misterio: el modo depuración (debug).

Activar el modo depuración en PrestaShop es como abrir el capó de tu coche para ver el motor. En lugar de mostrarte una pantalla vacía, te enseña exactamente qué archivo está fallando y por qué. En esta guía te voy a explicar, paso a paso y sin tecnicismos complicados, cómo activar debug PrestaShop desde el archivo de configuración principal. Olvídate de los dolores de cabeza y convirtámonos en detectives.

¿Qué es el modo depuración y por qué es tu salvavidas?

Antes de ensuciarnos las manos con código, vamos a entender qué estamos activando. El modo depuración PrestaShop es una función interna que muestra en pantalla los errores detallados del sistema. Normalmente, PrestaShop oculta estos detalles para proteger tu tienda de miradas indiscretas, pero cuando algo falla, esa discreción te deja sin pistas.

Cuando activas este modo, verás en tu pantalla (en lugar de una pantalla blanca PrestaShop o un error genérico) una serie de mensajes técnicos que incluyen:

• La descripción exacta del error.
• El archivo específico donde se ha producido.
• El número de línea exacta del problema.

Con esta información, podrás buscar soluciones concretas en foros o contactar a tu soporte técnico diciendo: "Tengo un error en la línea 245 del archivo classes/Product.php", en lugar de decir "no funciona". Es la diferencia entre ir al médico diciendo "me duele" y decir "me duele la muela del juicio del lado derecho".

¿Cuándo deberías activar este modo?

• Cuando tu tienda muestra una pantalla blanca total.
• Cuando ves errores como "500 Internal Server Error" o "Fatal error".
• Cuando instalas un módulo o tema nuevo y algo se rompe.
• Cuando necesitas saber si un archivo tiene permisos incorrectos.

Preparación antes del cambio: copia de seguridad y acceso

Vamos a tocar un archivo sensible de tu instalación, así que la prudencia es clave. Antes de editar nada, asegúrate de tener una copia de seguridad reciente de tu base de datos y de tus archivos. Si algo sale mal, podrás restaurar tu tienda en minutos.

También necesitarás dos cosas para acceder al archivo de configuración:

1. Un administrador de archivos: Puedes usar el panel de control de tu hosting (como cPanel, Plesk o Syspanel). Si tu hosting usa Syspanel, recuerda que el acceso se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Dentro de Syspanel, busca la opción "Administrador de archivos" o "Gestor de archivos".
2. Un cliente FTP: Programas como FileZilla te permiten conectarte a tu servidor y navegar por los archivos como si fueran carpetas locales.

Una vez que tengas una de estas dos herramientas, localiza la carpeta raíz de tu tienda PrestaShop. Normalmente se llama public_html, htdocs o www, pero puede variar según tu hosting.

El archivo mágico: config/defines.inc.php

Dentro de la carpeta raíz, busca una subcarpeta llamada config. Dentro de ella, encontrarás un archivo llamado defines.inc.php. Este es nuestro objetivo. Es el archivo de configuración central que define constantes globales para toda la aplicación.

Método 1: Editar el archivo con un editor de texto

Este es el método más directo y que funciona en el 99% de los casos. Sigue estos pasos al pie de la letra:

1. Descarga el archivo: Usando tu cliente FTP, descarga defines.inc.php a tu ordenador. Si usas el administrador de archivos de tu hosting, busca el archivo y haz clic derecho para "Editar" o "Descargar".

2. Abre el archivo: Ábrelo con un editor de texto plano. No uses Word o Pages, ya que pueden añadir caracteres invisibles que rompan el código. Programas como Sublime Text, Notepad++ o incluso el Bloc de notas de Windows son perfectos.

3. Busca la línea clave: Dentro del archivo, busca una línea de código que dice algo similar a esto:

   define('_PS_MODE_DEV_', false);
   

   Esta línea es la que controla el modo depuración. El valor false significa que está desactivado.

4. Cambia el valor: Modifica esa línea para que quede así:

   define('_PS_MODE_DEV_', true);
   

   Simplemente cambia false por true. Es un cambio mínimo, pero con un poder enorme.

5. Guarda y sube el archivo: Guarda los cambios en tu editor y vuelve a subir el archivo a tu servidor, sobrescribiendo el original. Si estás usando el administrador de archivos, guarda los cambios directamente.

[TIP]
Si no encuentras la línea exacta, no busques _PS_MODE_DEV_ directamente. Busca _PS_MODE_ y verás varias opciones. La que nos interesa es la que termina en _DEV_.

Método 2: Usar el administrador de archivos de tu hosting (La vía rápida)

Si tu hosting tiene un administrador de archivos web, este proceso es aún más rápido:

1. Accede a tu panel de control (cPanel, Plesk o Syspanel en el puerto 2106).
2. Abre el "Administrador de Archivos".
3. Navega hasta config/defines.inc.php.
4. Haz clic derecho sobre el archivo y selecciona "Editar" o "Code Editor".
5. El sistema abrirá un editor de texto en tu navegador. Busca la línea define('_PS_MODE_DEV_', false); y cambia false por true.
6. Guarda el archivo con el botón "Guardar" o "Save".

Este método es más visual y no necesitas programas externos. Es ideal para principiantes.

¿Qué hacer después de activar el modo depuración?

Ya has activado el modo depuración. Ahora, vuelve a cargar la página de tu tienda que daba error. En lugar de la pantalla blanca PrestaShop, verás una página con un fondo blanco y texto técnico. No te asustes, es la información que necesitamos.

Verás algo como esto:

[Fatal Error]
Class 'Module' not found in /home/tudominio/public_html/classes/controller/Controller.php on line 123

O un error de PHP más complejo. Anota todo lo que veas: el mensaje, el archivo y la línea. Esta es la clave para encontrar la solución.

Cómo interpretar los errores comunes

• "Fatal error: Class not found": Significa que un archivo no se está cargando correctamente. Suele ocurrir al instalar módulos incompatibles o al mover archivos de lugar.
• "Parse error: syntax error": Hay un error de sintaxis en un archivo PHP. Esto ocurre si has editado un archivo y has dejado un carácter de más o de menos.
• "Warning: require_once()": Indica que un archivo necesario no existe o no tiene permisos de lectura.

Con esta información, puedes buscar soluciones específicas en Google o pedir ayuda en foros especializados. Es la diferencia entre buscar "pantalla blanca prestashop" (que te dará miles de resultados genéricos) y buscar "Clase Module no encontrada en Controller.php línea 123" (que te dará soluciones exactas).

Desactivar el modo depuración: tan importante como activarlo

Una vez que hayas solucionado el error, es crítico que desactives el modo depuración. Dejarlo activo en una tienda en producción es un riesgo de seguridad grave. Cualquier visitante podría ver errores internos de tu servidor, rutas de archivos y otros detalles que podrían usar para intentar hackear tu tienda.

Para desactivarlo, repite los pasos anteriores, pero cambia true de vuelta a false en la línea define('_PS_MODE_DEV_', false);. Guarda y sube el archivo. Tu tienda volverá a la normalidad, pero ahora sabes cómo solucionar problemas.

[WARNING]
NUNCA dejes el modo debug activo en una tienda en producción. Es una puerta abierta para los atacantes. Úsalo solo para diagnosticar y soluciona el problema lo antes posible.

Errores comunes al activar el modo depuración

A veces, el propio proceso de activación puede dar problemas. Aquí te dejo las soluciones a los casos más frecuentes:

No encuentro el archivo defines.inc.php

Asegúrate de estar en la carpeta correcta. La estructura típica de PrestaShop es /config/defines.inc.php. Si no lo encuentras, tu instalación podría estar corrupta o el archivo podría tener otro nombre (poco probable). Revisa que estás en la raíz de la instalación, donde están las carpetas classes, controllers, themes, etc.

Después de cambiar el archivo, la tienda sigue en blanco

Esto puede significar que el problema es más profundo, como un fallo en la base de datos. El modo depuración te ayudará a ver el error, pero si no aparece, intenta activar también la visualización de errores de PHP. En el mismo archivo defines.inc.php, busca líneas que empiecen por ini_set o error_reporting. Puedes añadir estas líneas justo debajo de la definición de _PS_MODE_DEV_ para forzar la visualización:

ini_set('display_errors', '1');
error_reporting(E_ALL);

No tengo acceso FTP ni al administrador de archivos

En ese caso, contacta con tu proveedor de hosting. Ellos podrán hacer el cambio por ti. Explícales que necesitas activar el modo depuración PrestaShop en el archivo config/defines.inc.php. Si usas Syspanel, recuerda mencionar que accedes por el puerto 2106 para que te guíen correctamente.

Preguntas frecuentes (FAQ) sobre el modo depuración

¿Es seguro activar el debug en una tienda en desarrollo?

Sí, es totalmente seguro. De hecho, es la práctica recomendada. Mientras estás desarrollando o probando tu tienda, tener el modo debug activo te permite detectar errores al instante.

¿El modo depuración ralentiza mi tienda?

Sí, puede tener un pequeño impacto en el rendimiento, ya que se registran más datos. Por eso es vital desactivarlo en producción.

¿Puedo activar el debug desde el Panel de Administración de PrestaShop?

En versiones modernas de PrestaShop (1.7 y 8.x), no hay una opción directa en el panel para activar el debug. La forma más fiable y universal es editando el archivo config/defines.inc.php como hemos descrito.

¿Qué significa "pantalla blanca PrestaShop"?

Es el error más común. Significa que PHP ha fallado antes de poder generar la página HTML. Las causas más comunes son: falta de memoria, archivos corruptos o incompatibilidades de módulos. El modo debug te mostrará la causa raíz.

Conclusión: Un pequeño cambio, un gran poder

Activar el modo depuración PrestaShop desde el archivo config/defines.inc.php es una de las habilidades más valiosas que puedes aprender como administrador de una tienda. Es un proceso sencillo que te dará información crucial para diagnosticar y solucionar cualquier problema técnico.

Recuerda el flujo: cambia false a true, observa el error, soluciona el problema y vuelve a cambiarlo a false. Con esta guía, ya no temerás a la pantalla blanca PrestaShop; la verás como una oportunidad para entender mejor tu tienda y hacerla más robusta.

¿Tienes más dudas? No dudes en dejar un comentario o contactar con tu soporte técnico. ¡Tu tienda online te lo agradecerá!