Depuração com o PhpStorm

Extraia o máximo da depuração de código em PHP com o PhpStorm e o Xdebug.

Crie e gerencie pontos de interrupção

A interface gráfica de depuração do PhpStorm oferece ferramentas versáteis para pontos de interrupção. Use pontos de interrupção condicionais para delimitar condições de acionamento, tais como itens específicos dentro do loop. Você precisa detectar uma exceção quando ela ocorrer? Use pontos de interrupção de exceções, que podem ser aplicados em toda a base de código do projeto.

Pontos de interrupção e suas configurações não afetam o seu código-fonte, mas podem ser salvos juntamente com o seu projeto do PhpStorm e reutilizados em várias sessões de depuração.

Percorra o seu código linha a linha

Se você quiser depurar o fluxo de controle e examinar as estruturas de dados a cada linha do código executado, não precisa colocar pontos de interrupção por toda parte. Em vez disso, você pode percorrer o seu código passo a passo e inspecionar a pilha da frame e as variáveis momentâneas em cada etapa na janela de ferramentas Debug.

Você pode até entrar em uma função específica para ter uma depuração mais granular, linha a linha.

Teste suposições e saiba o que o seu código está fazendo

Janela interativa de depuração

A janela de ferramentas interativa Debug do PhpStorm permite que você faça experimentos com o estado atual do programa, alterando variáveis, chamando ou definindo funções em PHP ou avaliando expressões arbitrárias, sem fazer nenhuma alteração no seu código-fonte.

Depurador embutido

Quando um programa for suspenso, você poderá ver os valores das variáveis e adicionar inspeções não só na janela de ferramentas Debug, mas também no texto do editor de código. Os valores alterados serão realçados, tornando fácil visualizar o que foi alterado desde a última vez em que aquele ponto de interrupção foi atingido.

Previsões de fluxo de dados

A partir dos dados que recebe do depurador de PHP nos pontos de interrupção, o PhpStorm mostra dicas dentro do editor, informando o que acontecerá na execução daquele trecho de código. Os blocos de código no caminho que se prevê que sejam inatingíveis são mostrados em cinza.

Depure em qualquer lugar

Depuração local e remota

Você obtém dados de depuração em tempo real para cada linha executada no código, mesmo se ele estiver sendo executado em um servidor remoto de Web — dentro de um container do Docker, de uma máquina virtual ou em um host remoto através de SSH. Mapeie os arquivos do servidor para suas respectivas cópias no seu projeto do PhpStorm, configure o Xdebug e ative a escuta das conexões de entrada de depuração no PhpStorm.

Depuração de JavaScript

O PhpStorm vem com o depurador completo de JavaScript do WebStorm, com suporte tanto a JavaScript dentro do navegador quanto ao Node.js, e você pode até iniciar os depuradores do Xdebug e do JavaScript ao mesmo tempo.

Depure dentro de modelos do Blade e Twig

Crie pontos de interrupção dentro de modelos do Blade e do Twig e depure-os passo a passo, tal como você faria com arquivos de PHP. Não há nenhuma referência ao código do modelo no arquivo compilado? O PhpStorm avisará você que o ponto de interrupção que você criou não será capturado.

Depure chamadas de HTTP a partir da API

Você pode depurar solicitações de HTTP a servidores de PHP diretamente a partir do cliente de HTTP dentro do editor do PhpStorm. O IDE adicionará o cookie do Xdebug automaticamente à solicitação, a executará e interromperá a execução no ponto de interrupção especificado no arquivo correspondente de PHP.

Visualize e analise dados de profiling

Além de depurar, o PhpStorm cria relatórios visuais dos dados de profiling gerados pelo Xdebug. Você pode selecionar vários instantâneos de uma vez e obter os dados agregados do profiling. Em um relatório agregado, você pode pular das estatísticas de execução diretamente para as funções correspondentes no seu código em PHP.

Deixe o seu IDE fazer o trabalho de configuração

Verificação da configuração do Xdebug

O PhpStorm obtém dados da instalação do Xdebug no servidor de Web local ou remoto para proporcionar uma experiência de depuração flexível e poderosa dentro do IDE. Para uma configuração sem complicações, o IDE valida a configuração do depurador no ambiente apropriado e propõe correções para os problemas detectados.

Depuração sem configuração

Com a depuração sem configuração, tudo que você precisa fazer é abrir no navegador a página inicial do seu aplicativo de PHP e ativar o mecanismo de depuração a partir dela. O PhpStorm ficará na escuta das conexões de entrada do depurador e lhe apresentará os dados visuais da depuração.