PHP-accolades op een nieuwe regel

Plaatsing van accolades in deze tool

De tool heeft één indeling en geen optie om die te wijzigen: elke { begint op een eigen regel, elke } staat op een eigen regel, en wat erin staat wordt één niveau ingesprongen. Daarom begint else en catch na de sluitingsaccolade op een nieuwe regel.

Invoer met accolades aan het eind van de regel:

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

Resultaat:

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

Welke stijl moet je gebruiken?

Veelgebruikte PHP-stijlgidsen zetten de openingsaccolade van een klasse of methode op een eigen regel, terwijl besturingsstructuren zoals if en foreach de accolade op dezelfde regel als de instructie houden. Deze tool past de indeling met nieuwe regel overal toe. Dat is juist voor klassen en methoden, en voor de rest een bewuste keuze. Volgt jouw project de gemengde conventie, dan moet je de accolades van besturingsstructuren zelf weer naar de instructieregel verplaatsen.

Praktische aandachtspunten

• Geneste blokken blijven inspringen, dus een lus in een methode in een klasse eindigt op drie niveaus diepte.
• Op sluitingsaccolades volgt een regeleinde, zodat een } en de code erna nooit op dezelfde regel staan.
• Accolades in commentaar en in tekst die op tekenreeksen lijkt, zoals heredocs, worden als echte accolades geteld en kunnen de indeling verschuiven.
• Er is geen instelling om de openingsaccolade op de instructieregel te houden. Deze pagina kan die stijl niet maken.

Een voorbeeld met een klasse

Invoer:

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

Resultaat met 4 spaties:

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

De accolade van de klasse en die van de methode staan elk op hun eigen regel, en de inhoud van de methode is één niveau dieper ingesprongen dan de eigenschap erboven. Sluitingsaccolades lijnen uit met de regel die ze opende, zodat je blokken met een blik kunt koppelen.

Combineren met je eigen stijl

Als maar een paar blokken moeten veranderen, plak dan alleen die blokken. Het resultaat is makkelijk terug te zetten in een bestand door te kopiëren en plakken, omdat elk blok eindigt bij zijn eigen sluitingsaccolade. Plak geen fragment dat midden in een blok begint of eindigt, want de inspringdiepte begint bij nul en komt dan niet overeen met het omringende bestand.