Add Implements tags

Author: ahjdev

src/DocBlock/Tags/Factory/ImplementsFactory.php

@@ -5,13 +5,14 @@
 namespace phpDocumentor\Reflection\DocBlock\Tags\Factory;
 
 use Webmozart\Assert\Assert;
+use phpDocumentor\Reflection\DocBlock\Tag;
 use phpDocumentor\Reflection\TypeResolver;
 use phpDocumentor\Reflection\Types\Context;
-use phpDocumentor\Reflection\DocBlock\Tag;
+use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocTagNode;
 use phpDocumentor\Reflection\DocBlock\Tags\Implements_;
 use phpDocumentor\Reflection\DocBlock\DescriptionFactory;
-use PHPStan\PhpDocParser\Ast\PhpDoc\PhpDocTagNode;
 use PHPStan\PhpDocParser\Ast\PhpDoc\ImplementsTagValueNode;
+use phpDocumentor\Reflection\DocBlock\Tags\TemplateImplements;
 
 /**
  * @internal This class is not part of the BC promise of this library.
@@ -32,14 +33,21 @@ public function create(PhpDocTagNode $node, Context $context): Tag
         $tagValue = $node->value;
         Assert::isInstanceOf($tagValue, ImplementsTagValueNode::class);
 
-        return new Implements_(
+        $description = $tagValue->getAttribute('description');
+        if (is_string($description) === false) {
+            $description = $tagValue->description;
+        }
+
+        $class = $node->name === '@implements' ? Implements_::class : TemplateImplements::class;
+
+        return new $class(
             $this->typeResolver->createType($tagValue->type, $context),
             $this->descriptionFactory->create($tagValue->description, $context) 
         );
     }
 
     public function supports(PhpDocTagNode $node, Context $context): bool
     {
-        return $node->value instanceof ImplementsTagValueNode && $node->name === '@implements';
+        return $node->value instanceof ImplementsTagValueNode && ($node->name === '@implements' || $node->name === '@template-implements');
     }
 }

src/DocBlock/Tags/Implements_.php

@@ -13,14 +13,15 @@
 
 namespace phpDocumentor\Reflection\DocBlock\Tags;
 
+use Doctrine\Deprecations\Deprecation;
 use phpDocumentor\Reflection\Type;
 use phpDocumentor\Reflection\DocBlock\Description;
 use phpDocumentor\Reflection\DocBlock\Tags\TagWithType;
 
 /**
  * Reflection class for a {@}implements tag in a Docblock.
  */
-final class Implements_ extends TagWithType
+class Implements_ extends TagWithType 
 {
     public function __construct(Type $type, ?Description $description = null)
     {
@@ -35,23 +36,12 @@ public function __construct(Type $type, ?Description $description = null)
      */
     public static function create(string $body)
     {
-        trigger_error(
+        Deprecation::trigger(
+            'phpdocumentor/reflection-docblock',
+            'https://github.com/phpDocumentor/ReflectionDocBlock/issues/361',
             'Create using static factory is deprecated, this method should not be called directly
              by library consumers',
-            E_USER_DEPRECATED
         );
-    }
-
-    public function __toString(): string
-    {
-        if ($this->description) {
-            $description = $this->description->render();
-        } else {
-            $description = '';
-        }
-
-        $type = $this->type;
-
-        return $type . ($description !== '' ? ' ' . $description : '');
+        return null;
     }
 }

src/DocBlock/Tags/TemplateImplements.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of phpDocumentor.
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ *
+ * @link http://phpdoc.org
+ */
+
+namespace phpDocumentor\Reflection\DocBlock\Tags;
+
+use phpDocumentor\Reflection\Type;
+use phpDocumentor\Reflection\DocBlock\Description;
+
+/**
+ * Reflection class for a {@}template-implements tag in a Docblock.
+ */
+final class TemplateImplements extends Implements_ 
+{
+    public function __construct(Type $type, ?Description $description = null)
+    {
+        parent::__construct($type, $description);
+        $this->name = 'template-implements';
+    }
+}