Formátovač PHP
Formátujte kód PHP jednotným, čitelným stylem pomocí pluginu Prettier PHP, který se blíží konvencím PSR-12. Vložte soubor začínající na <?php a získejte sjednocené mezery, závorky, pole a řetězce metod; dlouhé seznamy argumentů se zalomí podle nastavené šířky tisku. Chyby syntaxe se zobrazí se zprávou analyzátoru, řádkem a sloupcem, což vývojářům PHP pomůže před kontrolou uklidit starší kód.
Často kladené otázky
Který formátovač se používá?
Nástroj na serveru spouští Prettier 3 s @prettier/plugin-php 0.26. Výstup se řídí stylem blízkým PSR-12: ve výchozím nastavení čtyři mezery na úroveň, otevírací závorky tříd a funkcí na samostatném řádku a jeden příkaz na řádek.
Musí můj kód obsahovat otevírací značku <?php?
Ano. Plugin formátuje kód uvnitř značek PHP. Vše mimo ně považuje za vložený HTML a ponechá beze změny, takže úryvek bez <?php se vrátí nezměněný.
Které verze PHP jsou podporovány?
Podporována je moderní syntaxe PHP 8, včetně atributů, výčtových typů, výrazů match, šipkových funkcí, pojmenovaných argumentů, povýšení vlastností konstruktoru a tříd readonly. Zformátuje se také starší kód PHP 5 a 7.
Změní formátovač chování mého kódu?
Ne. Mění pouze rozvržení. Může dojít k několika čistě kosmetickým úpravám; například dlouhá syntaxe array() se může změnit na ekvivalentní krátkou syntaxi []. Chování kódu zůstane stejné.
Co se stane při syntaktické chybě?
Formátování se zastaví a nástroj zobrazí zprávu analyzátoru včetně řádku a sloupce, například u chybějící uzavírací závorky. Opravte dané místo a spusťte formátování znovu.
Mohu použít tabulátory nebo dvě mezery?
Ano. Vyberte 2 nebo 4 mezery, případně zapněte tabulátory. Šířka tisku od 40 do 200 znaků (výchozí hodnota je 80) určuje, kdy se volání, pole a podmínky zalomí.
Zachovají se komentáře a bloky docblock?
Ano. Řádkové komentáře, blokové komentáře a bloky PHPDoc zůstanou vedle kódu, který popisují. Jejich text se nepřeformátuje.
Může formátovat šablony, které kombinují HTML a PHP?
Naformátuje bloky PHP uvnitř takových šablon a obsah HTML mezi nimi ponechá beze změny. U složitých souborů šablon mohou být stále nutné ruční úpravy.
Kolik kódu mohu naformátovat najednou?
Až 1 MB kódu na jeden požadavek; formátování se zastaví po 10 sekundách. To stačí i pro velmi velké samostatné soubory.
Zůstane můj kód na serveru?
Ne. Kód se naformátuje v paměti a ihned se vám vrátí. Neukládá se a zaznamenávají se pouze velikosti požadavků.