Como configurar o Stackdriver Debugger para PHP

Esta página descreve como configurar seu ambiente e seu aplicativo PHP para usar o Stackdriver Debugger. Para alguns ambientes, é preciso especificar explicitamente o escopo de acesso para permitir que o agente do Stackdriver Debugger envie dados. Recomendamos definir o escopo de acesso da forma mais ampla possível e, em seguida, usar o Cloud Identity and Access Management para restringir o acesso. Para manter essa prática recomendada, defina o escopo de acesso para todas as APIs Cloud com a opção cloud-platform.

Ambiente padrão do App Engine

O agente do Stackdriver Debugger para PHP ainda não é aceito no ambiente padrão do App Engine.

Ambiente flexível do App Engine

  1. Instale a extensão stackdriver_debugger do PECL (em inglês):

    pecl install stackdriver_debugger-alpha
    

    Caso seu arquivo php.ini não inclua extension=stackdriver_debugger.so depois de executar essa etapa, adicione-o manualmente.

  2. Adicione o pacote do depurador do Google Cloud para PHP ao arquivo composer.json:

    composer require google/cloud-debugger
    
  3. Adicione a extensão do Stackdriver Debugger para PHP por meio do arquivo composer.json:

    composer require ext-stackdriver_debugger:*
    
  4. Ative as integrações do Stackdriver no arquivo app.yaml:

    runtime_config:
      enable_stackdriver_integration: true
    
  5. Ative o agente.

    Adicione o seguinte código ao app o quanto antes na solicitação:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/app')]);
    

O depurador está pronto para ser usado com o aplicativo.

Google Kubernetes Engine

  1. Crie seu cluster com um dos seguintes escopos de acesso:
    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger

    Para criar um cluster usando o gcloud, faça o seguinte:

    1. Atualize o gcloud para a versão mais recente (opcional):
      gcloud components update
    2. Defina o código do projeto padrão:
      gcloud config set project [PROJECT_ID]
    3. Se você estiver trabalhando com clusters zonais, defina a zona de computação padrão:
      gcloud config set compute/zone [COMPUTE_ZONE]
    4. Se você estiver trabalhando com clusters regionais, defina a região de computação padrão:
      gcloud config set compute/region [COMPUTE_REGION]
    5. Execute o comando de criação:
      gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/cloud-platform

    Para informações mais detalhadas, consulte Como criar um cluster.

  2. Siga as instruções do Compute Engine.

Compute Engine

  1. Verifique se as instâncias do Compute Engine foram criadas com a opção de escopo de acesso Permitir acesso completo a todas as APIs do Cloud ou se elas têm um dos seguintes escopos de acesso:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger
  2. Instale a extensão stackdriver_debugger do PECL (em inglês). Se estiver usando contêineres, instale na imagem:

    pecl install stackdriver_debugger-alpha
    
  3. Adicione o pacote do depurador do Google Cloud para PHP ao arquivo composer.json:

    composer require google/cloud-debugger
    
  4. Configure um daemon para executar o processo daemon do Stackdriver Debugger:

    php /[YOUR-APP-PATH]/vendor/bin/google-cloud-debugger -s /[YOUR-APP-PATH]
    
  5. Ative o agente.

    Adicione o seguinte código ao app o quanto antes na solicitação:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/[YOUR-APP-PATH]')]);
    

O depurador está pronto para ser usado com o aplicativo.

Ambiente local e outros

  1. Instale a extensão stackdriver_debugger do PECL (em inglês):

    pecl install stackdriver_debugger-alpha
    
  2. Adicione o pacote do depurador do Google Cloud para PHP ao arquivo composer.json:

    composer require google/cloud-debugger
    
  3. Execute o processo daemon do Stackdriver Debugger:

    php /[YOUR-APP-PATH]/vendor/bin/google-cloud-debugger -s /[YOUR-APP-PATH]
    
  4. Ative o agente.

    Adicione o seguinte código ao app o quanto antes na solicitação:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/[YOUR-APP-PATH]')]);
    

O depurador está pronto para ser usado com o aplicativo.

A página "Depuração" no Console do GCP pode mostrar arquivos de origem locais, sem upload, para desenvolvimento local. Consulte Como selecionar o código-fonte manualmente.

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Stackdriver Debugger