Formattatore PHP
Formatta il codice PHP con uno stile uniforme e leggibile tramite il plugin Prettier PHP, vicino alle convenzioni PSR-12. Incollate un file che inizi con <?php per ottenere spazi, parentesi graffe, array e catene di metodi normalizzati, con gli elenchi lunghi di argomenti suddivisi in base alla larghezza di stampa. Gli errori di sintassi vengono segnalati con il messaggio del parser, la riga e la colonna, aiutando gli sviluppatori PHP a ripulire il codice legacy prima della revisione.
Domande frequenti
Quale formattatore viene usato?
Lo strumento esegue Prettier 3 sul server con @prettier/plugin-php 0.26. Il risultato segue uno stile vicino a PSR-12: quattro spazi per livello come impostazione predefinita, parentesi graffe di apertura delle classi e delle funzioni su una riga dedicata e un'istruzione per riga.
Il mio codice deve iniziare con il tag <?php?
Sì. Il plugin formatta il codice all'interno dei tag PHP. Tutto ciò che si trova al di fuori viene trattato come HTML in linea e mantenuto com'è, quindi un frammento senza <?php viene restituito invariato.
Quali versioni di PHP sono supportate?
La sintassi moderna PHP 8 è supportata, inclusi attributi, enum, espressioni match, funzioni freccia, argomenti denominati, promozione delle proprietà del costruttore e classi readonly. Vengono formattati anche codice PHP 5 e 7 meno recente.
Il formattatore modifica il comportamento del mio codice?
No. Modifica solo la disposizione. Possono verificarsi alcune riscritture puramente estetiche: per esempio, la sintassi array() lunga può diventare l'equivalente sintassi breve []. Il comportamento del codice resta invariato.
Cosa succede in caso di errore di sintassi?
La formattazione si interrompe e lo strumento mostra il messaggio del parser con la riga e la colonna, per esempio in caso di parentesi chiusa mancante. Correggete il punto indicato e formattate di nuovo.
Posso usare le tabulazioni o due spazi?
Sì. Scegliete 2 o 4 spazi oppure attivate le tabulazioni. La larghezza di stampa, da 40 a 200 caratteri, 80 come valore predefinito, determina quando le chiamate, gli array e le condizioni vanno a capo.
I commenti e i blocchi docblock vengono mantenuti?
Sì. I commenti su una riga, i commenti a blocco e i blocchi PHPDoc restano accanto al codice che descrivono. Il loro testo non viene riformattato.
Può formattare modelli che combinano HTML e PHP?
Formatta i blocchi PHP all'interno di questi modelli e mantiene invariato il contenuto HTML tra un blocco e l'altro. I file modello complessi potrebbero comunque richiedere qualche ritocco manuale.
Quanto codice posso formattare alla volta?
Fino a 1 MB di codice per richiesta; la formattazione si interrompe dopo 10 secondi. È sufficiente anche per file singoli molto grandi.
Il mio codice viene conservato sul server?
No. Il codice viene formattato in memoria e restituito subito. Non viene salvato e vengono registrate solo le dimensioni delle richieste.