Laravel Code Formatter

Esta herramienta formatea el código Laravel PHP aplicando un conjunto estandarizado de reglas de formateo que conservan el comportamiento y mejoran la legibilidad. Apunta a desarrolladores que mantienen apps Laravel, revisores de código y pipelines CI que imponen estilos. Al alinear la indentación, los espacios y las instrucciones use a una norma común, reduce la deriva entre archivos y equipos. No altera la lógica de negocio ni el comportamiento de ejecución.

El proceso central comienza con la tokenización de PHP, seguido de transformaciones basadas en reglas. Se aplican los fundamentos PSR-12 y convenciones específicas de Laravel como agrupar las declaraciones use, formato coherente de arrays y visibilidad explícita cuando corresponde. Perfiles opcionales permiten control más profundo: sangría de 2 o 4 espacios, longitud máxima de línea, preferencias de comas finales y formateo sensible a la versión de PHP. La salida es un nuevo bloque de código semánticamente idéntico pero con presentación uniforme.

Las entradas incluyen la cadena de código, un perfil de formateo seleccionado y preferencias opcionales. Las salidas proporcionan formatted_code y un diff/patch opcional. La validación detecta entradas vacías y problemas básicos de sintaxis; los errores de sintaxis devuelven diagnósticos sin aplicar cambios. Valores por defecto aseguran un comportamiento predecible cuando se omiten opciones, permitiendo adopción rápida en repositorios diversos.

Usuarios objetivo: equipos Laravel, freelancers y pipelines de herramientas. Su valor reside en reducir el esfuerzo manual de formateo, acelerar revisiones de código y mejorar la mantenibilidad manteniendo las convenciones Laravel. El refactoring semántico, plantillas Blade o transformaciones de código en tiempo de ejecución quedan fuera de alcance.