# Suporte a PHP no Maguyva: Aplicações Web de Longa Vida sem Edições às Cegas

Canonical source: https://maguyva.ai/pt-br/languages/php

License: text under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/); code samples under [MIT-0](https://opensource.org/license/mit-0); the Maguyva name, logos, brand assets and other code are not covered. Details: [maguyva.ai/license](https://maguyva.ai/license).

O Maguyva oferece suporte a PHP com parsing de AST e extração de símbolos, permitindo que agentes de IA naveguem por aplicações Laravel, frameworks personalizados, código da era WordPress e outros repositórios PHP de longa vida com mais estrutura do que o grep oferece.

## Panorama de suporte

- Nível: Suporte a AST e símbolos
- Programação
- Extensões: .php, .php3, .php4, .php5, .phps, .phtml
- Parsing real de AST para busca com consciência de sintaxe e contexto estrutural.
- Símbolos nomeados alimentam a busca semântica e as referências cruzadas. A navegação por grafo fica disponível quando a extração de relações está habilitada.
- Esta linguagem fornece símbolos e relações para a busca orientada por grafo; os tipos de aresta compatíveis variam de acordo com seus construtos nativos.
- A análise de AST e a extração de símbolos estão disponíveis.

## Uso ideal

- Repositórios Laravel, PHP personalizado ou monolitos mistos que ainda importam operacionalmente.
- Equipes que mantêm aplicações web mais antigas que agora convivem com frontends em JavaScript e código de infraestrutura.
- Trabalho de refatoração assistido por IA em que a prioridade é entender o fluxo existente antes de alterá-lo.

## Fluxos de trabalho de agente

- Rastrear uma rota, controller, service ou helper compartilhado antes de editá-lo.
- Encontrar padrões de implementação repetidos em um codebase PHP maduro, em vez de inventar novos.
- Recuperar a estrutura de código mais antigo que sobreviveu a várias eras de framework ou de hospedagem.

## Por que PHP precisa de busca que leva em conta a estrutura

PHP é um dos exemplos mais claros de por que o suporte amplo a linguagens precisa ser real, não aspiracional. Muitos sistemas importantes ainda são sistemas PHP: aplicações Laravel, monolitos antigos, ferramentas administrativas internas e aplicações web fortemente personalizadas que sobreviveram a todas as reescritas planejadas.

Nesses repositórios, o problema não é a sintaxe. É recuperar a estrutura com segurança de um codebase que teve anos para acumular helpers, convenções de framework e atalhos locais.

## O que o Maguyva realmente extrai em PHP

O Maguyva remove o símbolo `$` das definições, normaliza chamadas prefixadas por membro e filtra uma quantidade muito grande de ruído de funções nativas do PHP no grafo de relacionamentos. Esse é exatamente o tipo de limpeza de que código PHP mais antigo precisa antes que as visões de busca e de dependência se tornem úteis.

Ele também oferece suporte aos formatos de arquivo que equipes PHP realmente encontram, de `.php` e `.phtml` até extensões de arquivo associadas a versões antigas do PHP que ainda aparecem em parques de longa vida.

## Fluxos de trabalho com MCP úteis para aplicações PHP de longa vida

O padrão produtivo geralmente é:

- `find_symbol` para controllers, services, models ou classes auxiliares com nomes estáveis.
- `text_pattern_search` para nomes de rota, chamadas de helper ou convenções antigas de framework, quando o texto exato ainda é o caminho mais rápido.
- `get_task_context` quando o caminho de código está bagunçado e você quer um resumo que reúna o contexto relevante antes de editar.

## Quando esta página é útil

Esta página é para equipes cuja pergunta prática é simplesmente "ainda rodamos PHP importante". Se o frontend vive em JavaScript moderno, leia [JavaScript](/pt-br/languages/javascript) em seguida. Se o repositório tem camadas mais novas de serviço ou automação ao redor, a página de [Python](/pt-br/languages/python) é a companhia mais relevante.

## Detalhes do motor

- O PHP remove o símbolo `$` das definições e normaliza chamadas prefixadas por membro, o que facilita buscar de forma consistente em código antigo cheio de helpers.
- O suporte cobre formatos comuns de arquivo PHP, incluindo `.php`, `.php3`, `.php4`, `.php5`, `.phtml` e `.phps`.
- Um filtro grande de funções built-in exclui as funções padrão do ambiente de execução do PHP, para o grafo continuar focado no código da aplicação.

## Pontos de entrada MCP úteis

- `find_symbol`: Use para um controller, serviço, model ou classe helper quando o repositório ainda tiver nomes de símbolo reconhecíveis.
- `text_pattern_search`: Use para nomes de rota, chamadas de helper ou convenções de framework antigas quando a estrutura sozinha não for suficiente.
- `get_task_context`: Útil quando você precisa de um resumo que reúna o contexto relevante de um fluxo PHP antigo antes de alterá-lo.