A phpDoc template closing tag is mistakenly considered belonging to the following function

[morozov]

Consider the code example:

<?php

declare(strict_types=1);

namespace Test;

class Test
{
    /**#@+
     * Error codes.
     */
    public const ERR_1 = 1;
    public const ERR_2 = 2;
    /**#@-*/

    public function doStuff() : void
    {
    }
}

If a phpDoc template (example) is followed by a method without a docblock, then the "Squiz.Commenting.FunctionComment" sniff mistakenly attributes the closing template block to the method and marks it as invalid:

$ phpcs Test.php

------------------------------------------------------------------------------------------------
FOUND 1 ERROR AFFECTING 1 LINE
------------------------------------------------------------------------------------------------
 14 | ERROR | There must be no blank lines after the function comment
    |       | (Squiz.Commenting.FunctionComment.SpacingAfter)
------------------------------------------------------------------------------------------------

Although this specific rule is implemented using a component from the "Squiz" standard,

coding-standard/lib/Doctrine/ruleset.xml

Line 436 in 931c039

<rule ref="Squiz.Commenting.FunctionComment">

As per squizlabs/PHP_CodeSniffer#2838 (comment), the "Squiz" standard enforces docblocks and doesn't support docblock templates.

I'm filing the issue here to see if this specific rule can be reimplemented using some Slevomat building blocks which are better composable by design.