Depuração no &quantaplus;

Christopher Hornbaker

    chrishornbaker@earthlink.net

Linus McCabe

    Linus@McCabe.nu

Pedro Morais

    morais@kde.org

Tradução

# 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 suporte 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.