Formater PHP
Formatuj kod PHP w jednolitym, czytelnym stylu za pomocą wtyczki Prettier PHP, zbliżonym do konwencji PSR-12. Wklej plik zaczynający się od <?php, aby uzyskać ujednolicone odstępy, nawiasy klamrowe i tablice, uporządkowane łańcuchy wywołań metod oraz długie listy argumentów zawijane zgodnie z szerokością wydruku. Błędy składni są zgłaszane wraz z komunikatem parsera oraz numerem wiersza i kolumny, co pomaga programistom PHP uporządkować starszy kod przed przeglądem.
Najczęściej zadawane pytania
Jakiego formatera używa narzędzie?
Narzędzie uruchamia Prettier 3 z @prettier/plugin-php 0.26 na serwerze. Wynik ma styl zbliżony do PSR-12: domyślnie cztery spacje na poziom, nawiasy klamrowe otwierające klasy i funkcje w osobnym wierszu oraz jedno polecenie na wiersz.
Czy mój kod musi zawierać otwierający znacznik <?php?
Tak. Wtyczka formatuje kod wewnątrz znaczników PHP. Wszystko poza nimi jest traktowane jako tekst HTML i pozostaje bez zmian, więc fragment bez <?php wraca w niezmienionej postaci.
Które wersje PHP są obsługiwane?
Obsługiwana jest składnia PHP 8, w tym atrybuty, typy wyliczeniowe, wyrażenia match, funkcje strzałkowe, nazwane argumenty, promocja właściwości konstruktora i klasy readonly. Kod dla starszych wersji PHP 5 i 7 również jest formatowany.
Czy formater zmieni działanie mojego kodu?
Nie. Zmienia tylko układ. Mogą wystąpić drobne zmiany czysto kosmetyczne, na przykład długa składnia array() może zostać zamieniona na równoważną krótką składnię [], ale działanie kodu pozostaje takie samo.
Co się stanie w przypadku błędu składni?
Formatowanie zostaje przerwane, a narzędzie wyświetla komunikat parsera wraz z numerem wiersza i kolumny, na przykład informację o brakującym nawiasie zamykającym. Popraw ten fragment i uruchom formatowanie ponownie.
Czy mogę używać tabulatorów lub dwóch spacji?
Tak. Wybierz 2 lub 4 spacje albo włącz tabulatory. Szerokość wydruku od 40 do 200 znaków, domyślnie 80, określa, kiedy wywołania, tablice i warunki są zawijane.
Czy komentarze i bloki dokumentacji są zachowywane?
Tak. Komentarze w wierszach, komentarze blokowe i bloki PHPDoc pozostają przy opisywanym przez siebie kodzie. Ich tekst nie jest ponownie formatowany.
Czy może formatować szablony łączące HTML i PHP?
Formatuje bloki PHP w takich szablonach, a tekst HTML pomiędzy nimi pozostawia bez zmian. Wynik dla rozbudowanych plików szablonów może nadal wymagać ręcznych poprawek.
Ile kodu mogę sformatować jednocześnie?
Do 1 MB kodu na żądanie; formatowanie kończy się po 10 sekundach. Limit ten obejmuje nawet bardzo duże pojedyncze pliki.
Czy mój kod jest przechowywany na serwerze?
Nie. Kod jest formatowany w pamięci i od razu zwracany. Nie jest zapisywany; rejestrowane są tylko rozmiary żądań.