Nawias klamrowy PHP w nowym wierszu

Umieszczanie nawiasów klamrowych w tym narzędziu

Narzędzie ma jeden układ i nie ma dla niego opcji: każdy { zaczyna własny wiersz, każdy } stoi w osobnym wierszu, a to, co znajduje się wewnątrz, jest wcinane o jeden poziom. Dlatego else i catch zaczynają nowy wiersz po zamykającym nawiasie klamrowym.

Dane wejściowe z nawiasami klamrowymi na końcu wiersza:

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

Wynik:

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

Którego stylu użyć?

Popularne przewodniki stylu PHP umieszczają otwierający nawias klamrowy klasy lub metody w osobnym wierszu, podczas gdy struktury sterujące, takie jak if i foreach, zwykle trzymają nawias w tym samym wierszu co instrukcja. To narzędzie stosuje układ z nowym wierszem wszędzie. Dzięki temu wynik jest poprawny dla klas i metod, a w pozostałych przypadkach jest świadomym wyborem. Jeśli twój projekt stosuje konwencję mieszaną, nawiasy struktur sterujących musisz ręcznie przywrócić do wiersza instrukcji.

Praktyczne uwagi

• Zagnieżdżone bloki nadal są wcinane, więc pętla w metodzie w klasie znajdzie się na trzecim poziomie.
• Zamykający nawias klamrowy jest zawsze kończony podziałem wiersza, więc } i kod po nim nigdy nie dzielą wiersza.
• Nawiasy klamrowe w komentarzach i w tekście przypominającym strukturę, na przykład w heredoc, są liczone jak prawdziwe nawiasy i mogą przesunąć układ.
• Nie ma ustawienia, które zostawiłoby otwierający nawias w wierszu instrukcji. Ta strona nie potrafi wytworzyć takiego stylu.

Przykład z klasą

Dane wejściowe:

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

Wynik z 4 spacjami:

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

Nawias klasy i nawias metody stoją osobno, a ciało metody jest wcięte o poziom głębiej niż właściwość powyżej. Zamykające nawiasy wyrównują się z wierszem, który je otworzył, więc bloki można dopasować wzrokiem.

Łączenie z własnym stylem

Jeśli zmiany dotyczą tylko niektórych bloków, wklej tylko je. Wynik łatwo wkleić z powrotem do pliku, ponieważ każdy blok kończy się przy własnym zamykającym nawiasie. Nie wklejaj fragmentu, który zaczyna się lub kończy w środku bloku, bo głębokość wcięcia zaczyna się od zera i nie będzie zgodna z otaczającym plikiem.