Formatter PHP

Co robi to narzędzie

Formatter PHP zamienia nieuporządkowany, zminifikowany lub niespójnie wcięty kod PHP w czysty kod zgodny ze standardem kodowania społeczności. Obsługuje nowoczesną składnię, w tym typowane właściwości i właściwości readonly, promocję w konstruktorze (constructor promotion), funkcje strzałkowe, enumy, wyrażenia match i atrybuty.

Uruchamia Prettiera z oficjalną wtyczką PHP — tę samą kombinację, której wiele zespołów Laravel i Symfony używa w edytorach i hookach pre-commit — więc wynik jest taki sam, jak ten, który dałyby twoje narzędzia.

Jak używać

1. Wklej kod PHP lub otwórz plik .php. Otwierający tag <?php jest opcjonalny w krótkich fragmentach.
2. Sformatowany kod pojawia się po prawej w trakcie pisania.
3. Dostosuj opcje:
   • Wcięcie: 4 spacje to standard PSR; dostępne są też 2 spacje i tabulatory.
   • Szerokość linii: dłuższe linie są zawijane tam, gdzie pozwala na to składnia.
   • Nawiasy klamrowe: umieść nawiasy klas i funkcji w nowej linii (PER / PSR-12) lub w tej samej linii.
   • Wersja PHP: najstarsza wersja, na której musi działać kod.
   • Pojedyncze cudzysłowy i Końcowe przecinki na listach wielowierszowych.
4. Skopiuj lub pobierz wynik.

Jeśli kod zawiera błąd składni, komunikat podaje, czego oczekiwał parser, oraz linię i kolumnę, w której się zatrzymał.

Przykład

Przykład to kontroler w stylu Laravela, w którym wszystko jest stłoczone: zgrupowana instrukcja use, tablica we właściwości, promocja w konstruktorze, wywołanie walidacji, if zapisany w jednej linii i array_map z funkcją strzałkową. Po sformatowaniu nawias klamrowy każdej metody przechodzi do osobnej linii, operatory i => dostają spacje, ciało if zostaje rozwinięte, a długie wywołania response()->json() są zawijane — po jednym elemencie tablicy na linię i z końcowymi przecinkami.

Czego nie zmienia

Formatter zmienia tylko układ. Nie zmienia nazw zmiennych, nie porządkuje instrukcji use, nie zamienia array() na składnię skróconą ani nie poprawia logiki. Komentarze, w tym bloki PHPDoc, są zachowywane i wcinane na nowo razem z otaczającym je kodem.

Wskazówki

• Używaj tej samej szerokości linii i wersji PHP co konfiguracja Prettiera lub PHP-CS-Fixer w twoim projekcie, aby uniknąć zbędnych zmian w diffach.
• Sformatowanie fragmentu skopiowanego z logu lub stack trace’a znacznie ułatwia jego czytanie.
• Jeśli udostępniasz kod w zgłoszeniu (issue), najpierw go sformatuj, aby recenzenci mogli skupić się na tym, co robi.