Formateur PHP

Ce que fait l’outil

Le formateur PHP transforme du PHP désordonné, minifié ou mal indenté en code propre qui suit le standard de la communauté. Il gère la syntaxe moderne : propriétés typées et readonly, promotion de constructeur, fonctions fléchées, enums, expressions match et attributs.

Il exécute Prettier avec le plugin PHP officiel, la même combinaison que de nombreuses équipes Laravel et Symfony utilisent dans leurs éditeurs et leurs hooks de pre-commit : le résultat correspond donc à ce que produirait votre outillage.

Mode d’emploi

1. Collez du code PHP ou ouvrez un fichier .php. La balise ouvrante <?php est facultative pour les courts extraits.
2. Le code formaté apparaît à droite pendant la saisie.
3. Ajustez les options :
   • Indentation : 4 espaces est le standard PSR ; 2 espaces et les tabulations sont aussi disponibles.
   • Largeur de ligne : les lignes plus longues sont coupées là où la syntaxe le permet.
   • Accolades : placer les accolades des classes et fonctions sur la ligne suivante (PER / PSR-12) ou sur la même ligne.
   • Version de PHP : la version la plus ancienne sur laquelle le code doit tourner.
   • Guillemets simples et Virgules finales pour les listes multilignes.
4. Copiez ou téléchargez le résultat.

Si le code contient une erreur de syntaxe, le message indique ce que le parseur attendait ainsi que la ligne et la colonne où il s’est arrêté.

Exemple

L’exemple est un contrôleur de style Laravel où tout est entassé : une instruction use groupée, un tableau de propriétés, une promotion de constructeur, un appel de validation, un if écrit sur une ligne et un array_map avec une fonction fléchée. Après formatage, l’accolade de chaque méthode passe sur sa propre ligne, les opérateurs et les => reçoivent des espaces, le corps du if est développé, et les longs appels response()->json() sont coupés avec un élément de tableau par ligne et des virgules finales.

Ce qu’il ne change pas

Le formateur ne modifie que la mise en page. Il ne renomme pas les variables, ne réordonne pas les instructions use, ne convertit pas array() en syntaxe courte et ne corrige pas la logique. Les commentaires, blocs PHPDoc compris, sont conservés et réindentés avec le code qui les entoure.

Astuces

• Utilisez la même largeur de ligne et la même version de PHP que la configuration Prettier ou PHP-CS-Fixer de votre projet pour éviter des diffs inutiles.
• Formater un extrait copié depuis un log ou une stack trace le rend beaucoup plus lisible.
• Si vous partagez du code dans une issue, formatez-le d’abord pour que les relecteurs puissent se concentrer sur ce qu’il fait.