Formater du code PHP

Comment ça marche

Le code PHP d'un plugin ou d'un ancien projet arrive souvent sur une seule ligne, ou écrit avec une habitude différente dans chaque fichier. Collez le code dans la zone de gauche. À droite, les accolades des classes et des fonctions passent sur leur propre ligne, les blocs if, foreach et while s'ouvrent sur la même ligne, chaque instruction a sa ligne et les opérateurs comme =, => et + reçoivent une espace de chaque côté. Par exemple, function somme($a,$b){return $a+$b;} devient une fonction de trois lignes indentée de 4 espaces. Cette présentation est proche de PSR-12, le style de code commun de la communauté PHP. Si le code contient une erreur de syntaxe, comme un point-virgule oublié ou une parenthèse non fermée, rien n'est reformaté : vous voyez la ligne et la colonne, et vous allez directement au bon endroit dans votre éditeur. Pour un gabarit qui mêle HTML et PHP, seul l'intérieur des blocs <?php ... ?> change. La ligne de résultat indique le nombre de lignes obtenu.

Cet outil est aussi connu sous le nom de formater php, formater code php, php formatter, php beautifier en ligne, indenter code php, formatage psr-12.

Qu'est-ce que PHP ?

PHP est un langage de programmation qui s'exécute sur le serveur web et construit la page avant qu'elle soit envoyée au visiteur. WordPress, Laravel et de nombreuses boutiques en ligne sont écrits en PHP. Le code commence par la balise <?php et le même fichier peut contenir du HTML. PHP ignore les retours à la ligne et les espaces en trop : un code écrit sur une seule ligne fonctionne, mais il est difficile à lire.

Qu'est-ce que PSR-12 ?

PSR-12 (Extended Coding Style) est la recommandation de style du PHP Framework Interop Group ; elle remplace l'ancien PSR-2. Elle demande une indentation de 4 espaces, les accolades des classes et méthodes sur leur propre ligne, celles de if et foreach sur la même ligne, et des lignes de préférence sous 120 caractères. Le but : que le code écrit par des personnes différentes se ressemble.

Quelle différence entre formater et valider du PHP ?

Formater change l'apparence du code : indentation, espaces et retours à la ligne. Valider (linter) vérifie si PHP peut lire le code. Comme cet outil analyse le code avant de le mettre en forme, il repère aussi les erreurs de syntaxe et donne leur position. Il ne trouve pas les variables non définies, les mauvais types ni les erreurs qui n'apparaissent qu'à l'exécution ; pour cela il faut exécuter le code ou utiliser un outil d'analyse comme PHPStan.

La mise en forme change-t-elle le comportement du code ?

Non. L'outil lit d'abord le code avec un analyseur PHP, puis réécrit les mêmes instructions avec une nouvelle présentation. Les noms de variables, les chaînes, les commentaires et l'ordre des instructions restent identiques. Seuls les espaces, l'indentation et les retours à la ligne changent ; PHP les ignore, donc le code s'exécute de la même façon. Un ajout ne change pas non plus le sens : un corps de if d'une ligne écrit sans accolades (if ($x) return 1;) reçoit des accolades, comme le demande PSR-12.

Si le code ne peut pas être lu, l'outil ne devine pas : il s'arrête et montre où se trouve le problème. Reformater un code à moitié cassé risquerait de cacher l'erreur au lieu de la montrer.

Qu'est-ce que PSR-12 et jusqu'où l'outil le suit-il ?

PSR-12 est la recommandation de style publiée par le PHP-FIG : indentation de 4 espaces, accolades des classes et méthodes à la ligne, accolades des structures de contrôle sur la même ligne, une espace après les mots-clés. La plupart des paquets Laravel, Symfony et Composer suivent un style proche.

Cette page utilise le plugin PHP de Prettier. Le résultat est très proche de PSR-12 sans être identique : les lignes longues sont coupées à 80 caractères, les tableaux et listes d'arguments suivent ses propres règles. Si votre projet impose un style dans son intégration continue, utilisez son propre outil (PHP_CodeSniffer, PHP-CS-Fixer) ; cette page sert à rendre du code lisible rapidement.

• Lire le code de quelqu'un d'autre, nettoyer un extrait reçu par e-mail → cette page
• Style imposé avant chaque commit → la configuration PHP-CS-Fixer du projet
• 2 espaces seulement si votre équipe l'a décidé ; PSR-12 en demande 4

Questions fréquentes

Comment rendre lisible du code PHP minifié ?

Collez le code dans la zone de gauche de cette page. Chaque instruction passe sur sa propre ligne et les blocs de fonctions et de classes sont indentés de 4 espaces. Copiez le résultat ou téléchargez-le en fichier .php.

Que se passe-t-il si mon code contient une erreur ?

Un code avec une erreur de syntaxe n'est pas mis en forme ; vous voyez à la place la ligne et la colonne de l'erreur. La cause est souvent un point-virgule ou une parenthèse oublié à la ligne précédente.

Peut-on formater un gabarit .php qui contient du HTML ?

Oui. Seul l'intérieur des blocs <?php ... ?> est mis en forme ; le HTML entre eux n'est pas touché. Pour la partie HTML, utilisez en plus l'outil de mise en forme HTML.

Mon code est-il envoyé à un serveur ?

Non. La mise en forme se fait entièrement dans votre navigateur ; le code collé ne quitte pas cette page et n'est enregistré nulle part.