Laravel: Como visualizar a SQL com os valores preenchidos para facilitar o debug
Paulo Bolsanello·08 Jul 2025·3 min de leitura
No dia a dia do desenvolvimento com Laravel, é comum precisarmos inspecionar uma query SQL gerada dinamicamente. A primeira ferramenta que muitos desenvolvedores usam é:
$query->toSql();
Porém, esse método não exibe os valores reais que serão enviados ao banco de dados. Em vez disso, mostra apenas a SQL com placeholders ?, o que pode dificultar o debug, principalmente em queries complexas.
Neste artigo, vou te mostrar como criar um helper simples para resolver isso, exibindo a SQL com os valores reais preenchidos, de forma segura e prática para uso em desenvolvimento.
$query = DB::table('users')
->where('email', 'like', '%@example.com')
->where('status', 'active');
debug_sql($query); // Mostra a SQL com os valores reais
A saída será:
select * from users where email like '%@example.com' and status = 'active'
Você também pode obter a SQL como string, útil para logs ou testes:
Não use esse helper em produção, pois ele apenas simula a substituição dos parâmetros e não oferece proteção contra SQL Injection. É uma ferramenta de desenvolvimento.
Esse método não executa a query, apenas exibe como ela seria enviada ao banco.
Não serve para queries com binding nomeado (:param), apenas as do tipo ?.
Ferramentas simples como essa podem economizar muito tempo de debug, principalmente quando estamos lidando com queries complexas, filtros dinâmicos e comportamento inesperado no banco de dados.
Se você trabalha com Laravel no dia a dia, recomendo adicionar esse helper no seu kit de ferramentas. E se quiser ir além, pode criar até um middleware para logar queries lentas com os valores já aplicados.
O Docker é uma ferramenta poderosa para gerenciar contêineres, e sua integração com o WSL2 no Windows oferece um ambiente de desenvolvimento robusto e flexível. No entanto, ao configurar o Docker no WSL2, é comum…
Ao trabalhar com imagens base64 no front-end, é comum precisar redimensioná-las para melhorar o desempenho da aplicação, especialmente ao enviá-las para servidores ou APIs. Neste artigo, vamos explorar como…