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: AugmentParameters.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\Processors\Concerns\DocblockTrait;

class AugmentParameters implements ProcessorInterface
{
    use DocblockTrait;

protected $augmentOperationParameters;

public function __construct(bool $augmentOperationParameters = true)
    {
        $this->augmentOperationParameters = $augmentOperationParameters;
    }

public function isAugmentOperationParameters(): bool
    {
        return $this->augmentOperationParameters;
    }

/**
     * If set to <code>true</code> try to find operation parameter descriptions in the operation docblock.
     */
    public function setAugmentOperationParameters(bool $augmentOperationParameters): void
    {
        $this->augmentOperationParameters = $augmentOperationParameters;
    }

public function __invoke(Analysis $analysis)
    {
        $this->augmentSharedParameters($analysis);
        if ($this->augmentOperationParameters) {
            $this->augmentOperationParameters($analysis);
        }
    }

/**
     * Use the parameter->name as key field (parameter->parameter) when used as reusable component
     * (openapi->components->parameters).
     */
    protected function augmentSharedParameters(Analysis $analysis): void
    {
        if (!Generator::isDefault($analysis->openapi->components) && !Generator::isDefault($analysis->openapi->components->parameters)) {
            $keys = [];
            $parametersWithoutKey = [];
            foreach ($analysis->openapi->components->parameters as $parameter) {
                if (!Generator::isDefault($parameter->parameter)) {
                    $keys[$parameter->parameter] = $parameter;
                } else {
                    $parametersWithoutKey[] = $parameter;
                }
            }
            foreach ($parametersWithoutKey as $parameter) {
                if (!Generator::isDefault($parameter->name) && empty($keys[$parameter->name])) {
                    $parameter->parameter = $parameter->name;
                    $keys[$parameter->parameter] = $parameter;
                }
            }
        }
    }

protected function augmentOperationParameters(Analysis $analysis): void
    {
        /** @var OA\Operation[] $operations */
        $operations = $analysis->getAnnotationsOfType(OA\Operation::class);

foreach ($operations as $operation) {
            if (!Generator::isDefault($operation->parameters)) {
                $tags = [];
                $this->extractContent($operation->_context->comment, $tags);
                if (array_key_exists('param', $tags)) {
                    foreach ($tags['param'] as $name => $details) {
                        foreach ($operation->parameters as $parameter) {
                            if ($parameter->name == $name) {
                                if (Generator::isDefault($parameter->description) && $details['description']) {
                                    $parameter->description = $details['description'];
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}