%PDF-
%PDF-
Mini Shell
Mini Shell
<?php declare(strict_types=1);
/**
* @license Apache 2.0
*/
namespace OpenApi\Processors;
use OpenApi\Annotations\Components;
use OpenApi\Annotations\Schema;
use OpenApi\Analysis;
use OpenApi\Annotations\Items;
use OpenApi\Annotations\Property;
use OpenApi\Context;
/**
* Use the property context to extract useful information and inject that into the annotation.
*/
class AugmentProperties
{
public static $types = [
'array' => 'array',
'byte' => ['string', 'byte'],
'boolean' => 'boolean',
'bool' => 'boolean',
'int' => 'integer',
'integer' => 'integer',
'long' => ['integer', 'long'],
'float' => ['number', 'float'],
'double' => ['number', 'double'],
'string' => 'string',
'date' => ['string', 'date'],
'datetime' => ['string', 'date-time'],
'\datetime' => ['string', 'date-time'],
'datetimeimmutable' => ['string', 'date-time'],
'\datetimeimmutable' => ['string', 'date-time'],
'datetimeinterface' => ['string', 'date-time'],
'\datetimeinterface' => ['string', 'date-time'],
'number' => 'number',
'object' => 'object',
];
public function __invoke(Analysis $analysis)
{
$refs = [];
if ($analysis->openapi->components !== UNDEFINED && $analysis->openapi->components->schemas !== UNDEFINED) {
foreach ($analysis->openapi->components->schemas as $schema) {
if ($schema->schema !== UNDEFINED) {
$refs[strtolower($schema->_context->fullyQualifiedName($schema->_context->class))]
= Components::SCHEMA_REF . $schema->schema;
}
}
}
$allProperties = $analysis->getAnnotationsOfType(Property::class);
foreach ($allProperties as $property) {
$context = $property->_context;
// Use the property names for @OA\Property()
if ($property->property === UNDEFINED) {
$property->property = $context->property;
}
if ($property->ref !== UNDEFINED) {
continue;
}
$comment = str_replace("\r\n", "\n", $context->comment);
if (preg_match('/@var\s+(?<type>[^\s]+)([ \t])?(?<description>.+)?$/im', $comment, $varMatches)) {
if ($property->type === UNDEFINED) {
preg_match('/^([^\[]+)(.*$)/', trim($varMatches['type']), $typeMatches);
$isNullable = $this->isNullable($typeMatches[1]);
$type = $this->stripNull($typeMatches[1]);
if (array_key_exists(strtolower($type), static::$types) === false) {
$key = strtolower($context->fullyQualifiedName($type));
if ($property->ref === UNDEFINED && $typeMatches[2] === '' && array_key_exists($key, $refs)) {
if ($isNullable) {
$property->oneOf = [
new Schema([
'_context' => $property->_context,
'ref' => $refs[$key]
])
];
$property->nullable = true;
} else {
$property->ref = $refs[$key];
}
continue;
}
} else {
$type = static::$types[strtolower($type)];
if (is_array($type)) {
if ($property->format === UNDEFINED) {
$property->format = $type[1];
}
$type = $type[0];
}
$property->type = $type;
}
if ($typeMatches[2] === '[]') {
if ($property->items === UNDEFINED) {
$property->items = new Items(
[
'type' => $property->type,
'_context' => new Context(['generated' => true], $context),
]
);
if ($property->items->type === UNDEFINED) {
$key = strtolower($context->fullyQualifiedName($type));
$property->items->ref = array_key_exists($key, $refs) ? $refs[$key] : null;
}
}
$property->type = 'array';
}
}
if ($property->description === UNDEFINED && isset($varMatches['description'])) {
$property->description = trim($varMatches['description']);
}
}
if ($property->example === UNDEFINED && preg_match('/@example\s+([ \t])?(?<example>.+)?$/im', $comment, $varMatches)) {
$property->example = $varMatches['example'];
}
if ($property->description === UNDEFINED) {
$property->description = $context->phpdocContent();
}
}
}
protected function isNullable(string $typeDescription): bool
{
return in_array('null', explode('|', strtolower($typeDescription)));
}
protected function stripNull(string $typeDescription): string
{
if (strpos($typeDescription, '|') === false) {
return $typeDescription;
}
$types = [];
foreach (explode('|', $typeDescription) as $type) {
if (strtolower($type) === 'null') {
continue;
}
$types[] = $type;
}
return implode('|', $types);
}
}
Zerion Mini Shell 1.0