Support the "deprecationReason" attribute in the ApiProperty annotation (#1983)

* Fix ApiProperty annot, support deprecationReason attr

* Remove useless use

Author: dunglas

src/Annotation/ApiProperty.php

@@ -14,7 +14,6 @@
 namespace ApiPlatform\Core\Annotation;
 
 use ApiPlatform\Core\Exception\InvalidArgumentException;
-use Doctrine\Common\Annotations\Annotation\Attribute;
 
 /**
  * ApiProperty annotation.
@@ -24,6 +23,7 @@
  * @Annotation
  * @Target({"METHOD", "PROPERTY"})
  * @Attributes(
+ *     @Attribute("deprecationReason", type="string"),
  *     @Attribute("fetchable", type="bool"),
  *     @Attribute("fetchEager", type="bool"),
  *     @Attribute("jsonldContext", type="array"),
@@ -74,6 +74,13 @@ final class ApiProperty
      */
     public $identifier;
 
+    /**
+     * @see https://github.com/Haehnchen/idea-php-annotation-plugin/issues/112
+     *
+     * @var string
+     */
+    private $deprecationReason;
+
     /**
      * @see https://github.com/Haehnchen/idea-php-annotation-plugin/issues/112
      *

src/Annotation/ApiResource.php

@@ -14,7 +14,6 @@
 namespace ApiPlatform\Core\Annotation;
 
 use ApiPlatform\Core\Exception\InvalidArgumentException;
-use Doctrine\Common\Annotations\Annotation\Attribute;
 
 /**
  * ApiResource annotation.

tests/Annotation/ApiPropertyTest.php

@@ -48,13 +48,15 @@ public function testAssignation()
     public function testConstruct()
     {
         $property = new ApiProperty([
+            'deprecationReason' => 'this field is deprecated',
             'fetchable' => true,
             'fetchEager' => false,
             'jsonldContext' => ['foo' => 'bar'],
             'swaggerContext' => ['foo' => 'baz'],
             'attributes' => ['unknown' => 'unknown', 'fetchable' => false],
         ]);
         $this->assertEquals([
+            'deprecation_reason' => 'this field is deprecated',
             'fetchable' => false,
             'fetch_eager' => false,
             'jsonld_context' => ['foo' => 'bar'],