Laravel Code Formatter

Cet outil formatte le code Laravel PHP en appliquant un ensemble standardisé de règles de formatage qui préservent le comportement tout en améliorant la lisibilité. Il cible les développeurs qui maintiennent des applications Laravel, les revues de code et les pipelines CI qui imposent des styles. En alignant l’indentation, les espaces et les instructions use sur une norme commune, il réduit les dérives entre fichiers et équipes. Il n’altère pas la logique métier ni le comportement d’exécution.

Le processus principal commence par la tokenisation PHP, suivie de transformations basées sur des règles. Il applique les bases PSR-12 et les conventions Laravel spécifiques telles que le regroupement des using et un formatage cohérent des tableaux, avec une visibilité explicite lorsque cela s’applique. Des profils optionnels permettent un contrôle plus poussé : indentation en 2 ou 4 espaces, longueur maximale des lignes, préférences pour les virgules finales et un formatage sensible à la version PHP. La sortie est un nouveau bloc de code identique sur le plan sémantique mais avec une présentation cohérente.

Les entrées comprennent la chaîne de code, un profil de formatage choisi et des préférences optionnelles. Les sorties produisent formaté_code et éventuellement diff/patch. La validation détecte les entrées vides et les problèmes de syntaxe de base; les erreurs de syntaxe renvoient des diagnostics sans appliquer les changements. Des valeurs par défaut assurent un comportement prévisible lorsque les options ne sont pas fournies, facilitant l’adoption rapide dans divers dépôts.

Les utilisateurs visés incluent les équipes Laravel, les freelances et les pipelines d’outillage. La valeur réside dans la réduction de l’effort manuel de formatage, l’accélération des revues de code et l’amélioration de la maintenabilité tout en restant fidèle aux conventions Laravel. Le refactoring sémantique, le formatage des templates Blade ou les transformations de code à l’exécution ne font pas partie du périmètre.