Back to Php Cs Fixer

Rule ``blank_lines_before_namespace``

doc/rules/namespace_notation/blank_lines_before_namespace.rst

3.95.12.7 KB
Original Source

===================================== Rule blank_lines_before_namespace

Controls blank lines before a namespace declaration.

Warning

This rule is CONFIGURABLE


You can configure this rule using the following options: ``max_line_breaks``,
``min_line_breaks``.

Configuration
-------------

``max_line_breaks``
~~~~~~~~~~~~~~~~~~~

Maximum line breaks that should exist before namespace declaration.

Allowed types: ``int``

Default value: ``2``

``min_line_breaks``
~~~~~~~~~~~~~~~~~~~

Minimum line breaks that should exist before namespace declaration.

Allowed types: ``int``

Default value: ``2``

Examples
--------

Example #1
~~~~~~~~~~

*Default* configuration.

.. code-block:: diff

   --- Original
   +++ New
   -<?php  namespace A {}
   +<?php
   +
   +namespace A {}

Example #2
~~~~~~~~~~

With configuration: ``['min_line_breaks' => 1]``.

.. code-block:: diff

   --- Original
   +++ New
   -<?php  namespace A {}
   +<?php
   +namespace A {}

Example #3
~~~~~~~~~~

With configuration: ``['max_line_breaks' => 2]``.

.. code-block:: diff

   --- Original
   +++ New
    <?php

    declare(strict_types=1);

   -
   -
    namespace A{}

Example #4
~~~~~~~~~~

With configuration: ``['min_line_breaks' => 2]``.

.. code-block:: diff

   --- Original
   +++ New
    <?php

    /** Some comment */
   +
    namespace A{}

Example #5
~~~~~~~~~~

With configuration: ``['min_line_breaks' => 0, 'max_line_breaks' => 0]``.

.. code-block:: diff

   --- Original
   +++ New
   -<?php
   -
   -namespace A{}
   +<?php namespace A{}

Rule sets
---------

The rule is part of the following rule sets:

- `@PER <./../../ruleSets/PER.rst>`_ *(deprecated)*
- `@PER-CS <./../../ruleSets/PER-CS.rst>`_
- `@PER-CS1.0 <./../../ruleSets/PER-CS1.0.rst>`_ *(deprecated)*
- `@PER-CS1x0 <./../../ruleSets/PER-CS1x0.rst>`_
- `@PER-CS2.0 <./../../ruleSets/PER-CS2.0.rst>`_ *(deprecated)*
- `@PER-CS2x0 <./../../ruleSets/PER-CS2x0.rst>`_
- `@PER-CS3.0 <./../../ruleSets/PER-CS3.0.rst>`_ *(deprecated)*
- `@PER-CS3x0 <./../../ruleSets/PER-CS3x0.rst>`_
- `@PhpCsFixer <./../../ruleSets/PhpCsFixer.rst>`_
- `@PSR12 <./../../ruleSets/PSR12.rst>`_
- `@Symfony <./../../ruleSets/Symfony.rst>`_

References
----------

- Fixer class: `PhpCsFixer\\Fixer\\NamespaceNotation\\BlankLinesBeforeNamespaceFixer <./../../../src/Fixer/NamespaceNotation/BlankLinesBeforeNamespaceFixer.php>`_
- Test class: `PhpCsFixer\\Tests\\Fixer\\NamespaceNotation\\BlankLinesBeforeNamespaceFixerTest <./../../../tests/Fixer/NamespaceNotation/BlankLinesBeforeNamespaceFixerTest.php>`_

The test class defines officially supported behaviour. Each test case is a part of our backward compatibility promise.