# Depuração no &quantaplus;

## Utilizar o Depurador de &PHP;

Com o &quantaplus; versão 3.3, o tratamento do depurador foi reimplementado. O suporte para o depurador incorporado de &PHP; (3), agora obsoleto, foi abandonado, assim como o suporte para o depurador 'dbg'. Em vez disso, foi implementado um sistema genérico de depuração, de modo a permitir várias implementações de 'plugins'.

De momento, só está disponível um 'plugin' que adiciona o suprte para usar o &gubed; com o &quantaplus;.

Para usar um depurador no seu projecto, abra as opções do projecto e escolha um 'plugin' de depuração adequado. Para alterar as opções específicas do depurador, carregue no botão de 'Opções' ao lado da lista do 'plugin' de depuração.

### Uso geral

Logo que um projecto tenha um depurador activo, irão aparecer alguns itens adicionais na interface de utilizador do &quantaplus;:

Menu do depurador

- Irá aparecer um menu novo, onde poderá aceder à maioria das funcionalidades do depurador.

Barra de ferramentas de depuração

- Irá aparecer uma barra de ferramentas com acesso aos comandos de depuração mais comuns.

Janela de ferramentas de variáveis

- Uma janela onde é mostrado o conteúdo das variáveis vigiadas. Aparece do lado esquerdo, por omissão.

Janela de pontos de paragem

- Uma janela onde todos os pontos de paragem, sejam eles de linhas ou condicionais, irão aparecer. Esta aparecerá em baixo por omissão.

Janela de Resultado da Depuração

- Uma janela onde o resultado (em HTML) do depurador será mostrado. Aparece na área acoplável inferior por omissão.

Dependo do que o 'plugin' de depuração suporta, toda a funcionalidade, ou apenas um subconjunto desta, estará disponível.

Depurar Sessão Iniciar uma Sessão

- Esta acção é usada para ligar ao depurador se tal for necessário ou para indicar ao 'plugin' para começar a atender os pedidos de depuração. Esta acção é despoletada por omissão quando é aberto um projecto que use um depurador, como tal não terá à partida de se preocupar com ele.

Depurar Sessão Terminar a Sessão

- O oposto da opção Depurar Sessão Iniciar uma Sessão . Fecha a ligação ao depurador ou pára o atendimento de pedidos.

Depurar Execução Enviar um Pedido de HTTP

- Envia um pedido de HTTP para o servidor iniciar um pedido de depuração. A utilização desta acção é equivalente a usar um navegador para ver o documento actual. O resultado do pedido termina na área de Resultado da Depuração.

Depurar Execução Pausa

- Coloca um programa, actualmente em execução, em pausa

Depurar Execução Executar

- Diz ao depurador para começar a execução do programa e enviar informações sobre as variáveis vigiadas e a linha de execução actual à medida que vai correndo. Se isto for feito quando um programa está em pausa, a execução irá prosseguir. Se for feito antes de iniciar um pedido de depuração, o programa irá começar a correr, logo que o pedido tenha sido iniciado.

Depurar Execução Salto

- Indica ao depurador para começar a execução do programa, sem enviar informações sobre as variáveis vigiadas e a linha de execução actual. Se isto for feito enquanto um programa está em pausa, a execução irá prosseguir. Se tiver terminado antes de um pedido de depuração ter iniciado, o programa irá saltar até que o pedido seja iniciado.

Depurar Execução Passo

- Diz ao depurador para executar a próxima instrução do programa sem saltar para dentro das funções ou inclusões.

Depurar Execução Saltar Para

- Diz ao depurador para executar a próxima instrução do programa, saltando para dentro das funções ou inclusões se possível.

Depurar Execução Saltar para Fora

- Diz ao depurador para executar até que saia da função actual.

Depurar Execução Ignorar

- Diz ao depurador para saltar a próxima instrução e prosseguir para a próxima, como se a actual não existisse.

Depurar Execução Matar

- Diz ao depurador para matar o programa actualmente em execução.

Depurar Pontos de Paragem Parar quando...

- Abre uma janela onde poderá definir os pontos de paragem condicionais.

Depurar Pontos de Paragem Comutar o ponto de paragem

- Activa ou desactiva um ponto de paragem na linha onde o cursor se encontra

Depurar Pontos de Paragem Limpar os pontos de paragem

- Retira todos os pontos de paragem.

Depurar Variáveis Vigiar a variável

- Abre uma janela onde poderá introduzir uma variável ou expressão que deseje vigiar. O valor da vigia irá aparecer na janela de variáveis.

Depurar Variáveis Definir o valor da variável

- Abre uma janela onde poderá indicar uma variável e um valor novo para ela.

## Utilizar o &kxsl; o Depurador de &XSL;

O &kxsl; é uma criação do Keith Isdale, assim como esta secção da documentação. O &kxsl; é uma interface para o &kde; e uma KPart para o `xsldbg`, o qual poderá encontrar em http://xsldbg.sf.net, em conjunto com muitos outros trabalhos do Keith.

Para iniciar o &kxsl;, seleccione os 'Plugins' &kxsl; .

Veja por favor na documentação do &kxsl; mais informações sobre a sua utilização.