Sobre o projeto

PHP-Parser é uma biblioteca PHP instalável via Composer, destinada a simplificar a análise estática de código e a manipulação de código. Ela analisa arquivos-fonte PHP 7 e PHP 8 em uma árvore de sintaxe abstrata, incluindo informações precisas de localização, e pode se recuperar de erros de sintaxe para produzir uma AST parcial. A biblioteca fornece ferramentas para despejar ASTs em um formato legível por humanos, percorrer nós com visitantes, modificar nós, resolver nomes com namespace, avaliar expressões constantes e construir ASTs por meio de objetos construtores. As ASTs também podem ser convertidas para JSON e restauradas a partir de JSON. Um pretty printer converte ASTs de volta em código PHP e pode preservar a formatação de árvores parcialmente alteradas. A versão 5.x roda em PHP 7.4 ou mais recente, analisa PHP 7.0 até PHP 8.4 e tem suporte limitado à análise de PHP 5.x. A versão 4.x permanece suportada para PHP 7.0 ou mais recente e analisa PHP 5.2 até PHP 8.3. A documentação cobre uso básico, caminhada na AST, resolução de nomes, pretty printing, construtores, tokens e posições do lexer, recuperação de erros, avaliação de expressões constantes, representação JSON e considerações de desempenho.