Symfony Profiler

<?php
/*
* This file is part of the API Platform project.
*
* (c) Kévin Dunglas <dunglas@gmail.com>
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
declare(strict_types=1);
namespace ApiPlatform\Core\JsonSchema;
use ApiPlatform\Api\ResourceClassResolverInterface;
use ApiPlatform\Core\Api\OperationType;
use ApiPlatform\Core\Metadata\Property\Factory\PropertyMetadataFactoryInterface as LegacyPropertyMetadataFactoryInterface;
use ApiPlatform\Core\Metadata\Property\Factory\PropertyNameCollectionFactoryInterface as LegacyPropertyNameCollectionFactoryInterface;
use ApiPlatform\Core\Metadata\Property\PropertyMetadata;
use ApiPlatform\Core\Metadata\Resource\Factory\ResourceMetadataFactoryInterface;
use ApiPlatform\Core\Metadata\Resource\ResourceMetadata;
use ApiPlatform\Core\Swagger\Serializer\DocumentationNormalizer;
use ApiPlatform\JsonSchema\TypeFactoryInterface;
use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\HttpOperation;
use ApiPlatform\Metadata\Property\Factory\PropertyMetadataFactoryInterface;
use ApiPlatform\Metadata\Property\Factory\PropertyNameCollectionFactoryInterface;
use ApiPlatform\Metadata\Resource\Factory\ResourceMetadataCollectionFactoryInterface;
use ApiPlatform\Metadata\Resource\ResourceMetadataCollection;
use ApiPlatform\OpenApi\Factory\OpenApiFactory;
use ApiPlatform\Util\ResourceClassInfoTrait;
use Symfony\Component\PropertyInfo\Type;
use Symfony\Component\Serializer\NameConverter\NameConverterInterface;
use Symfony\Component\Serializer\Normalizer\AbstractNormalizer;
/**
* {@inheritdoc}
*
* @experimental
*
* @author Kévin Dunglas <dunglas@gmail.com>
*/
final class SchemaFactory implements SchemaFactoryInterface
{
use ResourceClassInfoTrait;
private $typeFactory;
/**
* @var LegacyPropertyNameCollectionFactoryInterface|PropertyNameCollectionFactoryInterface
*/
private $propertyNameCollectionFactory;
/**
* @var LegacyPropertyMetadataFactoryInterface|PropertyMetadataFactoryInterface
*/
private $propertyMetadataFactory;
private $nameConverter;
private $distinctFormats = [];
/**
* @param TypeFactoryInterface $typeFactory
* @param mixed $resourceMetadataFactory
* @param mixed $propertyNameCollectionFactory
* @param mixed $propertyMetadataFactory
*/
public function __construct($typeFactory, $resourceMetadataFactory, $propertyNameCollectionFactory, $propertyMetadataFactory, NameConverterInterface $nameConverter = null, ResourceClassResolverInterface $resourceClassResolver = null)
{
$this->typeFactory = $typeFactory;
if (!$resourceMetadataFactory instanceof ResourceMetadataCollectionFactoryInterface) {
trigger_deprecation('api-platform/core', '2.7', sprintf('Use "%s" instead of "%s".', ResourceMetadataCollectionFactoryInterface::class, ResourceMetadataFactoryInterface::class));
}
$this->resourceMetadataFactory = $resourceMetadataFactory;
$this->propertyNameCollectionFactory = $propertyNameCollectionFactory;
$this->propertyMetadataFactory = $propertyMetadataFactory;
$this->nameConverter = $nameConverter;
$this->resourceClassResolver = $resourceClassResolver;
}
/**
* When added to the list, the given format will lead to the creation of a new definition.
*
* @internal
*/
public function addDistinctFormat(string $format): void
{
$this->distinctFormats[$format] = true;
}
/**
* {@inheritdoc}
*/
public function buildSchema(string $className, string $format = 'json', string $type = Schema::TYPE_OUTPUT, ?string $operationType = null, ?string $operationName = null, ?Schema $schema = null, ?array $serializerContext = null, bool $forceCollection = false): Schema
{
$schema = $schema ? clone $schema : new Schema();
if (null === $metadata = $this->getMetadata($className, $type, $operationType, $operationName, $serializerContext)) {
return $schema;
}
[$resourceMetadata, $serializerContext, $validationGroups, $inputOrOutputClass] = $metadata;
if (null === $resourceMetadata && (null !== $operationType || null !== $operationName)) {
throw new \LogicException('The $operationType and $operationName arguments must be null for non-resource class.');
}
$operation = $resourceMetadata instanceof ResourceMetadataCollection ? $resourceMetadata->getOperation($operationName, OperationType::COLLECTION === $operationType) : null;
$version = $schema->getVersion();
$definitionName = $this->buildDefinitionName($className, $format, $inputOrOutputClass, $resourceMetadata instanceof ResourceMetadata ? $resourceMetadata : $operation, $serializerContext);
$method = $operation instanceof HttpOperation ? $operation->getMethod() : 'GET';
if (!$operation && (null === $operationType || null === $operationName)) {
$method = Schema::TYPE_INPUT === $type ? 'POST' : 'GET';
} elseif ($resourceMetadata instanceof ResourceMetadata) {
$method = $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, 'method', 'GET');
}
if (Schema::TYPE_OUTPUT !== $type && !\in_array($method, ['POST', 'PATCH', 'PUT'], true)) {
return $schema;
}
if (!isset($schema['$ref']) && !isset($schema['type'])) {
$ref = Schema::VERSION_OPENAPI === $version ? '#/components/schemas/'.$definitionName : '#/definitions/'.$definitionName;
if ($forceCollection || (OperationType::COLLECTION === $operationType && 'POST' !== $method)) {
$schema['type'] = 'array';
$schema['items'] = ['$ref' => $ref];
} else {
$schema['$ref'] = $ref;
}
}
$definitions = $schema->getDefinitions();
if (isset($definitions[$definitionName])) {
// Already computed
return $schema;
}
/** @var \ArrayObject<string, mixed> $definition */
$definition = new \ArrayObject(['type' => 'object']);
$definitions[$definitionName] = $definition;
if ($resourceMetadata instanceof ResourceMetadata) {
$definition['description'] = $resourceMetadata->getDescription() ?? '';
} else {
$definition['description'] = $operation ? ($operation->getDescription() ?? '') : '';
}
// additionalProperties are allowed by default, so it does not need to be set explicitly, unless allow_extra_attributes is false
// See https://json-schema.org/understanding-json-schema/reference/object.html#properties
if (false === ($serializerContext[AbstractNormalizer::ALLOW_EXTRA_ATTRIBUTES] ?? true)) {
$definition['additionalProperties'] = false;
}
// see https://github.com/json-schema-org/json-schema-spec/pull/737
if (
Schema::VERSION_SWAGGER !== $version
) {
if (($resourceMetadata instanceof ResourceMetadata &&
($operationType && $operationName ? $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, 'deprecation_reason', null, true) : $resourceMetadata->getAttribute('deprecation_reason', null))
) || ($operation && $operation->getDeprecationReason())
) {
$definition['deprecated'] = true;
}
}
// externalDocs is an OpenAPI specific extension, but JSON Schema allows additional keys, so we always add it
// See https://json-schema.org/latest/json-schema-core.html#rfc.section.6.4
if ($resourceMetadata instanceof ResourceMetadata && $resourceMetadata->getIri()) {
$definition['externalDocs'] = ['url' => $resourceMetadata->getIri()];
} elseif ($operation instanceof HttpOperation && ($operation->getTypes()[0] ?? null)) {
$definition['externalDocs'] = ['url' => $operation->getTypes()[0]];
}
// TODO: getFactoryOptions should be refactored because Item & Collection Operations don't exist anymore (API Platform 3.0)
$options = $this->getFactoryOptions($serializerContext, $validationGroups, $operationType, $operationName, $operation instanceof HttpOperation ? $operation : null);
foreach ($this->propertyNameCollectionFactory->create($inputOrOutputClass, $options) as $propertyName) {
$propertyMetadata = $this->propertyMetadataFactory->create($inputOrOutputClass, $propertyName, $options);
if (!$propertyMetadata->isReadable() && !$propertyMetadata->isWritable()) {
continue;
}
$normalizedPropertyName = $this->nameConverter ? $this->nameConverter->normalize($propertyName, $inputOrOutputClass, $format, $serializerContext) : $propertyName;
if ($propertyMetadata->isRequired()) {
$definition['required'][] = $normalizedPropertyName;
}
$this->buildPropertySchema($schema, $definitionName, $normalizedPropertyName, $propertyMetadata, $serializerContext, $format);
}
return $schema;
}
private function buildPropertySchema(Schema $schema, string $definitionName, string $normalizedPropertyName, $propertyMetadata, array $serializerContext, string $format): void
{
$version = $schema->getVersion();
$swagger = Schema::VERSION_SWAGGER === $version;
$propertySchema = $propertyMetadata->getSchema() ?? [];
if ($propertyMetadata instanceof ApiProperty) {
$additionalPropertySchema = $propertyMetadata->getOpenapiContext() ?? [];
} else {
switch ($version) {
case Schema::VERSION_SWAGGER:
$basePropertySchemaAttribute = 'swagger_context';
break;
case Schema::VERSION_OPENAPI:
$basePropertySchemaAttribute = 'openapi_context';
break;
default:
$basePropertySchemaAttribute = 'json_schema_context';
}
$additionalPropertySchema = $propertyMetadata->getAttributes()[$basePropertySchemaAttribute] ?? [];
}
$propertySchema = array_merge(
$propertySchema,
$additionalPropertySchema
);
if (false === $propertyMetadata->isWritable() && !$propertyMetadata->isInitializable()) {
$propertySchema['readOnly'] = true;
}
if (!$swagger && false === $propertyMetadata->isReadable()) {
$propertySchema['writeOnly'] = true;
}
if (null !== $description = $propertyMetadata->getDescription()) {
$propertySchema['description'] = $description;
}
$deprecationReason = $propertyMetadata instanceof PropertyMetadata ? $propertyMetadata->getAttribute('deprecation_reason') : $propertyMetadata->getDeprecationReason();
// see https://github.com/json-schema-org/json-schema-spec/pull/737
if (!$swagger && null !== $deprecationReason) {
$propertySchema['deprecated'] = true;
}
// externalDocs is an OpenAPI specific extension, but JSON Schema allows additional keys, so we always add it
// See https://json-schema.org/latest/json-schema-core.html#rfc.section.6.4
$iri = $propertyMetadata instanceof PropertyMetadata ? $propertyMetadata->getIri() : $propertyMetadata->getTypes()[0] ?? null;
if (null !== $iri) {
$propertySchema['externalDocs'] = ['url' => $iri];
}
if (!isset($propertySchema['default']) && !empty($default = $propertyMetadata->getDefault())) {
$propertySchema['default'] = $default;
}
if (!isset($propertySchema['example']) && !empty($example = $propertyMetadata->getExample())) {
$propertySchema['example'] = $example;
}
if (!isset($propertySchema['example']) && isset($propertySchema['default'])) {
$propertySchema['example'] = $propertySchema['default'];
}
$valueSchema = [];
// TODO: 3.0 support multiple types, default value of types will be [] instead of null
$type = $propertyMetadata instanceof PropertyMetadata ? $propertyMetadata->getType() : $propertyMetadata->getBuiltinTypes()[0] ?? null;
if (null !== $type) {
if ($isCollection = $type->isCollection()) {
$keyType = method_exists(Type::class, 'getCollectionKeyTypes') ? ($type->getCollectionKeyTypes()[0] ?? null) : $type->getCollectionKeyType();
$valueType = method_exists(Type::class, 'getCollectionValueTypes') ? ($type->getCollectionValueTypes()[0] ?? null) : $type->getCollectionValueType();
} else {
$keyType = null;
$valueType = $type;
}
if (null === $valueType) {
$builtinType = 'string';
$className = null;
} else {
$builtinType = $valueType->getBuiltinType();
$className = $valueType->getClassName();
}
$valueSchema = $this->typeFactory->getType(new Type($builtinType, $type->isNullable(), $className, $isCollection, $keyType, $valueType), $format, $propertyMetadata->isReadableLink(), $serializerContext, $schema);
}
if (\array_key_exists('type', $propertySchema) && \array_key_exists('$ref', $valueSchema)) {
$propertySchema = new \ArrayObject($propertySchema);
} else {
$propertySchema = new \ArrayObject($propertySchema + $valueSchema);
}
$schema->getDefinitions()[$definitionName]['properties'][$normalizedPropertyName] = $propertySchema;
}
private function buildDefinitionName(string $className, string $format = 'json', ?string $inputOrOutputClass = null, $resourceMetadata = null, ?array $serializerContext = null): string
{
if ($resourceMetadata) {
$prefix = $resourceMetadata instanceof ResourceMetadata ? $resourceMetadata->getShortName() : $resourceMetadata->getShortName();
}
if (!isset($prefix)) {
$prefix = (new \ReflectionClass($className))->getShortName();
}
if (null !== $inputOrOutputClass && $className !== $inputOrOutputClass) {
$parts = explode('\\', $inputOrOutputClass);
$shortName = end($parts);
$prefix .= '.'.$shortName;
}
if (isset($this->distinctFormats[$format])) {
// JSON is the default, and so isn't included in the definition name
$prefix .= '.'.$format;
}
$definitionName = $serializerContext[OpenApiFactory::OPENAPI_DEFINITION_NAME] ?? $serializerContext[DocumentationNormalizer::SWAGGER_DEFINITION_NAME] ?? null;
if ($definitionName) {
$name = sprintf('%s-%s', $prefix, $definitionName);
} else {
$groups = (array) ($serializerContext[AbstractNormalizer::GROUPS] ?? []);
$name = $groups ? sprintf('%s-%s', $prefix, implode('_', $groups)) : $prefix;
}
return $this->encodeDefinitionName($name);
}
private function encodeDefinitionName(string $name): string
{
return preg_replace('/[^a-zA-Z0-9.\-_]/', '.', $name);
}
private function getMetadata(string $className, string $type = Schema::TYPE_OUTPUT, ?string $operationType = null, ?string $operationName = null, ?array $serializerContext = null): ?array
{
if (!$this->isResourceClass($className)) {
return [
null,
$serializerContext ?? [],
[],
$className,
];
}
/** @var ResourceMetadata|ResourceMetadataCollection $resourceMetadata */
$resourceMetadata = $this->resourceMetadataFactory->create($className);
$attribute = Schema::TYPE_OUTPUT === $type ? 'output' : 'input';
$operation = ($this->resourceMetadataFactory instanceof ResourceMetadataFactoryInterface) ? null : $resourceMetadata->getOperation($operationName);
if ($this->resourceMetadataFactory instanceof ResourceMetadataFactoryInterface) {
if (null === $operationType || null === $operationName) {
$inputOrOutput = $resourceMetadata->getAttribute($attribute, ['class' => $className]);
} else {
$inputOrOutput = $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, $attribute, ['class' => $className], true);
}
} elseif ($operation) {
$inputOrOutput = (Schema::TYPE_OUTPUT === $type ? $operation->getOutput() : $operation->getInput()) ?? ['class' => $className];
} else {
$inputOrOutput = ['class' => $className];
}
if (null === ($inputOrOutput['class'] ?? $inputOrOutput->class ?? null)) {
// input or output disabled
return null;
}
return [
$resourceMetadata,
$serializerContext ?? $this->getSerializerContext($resourceMetadata, $type, $operationType, $operationName),
$this->getValidationGroups($this->resourceMetadataFactory instanceof ResourceMetadataFactoryInterface ? $resourceMetadata : $operation, $operationType, $operationName),
$inputOrOutput['class'] ?? $inputOrOutput->class,
];
}
private function getSerializerContext($resourceMetadata, string $type = Schema::TYPE_OUTPUT, ?string $operationType = null, ?string $operationName = null): array
{
if ($resourceMetadata instanceof ResourceMetadata) {
$attribute = Schema::TYPE_OUTPUT === $type ? 'normalization_context' : 'denormalization_context';
} else {
$operation = $resourceMetadata->getOperation($operationName);
}
if (null === $operationType || null === $operationName) {
if ($resourceMetadata instanceof ResourceMetadata) {
return $resourceMetadata->getAttribute($attribute, []);
}
return Schema::TYPE_OUTPUT === $type ? ($operation->getNormalizationContext() ?? []) : ($operation->getDenormalizationContext() ?? []);
}
if ($resourceMetadata instanceof ResourceMetadata) {
return $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, $attribute, [], true);
}
return Schema::TYPE_OUTPUT === $type ? ($operation->getNormalizationContext() ?? []) : ($operation->getDenormalizationContext() ?? []);
}
/**
* @param HttpOperation|ResourceMetadata|null $resourceMetadata
*/
private function getValidationGroups($resourceMetadata, ?string $operationType, ?string $operationName): array
{
if ($resourceMetadata instanceof ResourceMetadata) {
$attribute = 'validation_groups';
if (null === $operationType || null === $operationName) {
return \is_array($validationGroups = $resourceMetadata->getAttribute($attribute, [])) ? $validationGroups : [];
}
return \is_array($validationGroups = $resourceMetadata->getTypedOperationAttribute($operationType, $operationName, $attribute, [], true)) ? $validationGroups : [];
}
$groups = $resourceMetadata ? ($resourceMetadata->getValidationContext()['groups'] ?? []) : [];
return \is_array($groups) ? $groups : [$groups];
}
/**
* Gets the options for the property name collection / property metadata factories.
*/
private function getFactoryOptions(array $serializerContext, array $validationGroups, ?string $operationType, ?string $operationName, ?HttpOperation $operation = null): array
{
$options = [
/* @see https://github.com/symfony/symfony/blob/v5.1.0/src/Symfony/Component/PropertyInfo/Extractor/ReflectionExtractor.php */
'enable_getter_setter_extraction' => true,
];
if (isset($serializerContext[AbstractNormalizer::GROUPS])) {
/* @see https://github.com/symfony/symfony/blob/v4.2.6/src/Symfony/Component/PropertyInfo/Extractor/SerializerExtractor.php */
$options['serializer_groups'] = (array) $serializerContext[AbstractNormalizer::GROUPS];
}
if ($this->resourceMetadataFactory instanceof ResourceMetadataCollectionFactoryInterface && $operation) {
$options['normalization_groups'] = $operation->getNormalizationContext()['groups'] ?? null;
$options['denormalization_groups'] = $operation->getDenormalizationContext()['groups'] ?? null;
}
if (null !== $operationType && null !== $operationName) {
switch ($operationType) {
case OperationType::COLLECTION:
$options['collection_operation_name'] = $operationName;
break;
case OperationType::ITEM:
$options['item_operation_name'] = $operationName;
break;
default:
break;
}
}
if ($validationGroups) {
$options['validation_groups'] = $validationGroups;
}
return $options;
}
}

vendor/api-platform/core/src/Core/JsonSchema/SchemaFactory.php line 70