Activar modo debug en PrestaShop: Guía para ver errores

¿Qué es el modo debug de PrestaShop y para qué sirve?

Cuando tu tienda online da errores, a veces solo ves una página en blanco o un mensaje genérico como "Error 500". Eso es frustrante, ¿verdad? Pues bien, el modo debug de PrestaShop es una herramienta que te permite ver exactamente qué está fallando en tu tienda. En lugar de pantallas vacías, verás el error concreto, el archivo donde ocurre y la línea exacta del problema.

Piensa en ello como abrir el capó de un coche para ver el motor: no es algo que debas hacer siempre, pero cuando hay un problema, es imprescindible para saber qué pieza está fallando.

En este artículo voy a explicarte paso a paso cómo activar el modo debug de PrestaShop, tanto si tienes acceso al panel de administración como si solo puedes acceder a los archivos por FTP. También veremos cómo interpretar los errores y, lo más importante, cómo desactivarlo cuando hayas terminado.

¿Cuándo necesitas activar el modo debug?

Hay varias situaciones típicas donde activar debug PrestaShop te va a salvar la vida:

La tienda muestra una página en blanco sin ningún mensaje.
Aparece un error 500 o "Internal Server Error".
Algún módulo o plantilla está dando problemas y no sabes cuál es.
Necesitas ver errores PHP que están ocultos.
Quieres comprobar si hay conflictos entre módulos o con el tema.

En todos estos casos, el modo debug te dará información detallada para que puedas comunicársela a tu desarrollador o resolverlo tú mismo.

Método 1: Activar el modo debug desde el archivo config/defines.inc.php

Esta es la forma más común y directa de activar debug PrestaShop. Necesitarás acceder a los archivos de tu tienda mediante FTP, cPanel o el administrador de archivos de tu hosting.

Paso 1: Accede a tus archivos

Entra en tu panel de control de hosting (si usas Syspanel, recuerda que el puerto de acceso es el 2106) y abre el administrador de archivos. Alternativamente, puedes usar un cliente FTP como FileZilla.

Paso 2: Localiza el archivo defines.inc.php

Navega hasta la carpeta config de tu instalación de PrestaShop. La ruta completa suele ser:

public_html/config/defines.inc.php

Paso 3: Edita el archivo

Haz clic derecho sobre el archivo y selecciona "Editar" o "Ver/Editar". Busca esta línea:

define('_PS_MODE_DEV_', false);

Paso 4: Cambia el valor

Cambia false por true:

define('_PS_MODE_DEV_', true);

Guarda los cambios y sube el archivo si lo estás editando localmente.

Paso 5: Comprueba los errores

Ahora recarga la página que te daba problemas. Deberías ver detalles del error en pantalla, incluyendo el archivo y la línea exacta.

[WARNING] Si no encuentras la línea exacta, busca _PS_MODE_DEV_ con la función de búsqueda de tu editor. En versiones antiguas de PrestaShop, el nombre puede variar ligeramente.

Método 2: Activar el modo debug desde el panel de administración

PrestaShop 1.7 y versiones posteriores ofrecen una forma más sencilla de hacer esto, sin tocar archivos.

Paso 1: Entra al panel de administración

Accede a tu back-office de PrestaShop con tus credenciales de administrador.

Paso 2: Ve a Configuración avanzada

En el menú lateral, busca la sección Configuración avanzada y haz clic en Rendimiento.

Paso 3: Busca la opción de depuración

Dentro de la página de Rendimiento, localiza la sección Depuración (Debug). Verás una opción que dice "Modo de depuración".

Paso 4: Activa el modo debug

Selecciona Sí en "Activar el modo de depuración" y guarda los cambios con el botón de la parte superior.

Paso 5: Nivel de detalle

También puedes elegir el nivel de detalle de los errores:

Nivel 1: Muestra errores básicos.
Nivel 2: Muestra errores más detallados, incluyendo avisos.

[TIP] Empieza con el nivel 1. Si no encuentras el problema, sube al nivel 2 para obtener más información.

Método 3: Activar el modo debug mediante el archivo .htaccess

Este método es útil si no puedes editar el archivo defines.inc.php o prefieres una solución temporal.

Paso 1: Localiza el archivo .htaccess

Está en la raíz de tu instalación de PrestaShop, normalmente en public_html/.htaccess.

Paso 2: Añade las líneas necesarias

Al final del archivo, añade estas líneas:

php_flag display_errors on
php_value error_reporting E_ALL

Paso 3: Guarda y comprueba

Guarda los cambios y recarga la página con el error. Esto mostrará todos los errores PHP directamente en pantalla.

[WARNING] Este método es más agresivo y puede mostrar avisos de PHP que no son críticos. Úsalo con cuidado y elimina las líneas cuando termines.

¿Cómo interpretar los errores de PrestaShop?

Una vez que has conseguido ver errores PrestaShop debug, es importante saber leerlos. Los mensajes suelen tener este formato:

[Error] Undefined index: id_product
[Archivo] /home/usuario/public_html/modules/mimodulo/mimodulo.php
[Línea] 45

Partes clave de un error

Tipo de error: Puede ser "Notice", "Warning", "Fatal Error", etc. Los más graves son los "Fatal Error".
Mensaje: Te dice qué está fallando exactamente.
Archivo: Dónde está el problema.
Línea: La línea concreta del archivo.

Errores comunes

Tipo	Significado
Undefined index	Estás intentando acceder a una variable que no existe
Fatal error	Algo crítico impide que la página funcione
Parse error	Hay un error de sintaxis en el código PHP
Warning	Algo funciona pero podría dar problemas

[INFO] No te asustes con los "Notices" o "Warnings". Muchas veces son inofensivos, pero es buena idea corregirlos para un rendimiento óptimo.

Desactivar el modo debug cuando termines

Esto es CRÍTICO. Dejar el modo debug activo en una tienda en producción es un riesgo de seguridad y puede ralentizar tu web.

Para desactivarlo por archivo

Vuelve a config/defines.inc.php y cambia:

define('_PS_MODE_DEV_', true);

De vuelta a:

define('_PS_MODE_DEV_', false);

Para desactivarlo desde el panel

Ve a Configuración avanzada > Rendimiento y selecciona No en "Activar el modo de depuración".

Para desactivarlo por .htaccess

Elimina las líneas que añadiste al archivo .htaccess.

[WARNING] No olvides desactivar el modo debug antes de que tus clientes accedan a la tienda. Los errores detallados pueden revelar información sensible sobre tu servidor.

Consejos extra para solucionar errores en PrestaShop

Más allá de activar debug PrestaShop, aquí tienes algunos consejos que te ayudarán:

1. Limpia la caché

Muchas veces los errores persisten por caché. Ve a Parámetros avanzados > Rendimiento y limpia la caché.

2. Revisa los logs

PrestaShop guarda registros de errores en Parámetros avanzados > Registros. Ahí encontrarás historial de errores anteriores.

3. Comprueba los permisos de archivos

Los archivos deben tener permisos 644 y las carpetas 755. Puedes cambiarlos desde tu panel de control.

4. Desactiva módulos uno a uno

Si el error viene de un módulo, ve a Módulos > Gestor de módulos y desactívalos uno a uno para encontrar al culpable.

5. Revisa los requisitos de versión

Asegúrate de que tu versión de PHP es compatible con tu versión de PrestaShop.

Preguntas frecuentes sobre el modo debug

¿Es seguro activar el modo debug?

Es seguro temporalmente mientras solucionas un problema. No lo dejes activo en producción porque muestra información técnica que podría ser explotada.

¿Por qué no veo errores después de activar el modo debug?

Puede que el problema esté en el servidor, no en PrestaShop. Revisa los logs del servidor en tu panel de hosting.

¿Qué hago si el error dice "Fatal error: Out of memory"?

Aumenta el límite de memoria de PHP. Puedes añadir al archivo .htaccess:

php_value memory_limit 256M

¿Puedo activar el modo debug sin acceso FTP?

Sí, si tienes acceso al panel de administración puedes usar el método 2 descrito anteriormente.

¿El modo debug afecta al rendimiento?

Sí, especialmente si hay muchos errores. Por eso es importante desactivarlo cuando termines.

Resumen final

Activar el modo debug PrestaShop es una habilidad esencial para cualquier administrador de tienda online. Te permite:

Identificar errores rápidamente.
Comunicar problemas con precisión a desarrolladores.
Solucionar problemas tú mismo cuando son sencillos.
Evitar frustraciones con páginas en blanco.

Recuerda los tres métodos principales:

Editar config/defines.inc.php y cambiar _PS_MODE_DEV_ a true.
Desde el panel de administración en Configuración avanzada > Rendimiento.
Mediante el archivo .htaccess añadiendo las líneas de PHP.

Y lo más importante: desactiva el modo debug cuando hayas terminado de solucionar el problema.

Si después de todo esto sigues sin poder ver los errores, contacta con tu proveedor de hosting (como Syspanel, accesible en el puerto 2106) para que te ayuden a revisar los logs del servidor. A veces el problema está fuera de PrestaShop y necesitarás acceso a información más técnica.

Espero que esta guía te haya sido útil. Ahora ya sabes cómo activar el modo debug de PrestaShop y, más importante aún, cómo interpretar los errores que aparecen. Con esta herramienta, podrás diagnosticar y solucionar problemas en tu tienda online mucho más rápido.