Draft: How to use Security and SecurityRequirement

Makefile

@@ -37,6 +37,12 @@ fix-style: php-cs-fixer.phar
 	$(DOCKER_PHP) vendor/bin/indent --spaces .php_cs.dist
 	$(DOCKER_PHP) ./php-cs-fixer.phar fix src/ --diff
 
+cli:
+	docker-compose run --rm php bash
+
+#cli_root:
+#	docker-compose exec --user="root" php bash
+
 install:
 	$(DOCKER_PHP) composer install --prefer-dist --no-interaction --no-progress --ansi
 	$(DOCKER_NODE) yarn install

composer.json

@@ -28,8 +28,6 @@
 		"phpunit/phpunit": "^6.5 || ^7.5 || ^8.5 || ^9.4",
 		"oai/openapi-specification": "3.0.3",
 		"mermade/openapi3-examples": "1.0.0",
-		"apis-guru/openapi-directory": "1.0.0",
-		"nexmo/api-specification": "1.0.0",
 		"phpstan/phpstan": "^0.12.0"
 	},
 	"conflict": {

src/Writer.php

@@ -36,6 +36,7 @@ public static function writeToJson(SpecObjectInterface $object, int $flags = JSO
     public static function writeToYaml(SpecObjectInterface $object): string
     {
         return Yaml::dump($object->getSerializableData(), 256, 2, Yaml::DUMP_OBJECT_AS_MAP | Yaml::DUMP_EMPTY_ARRAY_AS_SEQUENCE);
+//        return Yaml::dump(json_decode(json_encode($object->getSerializableData()), true), 256, 2, Yaml::DUMP_OBJECT_AS_MAP | Yaml::DUMP_EMPTY_ARRAY_AS_SEQUENCE);
     }
 
     /**

src/spec/OpenApi.php

@@ -7,7 +7,6 @@
 
 namespace cebe\openapi\spec;
 
-use cebe\openapi\exceptions\TypeErrorException;
 use cebe\openapi\SpecBaseObject;
 
 /**
@@ -38,7 +37,7 @@ protected function attributes(): array
             'servers' => [Server::class],
             'paths' => Paths::class,
             'components' => Components::class,
-            'security' => [SecurityRequirement::class],
+            'security' => [Type::STRING, SecurityRequirement::class],
             'tags' => [Tag::class],
             'externalDocs' => ExternalDocumentation::class,
         ];

src/spec/Operation.php

@@ -46,7 +46,7 @@ protected function attributes(): array
             'responses' => Responses::class,
             'callbacks' => [Type::STRING, Callback::class],
             'deprecated' => Type::BOOLEAN,
-            'security' => [SecurityRequirement::class],
+            'security' => [Type::STRING, SecurityRequirement::class],
             'servers' => [Server::class],
         ];
     }

tests/WriterTest.php

@@ -1,6 +1,11 @@
 <?php
 
+use cebe\openapi\spec\Components;
+use cebe\openapi\spec\OpenApi;
+use cebe\openapi\spec\Operation;
+use cebe\openapi\spec\PathItem;
 use cebe\openapi\spec\SecurityRequirement;
+use cebe\openapi\spec\SecurityScheme;
 
 class WriterTest extends \PHPUnit\Framework\TestCase
 {
@@ -187,4 +192,31 @@ public function testWriteEmptySecurityPartYaml()
             $yaml
         );
     }
+
+    public function testSecurity()
+    {
+        $openapi = new OpenApi([
+            'components' => new Components([
+                'securitySchemes' => [
+                    'BearerAuth' => new SecurityScheme([
+                        'type' => 'http',
+                        'scheme' => 'bearer',
+                        'bearerFormat' => 'AuthToken and JWT Format' # optional, arbitrary value for documentation purposes
+                    ])
+                ],
+            ]),
+            'paths' => [
+                '/test' => new PathItem([
+                    'get' => new Operation([
+                        'security' => [
+                            'BearerAuth' => new SecurityRequirement([])
+                        ],
+                    ])
+                ])
+            ]
+        ]);
+
+        $result = json_decode(json_encode($openapi->getSerializableData()), true);
+        $this->assertTrue($result);
+    }
 }