UPDATE Method.php, MethodTest.php

- Modify the RegEx, so that an annotation like `@method static $this myMethod()` is parsed correctly
- Write a Unittest for that usecase

Author: Christoph Harms-Ensink

src/DocBlock/Tags/Method.php

@@ -91,10 +91,14 @@ public static function create(
                 )?
                 # Return type
                 (?:
-                    (
-                        (?:[\w\|_\\\\]+)
-                        # array notation           
-                        (?:\[\])*
+                    (   
+                        (?:[\w\|_\\\\]*\$this[\w\|_\\\\]*)
+                        |
+                        (?:
+                            (?:[\w\|_\\\\]+)
+                            # array notation           
+                            (?:\[\])*
+                        )
                     )?
                     \s+
                 )?

tests/unit/DocBlock/Tags/MethodTest.php

@@ -22,6 +22,7 @@
 use phpDocumentor\Reflection\Types\Integer;
 use phpDocumentor\Reflection\Types\Object_;
 use phpDocumentor\Reflection\Types\String_;
+use phpDocumentor\Reflection\Types\This;
 use phpDocumentor\Reflection\Types\Void_;
 
 /**
@@ -276,6 +277,29 @@ public function testFactoryMethod()
         $this->assertSame($description, $fixture->getDescription());
     }
 
+    public function testReturnTypeThis()
+    {
+        $descriptionFactory = m::mock(DescriptionFactory::class);
+        $resolver           = new TypeResolver();
+        $context            = new Context('');
+
+        $description  = new Description('');
+
+        $descriptionFactory->shouldReceive('create')->with('', $context)->andReturn($description);
+
+        $fixture = Method::create(
+            'static $this myMethod()',
+            $resolver,
+            $descriptionFactory,
+            $context
+        );
+
+        $this->assertTrue($fixture->isStatic());
+        $this->assertSame('static $this myMethod() ', (string)$fixture);
+        $this->assertSame('myMethod', $fixture->getMethodName());
+        $this->assertInstanceOf(This::class, $fixture->getReturnType());
+    }
+
     public function collectionReturnTypesProvider()
     {
         return [