doc/rules/basic/curly_braces_position.rst
curly_braces_positionCurly braces must be placed as configured.
This rule is DEPRECATED and will be removed in the next major version 4.0
You should use ``braces_position`` instead.
This rule is CONFIGURABLE
~~~~~~~~~~~~~~~~~~~~~~~~~
You can configure this rule using the following options:
``allow_single_line_anonymous_functions``,
``allow_single_line_empty_anonymous_classes``,
``anonymous_classes_opening_brace``, ``anonymous_functions_opening_brace``,
``classes_opening_brace``, ``control_structures_opening_brace``,
``functions_opening_brace``.
Configuration
-------------
``allow_single_line_anonymous_functions``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Allow anonymous functions to have opening and closing braces on the same line.
Allowed types: ``bool``
Default value: ``true``
Default value (future-mode): ``false``
``allow_single_line_empty_anonymous_classes``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Allow anonymous classes to have opening and closing braces on the same line.
Allowed types: ``bool``
Default value: ``true``
``anonymous_classes_opening_brace``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The position of the opening brace of anonymous classes‘ body.
Allowed values: ``'next_line_unless_newline_at_signature_end'`` and ``'same_line'``
Default value: ``'same_line'``
``anonymous_functions_opening_brace``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The position of the opening brace of anonymous functions‘ body.
Allowed values: ``'next_line_unless_newline_at_signature_end'`` and ``'same_line'``
Default value: ``'same_line'``
``classes_opening_brace``
~~~~~~~~~~~~~~~~~~~~~~~~~
The position of the opening brace of classes‘ body.
Allowed values: ``'next_line_unless_newline_at_signature_end'`` and ``'same_line'``
Default value: ``'next_line_unless_newline_at_signature_end'``
``control_structures_opening_brace``
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The position of the opening brace of control structures‘ body.
Allowed values: ``'next_line_unless_newline_at_signature_end'`` and ``'same_line'``
Default value: ``'same_line'``
``functions_opening_brace``
~~~~~~~~~~~~~~~~~~~~~~~~~~~
The position of the opening brace of functions‘ body.
Allowed values: ``'next_line_unless_newline_at_signature_end'`` and ``'same_line'``
Default value: ``'next_line_unless_newline_at_signature_end'``
Examples
--------
Example #1
~~~~~~~~~~
*Default* configuration.
.. code-block:: diff
--- Original
+++ New
<?php
-class Foo {
+class Foo
+{
}
-function foo() {
+function foo()
+{
}
-$foo = function()
-{
+$foo = function() {
};
-if (foo())
-{
+if (foo()) {
bar();
}
-$foo = new class
-{
+$foo = new class {
};
Example #2
~~~~~~~~~~
With configuration: ``['control_structures_opening_brace' => 'next_line_unless_newline_at_signature_end']``.
.. code-block:: diff
--- Original
+++ New
<?php
-if (foo()) {
+if (foo())
+{
bar();
}
Example #3
~~~~~~~~~~
With configuration: ``['functions_opening_brace' => 'same_line']``.
.. code-block:: diff
--- Original
+++ New
<?php
-function foo()
-{
+function foo() {
}
Example #4
~~~~~~~~~~
With configuration: ``['anonymous_functions_opening_brace' => 'next_line_unless_newline_at_signature_end']``.
.. code-block:: diff
--- Original
+++ New
<?php
-$foo = function () {
+$foo = function ()
+{
};
Example #5
~~~~~~~~~~
With configuration: ``['classes_opening_brace' => 'same_line']``.
.. code-block:: diff
--- Original
+++ New
<?php
-class Foo
-{
+class Foo {
}
Example #6
~~~~~~~~~~
With configuration: ``['anonymous_classes_opening_brace' => 'next_line_unless_newline_at_signature_end']``.
.. code-block:: diff
--- Original
+++ New
<?php
-$foo = new class {
+$foo = new class
+{
};
Example #7
~~~~~~~~~~
With configuration: ``['allow_single_line_empty_anonymous_classes' => true]``.
.. code-block:: diff
--- Original
+++ New
<?php
$foo = new class { };
-$bar = new class { private $baz; };
+$bar = new class {
+private $baz;
+};
Example #8
~~~~~~~~~~
With configuration: ``['allow_single_line_anonymous_functions' => true]``.
.. code-block:: diff
--- Original
+++ New
<?php
$foo = function () { return true; };
-$bar = function () { $result = true;
- return $result; };
+$bar = function () {
+$result = true;
+ return $result;
+};
References
----------
- Fixer class: `PhpCsFixer\\Fixer\\Basic\\CurlyBracesPositionFixer <./../../../src/Fixer/Basic/CurlyBracesPositionFixer.php>`_
- Test class: `PhpCsFixer\\Tests\\Fixer\\Basic\\CurlyBracesPositionFixerTest <./../../../tests/Fixer/Basic/CurlyBracesPositionFixerTest.php>`_
The test class defines officially supported behaviour. Each test case is a part of our backward compatibility promise.