Add extensions for the SpecBaseObject

Author: marcelthole

src/SpecBaseObject.php

@@ -484,4 +484,21 @@ public function getDocumentPosition(): ?JsonPointer
     {
         return $this->_jsonPointer;
     }
+
+    /**
+     * Handle extension properties with `x-` prefix.
+     * See https://github.com/OAI/OpenAPI-Specification/blob/3.0.2/versions/3.0.2.md#specificationExtensions
+     * @return array<string, mixed>
+     */
+    public function getExtensions(): array
+    {
+        $extensions = [];
+        foreach($this->_properties as $propertyKey => $extension) {
+            if (mb_strpos($propertyKey, 'x-') !== 0) {
+                continue;
+            }
+            $extensions[$propertyKey] = $extension;
+        }
+        return $extensions;
+    }
 }

src/spec/PathItem.php

@@ -190,6 +190,12 @@ public function resolveReferences(ReferenceContext $context = null)
                     }
                 }
             }
+
+            if ($pathItem instanceof SpecBaseObject) {
+                foreach ($pathItem->getExtensions() as $extensionKey => $extension) {
+                    $this->{$extensionKey} = $extension;
+                }
+            }
         }
         parent::resolveReferences($context);
     }

tests/spec/PathTest.php

@@ -137,7 +137,7 @@ public function testInvalidPath()
     public function testPathItemReference()
     {
         $file = __DIR__ . '/data/paths/openapi.yaml';
-        /** @var $openapi OpenApi */
+        /** @var $openapi \cebe\openapi\spec\OpenApi */
         $openapi = Reader::readFromYamlFile($file, \cebe\openapi\spec\OpenApi::class, false);
 
         $result = $openapi->validate();
@@ -147,6 +147,10 @@ public function testPathItemReference()
         $this->assertInstanceOf(Paths::class, $openapi->paths);
         $this->assertInstanceOf(PathItem::class, $fooPath = $openapi->paths['/foo']);
         $this->assertInstanceOf(PathItem::class, $barPath = $openapi->paths['/bar']);
+        $this->assertSame([
+            'x-extension-1' => 'Extension1',
+            'x-extension-2' => 'Extension2'
+        ], $openapi->getExtensions());
 
         $this->assertEmpty($fooPath->getOperations());
         $this->assertEmpty($barPath->getOperations());

tests/spec/ReferenceTest.php

@@ -508,7 +508,7 @@ enum:
   /something:
     get:
       responses:
-        200:
+        '200':
           description: 'OK if common params can be references'
     parameters:
       -

tests/spec/data/paths/openapi.yaml

@@ -3,6 +3,10 @@ openapi: 3.0.2
 info:
   title: My API
   version: 1.0.0
+x-extension-1: Extension1
+x-extension-2: Extension2
+X-EXTENSION: Invalid because of Uppercase X-
+xyz-extension: invalid extension
 paths:
   /foo:
     $ref: 'path-items.yaml#/~1foo'