Fork me on GitHub
a Sensio Labs Product

7th Gear (v3.59.3) edition

Rule comment_to_phpdoc

Comments with annotation should be docblock when used on structural elements.


Using this rule is risky

Risky as new docblocks might mean more, e.g. a Doctrine entity might have a new column in database.



List of ignored tags.

Allowed types: list<string>

Default value: []


Example #1

Default configuration.

--- Original
+++ New
-<?php /* header */ $x = true; /* @var bool $isFoo */ $isFoo = true;
+<?php /* header */ $x = true; /** @var bool $isFoo */ $isFoo = true;

Example #2

With configuration: ['ignored_tags' => ['todo']].

--- Original
+++ New
 // @todo do something later
 $foo = 1;

-// @var int $a
+/** @var int $a */
 $a = foo();

Rule sets

The rule is part of the following rule set:


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