¿Cómo activo el modo debug en PrestaShop?

El modo debug de PrestaShop muestra errores PHP y salida detallada de excepciones, lo que es útil para diagnosticar un problema pero inseguro si se deja activado en una tienda en vivo. Puede exponer rutas, detalles de configuración, errores SQL y stack traces visibles para clientes.

Desde el back office, la ruta normal es Advanced Parameters > Performance > Debug mode. En el sistema de archivos, el mismo ajuste se controla con _PS_MODE_DEV_ en config/defines.inc.php:

// config/defines.inc.php
define('_PS_MODE_DEV_', true);

// switch back after debugging
define('_PS_MODE_DEV_', false);

Si tienes que depurar producción brevemente, actívalo durante el menor tiempo posible, reproduce el problema, guarda los detalles del error y desactívalo de nuevo. Un patrón más seguro solo para desarrolladores es poner el modo debug detrás de una condición privada, por ejemplo una comprobación temporal de cookie:

define('_PS_MODE_DEV_', isset($_COOKIE['debug']) && $_COOKIE['debug'] === 'secret');

Después de cambiar el modo debug, limpia la caché de PrestaShop si el comportamiento no cambia de inmediato. Revisa también los logs del servidor, porque los errores fatales pueden registrarse allí aunque el navegador solo muestre una página 500 genérica.

Si usas MPR Performance Revolution, hay un patrón de producción más seguro que editar directamente el define del núcleo: Employee Debug Mode escribe un pequeño archivo bootstrap y define una cookie MPRPSDEV de corta duración para empleados de back office con sesión iniciada, de modo que los visitantes normales permanecen en modo producción. La cookie es HTTP-only, segura cuando se usa HTTPS, same-site Lax, y caduca tras cuatro horas de inactividad. Sigue siendo depuración en una tienda en vivo, así que úsalo de forma estrecha, pero es menos arriesgado que mostrar stack traces a cada visitante.

Nunca dejes _PS_MODE_DEV_ activado después de reproducir el incidente. Captura el mensaje de excepción, stack trace y la URL de la solicitud, luego desactiva el modo debug y trabaja desde logs. Si el error aparece solo durante checkout o callbacks de pago, prefiere logs del servidor y logs del módulo antes que exponer salida debug en URLs públicas de retorno de pago.