Openapi extend configuration

src/Annotation/Controller/Tag.php

@@ -8,7 +8,7 @@
 
 /**
  * @Annotation
- * @Target("CLASS")
+ * @Target({"CLASS", "METHOD"})
  */
 final class Tag
 {
@@ -24,8 +24,9 @@ final class Tag
 	 */
 	public function __construct(array $values)
 	{
-		if (!isset($values['name'])) {
-			throw new AnnotationException('Name is required at @Tag');
+		if (isset($values['value']) && !isset($values['name'])) {
+			$values['name'] = $values['value'];
+			unset($values['value']);
 		}
 
 		$this->name = $values['name'];

src/DI/Loader/DoctrineAnnotationLoader.php

@@ -252,6 +252,13 @@ protected function parseControllerMethodsAnnotations(Controller $controller, Cla
 					continue;
 				}
 
+				// Parse @Tag ==============================
+				if (get_class($annotation) == Tag::class) {
+					/** @var Tag $annotation */
+					$schemaMethod->addTag($annotation->getName());
+					continue;
+				}
+
 				// Parse @Id ===============================
 				if (get_class($annotation) === Id::class) {
 					/** @var Id $annotation */

src/Schema/Builder/Controller/Method.php

@@ -20,6 +20,9 @@ final class Method
 	/** @var string[] */
 	private $methods = [];
 
+	/** @var string[] */
+	private $tags = [];
+
 	/** @var string[] */
 	private $arguments = [];
 
@@ -129,7 +132,7 @@ public function addMethod($method)
 	}
 
 	/**
-	 * @param string|string[] $methods
+	 * @param string[] $methods
 	 * @return void
 	 */
 	public function addMethods(array $methods)
@@ -139,6 +142,34 @@ public function addMethods(array $methods)
 		}
 	}
 
+	/**
+	 * @return string[]
+	 */
+	public function getTags()
+	{
+		return $this->tags;
+	}
+
+	/**
+	 * @param string $tag
+	 * @return void
+	 */
+	public function addTag($tag)
+	{
+		$this->tags[] = $tag;
+	}
+
+	/**
+	 * @param string[] $tags
+	 * @return void
+	 */
+	public function addTags(array $tags)
+	{
+		foreach ($tags as $tag) {
+			$this->addTag($tag);
+		}
+	}
+
 	/**
 	 * @param string $name
 	 * @param string $type

src/Schema/EndpointParameter.php

@@ -5,13 +5,13 @@
 final class EndpointParameter
 {
 
-	const TYPE_SCALAR = 1;
-	const TYPE_STRING = 2;
-	const TYPE_INTEGER = 3;
-	const TYPE_FLOAT = 4;
-	const TYPE_BOOLEAN = 5;
-	const TYPE_DATETIME = 6;
-	const TYPE_OBJECT = 7;
+	const TYPE_SCALAR = 'scalar';
+	const TYPE_STRING = 'string';
+	const TYPE_INTEGER = 'int';
+	const TYPE_FLOAT = 'float';
+	const TYPE_BOOLEAN = 'bool';
+	const TYPE_DATETIME = 'datetime';
+	const TYPE_OBJECT = 'object';
 
 	const IN_QUERY = 'query';
 	const IN_COOKIE = 'cookie';

src/Schema/Serialization/ArraySerializator.php

@@ -96,7 +96,7 @@ protected function serializeInit(Controller $controller, Method $method)
 				'arguments' => $method->getArguments(),
 			],
 			'id' => $id,
-			'tags' => $controller->getTags(),
+			'tags' => $method->getTags(),
 			'methods' => $method->getMethods(),
 			'mask' => $mask,
 			'description' => $method->getDescription(),