Accolades PHP sur une nouvelle ligne

Placement des accolades dans cet outil

L’outil n’a qu’une seule mise en forme et aucune option pour la changer : chaque { commence sur sa propre ligne, chaque } occupe une ligne seule, et ce qui se trouve à l’intérieur est indenté d’un niveau. Ainsi, else et catch commencent sur une nouvelle ligne après l’accolade fermante.

Entrée avec les accolades en fin de ligne :

<?php if ($age >= 18) { echo "adult"; } else { echo "minor"; }

Résultat :

<?php if ($age >= 18)
{
    echo "adult";
}
else
{
    echo "minor";
}

Quel style choisir ?

Les guides de style PHP courants placent l’accolade ouvrante d’une classe ou d’une méthode sur sa propre ligne, alors que les structures de contrôle comme if et foreach gardent l’accolade sur la même ligne que l’instruction. Cet outil applique la mise en forme à nouvelle ligne partout. C’est juste pour les classes et les méthodes, et un choix délibéré pour le reste. Si votre projet suit la convention mixte, il faudra remettre à la main les accolades des structures de contrôle sur la ligne de l’instruction.

Remarques pratiques

• Les blocs imbriqués continuent de s’enfoncer, donc une boucle dans une méthode d’une classe se retrouve à trois niveaux de profondeur.
• Les accolades fermantes sont suivies d’un saut de ligne, si bien qu’un } et le code qui le suit ne partagent jamais la même ligne.
• Les accolades placées dans des commentaires et dans des textes proches de chaînes, comme les heredocs, sont comptées comme de vraies accolades et peuvent décaler la mise en forme.
• Il n’existe aucune option pour garder l’accolade ouvrante sur la ligne de l’instruction. Cette page ne peut pas produire ce style.

Exemple avec une classe

Entrée :

<?php class User{private $name;public function getName(){return $this->name;}}

Résultat avec 4 espaces :

<?php class User
{
    private $name;
    public function getName()
    {
        return $this->name;
    }
}

L’accolade de la classe et celle de la méthode occupent chacune leur ligne, et le corps de la méthode est indenté d’un niveau de plus que la propriété au-dessus. Les accolades fermantes s’alignent sur la ligne qui les a ouvertes, si bien que vous pouvez associer les blocs à l’œil.

Mélanger avec votre propre style

Si seuls certains blocs doivent changer, collez uniquement ces blocs. Le résultat se réintègre facilement dans un fichier par copier-coller, car chaque bloc se termine à sa propre accolade fermante. Ne collez pas un fragment qui commence ou se termine au milieu d’un bloc, car la profondeur d’indentation part de zéro et ne correspondra pas au fichier qui l’entoure.