Activar modo debug en PrestaShop: guía para mostrar errores

¿Tu tienda PrestaShop muestra una pantalla en blanco, un error 500 o algún comportamiento extraño que no sabes interpretar? No te preocupes, es mucho más común de lo que parece. La mayoría de las veces, la solución pasa por activar el modo debug de PrestaShop (también conocido como modo depuración). Este modo es la linterna que necesitas para iluminar el código y ver exactamente qué está fallando.

En esta guía completa y paso a paso, voy a explicarte cómo activar el modo debug en PrestaShop de varias formas distintas, para que elijas la que mejor se adapte a tu nivel de confianza técnica. Al final, también te enseñaré a desactivarlo para que tu tienda quede protegida.

¿Qué es el Modo Debug de PrestaShop?

El modo debug (o depuración) es una funcionalidad interna de PrestaShop que, cuando se activa, muestra en pantalla los errores PHP que están ocurriendo en tu tienda. En lugar de ver una página en blanco o un error genérico, verás un mensaje detallado con la ruta del archivo, la línea exacta del problema y la descripción del fallo.

Piénsalo como el "interruptor de mantenimiento" para desarrolladores. Es la herramienta número uno para mostrar errores en PrestaShop y diagnosticar problemas de forma rápida. Existen tres niveles de depuración:

Nivel 0 (Desactivado): No se muestran errores. Es el estado normal de una tienda en producción.
Nivel 1 (Debug): Muestra los errores PHP en pantalla, pero no los errores de SQL (base de datos).
Nivel 2 (Debug + SQL): Muestra tanto errores PHP como consultas SQL fallidas. Es el modo más exhaustivo y el que debes usar para problemas complejos de base de datos.

Antes de Empezar: Haz una Copia de Seguridad

[WARNING] Este paso es CRÍTICO. Antes de tocar cualquier archivo de configuración, haz una copia de seguridad completa de tu tienda, tanto de los archivos como de la base de datos. Si algo sale mal, podrás restaurar tu tienda sin perder ventas ni datos. La mayoría de los paneles de control de hosting (como Syspanel, que puedes acceder a través del puerto 2106) ofrecen herramientas de copia de seguridad automática.

Método 1: Activar Debug desde el Panel de Administración (La Forma Fácil)

Esta es la forma más recomendada y segura, ya que no requiere acceso a archivos del servidor. Es perfecta si tienes acceso al back-office de tu PrestaShop.

Paso 1: Accede a tu Panel de Administración

Inicia sesión en la URL de tu administrador (normalmente www.tutienda.com/admin1234).

Paso 2: Ve a Parámetros Avanzados

En el menú lateral izquierdo, busca la sección "Parámetros Avanzados" y haz clic en ella.

Paso 3: Entra en "Rendimiento"

Dentro de "Parámetros Avanzados", verás una opción llamada "Rendimiento". Haz clic en ella.

Paso 4: Configura el Nivel de Depuración

En la parte superior de la página de "Rendimiento", busca el bloque llamado "Depuración" o "Debug mode". Verás un selector con las siguientes opciones:

Nunca (Nivel 0): Es la opción por defecto.
Sí (Nivel 1): Para mostrar solo errores PHP.
Sí, con el rendimiento de SQL (Nivel 2): Para mostrar errores PHP y de SQL.

Selecciona el nivel que necesites. Para la mayoría de los casos, el Nivel 1 es suficiente. Si el error está relacionado con la base de datos, elige el Nivel 2.

Paso 5: Guarda los Cambios

Haz clic en el botón "Guardar" en la parte inferior de la página. PrestaShop se recargará y, si hay errores, ahora deberías verlos claramente en pantalla.

Método 2: Activar Debug Editando el Archivo `config/defines.inc.php` (La Forma Manual)

Este método es útil cuando no puedes acceder al panel de administración (por ejemplo, porque te da un error 500 o una pantalla blanca). Necesitarás un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting.

Paso 1: Conéctate a tu Servidor

Conéctate a tu cuenta de hosting mediante FTP o a través del administrador de archivos de tu panel de control (recuerda que Syspanel es tu aliado, y su puerto de acceso es el 2106).

Paso 2: Navega hasta la Carpeta `config`

Localiza la carpeta raíz de tu PrestaShop (donde están las carpetas admin, themes, modules, etc.). Dentro de ella, entra en la carpeta llamada config.

Paso 3: Edita el Archivo `defines.inc.php`

Busca el archivo defines.inc.php y ábrelo con un editor de texto plano (como el Bloc de Notas o Notepad++). Nunca uses Word o programas de procesamiento de texto.

Paso 4: Busca la Línea de Depuración

Dentro del archivo, busca una línea que contenga el siguiente texto:

define('_PS_MODE_DEV_', false);

Paso 5: Cambia el Valor a `true`

Para activar el modo debug, cambia false a true. La línea debería quedar así:

define('_PS_MODE_DEV_', true);

Paso 6: Guarda y Sube el Archivo

Guarda el archivo con los cambios y súbelo al servidor, sobrescribiendo el original (si lo estás editando localmente). Si lo estás editando directamente en el servidor, asegúrate de guardar los cambios.

[INFO] Si necesitas ver también los errores de SQL, busca la línea define('_PS_DISPLAY_COMPATIBILITY_WARNING_', false); y cámbiala a true. Sin embargo, esto no es obligatorio para la mayoría de los casos.

Método 3: Activar Debug desde el Archivo `.htaccess` (Para Errores Críticos)

Si los métodos anteriores no funcionan, o si el problema es tan grave que ni siquiera puedes cargar la tienda, este es el último recurso. Este método fuerza a PHP a mostrar los errores directamente.

Paso 1: Localiza el Archivo `.htaccess`

En la raíz de tu instalación de PrestaShop, busca el archivo llamado .htaccess. Ten en cuenta que es un archivo oculto, así que en tu cliente FTP deberás activar la opción "Mostrar archivos ocultos".

Paso 2: Añade las Líneas de Configuración PHP

Abre el archivo .htaccess con un editor de texto. Al principio del archivo, añade las siguientes líneas:

php_flag display_errors on
php_value error_reporting E_ALL

Paso 3: Guarda y Sube el Archivo

Guarda los cambios y sube el archivo al servidor si es necesario. Esto forzará a PHP a mostrar todos los errores, incluso si PrestaShop está intentando ocultarlos.

¿Qué Hago Ahora que Veo los Errores?

Una vez que has activado el modo debug, verás en pantalla información técnica. Esta información es oro puro para un desarrollador, pero para ti puede ser abrumadora. Anota el mensaje de error y la ruta del archivo que aparece. Ese es el punto exacto donde debes empezar a investigar.

[TIP] No intentes arreglar el código tú mismo si no sabes programar. Copia el mensaje de error y búscalo en Google o en foros de PrestaShop. Es muy probable que otra persona ya haya tenido el mismo problema y encuentres la solución.

Cómo Desactivar el Modo Debug (¡Importante!)

Una vez que hayas solucionado el error, es obligatorio desactivar el modo debug. Dejarlo activado en una tienda en producción es un riesgo de seguridad grave, ya que expone información sensible de tu servidor y de tu código a cualquier visitante.

Para desactivarlo desde el Panel de Administración:

Simplemente vuelve a "Parámetros Avanzados" > "Rendimiento" y selecciona "Nunca" en el selector de depuración. Guarda los cambios.

Para desactivarlo desde el archivo `defines.inc.php`:

Vuelve a cambiar la línea que modificaste:

define('_PS_MODE_DEV_', false);

Y si añadiste líneas al .htaccess, elimínalas.

[WARNING] Nunca dejes el modo debug activado en tu tienda en producción. Es una puerta abierta para que los atacantes obtengan información valiosa sobre tu sistema. Actívalo solo para diagnosticar problemas específicos y desactívalo inmediatamente después.

Preguntas Frecuentes (FAQ) sobre el Modo Debug en PrestaShop

¿Activar el modo debug afecta el rendimiento de mi tienda?

Sí, ligeramente. El modo debug consume más recursos del servidor, ya que PHP tiene que generar y mostrar información adicional. Por eso es fundamental desactivarlo cuando no lo necesites.

¿Por qué veo una pantalla en blanco después de activar el modo debug?

Esto suele ocurrir si el error es tan grave que impide que PHP se ejecute correctamente. En ese caso, activa el modo debug a través del archivo .htaccess (Método 3) para forzar la visualización de errores.

¿El modo debug muestra errores de mi tema o de mis módulos?

Sí, el modo debug muestra cualquier error PHP que ocurra en tu tienda, ya sea del núcleo, del tema o de cualquier módulo. Es la mejor herramienta para identificar qué componente está causando el problema.

¿Puedo activar el modo debug de forma temporal?

Sí, es la práctica recomendada. Actívalo, diagnostica el problema, arréglalo y desactívalo de inmediato. No hay una función de "temporizador" nativa, así que tendrás que hacerlo manualmente.

¿Qué significa el error "Fatal error: Uncaught Error..."?

Este es un error típico de PHP que significa que el código encontró un problema grave y no pudo continuar. La descripción del error te dirá exactamente qué archivo y línea están causando el problema. Es un punto de partida perfecto para buscar una solución.

Conclusión

Activar el modo debug en PrestaShop es una habilidad esencial para cualquier propietario de una tienda online. No solo te permite mostrar errores de PrestaShop y diagnosticar problemas, sino que te da la confianza para solucionar incidencias por ti mismo, sin depender de un desarrollador para cada pequeño fallo.

Recuerda los tres métodos: el más fácil desde el panel de administración, el manual editando el archivo defines.inc.php, y el de emergencia a través del .htaccess. Y, sobre todo, nunca olvides desactivarlo cuando hayas terminado.

Con esta guía, ya tienes las herramientas para encender la luz en la oscuridad de los errores de tu tienda. ¡Buena suerte con tus diagnósticos!