Configurar um ambiente de desenvolvimento eficiente para PHP no Windows exige a integração correta entre o interpretador, a extensão de depuração (Xdebug) e o editor de código. Este guia detalha o processo de instalação e configuração do Visual Studio Code para depurar scripts PHP localmente.

Requisitos de Software

• Visual Studio Code: Editor de código-fonte.
• PHP para Windows: Versão thread-safe (ex: 7.x ou superior).
• Xdebug: DLL correspondente à versão e arquitetura do PHP instalado.
• Extensão PHP Debug: Instalada diretamente via marketplace do VSCode (desenvolvida por Felix Becker).

1. Preparação do Ambiente PHP

Após baixar o pacote binário do PHP, extraia o conteúdo para um diretório na raiz do sistema, como C:\php. Em seguida, localize o arquivo de configuração:

1. Na pasta C:\php, duplique o arquivo php.ini-development.

2. Renomeie a cópia para php.ini.

3. Mova o arquivo da extensão Xdebug (ex: php_xdebug.dll) para a pasta C:\php\ext.

4. Configuração do arquivo php.ini

Abra o arquivo php.ini em um editor de texto e adicione as seguintes diretivas ao final do documento para habilitar o Xdebug 2.x:

zend_extension = "C:\php\ext\php_xdebug.dll"
xdebug.remote_enable = 1
xdebug.remote_autostart = 1
xdebug.remote_port = 9000

Certifique-se de que o caminho em zend_extension aponta exatamente para o local onde a DLL foi salva.

3. Ajuste das Variáveis de Ambiente

Para que o PHP seja reconhecido globalmente no terminal, adicione o caminho C:\php à variável de sistema Path:

1. Pesquise por "Editar as variáveis de ambiente do sistema".

2. Em "Variáveis de Ambiente", localzie a variável Path em "Variáveis do Sistema".

3. Clique em "Novo" e insira o caminho C:\php.

4. Integração com o Visual Studio Code

Abra as configurações do VSCode (settings.json) e defina o caminho do executável do PHP para validação de sintaxe:

{
   "php.validate.enable": true,
   "php.validate.executablePath": "C:\\php\\php.exe",
   "php.validate.run": "onType"
}

5. Configuração do Depurador (launch.json)

No VSCode, acesse a aba de "Run and Debug" e crie um arquivo launch.json. Configure-o para escutar as requisições do Xdebug:

{
   "version": "0.2.0",
   "configurations": [
       {
           "name": "Escutar XDebug",
           "type": "php",
           "request": "launch",
           "port": 9000
       },
       {
           "name": "Executar script atual",
           "type": "php",
           "request": "launch",
           "program": "${file}",
           "cwd": "${fileDirname}",
           "port": 9000
       }
   ]
}

6. Teste de Depuração

Crie um arquivo chamado debug_test.php com o seguinte conteúdo para validar o funcionamento:

<?php
$mensagem = "Iniciando Depuração";
$contador = 10;

$resultado = $contador * 2;

echo $mensagem . " - Resultado: " . $resultado;
?>

Para testar:

1. Insira um breakpoint (clique na margem esquerda) na linha do cálculo do $resultado.
2. Pressione F5 no VSCode para iniciar a escuta.
3. No terminal, execute o comando: php debug_test.php.
4. O VSCode deverá pausar a execução na linha seelcionada, permitindo a inspeção de variáveis.