Fork me on GitHub
a Sensio Labs Product

Remote Void (v2.18.5) edition

Rule phpdoc_return_self_reference

The type of @return annotations of methods returning a reference to itself must the configured one.

Configuration

replacements

Mapping between replaced return types with new ones.

Allowed types: array

Default value: ['this' => '$this', '@this' => '$this', '$self' => 'self', '@self' => 'self', '$static' => 'static', '@static' => 'static']

Examples

Example #1

Default configuration.

--- Original
+++ New
 <?php
 class Sample
 {
     /**
-     * @return this
+     * @return $this
      */
     public function test1()
     {
         return $this;
     }

     /**
-     * @return $self
+     * @return self
      */
     public function test2()
     {
         return $this;
     }
 }

Example #2

With configuration: ['replacements' => ['this' => 'self']].

--- Original
+++ New
 <?php
 class Sample
 {
     /**
-     * @return this
+     * @return self
      */
     public function test1()
     {
         return $this;
     }

     /**
      * @return $self
      */
     public function test2()
     {
         return $this;
     }
 }

Rule sets

The rule is part of the following rule sets:

@PhpCsFixer

Using the @PhpCsFixer rule set will enable the phpdoc_return_self_reference rule with the default config.

@Symfony

Using the @Symfony rule set will enable the phpdoc_return_self_reference rule with the default config.

The logo is © 2010-2014 Sensio Labs