Ativar temporariamente o modo de depuração do PrestaShop

O modo de depuração ajuda a obter a exceção exata quando o PrestaShop esconde a falha. Pode mostrar caminhos, consultas e dados internos a qualquer visitante, além de reduzir o desempenho, pelo que deve utilizá-lo de preferência num clone ou restringir temporariamente o acesso.

Nas versões atuais, ative-o em Parâmetros avançados > Desempenho > Modo de depuração. Reproduza apenas a ação que falha, guarde o rastreio e desative-o imediatamente.

Se não conseguir aceder ao administrador, faça uma cópia de config/defines.inc.php e altere:

define('_PS_MODE_DEV_', false);	

Para:

define('_PS_MODE_DEV_', true);	

Não edite outros valores nem deixe o modo ativo enquanto investiga. O rastreio mostra o ponto onde ocorreu a falha, mas não demonstra por si só que atualização, módulo ou alteração a originou. Compare a hora com os registos do PrestaShop e do PHP.

No fim, reponha _PS_MODE_DEV_ a false, limpe a cache se for o caso e confirme a partir de outra sessão que o erro já não é mostrado publicamente. O PrestaShop 9 também permite gerir este estado com o comando oficial prestashop:debug.

Não confundir debug e profiler

_PS_MODE_DEV_ controla o modo de depuração; _PS_DEBUG_PROFILING_ é uma opção diferente de análise de desempenho. Não ative o profiler para obter um erro qualquer nem deixe dados de consultas visíveis ao público.

A mudança de ambiente pode regenerar caches e alterar os tempos de resposta. Se um problema desaparecer apenas em modo debug, verifique também a cache e a configuração do ambiente de produção antes de o dar por resolvido. Guarde o rastreio de forma privada e não partilhe capturas com tokens, dados de clientes ou consultas completas.