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.
Na segunda parte, divido o texto do edital por página, gero os embeddings com o Laravel AI SDK e guardo tudo no pgvector. A primeira busca semântica funciona e mostra um limite importante: o trecho mais parecido com a pergunta nem sempre traz a resposta.
Ao desenvolver aplicações modernas com PHP, uma das tarefas mais comuns é manipular arrays — filtrando, transformando ou agrupando dados. Embora o PHP nativamente ofereça funções poderosas para isso, como array_map,…