Monitoramento de aplicações PHP com as bibliotecas php-ast e xhprof

O que é monitoramento de aplicações PHP e para que serve?

Monitoramento de aplicações PHP é o processo de coleta, análise e visualização de métricas de desempenho, erros e uso de recursos de aplicações web escritas em PHP. Sem monitoramento, é impossível identificar gargalos, vazamentos de memória, consultas lentas ao banco de dados ou código não otimizado. As principais bibliotecas para isso são xhprof (profiling) e php-ast (análise de árvores sintáticas).

Como instalar?

Para instalar o xhprof (extensão para profiling), execute:

pecl install xhprof

Adicione no php.ini:

extension=xhprof.so

Para php-ast (análise de AST):

pecl install ast

Em seguida, conecte no composer:

composer require phpunit/php-code-coverage

Principais funções

• Profiling de requisições — xhprof coleta dados sobre tempo de execução, número de chamadas de funções e uso de memória.
• Análise de sintaxe — php-ast permite analisar código PHP em uma árvore sintática abstrata para análise estática.
• Monitoramento de erros — integração com Sentry ou Monolog para registro de exceções.
• Métricas de desempenho — tempo de resposta, número de requisições por segundo (RPS), uso de CPU/RAM.

Exemplo de código em PHP

<?php// Profiling com xhprofxhprof_enable();

// Seu código da aplicação$result = someHeavyFunction();

$xhprofData = xhprof_disable();include_once '/path/to/xhprof_lib/utils/xhprof_lib.php';include_once '/path/to/xhprof_lib/utils/xhprof_runs.php';$xhprofRuns = new XHProfRuns_Default();$runId = $xhprofRuns->save_run($xhprofData, 'my_app');echo 'Profiler run ID: ' . $runId;

// Análise de AST com php-ast$code = file_get_contents('index.php');$ast = ast\\parse_code($code, $version = 70);echo ast\\get_kind_name($ast->kind);?>

Quando usar?

O monitoramento é necessário em ambiente de produção para rastrear degradação de desempenho após lançamentos, durante testes de carga, e também para encontrar vazamentos de memória em processos de longa duração (por exemplo, em filas ou servidores WebSocket). As bibliotecas xhprof e php-ast são ideais para integração em pipelines de CI/CD e sistemas de observabilidade (Prometheus, Grafana).

Conclusão

O uso de profilers e analisadores estáticos é uma prática obrigatória para manter a alta qualidade de aplicações PHP. Comece instalando xhprof e php-ast para obter uma visão completa do funcionamento do seu código.