Formattatore PHP

Cosa fa questo strumento

Il formattatore PHP trasforma codice PHP disordinato, minificato o indentato in modo incoerente in codice pulito che segue lo standard della community. Gestisce la sintassi moderna, comprese le proprietà tipizzate e readonly, la constructor promotion, le arrow function, gli enum, le espressioni match e gli attributi.

Esegue Prettier con il plugin PHP ufficiale, la stessa combinazione che molti team Laravel e Symfony usano negli editor e negli hook di pre-commit, quindi il risultato corrisponde a quello che produrrebbero i tuoi strumenti.

Come si usa

1. Incolla codice PHP oppure apri un file .php. Il tag di apertura <?php è facoltativo per gli snippet brevi.
2. Il codice formattato compare a destra mentre scrivi.
3. Regola le opzioni:
   • Indentazione: 4 spazi è lo standard PSR; sono disponibili anche 2 spazi e tabulazioni.
   • Larghezza riga: le righe più lunghe di questo valore vengono spezzate dove la sintassi lo consente.
   • Parentesi graffe: metti le graffe di classi e funzioni sulla riga successiva (PER / PSR-12) o sulla stessa riga.
   • Versione PHP: la versione più vecchia su cui il codice deve girare.
   • Apici singoli e Virgole finali per le liste su più righe.
4. Copia o scarica il risultato.

Se il codice contiene un errore di sintassi, il messaggio indica cosa si aspettava il parser e la riga e la colonna in cui si è fermato.

Esempio

L’esempio è un controller in stile Laravel con tutto ammassato: un’istruzione use raggruppata, un array di proprietà, la constructor promotion, una chiamata di validazione, un if scritto su una sola riga e un array_map con una arrow function. Dopo la formattazione la graffa di ogni metodo passa su una riga a sé, operatori e => ricevono gli spazi, il corpo dell’if viene espanso e le lunghe chiamate response()->json() vengono spezzate con un elemento dell’array per riga e le virgole finali.

Cosa non cambia

Il formattatore cambia solo l’impaginazione. Non rinomina variabili, non riordina le istruzioni use, non converte array() nella sintassi breve e non corregge la logica. I commenti, compresi i blocchi PHPDoc, vengono mantenuti e reindentati insieme al codice circostante.

Suggerimenti

• Usa la stessa larghezza di riga e la stessa versione di PHP della configurazione Prettier o PHP-CS-Fixer del tuo progetto per evitare modifiche inutili nei diff.
• Formattare uno snippet copiato da un log o da uno stack trace lo rende molto più leggibile.
• Se condividi codice in una issue, formattalo prima, così i revisori possono concentrarsi su cosa fa.