OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	08/07/2024 04:34:30 AM	rwxr-xr-x
📄 AbstractAnnotation.php	29.5 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 AdditionalProperties.php	806 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Attachable.php	1.72 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Components.php	3.46 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Contact.php	1.13 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 CookieParameter.php	317 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Delete.php	320 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Discriminator.php	1.66 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Examples.php	2.29 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 ExternalDocumentation.php	1.53 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Flow.php	2.12 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Get.php	314 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Head.php	316 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Header.php	2.12 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 HeaderParameter.php	349 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Info.php	2.06 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Items.php	1.48 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 JsonContent.php	825 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 License.php	2.2 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Link.php	3.22 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 MediaType.php	2.26 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 OpenApi.php	8.44 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Operation.php	7.37 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Options.php	322 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Parameter.php	8.53 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Patch.php	318 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 PathItem.php	3.71 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 PathParameter.php	406 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Post.php	316 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Property.php	952 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Put.php	314 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 QueryParameter.php	345 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 RequestBody.php	2.57 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Response.php	3.33 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Schema.php	16.2 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 SecurityScheme.php	3 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Server.php	1.89 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 ServerVariable.php	1.89 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Tag.php	1.22 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 Trace.php	318 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Webhook.php	686 bytes	08/07/2024 04:34:28 AM	rw-r--r--
📄 Xml.php	2.34 KB	08/07/2024 04:34:28 AM	rw-r--r--
📄 XmlContent.php	851 bytes	08/07/2024 04:34:28 AM	rw-r--r--

Editing: Parameter.php

<?php declare(strict_types=1);

/**
 * @license Apache 2.0
 */

namespace OpenApi\Annotations;

use OpenApi\Generator;

/**
 * Describes a single operation parameter.
 *
 * A unique parameter is defined by a combination of a name and location.
 *
 * @see [OAA Parameter Object](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#parameter-object)
 *
 * @Annotation
 */
class Parameter extends AbstractAnnotation
{
    /**
     * The relative or absolute path to the endpoint.
     *
     * @see [Using refs](https://swagger.io/docs/specification/using-ref/)
     *
     * @var string|class-string|object
     */
    public $ref = Generator::UNDEFINED;

/**
     * The key into <code>Components::parameters</code> or <code>PathItem::parameters</code> array.
     *
     * @var string
     */
    public $parameter = Generator::UNDEFINED;

/**
     * The (case-sensitive) name of the parameter.
     *
     * If in is "path", the name field must correspond to the associated path segment from the path field in the Paths Object.
     *
     * If in is "header" and the name field is "Accept", "Content-Type" or "Authorization", the parameter definition shall be ignored.
     * For all other cases, the name corresponds to the parameter name used by the in property.
     *
     * @var string
     */
    public $name = Generator::UNDEFINED;

/**
     * The location of the parameter.
     *
     * Possible values are "query", "header", "path" or "cookie".
     *
     * @var string
     */
    public $in = Generator::UNDEFINED;

/**
     * A brief description of the parameter.
     *
     * This could contain examples of use.
     *
     * CommonMark syntax may be used for rich text representation.
     *
     * @var string
     */
    public $description = Generator::UNDEFINED;

/**
     * Determines whether this parameter is mandatory.
     *
     * If the parameter location is "path", this property is required and its value must be true.
     * Otherwise, the property may be included and its default value is false.
     *
     * @var bool
     */
    public $required = Generator::UNDEFINED;

/**
     * Specifies that a parameter is deprecated and should be transitioned out of usage.
     *
     * @var bool
     */
    public $deprecated = Generator::UNDEFINED;

/**
     * Sets the ability to pass empty-valued parameters.
     *
     * This is valid only for query parameters and allows sending a parameter with an empty value.
     *
     * Default value is false.
     *
     * If style is used, and if behavior is n/a (cannot be serialized), the value of allowEmptyValue shall be ignored.
     *
     * @var bool
     */
    public $allowEmptyValue = Generator::UNDEFINED;

/**
     * Describes how the parameter value will be serialized depending on the type of the parameter value.
     *
     * Default values (based on value of in): for query - form; for path - simple; for header - simple; for cookie - form.
     *
     * @var string
     */
    public $style = Generator::UNDEFINED;

/**
     * When this is true, parameter values of type array or object generate separate parameters for each value of the array or key-value pair of the map.
     *
     * For other types of parameters this property has no effect.
     *
     * When style is form, the default value is true.
     * For all other styles, the default value is false.
     *
     * @var bool
     */
    public $explode = Generator::UNDEFINED;

/**
     * Determines whether the parameter value should allow reserved characters, as defined by RFC3986 :/?#[]@!$&'()*+,;= to be included without percent-encoding.
     *
     * This property only applies to parameters with an in value of query.
     *
     * The default value is false.
     *
     * @var bool
     */
    public $allowReserved = Generator::UNDEFINED;

/**
     * The schema defining the type used for the parameter.
     *
     * @var Schema
     */
    public $schema = Generator::UNDEFINED;

/**
     * Example of the media type.
     *
     * The example should match the specified schema and encoding properties if present.
     * The example object is mutually exclusive of the examples object.
     * Furthermore, if referencing a schema which contains an example, the example value shall override the example provided by the schema.
     * To represent examples of media types that cannot naturally be represented in JSON or YAML, a string value can contain the example with escaping where necessary.
     */
    public $example = Generator::UNDEFINED;

/**
     * Examples of the parameter.
     *
     * Each example should contain a value in the correct format as specified in the parameter encoding.
     * The examples object is mutually exclusive of the example object.
     * Furthermore, if referencing a schema which contains an example, the examples value shall override the example provided by the schema.
     *
     * @var array<Examples>
     */
    public $examples = Generator::UNDEFINED;

/**
     * A map containing the representations for the parameter.
     *
     * The key is the media type and the value describes it.
     * The map must only contain one entry.
     *
     * @var array<MediaType>|JsonContent|XmlContent|Attachable
     */
    public $content = Generator::UNDEFINED;

/**
     * Path-style parameters defined by RFC6570.
     *
     * @see [RFC6570](https://tools.ietf.org/html/rfc6570#section-3.2.7)
     */
    public $matrix = Generator::UNDEFINED;

/**
     * Label style parameters defined by RFC6570.
     *
     * @see [RFC6570](https://tools.ietf.org/html/rfc6570#section-3.2.5)
     */
    public $label = Generator::UNDEFINED;

/**
     * Form style parameters defined by RFC6570.
     *
     * This option replaces collectionFormat with a csv (when explode is false) or multi (when explode is true) value from OpenAPI 2.0.
     *
     * @see [RFC6570](https://tools.ietf.org/html/rfc6570#section-3.2.8)
     */
    public $form = Generator::UNDEFINED;

/**
     * Simple style parameters defined by RFC6570.
     *
     * This option replaces collectionFormat with a csv value from OpenAPI 2.0.
     *
     * @see [RFC6570](https://tools.ietf.org/html/rfc6570#section-3.2.2)
     *
     * @var array
     */
    public $simple = Generator::UNDEFINED;

/**
     * Space separated array values.
     *
     * This option replaces collectionFormat equal to ssv from OpenAPI 2.0.
     *
     * @var array
     */
    public $spaceDelimited = Generator::UNDEFINED;

/**
     * Pipe separated array values.
     *
     * This option replaces collectionFormat equal to pipes from OpenAPI 2.0.
     *
     * @var array
     */
    public $pipeDelimited = Generator::UNDEFINED;

/**
     * Provides a simple way of rendering nested objects using form parameters.
     */
    public $deepObject = Generator::UNDEFINED;

/**
     * @inheritdoc
     */
    public static $_required = ['name', 'in'];

/**
     * @inheritdoc
     */
    public static $_types = [
        'name' => 'string',
        'in' => ['query', 'header', 'path', 'cookie'],
        'description' => 'string',
        'style' => ['matrix', 'label', 'form', 'simple', 'spaceDelimited', 'pipeDelimited', 'deepObject'],
        'required' => 'boolean',
    ];

/**
     * @inheritdoc
     */
    public static $_nested = [
        Schema::class => 'schema',
        Examples::class => ['examples', 'example'],
        Attachable::class => ['attachables'],
    ];

/**
     * @inheritdoc
     */
    public static $_parents = [
        Components::class,
        PathItem::class,
        Operation::class,
        Get::class,
        Post::class,
        Put::class,
        Delete::class,
        Patch::class,
        Head::class,
        Options::class,
        Trace::class,
    ];

/**
     * @inheritdoc
     */
    public function validate(array $stack = [], array $skip = [], string $ref = '', $context = null): bool
    {
        if (in_array($this, $skip, true)) {
            return true;
        }

$valid = parent::validate($stack, $skip, $ref, $context);

if (Generator::isDefault($this->ref)) {
            if ($this->in === 'body') {
                if (Generator::isDefault($this->schema)) {
                    $this->_context->logger->warning('Field "schema" is required when ' . $this->identity() . ' is in "' . $this->in . '" in ' . $this->_context);
                    $valid = false;
                }
            }
        }

return $valid;
    }

/**
     * @inheritdoc
     */
    public function identity(): string
    {
        return parent::_identity(['name', 'in']);
    }
}