Support for self in phpdoc

This is typically useful in traits that would accept a parameter of
their own type.

Author: PowerKiKi

src/Factory/AbstractFieldsConfigurationFactory.php

@@ -160,6 +160,10 @@ final protected function getTypeFromPhpDeclaration(ReflectionMethod $method, ?st
      */
     private function adjustNamespace(ReflectionMethod $method, string $type): string
     {
+        if ($type === 'self') {
+            $type = $method->getDeclaringClass()->getName();
+        }
+
         $namespace = $method->getDeclaringClass()->getNamespaceName();
         if ($namespace) {
             $namespace = $namespace . '\\';

tests/Blog/Model/Special/SelfSupport.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace GraphQLTests\Doctrine\Blog\Model\Special;
+
+use Doctrine\ORM\Mapping as ORM;
+use GraphQLTests\Doctrine\Blog\Model\AbstractModel;
+
+/**
+ * @ORM\Entity
+ */
+final class SelfSupport extends AbstractModel
+{
+    private $sibling;
+
+    /**
+     * @return null|self
+     */
+    public function getSibling(): ?self
+    {
+        return $this->sibling;
+    }
+
+    /**
+     * @param self $sibling
+     */
+    public function setSibling(self $sibling): void
+    {
+        $this->sibling = $sibling;
+    }
+}

tests/InputTypesTest.php

@@ -34,6 +34,12 @@ public function testDefaultValuesPartialInput(): void
         $this->assertType('tests/data/DefaultValuePartialInput.graphqls', $actual);
     }
 
+    public function testSelfSupportInput(): void
+    {
+        $actual = $this->types->getInput(Blog\Model\Special\SelfSupport::class);
+        $this->assertType('tests/data/SelfSupportInput.graphqls', $actual);
+    }
+
     public function testInputWithoutTypeMustThrow(): void
     {
         $this->expectExceptionMessage('Could not find type for parameter `$bar` for method `GraphQLTests\Doctrine\Blog\Model\Special\NoTypeInput::setFoo()`. Either type hint the parameter, or specify the type with `@API\Input` annotation.');

tests/OutputTypesTest.php

@@ -47,6 +47,12 @@ public function testDefaultValuesOutput(): void
         $this->assertType('tests/data/DefaultValue.graphqls', $actual);
     }
 
+    public function testSelfSupportOutput(): void
+    {
+        $actual = $this->types->getOutput(Blog\Model\Special\SelfSupport::class);
+        $this->assertType('tests/data/SelfSupport.graphqls', $actual);
+    }
+
     public function testFieldWithoutTypeMustThrow(): void
     {
         $this->expectExceptionMessage('Could not find type for method `GraphQLTests\Doctrine\Blog\Model\Special\NoType::getWithoutTypeHint()`. Either type hint the return value, or specify the type with `@API\Field` annotation.');

tests/data/SelfSupport.graphqls

@@ -0,0 +1,5 @@
+type SelfSupport {
+  sibling: SelfSupport
+  id: ID!
+  creationDate: DateTime!
+}

tests/data/SelfSupportInput.graphqls

@@ -0,0 +1,4 @@
+input SelfSupportInput {
+  sibling: SelfSupportID!
+  creationDate: DateTime!
+}