Code Style. PHP

Function declaration parentheses

If selected, a space is inserted before the opening parenthesis in function declarations. Otherwise, no space is inserted.

function foo ($x, $z) {}

function foo($x, $z) {}

Function call parentheses

If selected, a space is inserted before the opening parenthesis in function calls. Otherwise, no space is inserted.

$obj->foo ()->bar ();

$obj->foo()->bar();

Anonymous function parentheses

If selected, a space is inserted before the opening parenthesis in anonymous function declarations. Otherwise, no space is inserted.

$example = function () {};

$example = function() {};

'if' parentheses

If selected, a space is inserted before the opening parenthesis in if constructs. Otherwise, no space is inserted.

if ($x) {
    echo $x;
}

if($x) {
    echo $x;
}

'for' parentheses

If selected, a space is inserted before the opening parenthesis in for loops. Otherwise, no space is inserted.

for ($i = 0; $i < $x; $i++) {
    $y += $i;
}

for($i = 0; $i < $x; $i++) {
    $y += $i;
}

'while' parentheses

If selected, a space is inserted before the opening parenthesis in while loops. Otherwise, no space is inserted.

while ($x != $y) {
    echo ($x * 2);
}

while($x != $y) {
    echo ($x * 2);
}

'switch' parentheses

If selected, a space is inserted before the opening parenthesis in switch statements. Otherwise, no space is inserted.

switch ($i) {
    case 0:
        echo "i equals 0";
        break;
    case 1:
        echo "i equals 1";
        break;
}

switch($i) {
    case 0:
        echo "i equals 0";
        break;
    case 1:
        echo "i equals 1";
        break;
}

'catch' parentheses

If selected, a space is inserted before the opening parenthesis in catch constructs. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
}

try {
    get($x);
} catch(Exception $e) {
}

Array initializer parentheses

If selected, a space is inserted before the opening parenthesis in array declarations. Otherwise, no space is inserted.

$array = array (0 => "zero", 1 => "one");

$array = array(0 => "zero", 1 => "one");

Arrow function parentheses

If selected, a space is inserted before the opening parenthesis in anonymous function declarations. Otherwise, no space is inserted.

$double = fn ($x) => $x * 2;

$double = fn($x) => $x * 2;

Assignment operators (=, +=, ...)

If selected, spaces are inserted around assignment operators in assignment expressions. Otherwise, no spaces are inserted.

$var = f($a);

$var=f($a);

Logical operators (&&, ||)

If selected, spaces are inserted around logical operators in logical expressions. Otherwise, no spaces are inserted.

$var = $a && $b;

$var = $a&&$b;

Equality operators (==, =)

If selected, spaces are inserted around equality operators in comparison expressions. Otherwise, no spaces are inserted.

if ($a == $b) {};

if ($a==$b) {};

Relational operators (<, >, <=, >=)

If selected, spaces are inserted around relational operators in comparison expressions. Otherwise, no spaces are inserted.

if ($a > $b) {};

if ($a>$b) {};

Bitwise operators (&, |, ^)

If selected, spaces are inserted around bitwise operators. Otherwise, no spaces are inserted.

$var += ($var ^ 0x123);

$var += ($var^0x123);

Additive operators (+, -)

If selected, spaces are inserted around additive operators. Otherwise, no spaces are inserted.

$var = $a + $b;

$var = $a+$b;

Multiplicative operators (*, /, %, **)

If selected, spaces are inserted around multiplicative operators. Otherwise, no spaces are inserted.

$var = $a * $b;

$var = $a*$b;

Shift operators (<<, >>, >>>)

If selected, spaces are inserted around bit shifting operators. Otherwise, no spaces are inserted.

$var = $a << 1;

$var = $a<<1;

Unary additive operators (+,-,++,--)

If selected, spaces are inserted around unary additive operators. Otherwise, no spaces are inserted.

for ($i = 0; $i < $x; $i ++) {}

for ($i = 0; $i < $x; $i++) {}

Concatenation (.)

If selected, spaces are inserted around the . concatenation operator. Otherwise, no spaces are inserted.

echo "The result is " . $i;

echo "The result is ".$i;

Object access operator (->)

If selected, spaces are inserted around the -> object access operator. Otherwise, no spaces are inserted.

$obj -> foo() -> bar();

$obj->foo()->bar();

Null coalescing operator (??)

If selected, spaces are inserted around the ?? null coalescing operator. Otherwise, no spaces are inserted.

foo() ?? bar();

foo()??bar();

Assignment in declare statement

If selected, spaces are inserted around the assignment operator in the declare statement. Otherwise, no spaces are inserted.

declare(strict_types = 1);

declare(strict_types=1);

Class left brace

If selected, a space is inserted between the class name and the opening brace in class declarations. Otherwise, no space is inserted.

class Class1 {
    function Foo() {}
}

class Class1{
    function Foo() {}
}

Selecting or clearing the checkbox is relevant only when Braces placement for In class declaration is set to End of line on the Wrapping and Braces tab.

Function left brace

If selected, a space is inserted between the function parameters' list closing parenthesis and the opening brace in function declarations. Otherwise, no space is inserted.

function foo() {}

function foo(){}

Selecting or clearing the checkbox is relevant only when Braces placement for In function declaration is set to End of line on the Wrapping and Braces tab.

'if' left brace

If selected, a space is inserted between the conditional expression's closing parenthesis and the opening brace in if statements. Otherwise, no space is inserted.

if ($x) {
    echo $x;
}

if ($x){
    echo $x;
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'else' left brace

If selected, a space is inserted between the else keyword and the opening brace in if-else statements. Otherwise, no space is inserted.

if ($x) {
    echo $x;
} else {
    echo $y;
}

if ($x) {
    echo $x;
} else{
    echo $y;
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'for' left brace

If selected, a space is inserted between the conditional expression's closing parenthesis and the opening brace in for loops. Otherwise, no space is inserted.

for ($i = 0; $i < $y; $i++) {
    $str = $arr[$i];
}

for ($i = 0; $i < $y; $i++){
    $str = $arr[$i];
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'while' left brace

If selected, a space is inserted between the conditional expression's closing parenthesis and the opening brace in while loops. Otherwise, no space is inserted.

while ($var != $x) {
    $var++;
}

while ($var != $x){
    $var++;
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'do' left brace

If selected, a space is inserted between the do keyword and the opening brace in do-while loops. Otherwise, no space is inserted.

do {
    echo $var;
} while ($var > 0);

do{
    echo $var;
} while ($var > 0);

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'switch' left brace

If selected, a space is inserted between the conditional expression's closing parenthesis and the opening brace in switch statements. Otherwise, no space is inserted.

switch ($i) {
    case 0:
        $var = 'zero';
        break;
    default:
        $var = 'other';
}

switch ($i){
    case 0:
        $var = 'zero';
        break;
    default:
        $var = 'other';
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'try' left brace

If selected, a space is inserted between the try keyword and the opening brace in try blocks. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
}

try{
    get($x);
} catch (Exception $e) {
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'catch' left brace

If selected, a space is inserted between the catch statement arguments list and the opening brace in catch blocks. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
}

try{
    get($x);
} catch (Exception $e){
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'finally' left brace

If selected, a space is inserted between the finally keyword and the opening brace in finally blocks. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
} finally {
}

try {
    get($x);
} catch (Exception $e) {
} finally{
}

Selecting or clearing the checkbox is relevant only when Braces placement for Other is set to End of line on the Wrapping and Braces tab.

'else' keyword

If selected, a space is inserted between the closing brace of an if block and an else/elseif keyword. Otherwise, no space is inserted.

if ($x) {
    echo $x;
} else {
    echo $y;
}

if ($x) {
    echo $x;
}else {
    echo $y;
}

'while' keyword

If selected, a space is inserted between the closing brace of a do block and the while keyword in do-while loops. Otherwise, no space is inserted.

do {
    echo $var;
} while ($var > 0);

do {
    echo $var;
}while ($var > 0);

'catch' keyword

If selected, a space is inserted between the closing brace of a try block and the catch keyword. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
}

try{
    get($x);
}catch (Exception $e){
}

'finally' keyword

If selected, a space is inserted between the closing brace of a catch block and the finally keyword. Otherwise, no space is inserted.

try {
    get($x);
} catch (Exception $e) {
} finally {
}

try {
    get($x);
} catch (Exception $e) {
}finally {
}

Brackets

If selected, spaces within brackets are always inserted. Otherwise, spaces are never inserted.

Brackets around variable/expression

If selected, PhpStorm inserts spaces inside brackets during reformatting only if the brackets enclose a variable or an expression. This setting affects reformatting only if you have not configured force insertion of spaces inside brackets by selecting the Brackets checkbox under the Within node in the Spaces tab.

This option helps you keep your code in accordance with the WordPress PHP Coding Standards.

If the checkbox is cleared, the spaces insertion policy depends on the Brackets setting regardless of the type of content inside brackets.

Array initializer parentheses

If selected, spaces inside parentheses in array initializer expressions are always inserted. Otherwise, no spaces are inserted.

$array = array( 0 => "zero", 1 => "one" );

$array = array(0 => "zero", 1 => "one");

Grouping parentheses

If selected, spaces inside grouping parentheses in complex expressions are always inserted. Otherwise, no spaces are inserted.

$var += ( $var ^ 0x123 ) << 2;

$var += ($var ^ 0x123) << 2;

Function declaration parentheses

If selected, spaces inside parentheses in function declarations are always inserted. Otherwise, no spaces are inserted.

function foo( $x, $z ) {}

function foo($x, $z) {}

Function call parentheses

If selected, spaces inside parentheses in function calls are always inserted. Otherwise, no spaces are inserted.

foo( $x, $z );

foo($x, $z) {};

'if' parentheses

If selected, spaces inside parentheses in if statements are always inserted. Otherwise, no spaces are inserted.

if ( $x ) {
    echo $x;
}

if ($x) {
    echo $x;
}

'for' parentheses

If selected, spaces inside parentheses in for loops are always inserted. Otherwise, no spaces are inserted.

for ( $i = 0; $i < $x; $i++ ) {
    $y += $i;
}

for ($i = 0; $i < $x; $i++) {
    $y += $i;
}

'while' parentheses

If selected, spaces inside parentheses in while loops are always inserted. Otherwise, no spaces are inserted.

while ( $x != $y ) {
    echo ($x * 2);
}

while ($x != $y) {
    echo ($x * 2);
}

'switch' parentheses

If selected, spaces inside parentheses in switch statements are always inserted. Otherwise, no spaces are inserted.

switch ( $i ) {
    default:
        echo "i equals 0";
        break;
}

switch($i) {
    default:
        echo "i equals 0";
        break;
}

'catch' parentheses

If selected, spaces inside parentheses in catch constructs are always inserted. Otherwise, no spaces are inserted.

try {
    get($x);
} catch ( Exception $e ) {
}

try {
    get($x);
} catch (Exception $e) {
}

<=and ?>

If selected, spaces inside the opening and closing PHP tags (<?= and ?>) are always inserted. Otherwise, no spaces are inserted.

<div><?= echo foo(); ?></div>

<div><?=echo foo();?></div>

Before '?'

After '?'

Before ':'

After ':'

Between '?' and ':'

Select the checkboxes in this section to have spaces automatically inserted around ?, around :, and between ? and : in ternary (conditional) operators.

For example, if Before '?' and After ':' are selected, PhpStorm automatically inserts spaces before ? and after : in ternary conditional expressions. Otherwise, no spaces are inserted.

$var = $x > 0 ?1: 2;

$var = $x > 0?1:2;

Before comma / After comma

If selected, spaces are automatically inserted before/after commas in parameter lists, argument lists, array declarations, and so on. Otherwise, no spaces are inserted.

function foo ($x , $z) {}

function foo ($x,$z) {}

Before 'for' semicolon / After 'for' semicolon

If selected, spaces are automatically inserted before/after semicolons in for loops. Otherwise, no spaces are inserted.

for($i = 0 ; $i < $x ; $i++) {
    $y += $i;
}

for($i = 0;$i < $x;$i++) {
    $y += $i;
}

After type cast

If selected, a space is automatically inserted after the closing parenthesis of a cast. Otherwise, no space is inserted and the casted variable sticks to the cast.

$fst = (string) $foo;

$fst = (string)$foo;

Before colon in return type / After colon in return type

If selected, spaces are automatically inserted before/after colons in function return type declarations. Otherwise, no spaces are inserted.

function foo() : int {}

function foo():int {}

Around | in union type

If selected, spaces are automatically inserted around the pipe symbol | in union types' declarations. Otherwise, no spaces are inserted.

function returnNumber (
    int | float $number)
    : int | float {}

function returnNumber (
    int|float $number)
    : int|float {}

Before colon in named argument / After colon in named argument

If selected, spaces are automatically inserted before/after colons in named arguments. Otherwise, no spaces are inserted.

foo(start : $a, end : $b);

foo(start:$a, end:$b);

Before colon next to type declaration in backed enum / After colon next to type declaration in backed enum

If selected, spaces are automatically inserted before/after colons in backed enums' type declarations. Otherwise, no spaces are inserted.

enum Suit : string {
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

enum Suit:string {
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

Before unary Not (!) / After unary Not (!)

If selected, spaces are automatically inserted before/after unary Not ! operators. Otherwise, no spaces are inserted.

if ( ! 0 > $x &&  ! $x < 10) {}

if (!0 > $x && !$x < 10) {}

Hard wrap at

Use this field to specify a margin space required on the right side of an element. If you select the Default option, then a value of the right margin from the global settings is used.

Wrap on typing

Use these settings to specify how the edited text is fitted in the specified Hard wrap at:

• Default: in this case PhpStorm uses the Wrap on typing option that is specified in the global settings.

• Yes: in this case PhpStorm uses the value specified in the Right Margin field.

• No: in this case this option is switched off and a line can exceed the value specified in the right margin.

Visual guides

Use this field to specify multiple right margins. You can leave a default value or enter the number of spaces for your margin. If you want to specify several margins, enter numbers separated by comma.

Line breaks

If selected, line breaks will be kept after reformatting the code. Otherwise, the lines that are shorter than a standard convention will be merged into one line.

Comment at first column

If selected, comments placed at the first column won't change their position after reformatting the code. Otherwise, such comments will align with the next line of code.

Control statement in one line

If selected, control statements will be placed in line after reformatting the code. Otherwise, they will be placed on multiple lines.

if (true) $x = 10;
elseif ($y < 10) $x = 5;
else if (true) $x = 5;

if (true)
    $x = 10;
elseif ($y < 10)
    $x = 5;
else if (true)
    $x = 5;

Simple methods in one line

If selected, simple methods will be kept in line after reformatting the code. Otherwise, they will expand into multiple lines.

class Foo() {
    public function bar() { }
}

class Foo() {
    public function bar() {
    }
}

Simple classes in one line

If selected, simple classes will be kept in line after reformatting the code. Otherwise, they will expand into multiple lines.

class Foo() { }

class Foo() {
}

End of line

If selected, the opening brace is placed at the declaration line end.

Next line if wrapped

If selected, the opening brace is placed at the beginning of the line after the multiline declaration line.

Next line

If selected, the opening brace is placed at the beginning of the line after the declaration line.

Next line shifted

If selected, the opening brace is placed at the line after the declaration line being shifted to the corresponding indent level.

Next line, each shifted

If selected, the opening brace is placed at the line after the declaration line being shifted to the corresponding indent level, and have the next line shifted to the next indent level as well.

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each item in an extends or an implements list, which after wrapping starts on a new line, is aligned by the first item, which remains unwrapped.

When the checkbox is cleared, the position of each item in a wrapped list is determined by the chosen indentation level.

The status of the checkbox affects the formatting only if you have chosen to wrap lists, if the Do not wrap option is chosen, selecting or clearing the checkbox has no effect.

class Foo extends
Class1 implements Class2,
                  Class3,
                  Class4 {
}

class Foo extends
Class1 implements
Class2,
Class3,
Class4 {
}

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each parameter in a parameters list which after wrapping starts on a new line, is aligned by the first parameter, which remains unwrapped.

When the checkbox is cleared, the position of each item in a wrapped list is determined by the chosen indentation level.

The status of the checkbox affects the formatting only if you have chosen to wrap lists, if the Do not wrap option is chosen, selecting or clearing the checkbox has no effect.

function bar($x,
             $y,
             int $z = 1) {}

function bar($x,
    $y,
    int $z = 1) {}

New line after '('

If selected, parameters in function/method declarations are displayed on a new line after the opening parenthesis. Otherwise, they are displayed on the same line.

When the checkbox is cleared, the position of each item in a wrapped list is determined by the chosen indentation level.

The status of the checkbox affects the formatting only if you have chosen to wrap lists, if the Do not wrap option is chosen, selecting or clearing the checkbox has no effect.

function bar(
$x,
$y,
int) {}

function bar($x, $y, $z) {}

Place ')' on new line

If selected, the closing parenthesis in a function/method declaration is placed on a new line. Otherwise, it is displayed on the same line with the last parameter.

function bar(
    $x,
    $y,
    int
) {}

function bar(
    $x,
    $y,
    int) {}

Keep ')' and '{' on one line

If selected, the opening curly brace is displayed on the same line as the function parameters. Otherwise, the opening curly brace is moved to the next line.

function Foo() {
}

function Foo()
{
}

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each argument in a function call which after wrapping starts on a new line, is aligned by the first argument, which remains unwrapped.

When the checkbox is cleared, the position of each item in a wrapped list is determined by the chosen indentation level.

The status of the checkbox affects the formatting only if you have chosen to wrap lists, if the Do not wrap option is chosen, selecting or clearing the checkbox has no effect.

$result = foo("arg1",
              "arg2", true);

$result = foo("arg1",
    "arg2", true);

New line after '('

If selected, arguments in function calls are displayed on a new line after the opening parenthesis. Otherwise, they are displayed on the same line.

$result = foo("arg1", "arg2", true);

$result = foo(
    "arg1", "arg2", true);

Place ')' on new line

If selected, the closing parenthesis in a function call is placed on a new line. Otherwise, it is displayed on the same line with the last argument.

$result = foo("arg1",
    "arg2",
    true
);

$result = foo("arg1",
"arg2",
true);

Place '()' for constructor

Choose whether PhpStorm should automatically add braces in construct statements without parameters during reformatting the code.

• As is: existing braces are preserved and no new ones are added.

• Always: braces are always added.

• Never: braces are always removed.

$var = new ExampleClass();

$var = new ExampleClass;

Align named arguments

If selected, named arguments in a function call are aligned against the rightmost one. Otherwise, they are aligned according to the indentation settings.

foo(
    start : $a,
      end : $b
);

foo(
    start : $a,
    end : $b
);

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each called method, which after wrapping is positioned on a new line, is aligned by the first one, which remains unwrapped.

When the checkbox is cleared, the position of each item in a wrapped list is determined by the chosen indentation level.

The status of the checkbox affects the formatting only if you have chosen to wrap lists, if the Do not wrap option is chosen, selecting or clearing the checkbox has no effect.

$x = $x->one( "a", "b" )
       ->two( "c", "d", "e" )
       ->three( "fg" )
       ->four();

$x = $x->one( "a", "b" )
    ->two( "c", "d", "e" )
    ->three( "fg" )
    ->four();

Place ';' on new line

If selected, the semicolon ; is moved to a new line after the last item in a chained call. Otherwise, it is displayed on the same line.

$x = $x->one( "a", "b" )
       ->two( "c", "d", "e" )
       ->three( "fg" )
       ->four()
;

$x = $x->one( "a", "b" )
       ->two( "c", "d", "e" )
       ->three( "fg" )
       ->four();

New line before first element

If selected, conditional expressions are moved to the next line after the opening parenthesis in if statements. Otherwise, they stay on the same line.

if (
    $var == "one") { }

if ($var == "one") { }

New line after last element

If selected, closing braces of conditional expressions in if statements are moved to the next line. Otherwise, they stay on the same line.

if ($var == "one"
    ) { }

if ($var == "one") { }

Force braces

Choose the braces introduction method for if statements:

• Do not force: select this option to suppress introducing braces automatically.

• When multiline: select this option to have braces introduced automatically if a statement occupies more than one line. Note that PhpStorm analyzes the number of lines in the entire statement but not only its condition.

• Always: select this checkbox to have braces always introduced automatically.

'else' on new line

If selected, the else keyword is moved to a new line in if-else statements. Otherwise, it stays on the same line with a preceding statement.

if ($var == "one") { }
else $var = true;

if ($var == "one") { } else $var = true;

Special 'else if' treatment

If selected, else if constructs are treated specially and not split during reformatting. Otherwise, they are split into a nested else-if structure.

The status of the checkbox affects formatting only if you have chosen to force braces in if statements. If the Do not force option is selected, the Special 'else if' treatment checkbox has no effect.

if (true) $x = 10;
    else if ($y < 10) $x = 5;
else $x = 0;

if (true) {
    $x = 10;
} else {
    if ($y < 10) {
        $x = 5;
    }
else $x = 0;

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

When the checkbox is selected and the New line before first element checkbox is cleared, each item in a for / foreach loop expression, which after wrapping starts on a new line, is aligned by the first item, which remains unwrapped.

for ($i = 0;
     $i < $x;
     $i++) {
    $y += $i;
}

for ($i = 0;
    $i < $x;
    $i++) {
    $y += $i;
}

New line after '('

If selected, expressions in for / foreach loops are displayed on the next line after the opening parenthesis. Otherwise, they are displayed on the same line.

for (
    $i = 0; $i < $a; $i++) {
    $y += $i;
}

for ($i = 0; $i < $a; $i++) {
    $y += $i;
}

Place ')' on new line

If selected, closing braces in for / foreach loops are displayed on the next line after the expression. Otherwise, they are displayed on the same line.

for (
    $i = 0; $i < $a; $i++
) {
    $y += $i;
}

for ($i = 0; $i < $a; $i++) {
    $y += $i;
}

Force braces

Choose the braces introduction method for for / foreach loops:

• Do not force: select this option to suppress introducing braces automatically.

• When multiline: select this option to have braces introduced automatically if a statement occupies more than one line. Note that PhpStorm analyzes the number of lines in the entire statement but not only its condition.

• Always: select this checkbox to have braces always introduced automatically.

Force braces

Choose the braces introduction method for while loops:

• Do not force: select this option to suppress introducing braces automatically.

• When multiline: select this option to have braces introduced automatically if a statement occupies more than one line. Note that PhpStorm analyzes the number of lines in the entire statement but not only its condition.

• Always: select this checkbox to have braces always introduced automatically.

Force braces

Choose the braces introduction method for do-while loops:

• Do not force: select this option to suppress introducing braces automatically.

• When multiline: select this option to have braces introduced automatically if a statement occupies more than one line. Note that PhpStorm analyzes the number of lines in the entire statement but not only its condition.

• Always: select this checkbox to have braces always introduced automatically.

'while' on new line

If selected, the while keyword is moved to the next line after a do block in do-while loops. Otherwise, it stays on the same line.

do {
    echo $var;
}
while ($var > 0);

do{
    echo $var;
} while ($var > 0);

Indent 'case' branches

If selected, case statements are indented relative to the switch statement. Otherwise, they are placed at the same indent level.

switch ($i) {
    case 0:
        echo "i equals 0";
        break;
    case 1:
        echo "i equals 1";
        break;
}

switch ($i) {
case 0:
    echo "i equals 0";
    break;
case 1:
    echo "i equals 1";
    break;
}

Indent 'break' from 'case'

If selected, break statements are indented relative to case statements. Otherwise, they are placed at the same indent level.

switch ($i) {
    case 0:
        echo "i equals 0";
        break;
    case 1:
        echo "i equals 1";
        break;
}

switch ($i) {
    case 0:
        echo "i equals 0";
    break;
    case 1:
        echo "i equals 1";
    break;
}

'catch' on new line

If selected, catch statements are placed on the next line after the closing brace of a try block. Otherwise, they are placed on the same line.

try {
    get($x);
}
catch (Exception $e) {
}

try {
    get($x);
} catch (Exception $e) {
}

'finally' on new line

If selected, finally statements are placed on the next line after the closing brace of a catch block. Otherwise, they are placed on the same line.

try {
    get($x);
} catch (Exception $e) {
}
finally {
}

try {
    get($x);
} catch (Exception $e) {
} finally {
}

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each operand in a binary operation, which after wrapping starts on a new line, is aligned by the first item, which remains unwrapped. Otherwise, operands are indented according to the indentation settings.

function foo($a, $b, $c) {
    return $a +
           $b +
           $c;
}

function foo($a, $b, $c) {
    return $a +
       $b +
       $c;
}

Operation sign on next line

If selected, operators in binary operations are moved to the next line together with the wrapped right operand. Otherwise, operators stay on the previous line together with the left operand.

function foo($a, $b, $c) {
    return $a
           + $b
           + $c;
}

function foo($a, $b, $c) {
    return $a +
           $b +
           $c;
}

New line after '('

If selected, a new line is added after the opening parenthesis and the binary expression is moved to this line. Otherwise, an expression stays on the same line with the opening parenthesis.

$a = $b + (
    $c + $d);

$a = $b + ($c + $d);

Place ')' on new line

If selected, a closing parenthesis is moved to a new line after the binary expression. Otherwise, the parenthesis stays on the same line with the expression.

$a = $b + ($c + $d
);

$a = $b + ($c + $d);

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Assignment sign on next line

If selected, assignment signs in assignment statements are moved to the next line together with the wrapped right operand. Otherwise, operators stay on the previous line together with the left operand.

var $numbers
    = array("one", "two", "three");

var $numbers =
    array("one", "two", "three");

Align consecutive assignments

If selected, the assignment signs in consecutive assignment statements are aligned by the rightmost one. Otherwise, no alignment is applied.

$y            = foo( $x );
$i = foo( $i );
$result       = $result . $y . $i;

$y = foo( $x );
$i = foo( $i );
$result = $result . $y . $i;

Align properties in columns

If selected, class properties' declarations are aligned by the rightmost one. Otherwise, no alignment is applied.

class Foo {
    public    $a;
    protected $b;
    private   $c
}

class Foo {
    public $a;
    protected $b;
    private $c
}

Align constants

If selected, grouped constants' declarations are aligned by the rightmost one. Otherwise, no alignment is applied.

class Foo {
    const ONE   = 1;
    const TWO   = 2;
    const THREE = 3;
}

class Foo {
    const ONE = 1;
    const TWO = 2;
    const THREE = 3;
}

Align enum cases

If selected, assigned values in backed enumerations are aligned by the rightmost one. Otherwise, no alignment is applied.

enum Suit: string {
case Clubs = '♣';
case Diamonds = '♦';
case Hearts = '♥';
case Spades = '♠';
}

enum Suit: string {
case Clubs    = '♣';
case Diamonds = '♦';
case Hearts   = '♥';
case Spades   = '♠';
}

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

'?' and ':' signs on next line

If selected, the ? and : symbols are moved to the next line together with the wrapped right operand. Otherwise, they stay on the previous line together with the left operand.

echo ($result == 42)
    ? "Passed"
    : " Failed";

echo ($result == 42) ?
    "Passed" :
    " Failed";

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Align when multiline

If selected, each array element, which after wrapping is positioned on a new line, is aligned by the first one, which remains unwrapped. Otherwise, all the elements are aligned according to the indentation settings.

$arr = [0.1,
        0.2,
        0.3,
        0.4
];

$arr = [0.1,
    0.2,
    0.3,
    0.4
];

Selecting or clearing the Align when multiline checkbox affects formatting only if you have chosen to wrap lists. If the Do not wrap option is chosen, the status of the checkboxes has no effect.

Align key-value pairs

If selected, all key-value array elements are aligned against the rightmost assignment operator =>. Otherwise, all the elements are aligned according to the indentation settings.

$arr = [0    => "value 1",
        1234 => "value 2",
        56   => "value 3"
];

$arr = [0 => "value 1",
    1234 => "value 2",
    56   => "value 3"
];

New line before first element

If selected, the first element of the array is displayed on a new line and all the elements of the array are aligned according to the indentation settings, regardless of the status of the Align when multiline checkbox. Otherwise, the first element of the array remains on the same line, and the other elements are aligned according to the indentation settings.

$arr = [
    "value 1",
    "value 2",
    "value 3"
];

$arr = ["value 1",
        "value 2",
        "value 3"
];

New line after last element

If selected, the closing parenthesis is displayed on a separate line. Otherwise, it remains on the same line together with the last element of the array.

$arr = ["value 1",
        "value 2",
        "value 3"
];

$arr = ["value 1",
        "value 2",
        "value 3"];

Wrap after modifier list

If selected, the code is wrapped after a list of visibility modifiers. Otherwise, no wrapping is performed.

protected
function Foo() {
}

protected function Foo() {
}

Return type on new line

If selected, functions' return type declarations are placed on the next line. Otherwise, they stay on the same line.

function foo()
: int {
}

function foo() : int {
}

Align inline comments

If selected, inline comments located on consecutive lines are aligned by the rightmost comment.

echo "one"; //one
echo "two"; //two
echo "three"; //three

echo "one";   //one
echo "two";   //two
echo "three"; //three

New line after '<?php' tag

If selected, the code is moved to the next line after the opening <?php tag. Otherwise, it stays on the same line.

<?php
echo "Message";

<?php echo "Message";

Align 'match' arm bodies

If selected, all expressions in match arms are aligned against the rightmost operator =>. Otherwise, the expressions are aligned according to the indentation settings.

match ($i) {
    0       => 'zero',
    42      => 'forty-two',
    default => 'none'
};

match ($i) {
    0 => 'zero',
    42 => 'forty-two',
    default => 'none'
};

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

• Chop down if long: select this option to have elements in lists that go beyond the right margin wrapped, so that there is one element per line with proper indentation.

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.

Common wrapping options

• Do not wrap: when this option is selected, no special wrapping style is applied.

  With this option selected, the nested alignment and braces settings are ignored.

• Wrap if long: select this option to have lines going beyond the right margin wrapped with proper indentation.

• Wrap always: select this option to have all elements in lists wrapped, so that there is one element per line with proper indentation.