PHP-muotoilija
Muotoile PHP-koodi yhdenmukaiseen ja helppolukuiseen tyyliin Prettier-PHP-lisäosalla. Tyyli noudattaa pääpiirteissään PSR-12-käytäntöjä. Liitä <?php-alkuinen tiedosto, niin saat yhdenmukaistetut välit, aaltosulkeet ja taulukot, sekä pitkät metodiketjut ja argumenttilistat rivitettyinä tulostusleveytesi mukaan. Syntaksivirheet ilmoitetaan jäsentimen viestin sekä rivi- ja sarakenumeron kanssa. Tämä auttaa PHP-kehittäjiä siistimään vanhaa koodia ennen katselmointia.
Usein kysytyt kysymykset
Mitä muotoilijaa käytetään?
Työkalu suorittaa palvelimella Prettier 3:n ja @prettier/plugin-php 0.26:n. Tuloste noudattaa PSR-12:n kaltaista tyyliä: oletuksena neljä välilyöntiä tasoa kohden, luokkien ja funktioiden avaavat aaltosulkeet omalla rivillään sekä yksi lauseke rivillä.
Tarvitseeko koodissani olla avaava <?php-tunniste?
Kyllä. Lisäosa muotoilee PHP-tunnisteiden sisällä olevan koodin. Kaikki niiden ulkopuolella käsitellään upotettuna HTML-koodina ja säilytetään ennallaan, joten ilman <?php-tunnistetta annettu koodinpätkä palautuu muuttumattomana.
Mitä PHP-versioita tuetaan?
Nykyaikaisen PHP 8:n syntaksi tunnetaan, mukaan lukien attribuutit, enumeraatiot, match-lausekkeet, nuolifunktiot, nimettyjen argumenttien välitys, konstruktorin ominaisuuksien edistäminen ja vain luku -luokat. Myös vanhempi PHP 5:n ja 7:n koodi muotoillaan.
Muutaako muotoilija koodini toimintaa?
Ei. Se muuttaa vain asettelua. Joitakin puhtaasti ulkoasuun liittyviä muutoksia voi tapahtua: esimerkiksi pitkä array()-syntaksi voidaan muuttaa vastaavaksi lyhyeksi []-syntaksiksi, mutta koodin toiminta pysyy samana.
Mitä tapahtuu syntaksivirheen sattuessa?
Muotoilu keskeytyy, ja työkalu näyttää jäsentimen viestin sekä rivin ja sarakkeen, esimerkiksi puuttuvan sulkevan sulkeen. Korjaa kyseinen kohta ja muotoile uudelleen.
Voinko käyttää sarkaimia tai kahta välilyöntiä?
Kyllä. Valitse 2 tai 4 välilyöntiä tai ota sarkaimet käyttöön. Tulostusleveys, jonka voi asettaa välille 40–200 merkkiä ja jonka oletusarvo on 80, määrittää, milloin kutsut, taulukot ja ehdot rivitetään.
Säilyvätkö kommentit ja dokumentaatiolohkot?
Kyllä. Rivikommentit, lohkokommentit ja PHPDoc-lohkot säilyvät paikallaan kuvailemansa koodin vieressä. Niiden tekstiä ei rivitetä uudelleen.
Voiko sillä muotoilla malleja, joissa yhdistyvät HTML ja PHP?
Se muotoilee tällaisten mallien PHP-lohkot ja säilyttää niiden välissä olevan HTML-sisällön muuttumattomana. Laajoissa mallitiedostoissa tulosta voi silti joutua viimeistelemään käsin.
Kuinka paljon koodia voin muotoilla kerralla?
Enintään 1 MB koodia pyyntöä kohden, ja muotoilu keskeytyy 10 sekunnin jälkeen. Tämä riittää hyvin suuriinkin yksittäisiin tiedostoihin.
Säilytetäänkö koodini palvelimella?
Ei. Koodi muotoillaan muistissa ja palautetaan heti. Sitä ei tallenneta, ja vain pyyntöjen koot kirjataan.