# Wsparcie dla PHP w Maguyva: długowieczne aplikacje webowe bez ślepych edycji

Canonical source: https://maguyva.ai/pl/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).

Maguyva obsługuje PHP dzięki parsowaniu AST i ekstrakcji symboli, dzięki czemu agenci AI mogą poruszać się po aplikacjach Laravel, niestandardowych frameworkach, kodzie z epoki WordPressa i innych długowiecznych repozytoriach PHP z większą strukturą niż grep.

## Migawka wsparcia

- Poziom: Obsługa AST i symboli
- Programowanie
- Rozszerzenia: .php, .php3, .php4, .php5, .phps, .phtml
- Prawdziwe parsowanie AST dla wyszukiwania świadomego składni i kontekstu strukturalnego.
- Nazwane symbole zasilają wyszukiwanie semantyczne i wzajemne odwołania. Nawigacja po grafie jest dostępna po włączeniu ekstrakcji relacji.
- Ten język dostarcza symbole i relacje do wyszukiwania uwzględniającego graf; obsługiwane typy krawędzi zależą od jego rodzimych konstrukcji.
- Dostępne są zarówno parsowanie AST, jak i ekstrakcja symboli.

## Najlepsze dopasowanie

- Repozytoria Laravel, niestandardowego PHP lub mieszanych monolitów, które wciąż mają znaczenie operacyjne.
- Zespoły utrzymujące starsze aplikacje webowe, które teraz sąsiadują z frontendami JavaScript i kodem infrastruktury.
- Refaktoryzacja wspomagana przez AI, w której priorytetem jest zrozumienie istniejącego przepływu przed jego zmianą.

## Workflow agentów

- Prześledź ścieżkę trasy, kontrolera, usługi lub współdzielonej funkcji pomocniczej, zanim ją zedytujesz.
- Znajdź powtarzające się wzorce implementacji w dojrzałej bazie kodu PHP, zamiast wymyślać nowe.
- Odtwórz strukturę w starszym kodzie, który przetrwał kilka epok frameworków lub hostingu.

## Dlaczego PHP potrzebuje wyszukiwania uwzględniającego strukturę

PHP to jeden z najwyraźniejszych przykładów tego, dlaczego szerokie wsparcie językowe musi być realne, a nie aspiracyjne. Wiele ważnych systemów wciąż jest systemami PHP: aplikacje Laravel, stare monolity, wewnętrzne narzędzia administracyjne i mocno dostosowane aplikacje webowe, które przetrwały każde planowane przepisanie.

W tych repozytoriach problemem nie jest składnia. Problemem jest bezpieczne odtworzenie struktury z bazy kodu, która przez lata obrastała funkcjami pomocniczymi, konwencjami frameworka i lokalnymi skrótami.

## Co Maguyva faktycznie ekstrahuje w PHP

Maguyva usuwa znak `$` z definicji, normalizuje wywołania z prefiksem składowej i odfiltrowuje bardzo dużą ilość szumu wbudowanych funkcji PHP z grafu relacji. To dokładnie taki rodzaj porządkowania, jakiego starszy kod PHP potrzebuje, zanim widoki wyszukiwania i zależności staną się użyteczne.

Obsługuje też typy plików, z jakimi zespoły PHP faktycznie się spotykają — od `.php` i `.phtml` po rozszerzenia plików związane ze starszymi wersjami PHP, które wciąż pojawiają się w długowiecznych środowiskach.

## Przydatne przepływy pracy MCP dla długowiecznych aplikacji PHP

Produktywny wzorzec to zwykle:

- `find_symbol` dla kontrolerów, usług, modeli lub klas pomocniczych o stabilnych nazwach.
- `text_pattern_search` dla nazw tras, wywołań pomocniczych lub starych konwencji frameworka, gdy dokładny tekst wciąż jest najszybszą ścieżką.
- `get_task_context`, gdy ścieżka kodu jest chaotyczna i chcesz uzyskać podsumowanie łączące istotne informacje przed edycją.

## Kiedy ta strona jest przydatna

Ta strona jest dla zespołów, których praktyczne pytanie brzmi po prostu: „wciąż uruchamiamy ważne PHP”. Jeśli frontend znajduje się w nowoczesnym JavaScript, przeczytaj następnie [JavaScript](/pl/languages/javascript). Jeśli repozytorium ma nowsze warstwy usług lub automatyzacji na obrzeżach, bardziej odpowiednią stroną towarzyszącą jest [Python](/pl/languages/python).

## Szczegóły silnika

- Ekstraktor PHP usuwa znak `$` z definicji i normalizuje wywołania z prefiksem członka, co ułatwia spójne przeszukiwanie starego kodu obfitującego w helpery.
- Wsparcie obejmuje typowe formy plików PHP, w tym `.php`, `.php3`, `.php4`, `.php5`, `.phtml` i `.phps`.
- Duży filtr funkcji wbudowanych usuwa z grafu wywołania standardowych funkcji środowiska PHP, żeby graf pozostał skupiony na kodzie aplikacji.

## Przydatne punkty wejścia MCP

- `find_symbol`: Użyj dla kontrolera, usługi, modelu albo klasy pomocniczej, kiedy repo wciąż ma rozpoznawalne nazwy symboli.
- `text_pattern_search`: Użyj dla nazw tras, wywołań helperów albo starych konwencji frameworka, kiedy sama struktura nie wystarczy.
- `get_task_context`: Przydatne, kiedy potrzebujesz podsumowania łączącego istotne informacje o działaniu starego przepływu PHP przed jego zmianą.