OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	08/07/2024 04:34:30 AM	rwxr-xr-x
📄 AugmentParameters.php	3.21 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 AugmentProperties.php	8.44 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 AugmentRefs.php	3.88 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 AugmentRequestBody.php	1.43 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 AugmentSchemas.php	5.42 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 BuildPaths.php	2.21 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 CleanUnmerged.php	995 bytes	08/07/2024 04:34:30 AM	rw-r--r--
📄 CleanUnusedComponents.php	3.56 KB	08/07/2024 04:34:30 AM	rw-r--r--
📁 Concerns	-	08/07/2024 04:34:51 AM	rwxr-xr-x
📄 DocBlockDescriptions.php	3.1 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 ExpandClasses.php	1.68 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 ExpandEnums.php	3.64 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 ExpandInterfaces.php	2.09 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 ExpandTraits.php	3.54 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 MergeIntoComponents.php	1.08 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 MergeIntoOpenApi.php	1.88 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 MergeJsonContent.php	2.07 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 MergeXmlContent.php	2.05 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 OperationId.php	2.1 KB	08/07/2024 04:34:30 AM	rw-r--r--
📄 ProcessorInterface.php	151 bytes	08/07/2024 04:34:30 AM	rw-r--r--

Editing: ExpandEnums.php

<?php declare(strict_types=1);

/**
 * @license Apache 2.0
 */

namespace OpenApi\Processors;

use OpenApi\Analysis;
use OpenApi\Annotations as OA;
use OpenApi\Generator;
use OpenApi\OpenApiException;

/**
 * Expands PHP enums.
 *
 * Determines `schema`, `enum` and `type`.
 */
class ExpandEnums implements ProcessorInterface
{
    use Concerns\TypesTrait;

public function __invoke(Analysis $analysis)
    {
        if (!class_exists('\\ReflectionEnum')) {
            return;
        }

$this->expandContextEnum($analysis);
        $this->expandSchemaEnum($analysis);
    }

protected function expandContextEnum(Analysis $analysis): void
    {
        /** @var OA\Schema[] $schemas */
        $schemas = $analysis->getAnnotationsOfType(OA\Schema::class, true);

foreach ($schemas as $schema) {
            if ($schema->_context->is('enum')) {
                $re = new \ReflectionEnum($schema->_context->fullyQualifiedName($schema->_context->enum));
                $schema->schema = !Generator::isDefault($schema->schema) ? $schema->schema : $re->getShortName();

$schemaType = $schema->type;
                $enumType = null;
                if ($re->isBacked()) {
                    $backingType = $re->getBackingType();
                    if ($backingType instanceof \ReflectionNamedType) {
                        $enumType = $backingType->getName();
                    }
                }

// no (or invalid) schema type means name
                $useName = Generator::isDefault($schemaType) || ($enumType && $this->native2spec($enumType) != $schemaType);

$schema->enum = array_map(function ($case) use ($useName) {
                    return ($useName || !($case instanceof \ReflectionEnumBackedCase)) ? $case->name : $case->getBackingValue();
                }, $re->getCases());

$schema->type = $useName ? 'string' : $enumType;

$this->mapNativeType($schema, $schemaType);
            }
        }
    }

protected function expandSchemaEnum(Analysis $analysis): void
    {
        /** @var OA\Schema[] $schemas */
        $schemas = $analysis->getAnnotationsOfType([OA\Schema::class, OA\ServerVariable::class]);

foreach ($schemas as $schema) {
            if (Generator::isDefault($schema->enum)) {
                continue;
            }

if (is_string($schema->enum)) {
                // might be enum class-string
                if (is_a($schema->enum, \UnitEnum::class, true)) {
                    $cases = $schema->enum::cases();
                } else {
                    throw new OpenApiException("Unexpected enum value, requires specifying the Enum class string: $schema->enum");
                }
            } else {
                // might be an array of \UnitEnum::class, string, int, etc...
                assert(is_array($schema->enum));

$cases = [];

// transform each Enum cases into UnitEnum
                foreach ($schema->enum as $enum) {
                    if (is_string($enum) && function_exists('enum_exists') && enum_exists($enum)) {
                        foreach ($enum::cases() as $case) {
                            $cases[] = $case;
                        }
                    } else {
                        $cases[] = $enum;
                    }
                }
            }

$enums = [];
            foreach ($cases as $enum) {
                if (is_a($enum, \UnitEnum::class)) {
                    $enums[] = $enum->value ?? $enum->name;
                } else {
                    $enums[] = $enum;
                }
            }

$schema->enum = $enums;
        }
    }
}