Laravel Code Formatter

Questo strumento formatta il codice Laravel PHP applicando un insieme standardizzato di regole di formattazione che mantengono il comportamento e migliorano la leggibilità. Si rivolge agli sviluppatori che mantengono app Laravel, revisori del codice e pipeline CI che impongono uno stile. Allineando l’indentazione, lo spazio e le istruzioni use a una norma comune, riduce la deriva tra file e team. Non altera logica di business o comportamento di esecuzione.

Il processo core inizia con la tokenizzazione PHP, seguito da trasformazioni basate su regole. Applica le basi PSR-12 e convenzioni Laravel-specific come raggruppare le istruzioni use, formattazione coerente degli array e visibilità esplicita dove pertinente. Profili opzionali consentono controllo avanzato: indentazione a 2 o 4 spazi, lunghezza massima delle linee, preferenze per virgole finali e formattazione dipendente dalla versione PHP. L’output è un nuovo blocco di codice identico in semantica ma con presentazione coerente.

Gli input includono la stringa di codice, un profilo di formattazione selezionato e preferenze opzionali. Gli output forniscono formatted_code e eventuale patch/diff. La validazione cattura input vuoti e problemi di sintassi di base; errori di sintassi restituiscono diagnosi senza applicare cambiamenti. I valori predefiniti garantiscono comportamento prevedibile quando le opzioni sono omesse, facilitando un’adozione rapida in repository diversi.

Destinatari: team Laravel, freelance e pipeline di strumenti. Il valore risiede nella riduzione dello sforzo manuale di formattazione, accelerazione delle revisioni del codice e miglioramento della manutenibilità, rimanendo fedeli alle convenzioni Laravel. Refactoring semantico, Blade-template o trasformazioni di codice in fase di esecuzione non rientrano nell’ambito.