Fork me on GitHub
a Sensio Labs Product

I ate three cookies 🍪 (v3.40.2) edition

Rule phpdoc_tag_type

Forces PHPDoc tags to be either regular annotations or inline.

Configuration

tags

The list of tags to fix.

Allowed types: array

Default value: ['api' => 'annotation', 'author' => 'annotation', 'copyright' => 'annotation', 'deprecated' => 'annotation', 'example' => 'annotation', 'global' => 'annotation', 'inheritDoc' => 'annotation', 'internal' => 'annotation', 'license' => 'annotation', 'method' => 'annotation', 'package' => 'annotation', 'param' => 'annotation', 'property' => 'annotation', 'return' => 'annotation', 'see' => 'annotation', 'since' => 'annotation', 'throws' => 'annotation', 'todo' => 'annotation', 'uses' => 'annotation', 'var' => 'annotation', 'version' => 'annotation']

Examples

Example #1

Default configuration.

--- Original
+++ New
 <?php
 /**
- * {@api}
+ * @api
  */

Example #2

With configuration: ['tags' => ['inheritdoc' => 'inline']].

--- Original
+++ New
 <?php
 /**
- * @inheritdoc
+ * {@inheritdoc}
  */

Rule sets

The rule is part of the following rule sets:

  • @PhpCsFixer with config:

    ['tags' => ['inheritDoc' => 'inline']]

  • @Symfony with config:

    ['tags' => ['inheritDoc' => 'inline']]

Source class

PhpCsFixer\Fixer\Phpdoc\PhpdocTagTypeFixer