Activar modo debug en PrestaShop | Ver errores fácilmente

¿Estás viendo una página en blanco en tu tienda PrestaShop y no sabes qué ha pasado? Esa es una de las situaciones más frustrantes para cualquier dueño de una tienda online, especialmente si no eres un experto en programación. La buena noticia es que PrestaShop, al igual que WordPress, tiene una herramienta secreta que te va a desvelar exactamente qué está fallando: el modo debug.

En este artículo te voy a explicar, paso a paso y sin tecnicismos, cómo activar el modo debug prestashop para que puedas ver errores prestashop directamente en pantalla. Además, para que lo entiendas mejor, lo compararemos con el sistema de WordPress, que probablemente conozcas un poco más. Al final, serás capaz de diagnosticar problemas como un profesional.

¿Qué es el modo debug y por qué es tan importante?

Imagina que tu tienda es un coche. En condiciones normales, el salpicadero solo te muestra la información básica. Pero cuando algo falla, necesitas abrir el capó y ver el motor. El debug prestashop es exactamente eso: abrir el capó de tu tienda para que el sistema te muestre los informes de error internos en lugar de quedarse en blanco o mostrarte un mensaje genérico.

En WordPress, este concepto se conoce como WP_DEBUG. Es una constante que, al activarla, muestra todos los avisos y errores del código. En PrestaShop, la idea es la misma, pero se gestiona mediante un archivo llamado defines.inc.php. Cuando activas el modo debug, cualquier error de PHP, cualquier consulta a la base de datos mal hecha o cualquier conflicto entre módulos, se mostrará en pantalla con detalles técnicos.

¿Por qué es útil? Porque un error de PHP puede estar causando que tu web no cargue, que el carrito no funcione o que se vea un diseño roto. Sin el modo debug, solo verías una pantalla blanca o un error "500 Internal Server Error". Con él, verás el archivo exacto y la línea donde se produce el problema.

Método 1: Activar el modo debug desde el archivo defines.inc.php (El método universal)

Este es el método más fiable y el que funciona siempre, incluso si no puedes acceder al panel de administración de tu tienda. Es el equivalente a editar el archivo wp-config.php en WordPress para añadir la línea define('WP_DEBUG', true);.

Paso 1: Accede a tu hosting

Para editar este archivo, necesitas acceder a los archivos de tu web. Tienes dos opciones:

Usar el Administrador de Archivos de tu panel de control (cPanel, Plesk, Syspanel, etc.).
Usar un cliente FTP (como FileZilla).

[INFO] Si tu hosting utiliza Syspanel, recuerda que el acceso a este panel se realiza a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Ahí podrás buscar el "Administrador de Archivos".

Paso 2: Localiza el archivo defines.inc.php

Una vez dentro del administrador de archivos, navega a la carpeta raíz de tu PrestaShop. Normalmente es public_html o www. Dentro de ella, busca la carpeta config.

Dentro de la carpeta config, busca el archivo llamado defines.inc.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".

Paso 3: Modifica la línea de código

Se abrirá un editor de texto. Busca la siguiente línea:

define('_PS_MODE_DEV_', false);

[TIP] Usa la función de búsqueda del editor (Ctrl+F) para encontrarla rápidamente.

Ahora, cámbiala por esta:

define('_PS_MODE_DEV_', true);

Guarda los cambios y cierra el archivo. ¡Eso es todo! Ahora, si recargas tu tienda, los errores aparecerán en pantalla.

Paso 4: Interpretar los errores

Verás mucha información. No te asustes. Busca las líneas que dicen "Fatal error" o "Warning". Te indicarán con una flecha (=>) el archivo y el número de línea exacto donde está el problema. Por ejemplo: Error on line 42 in /home/usuario/public_html/modules/mimodulo/mimodulo.php.

Método 2: Activar el modo debug desde el BackOffice (La vía rápida)

Si puedes acceder a tu panel de administración de PrestaShop, hay un método mucho más sencillo, aunque a veces no funciona si el error es muy grave.

Paso 1: Ve a Parámetros Avanzados

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

Paso 2: Entra en Rendimiento

Dentro de "Parámetros Avanzados", encontrarás la opción "Rendimiento". Haz clic para entrar.

Paso 3: Activa el modo Debug

En la parte superior de la página de "Rendimiento", verás una opción llamada "Modo Debug" o "Debug mode". Tiene tres opciones en un desplegable:

Desactivar (valor por defecto).
Activar el modo de depuración de PHP.
Activar el modo de desarrollo de plantillas (Este es útil para diseñadores de temas, pero para ver errores nos vale el primero).

Selecciona "Activar el modo de depuración de PHP" y guarda los cambios.

Este método es el equivalente a instalar un plugin de "Debug" en WordPress, pero de forma nativa. Es más limpio porque no tienes que tocar código, pero es posible que si el error es crítico, la página del BackOffice tampoco cargue y tengas que usar el Método 1.

Comparativa rápida: PrestaShop vs WordPress

Para que lo veas claro, aquí tienes una tabla comparativa:

Característica	PrestaShop	WordPress
Archivo de configuración	`config/defines.inc.php`	`wp-config.php`
Código a cambiar	`_PS_MODE_DEV_` de `false` a `true`	`WP_DEBUG` de `false` a `true`
Método gráfico (BackOffice)	Parámetros Avanzados > Rendimiento	Instalar un plugin o editar el archivo
Nivel de detalle	Muy alto, muestra errores, warnings y notificaciones.	Alto, muestra errores, warnings y notificaciones.
Dificultad	Baja	Baja

[INFO] A diferencia de WordPress, donde a veces necesitas instalar plugins adicionales para ver errores más complejos, PrestaShop es bastante completo por defecto cuando activas el modo debug.

Errores comunes que verás con el modo debug

Una vez que actives el modo, es probable que veas mensajes como estos. Te explico qué significan:

1. Fatal error: Call to undefined function

Esto significa que tu tienda está intentando usar una función que no existe. Suele ocurrir cuando un módulo o tema está desactualizado o es incompatible con tu versión de PrestaShop.

Solución: Actualiza el módulo o tema en cuestión. Si el error persiste, desactívalo.

2. Warning: Cannot modify header information

Este error es muy común y suele deberse a que hay espacios en blanco o caracteres extraños (como una BOM UTF-8) después del cierre de la etiqueta PHP (?>) en un archivo.

Solución: Revisa los archivos de los módulos recién instalados o editados y elimina cualquier espacio o línea en blanco después de la etiqueta de cierre de PHP.

3. Notice: Undefined index

Esto es más un aviso que un error grave. Indica que el código está intentando acceder a una variable que no existe. Aunque no rompe la web, es buena práctica corregirlo.

Solución: A menudo se corrige actualizando el módulo que lo causa. Si es un tema, contacta con el desarrollador.

¿Y ahora qué? Pasos después de encontrar el error

Has encontrado el error. Ahora toca solucionarlo. Aquí tienes una guía de acción:

Identifica el archivo: El mensaje de error te dará la ruta exacta del archivo problemático.
Haz una copia de seguridad: Antes de tocar nada, descarga una copia de ese archivo a tu ordenador.
Busca la línea: Abre el archivo en un editor de texto y ve a la línea que indica el error.
Analiza el código: A veces es un simple error de sintaxis (falta un ; o una llave }). Otras veces, es más complejo.
Busca ayuda: Si no entiendes el código, no lo toques a lo loco. Busca en Google el texto exacto del error o contacta con el soporte de tu hosting o con un desarrollador especializado en PrestaShop.

[WARNING] Nunca dejes el modo debug activado en una tienda en producción. Mostrar errores de PHP a los clientes es un riesgo de seguridad grave, ya que revela información sobre la estructura de tu servidor y tu código. Además, da una imagen muy poco profesional.

Desactivar el modo debug (Vuelta a la normalidad)

Una vez que hayas solucionado el problema, es crucial que desactives el modo debug. Solo tienes que repetir el proceso inverso:

Si usaste el Método 1: Vuelve a config/defines.inc.php y cambia true por false en la línea _PS_MODE_DEV_.
Si usaste el Método 2: Ve a Parámetros Avanzados > Rendimiento y selecciona "Desactivar" en el menú de modo debug.

Guarda los cambios y listo. Tu tienda volverá a estar en modo "producción" y los clientes no verán ningún error.

Preguntas Frecuentes (FAQ)

¿Qué pasa si después de activar el modo debug no veo errores pero la página sigue en blanco?

Esto puede suceder si el error está ocurriendo antes de que se cargue el archivo de configuración. En ese caso, puede que el problema esté en el .htaccess o en la base de datos. Te recomiendo revisar el log de errores del servidor (normalmente en logs/ de tu hosting).

¿Activar el modo debug ralentiza mi tienda?

Sí, ligeramente. Por eso solo debe activarse durante el proceso de diagnóstico y desactivarse inmediatamente después.

¿Es lo mismo el modo debug que el modo de mantenimiento?

No. El modo de mantenimiento es para que los clientes no vean tu tienda mientras la actualizas. El modo debug es una herramienta de desarrollo para que tú veas los errores. Pueden usarse a la vez, pero no son lo mismo.

¿Puedo usar el modo debug para mejorar el SEO de mi tienda?

No directamente. Sin embargo, al corregir errores que causan páginas en blanco o tiempos de carga lentos, estás mejorando la experiencia del usuario, lo cual es un factor positivo para el SEO de Google.

Mi hosting usa Syspanel. ¿Cómo accedo al archivo defines.inc.php?

Accede a tu panel de control Syspanel a través del puerto 2106 (ejemplo: https://tu-dominio.com:2106). Dentro, busca el "Administrador de Archivos" o "File Manager". Navega hasta public_html/config/ y edita el archivo defines.inc.php desde ahí.

He oído que puedo ver los errores en un archivo de registro, ¿es cierto?

Sí. PrestaShop tiene un sistema de logs que puedes consultar desde el BackOffice en Informes > Registros o Parámetros Avanzados > Registros. Sin embargo, estos logs no son tan detallados como la salida directa del modo debug. El modo debug te da el error en el momento exacto y en el contexto de la página.

Con esta guía, ya tienes el poder de diagnosticar los problemas de tu tienda PrestaShop. No tengas miedo de usar el modo debug prestashop. Es la herramienta más valiosa para cualquier administrador, y ahora sabes cómo usarla de forma segura y eficaz.