Backport AugmentItems processor (#1863)

Author: DerManoMann

docs/examples/specs/api/annotations/ProductController.php

@@ -68,7 +68,6 @@ public function getProduct(?int $product_id)
      *         @OA\MediaType(
      *             mediaType="application/json",
      *             @OA\Schema(
-     *                 type="array",
      *                 @OA\Items(ref="#/components/schemas/Product")
      *             )
      *         )

docs/examples/specs/api/attributes/ProductController.php

@@ -48,7 +48,6 @@ public function getProduct(
         content: [new OAT\MediaType(
             mediaType: 'application/json',
             schema: new OAT\Schema(
-                type: 'array',
                 items: new OAT\Items(type: Product::class)
             )
         )]

docs/examples/specs/api/mixed/ProductController.php

@@ -57,7 +57,6 @@ public function getProduct(?int $product_id)
      *         description="New product",
      *         required=true,
      *         @OA\JsonContent(
-     *             type="array",
      *             @OA\Items(ref="#/components/schemas/Product")
      *         )
      *     )

src/Generator.php

@@ -237,6 +237,7 @@ public function getProcessorPipeline(): Pipeline
                 new Processors\BuildPaths(),
                 new Processors\AugmentParameters(),
                 new Processors\AugmentRefs(),
+                new Processors\AugmentItems(),
                 new Processors\MergeJsonContent(),
                 new Processors\MergeXmlContent(),
                 new Processors\AugmentMediaType(),

src/Processors/AugmentItems.php

@@ -0,0 +1,30 @@
+<?php declare(strict_types=1);
+
+/**
+ * @license Apache 2.0
+ */
+
+namespace OpenApi\Processors;
+
+use OpenApi\Analysis;
+use OpenApi\Annotations as OA;
+use OpenApi\Context;
+
+/**
+ * Use the Schema context to extract useful information and inject that into the annotation.
+ *
+ * Merges properties.
+ */
+class AugmentItems
+{
+    public function __invoke(Analysis $analysis): void
+    {
+        $schemas = $analysis->getAnnotationsOfType(OA\Schema::class);
+
+        foreach ($schemas as $schema) {
+            if ($schema->items instanceof OA\Items) {
+                $schema->type = 'array';
+            }
+        }
+    }
+}