vendor/api-platform/core/src/Symfony/Bundle/DependencyInjection/ApiPlatformExtension.php line 179

  1. <?php
  3. /*
  4.  * This file is part of the API Platform project.
  5.  *
  6.  * (c) Kévin Dunglas <dunglas@gmail.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. declare(strict_types=1);
  14. namespace ApiPlatform\Symfony\Bundle\DependencyInjection;
  16. use ApiPlatform\Doctrine\Odm\Extension\AggregationCollectionExtensionInterface;
  17. use ApiPlatform\Doctrine\Odm\Extension\AggregationItemExtensionInterface;
  18. use ApiPlatform\Doctrine\Odm\Filter\AbstractFilter as DoctrineMongoDbOdmAbstractFilter;
  19. use ApiPlatform\Doctrine\Odm\State\LinksHandlerInterface as OdmLinksHandlerInterface;
  20. use ApiPlatform\Doctrine\Orm\Extension\EagerLoadingExtension;
  21. use ApiPlatform\Doctrine\Orm\Extension\FilterEagerLoadingExtension;
  22. use ApiPlatform\Doctrine\Orm\Extension\QueryCollectionExtensionInterface as DoctrineQueryCollectionExtensionInterface;
  23. use ApiPlatform\Doctrine\Orm\Extension\QueryItemExtensionInterface;
  24. use ApiPlatform\Doctrine\Orm\Filter\AbstractFilter as DoctrineOrmAbstractFilter;
  25. use ApiPlatform\Doctrine\Orm\State\LinksHandlerInterface as OrmLinksHandlerInterface;
  26. use ApiPlatform\Elasticsearch\Extension\RequestBodySearchCollectionExtensionInterface;
  27. use ApiPlatform\GraphQl\Error\ErrorHandlerInterface;
  28. use ApiPlatform\GraphQl\Resolver\MutationResolverInterface;
  29. use ApiPlatform\GraphQl\Resolver\QueryCollectionResolverInterface;
  30. use ApiPlatform\GraphQl\Resolver\QueryItemResolverInterface;
  31. use ApiPlatform\GraphQl\Type\Definition\TypeInterface as GraphQlTypeInterface;
  32. use ApiPlatform\Metadata\ApiResource;
  33. use ApiPlatform\Metadata\FilterInterface;
  34. use ApiPlatform\Metadata\UrlGeneratorInterface;
  35. use ApiPlatform\Metadata\Util\Inflector;
  36. use ApiPlatform\State\ApiResource\Error;
  37. use ApiPlatform\State\ProcessorInterface;
  38. use ApiPlatform\State\ProviderInterface;
  39. use ApiPlatform\Symfony\GraphQl\Resolver\Factory\DataCollectorResolverFactory;
  40. use ApiPlatform\Symfony\Validator\Exception\ValidationException;
  41. use ApiPlatform\Symfony\Validator\Metadata\Property\Restriction\PropertySchemaRestrictionMetadataInterface;
  42. use ApiPlatform\Symfony\Validator\ValidationGroupsGeneratorInterface;
  43. use Doctrine\Persistence\ManagerRegistry;
  44. use phpDocumentor\Reflection\DocBlockFactoryInterface;
  45. use PHPStan\PhpDocParser\Parser\PhpDocParser;
  46. use Ramsey\Uuid\Uuid;
  47. use Symfony\Component\Config\FileLocator;
  48. use Symfony\Component\Config\Resource\DirectoryResource;
  49. use Symfony\Component\DependencyInjection\ContainerBuilder;
  50. use Symfony\Component\DependencyInjection\ContainerInterface;
  51. use Symfony\Component\DependencyInjection\Definition;
  52. use Symfony\Component\DependencyInjection\Exception\RuntimeException;
  53. use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
  54. use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
  55. use Symfony\Component\DependencyInjection\Reference;
  56. use Symfony\Component\Finder\Finder;
  57. use Symfony\Component\HttpClient\ScopingHttpClient;
  58. use Symfony\Component\HttpKernel\DependencyInjection\Extension;
  59. use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
  60. use Symfony\Component\Uid\AbstractUid;
  61. use Symfony\Component\Validator\Validator\ValidatorInterface;
  62. use Symfony\Component\Yaml\Yaml;
  63. use Twig\Environment;
  65. /**
  66.  * The extension of this bundle.
  67.  *
  68.  * @author Kévin Dunglas <dunglas@gmail.com>
  69.  */
  70. final class ApiPlatformExtension extends Extension implements PrependExtensionInterface
  71. {
  72.     /**
  73.      * {@inheritdoc}
  74.      */
  75.     public function prepend(ContainerBuilder $container): void
  76.     {
  77.         if (isset($container->getExtensions()['framework'])) {
  78.             $container->prependExtensionConfig('framework', [
  79.                 'serializer' => [
  80.                     'enabled' => true,
  81.                 ],
  82.             ]);
  83.             $container->prependExtensionConfig('framework', [
  84.                 'property_info' => [
  85.                     'enabled' => true,
  86.                 ],
  87.             ]);
  88.         }
  89.         if (isset($container->getExtensions()['lexik_jwt_authentication'])) {
  90.             $container->prependExtensionConfig('lexik_jwt_authentication', [
  91.                 'api_platform' => [
  92.                     'enabled' => true,
  93.                 ],
  94.             ]);
  95.         }
  96.     }
  98.     /**
  99.      * {@inheritdoc}
  100.      */
  101.     public function load(array $configs, ContainerBuilder $container): void
  102.     {
  103.         $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
  105.         $configuration = new Configuration();
  106.         $config = $this->processConfiguration($configuration, $configs);
  108.         if (!$config['formats']) {
  109.             trigger_deprecation('api-platform/core', '3.2', 'Setting the "formats" section will be mandatory in API Platform 4.');
  110.             $config['formats'] = [
  111.                 'jsonld' => ['mime_types' => ['application/ld+json']],
  112.                 // Note that in API Platform 4 this will be removed as it was used for documentation only and are is now present in the docsFormats
  113.                 'json' => ['mime_types' => ['application/json']], // Swagger support
  114.             ];
  115.         }
  117.         $formats = $this->getFormats($config['formats']);
  118.         $patchFormats = $this->getFormats($config['patch_formats']);
  119.         $errorFormats = $this->getFormats($config['error_formats']);
  120.         $docsFormats = $this->getFormats($config['docs_formats']);
  122.         if (!isset($errorFormats['json'])) {
  123.             $errorFormats['json'] = ['application/problem+json', 'application/json'];
  124.         }
  126.         if (!isset($errorFormats['jsonproblem'])) {
  127.             $errorFormats['jsonproblem'] = ['application/problem+json'];
  128.         }
  130.         if ($this->isConfigEnabled($container, $config['graphql']) && !isset($formats['json'])) {
  131.             trigger_deprecation('api-platform/core', '3.2', 'Add the "json" format to the configuration to use GraphQL.');
  132.             $formats['json'] = ['application/json'];
  133.         }
  135.         // Backward Compatibility layer
  136.         if (isset($formats['jsonapi']) && !isset($patchFormats['jsonapi'])) {
  137.             $patchFormats['jsonapi'] = ['application/vnd.api+json'];
  138.         }
  140.         if (isset($docsFormats['json']) && !isset($docsFormats['jsonopenapi'])) {
  141.             trigger_deprecation('api-platform/core', '3.2', 'The "json" format is too broad, use ["jsonopenapi" => ["application/vnd.openapi+json"]] instead.');
  142.             $docsFormats['jsonopenapi'] = ['application/vnd.openapi+json'];
  143.         }
  145.         $this->registerCommonConfiguration($container, $config, $loader, $formats, $patchFormats, $errorFormats, $docsFormats);
  146.         $this->registerMetadataConfiguration($container, $config, $loader);
  147.         $this->registerOAuthConfiguration($container, $config);
  148.         $this->registerOpenApiConfiguration($container, $config, $loader);
  149.         $this->registerSwaggerConfiguration($container, $config, $loader);
  150.         $this->registerJsonApiConfiguration($formats, $loader, $config);
  151.         $this->registerJsonLdHydraConfiguration($container, $formats, $loader, $config);
  152.         $this->registerJsonHalConfiguration($formats, $loader);
  153.         $this->registerJsonProblemConfiguration($errorFormats, $loader);
  154.         $this->registerGraphQlConfiguration($container, $config, $loader);
  155.         $this->registerCacheConfiguration($container);
  156.         $this->registerDoctrineOrmConfiguration($container, $config, $loader);
  157.         $this->registerDoctrineMongoDbOdmConfiguration($container, $config, $loader);
  158.         $this->registerHttpCacheConfiguration($container, $config, $loader);
  159.         $this->registerValidatorConfiguration($container, $config, $loader);
  160.         $this->registerDataCollectorConfiguration($container, $config, $loader);
  161.         $this->registerMercureConfiguration($container, $config, $loader);
  162.         $this->registerMessengerConfiguration($container, $config, $loader);
  163.         $this->registerElasticsearchConfiguration($container, $config, $loader);
  164.         $this->registerSecurityConfiguration($container, $config, $loader);
  165.         $this->registerMakerConfiguration($container, $config, $loader);
  166.         $this->registerArgumentResolverConfiguration($loader);
  168.         $container->registerForAutoconfiguration(FilterInterface::class)
  169.             ->addTag('api_platform.filter');
  170.         $container->registerForAutoconfiguration(ProviderInterface::class)
  171.             ->addTag('api_platform.state_provider');
  172.         $container->registerForAutoconfiguration(ProcessorInterface::class)
  173.             ->addTag('api_platform.state_processor');
  175.         if (!$container->has('api_platform.state.item_provider')) {
  176.             $container->setAlias('api_platform.state.item_provider', 'api_platform.state_provider.object');
  177.         }
  179.         $this->registerInflectorConfiguration($config);
  180.     }
  182.     private function registerCommonConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader, array $formats, array $patchFormats, array $errorFormats, array $docsFormats): void
  183.     {
  184.         $loader->load('symfony/events.xml');
  185.         $loader->load('symfony/controller.xml');
  186.         $loader->load('api.xml');
  187.         $loader->load('state.xml');
  188.         $loader->load('filter.xml');
  190.         if (class_exists(Uuid::class)) {
  191.             $loader->load('ramsey_uuid.xml');
  192.         }
  194.         if (class_exists(AbstractUid::class)) {
  195.             $loader->load('symfony/uid.xml');
  196.         }
  198.         // TODO: remove in 4.x
  199.         $container->setParameter('api_platform.event_listeners_backward_compatibility_layer', $config['event_listeners_backward_compatibility_layer']);
  200.         $loader->load('legacy/events.xml');
  202.         $container->setParameter('api_platform.enable_entrypoint', $config['enable_entrypoint']);
  203.         $container->setParameter('api_platform.enable_docs', $config['enable_docs']);
  204.         $container->setParameter('api_platform.keep_legacy_inflector', $config['keep_legacy_inflector']);
  205.         $container->setParameter('api_platform.title', $config['title']);
  206.         $container->setParameter('api_platform.description', $config['description']);
  207.         $container->setParameter('api_platform.version', $config['version']);
  208.         $container->setParameter('api_platform.show_webby', $config['show_webby']);
  209.         $container->setParameter('api_platform.url_generation_strategy', $config['defaults']['url_generation_strategy'] ?? UrlGeneratorInterface::ABS_PATH);
  210.         $container->setParameter('api_platform.exception_to_status', $config['exception_to_status']);
  211.         $container->setParameter('api_platform.formats', $formats);
  212.         $container->setParameter('api_platform.patch_formats', $patchFormats);
  213.         $container->setParameter('api_platform.error_formats', $errorFormats);
  214.         $container->setParameter('api_platform.docs_formats', $docsFormats);
  215.         $container->setParameter('api_platform.eager_loading.enabled', $this->isConfigEnabled($container, $config['eager_loading']));
  216.         $container->setParameter('api_platform.eager_loading.max_joins', $config['eager_loading']['max_joins']);
  217.         $container->setParameter('api_platform.eager_loading.fetch_partial', $config['eager_loading']['fetch_partial']);
  218.         $container->setParameter('api_platform.eager_loading.force_eager', $config['eager_loading']['force_eager']);
  219.         $container->setParameter('api_platform.collection.exists_parameter_name', $config['collection']['exists_parameter_name']);
  220.         $container->setParameter('api_platform.collection.order', $config['collection']['order']);
  221.         $container->setParameter('api_platform.collection.order_parameter_name', $config['collection']['order_parameter_name']);
  222.         $container->setParameter('api_platform.collection.order_nulls_comparison', $config['collection']['order_nulls_comparison']);
  223.         $container->setParameter('api_platform.collection.pagination.enabled', $config['defaults']['pagination_enabled'] ?? true);
  224.         $container->setParameter('api_platform.collection.pagination.partial', $config['defaults']['pagination_partial'] ?? false);
  225.         $container->setParameter('api_platform.collection.pagination.client_enabled', $config['defaults']['pagination_client_enabled'] ?? false);
  226.         $container->setParameter('api_platform.collection.pagination.client_items_per_page', $config['defaults']['pagination_client_items_per_page'] ?? false);
  227.         $container->setParameter('api_platform.collection.pagination.client_partial', $config['defaults']['pagination_client_partial'] ?? false);
  228.         $container->setParameter('api_platform.collection.pagination.items_per_page', $config['defaults']['pagination_items_per_page'] ?? 30);
  229.         $container->setParameter('api_platform.collection.pagination.maximum_items_per_page', $config['defaults']['pagination_maximum_items_per_page'] ?? null);
  230.         $container->setParameter('api_platform.collection.pagination.page_parameter_name', $config['defaults']['pagination_page_parameter_name'] ?? $config['collection']['pagination']['page_parameter_name']);
  231.         $container->setParameter('api_platform.collection.pagination.enabled_parameter_name', $config['defaults']['pagination_enabled_parameter_name'] ?? $config['collection']['pagination']['enabled_parameter_name']);
  232.         $container->setParameter('api_platform.collection.pagination.items_per_page_parameter_name', $config['defaults']['pagination_items_per_page_parameter_name'] ?? $config['collection']['pagination']['items_per_page_parameter_name']);
  233.         $container->setParameter('api_platform.collection.pagination.partial_parameter_name', $config['defaults']['pagination_partial_parameter_name'] ?? $config['collection']['pagination']['partial_parameter_name']);
  234.         $container->setParameter('api_platform.collection.pagination', $this->getPaginationDefaults($config['defaults'] ?? [], $config['collection']['pagination']));
  235.         $container->setParameter('api_platform.http_cache.etag', $config['defaults']['cache_headers']['etag'] ?? true);
  236.         $container->setParameter('api_platform.http_cache.max_age', $config['defaults']['cache_headers']['max_age'] ?? null);
  237.         $container->setParameter('api_platform.http_cache.shared_max_age', $config['defaults']['cache_headers']['shared_max_age'] ?? null);
  238.         $container->setParameter('api_platform.http_cache.vary', $config['defaults']['cache_headers']['vary'] ?? ['Accept']);
  239.         $container->setParameter('api_platform.http_cache.public', $config['defaults']['cache_headers']['public'] ?? $config['http_cache']['public']);
  240.         $container->setParameter('api_platform.http_cache.invalidation.max_header_length', $config['defaults']['cache_headers']['invalidation']['max_header_length'] ?? $config['http_cache']['invalidation']['max_header_length']);
  241.         $container->setParameter('api_platform.http_cache.invalidation.xkey.glue', $config['defaults']['cache_headers']['invalidation']['xkey']['glue'] ?? $config['http_cache']['invalidation']['xkey']['glue']);
  243.         $container->setAlias('api_platform.path_segment_name_generator', $config['path_segment_name_generator']);
  245.         if ($config['name_converter']) {
  246.             $container->setAlias('api_platform.name_converter', $config['name_converter']);
  247.         }
  248.         $container->setParameter('api_platform.asset_package', $config['asset_package']);
  249.         $container->setParameter('api_platform.defaults', $this->normalizeDefaults($config['defaults'] ?? []));
  250.         $container->setParameter('api_platform.rfc_7807_compliant_errors', $config['defaults']['extra_properties']['rfc_7807_compliant_errors'] ?? false);
  252.         if ($container->getParameter('kernel.debug')) {
  253.             $container->removeDefinition('api_platform.serializer.mapping.cache_class_metadata_factory');
  254.         }
  255.     }
  257.     /**
  258.      * This method will be removed in 3.0 when "defaults" will be the regular configuration path for the pagination.
  259.      */
  260.     private function getPaginationDefaults(array $defaults, array $collectionPaginationConfiguration): array
  261.     {
  262.         $paginationOptions = [];
  264.         foreach ($defaults as $key => $value) {
  265.             if (!str_starts_with($key, 'pagination_')) {
  266.                 continue;
  267.             }
  269.             $paginationOptions[str_replace('pagination_', '', $key)] = $value;
  270.         }
  272.         return array_merge($collectionPaginationConfiguration, $paginationOptions);
  273.     }
  275.     private function normalizeDefaults(array $defaults): array
  276.     {
  277.         $normalizedDefaults = ['extra_properties' => $defaults['extra_properties'] ?? []];
  278.         unset($defaults['extra_properties']);
  280.         $rc = new \ReflectionClass(ApiResource::class);
  281.         $publicProperties = [];
  282.         foreach ($rc->getConstructor()->getParameters() as $param) {
  283.             $publicProperties[$param->getName()] = true;
  284.         }
  286.         $nameConverter = new CamelCaseToSnakeCaseNameConverter();
  287.         foreach ($defaults as $option => $value) {
  288.             if (isset($publicProperties[$nameConverter->denormalize($option)])) {
  289.                 $normalizedDefaults[$option] = $value;
  291.                 continue;
  292.             }
  294.             $normalizedDefaults['extra_properties'][$option] = $value;
  295.         }
  297.         return $normalizedDefaults;
  298.     }
  300.     private function registerMetadataConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  301.     {
  302.         [$xmlResources, $yamlResources] = $this->getResourcesToWatch($container, $config);
  304.         $container->setParameter('api_platform.class_name_resources', $this->getClassNameResources());
  306.         $loader->load('metadata/resource_name.xml');
  307.         $loader->load('metadata/property_name.xml');
  309.         if (!empty($config['resource_class_directories'])) {
  310.             $container->setParameter('api_platform.resource_class_directories', array_merge(
  311.                 $config['resource_class_directories'],
  312.                 $container->getParameter('api_platform.resource_class_directories')
  313.             ));
  314.         }
  316.         // V3 metadata
  317.         $loader->load('metadata/xml.xml');
  318.         $loader->load('metadata/links.xml');
  319.         $loader->load('metadata/property.xml');
  320.         $loader->load('metadata/resource.xml');
  321.         $loader->load('metadata/operation.xml');
  323.         $container->getDefinition('api_platform.metadata.resource_extractor.xml')->replaceArgument(0, $xmlResources);
  324.         $container->getDefinition('api_platform.metadata.property_extractor.xml')->replaceArgument(0, $xmlResources);
  326.         if (class_exists(PhpDocParser::class) || interface_exists(DocBlockFactoryInterface::class)) {
  327.             $loader->load('metadata/php_doc.xml');
  328.         }
  330.         if (class_exists(Yaml::class)) {
  331.             $loader->load('metadata/yaml.xml');
  332.             $container->getDefinition('api_platform.metadata.resource_extractor.yaml')->replaceArgument(0, $yamlResources);
  333.             $container->getDefinition('api_platform.metadata.property_extractor.yaml')->replaceArgument(0, $yamlResources);
  334.         }
  335.     }
  337.     private function getClassNameResources(): array
  338.     {
  339.         return [
  340.             Error::class,
  341.             ValidationException::class,
  342.         ];
  343.     }
  345.     private function getBundlesResourcesPaths(ContainerBuilder $container, array $config): array
  346.     {
  347.         $bundlesResourcesPaths = [];
  349.         foreach ($container->getParameter('kernel.bundles_metadata') as $bundle) {
  350.             $dirname = $bundle['path'];
  351.             $paths = [
  352.                 "$dirname/ApiResource",
  353.                 "$dirname/src/ApiResource",
  354.             ];
  355.             foreach (['.yaml', '.yml', '.xml', ''] as $extension) {
  356.                 $paths[] = "$dirname/Resources/config/api_resources$extension";
  357.                 $paths[] = "$dirname/config/api_resources$extension";
  358.             }
  359.             if ($this->isConfigEnabled($container, $config['doctrine'])) {
  360.                 $paths[] = "$dirname/Entity";
  361.                 $paths[] = "$dirname/src/Entity";
  362.             }
  363.             if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
  364.                 $paths[] = "$dirname/Document";
  365.                 $paths[] = "$dirname/src/Document";
  366.             }
  368.             foreach ($paths as $path) {
  369.                 if ($container->fileExists($path, false)) {
  370.                     $bundlesResourcesPaths[] = $path;
  371.                 }
  372.             }
  373.         }
  375.         return $bundlesResourcesPaths;
  376.     }
  378.     private function getResourcesToWatch(ContainerBuilder $container, array $config): array
  379.     {
  380.         $paths = array_unique(array_merge($this->getBundlesResourcesPaths($container, $config), $config['mapping']['paths']));
  382.         if (!$config['mapping']['paths']) {
  383.             $projectDir = $container->getParameter('kernel.project_dir');
  384.             foreach (["$projectDir/config/api_platform", "$projectDir/src/ApiResource"] as $dir) {
  385.                 if (is_dir($dir)) {
  386.                     $paths[] = $dir;
  387.                 }
  388.             }
  390.             if ($this->isConfigEnabled($container, $config['doctrine']) && is_dir($doctrinePath = "$projectDir/src/Entity")) {
  391.                 $paths[] = $doctrinePath;
  392.             }
  394.             if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm']) && is_dir($documentPath = "$projectDir/src/Document")) {
  395.                 $paths[] = $documentPath;
  396.             }
  397.         }
  399.         $resources = ['yml' => [], 'xml' => [], 'dir' => []];
  401.         foreach ($paths as $path) {
  402.             if (is_dir($path)) {
  403.                 foreach (Finder::create()->followLinks()->files()->in($path)->name('/\.(xml|ya?ml)$/')->sortByName() as $file) {
  404.                     $resources['yaml' === ($extension = $file->getExtension()) ? 'yml' : $extension][] = $file->getRealPath();
  405.                 }
  407.                 $resources['dir'][] = $path;
  408.                 $container->addResource(new DirectoryResource($path, '/\.(xml|ya?ml|php)$/'));
  410.                 continue;
  411.             }
  413.             if ($container->fileExists($path, false)) {
  414.                 if (!preg_match('/\.(xml|ya?ml)$/', (string) $path, $matches)) {
  415.                     throw new RuntimeException(sprintf('Unsupported mapping type in "%s", supported types are XML & YAML.', $path));
  416.                 }
  418.                 $resources['yaml' === $matches[1] ? 'yml' : $matches[1]][] = $path;
  420.                 continue;
  421.             }
  423.             throw new RuntimeException(sprintf('Could not open file or directory "%s".', $path));
  424.         }
  426.         $container->setParameter('api_platform.resource_class_directories', $resources['dir']);
  428.         return [$resources['xml'], $resources['yml']];
  429.     }
  431.     private function registerOAuthConfiguration(ContainerBuilder $container, array $config): void
  432.     {
  433.         if (!$config['oauth']) {
  434.             return;
  435.         }
  437.         $container->setParameter('api_platform.oauth.enabled', $this->isConfigEnabled($container, $config['oauth']));
  438.         $container->setParameter('api_platform.oauth.clientId', $config['oauth']['clientId']);
  439.         $container->setParameter('api_platform.oauth.clientSecret', $config['oauth']['clientSecret']);
  440.         $container->setParameter('api_platform.oauth.type', $config['oauth']['type']);
  441.         $container->setParameter('api_platform.oauth.flow', $config['oauth']['flow']);
  442.         $container->setParameter('api_platform.oauth.tokenUrl', $config['oauth']['tokenUrl']);
  443.         $container->setParameter('api_platform.oauth.authorizationUrl', $config['oauth']['authorizationUrl']);
  444.         $container->setParameter('api_platform.oauth.refreshUrl', $config['oauth']['refreshUrl']);
  445.         $container->setParameter('api_platform.oauth.scopes', $config['oauth']['scopes']);
  446.         $container->setParameter('api_platform.oauth.pkce', $config['oauth']['pkce']);
  448.         if ($container->hasDefinition('api_platform.swagger_ui.action')) {
  449.             $container->getDefinition('api_platform.swagger_ui.action')->setArgument(10, $config['oauth']['pkce']);
  450.         }
  451.     }
  453.     /**
  454.      * Registers the Swagger, ReDoc and Swagger UI configuration.
  455.      */
  456.     private function registerSwaggerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  457.     {
  458.         foreach (array_keys($config['swagger']['api_keys']) as $keyName) {
  459.             if (!preg_match('/^[a-zA-Z0-9._-]+$/', $keyName)) {
  460.                 trigger_deprecation('api-platform/core', '3.1', sprintf('The swagger api_keys key "%s" is not valid with OpenAPI 3.1 it should match "^[a-zA-Z0-9._-]+$"', $keyName));
  461.             }
  462.         }
  464.         $container->setParameter('api_platform.swagger.versions', $config['swagger']['versions']);
  466.         if (!$config['enable_swagger'] && $config['enable_swagger_ui']) {
  467.             throw new RuntimeException('You can not enable the Swagger UI without enabling Swagger, fix this by enabling swagger via the configuration "enable_swagger: true".');
  468.         }
  470.         if (!$config['enable_swagger']) {
  471.             return;
  472.         }
  474.         $loader->load('openapi.xml');
  475.         $loader->load('swagger_ui.xml');
  477.         $loader->load('legacy/swagger_ui.xml');
  479.         if (!$config['enable_swagger_ui'] && !$config['enable_re_doc']) {
  480.             // Remove the listener but keep the controller to allow customizing the path of the UI
  481.             $container->removeDefinition('api_platform.swagger.listener.ui');
  482.         }
  484.         $container->setParameter('api_platform.enable_swagger_ui', $config['enable_swagger_ui']);
  485.         $container->setParameter('api_platform.enable_re_doc', $config['enable_re_doc']);
  486.         $container->setParameter('api_platform.swagger.api_keys', $config['swagger']['api_keys']);
  487.         if ($config['openapi']['swagger_ui_extra_configuration'] && $config['swagger']['swagger_ui_extra_configuration']) {
  488.             throw new RuntimeException('You can not set "swagger_ui_extra_configuration" twice - in "openapi" and "swagger" section.');
  489.         }
  490.         $container->setParameter('api_platform.swagger_ui.extra_configuration', $config['openapi']['swagger_ui_extra_configuration'] ?: $config['swagger']['swagger_ui_extra_configuration']);
  491.     }
  493.     private function registerJsonApiConfiguration(array $formats, XmlFileLoader $loader, array $config): void
  494.     {
  495.         if (!isset($formats['jsonapi'])) {
  496.             return;
  497.         }
  499.         $loader->load('jsonapi.xml');
  500.         $loader->load('legacy/jsonapi.xml');
  501.     }
  503.     private function registerJsonLdHydraConfiguration(ContainerBuilder $container, array $formats, XmlFileLoader $loader, array $config): void
  504.     {
  505.         if (!isset($formats['jsonld'])) {
  506.             return;
  507.         }
  509.         $loader->load('jsonld.xml');
  510.         $loader->load('legacy/hydra.xml');
  511.         $loader->load('hydra.xml');
  513.         if (!$container->has('api_platform.json_schema.schema_factory')) {
  514.             $container->removeDefinition('api_platform.hydra.json_schema.schema_factory');
  515.         }
  517.         if (!$config['enable_docs']) {
  518.             $container->removeDefinition('api_platform.hydra.listener.response.add_link_header');
  519.         }
  520.     }
  522.     private function registerJsonHalConfiguration(array $formats, XmlFileLoader $loader): void
  523.     {
  524.         if (!isset($formats['jsonhal'])) {
  525.             return;
  526.         }
  528.         $loader->load('hal.xml');
  529.     }
  531.     private function registerJsonProblemConfiguration(array $errorFormats, XmlFileLoader $loader): void
  532.     {
  533.         if (!isset($errorFormats['jsonproblem'])) {
  534.             return;
  535.         }
  537.         $loader->load('problem.xml');
  538.     }
  540.     private function registerGraphQlConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  541.     {
  542.         $enabled = $this->isConfigEnabled($container, $config['graphql']);
  544.         $graphqlIntrospectionEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['introspection']);
  546.         $graphiqlEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphiql']);
  547.         $graphqlPlayGroundEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphql_playground']);
  548.         if ($graphqlPlayGroundEnabled) {
  549.             trigger_deprecation('api-platform/core', '3.1', 'GraphQL Playground is deprecated and will be removed in API Platform 4.0. Only GraphiQL will be available in the future. Set api_platform.graphql.graphql_playground to false in the configuration to remove this deprecation.');
  550.         }
  552.         $container->setParameter('api_platform.graphql.enabled', $enabled);
  553.         $container->setParameter('api_platform.graphql.introspection.enabled', $graphqlIntrospectionEnabled);
  554.         $container->setParameter('api_platform.graphql.graphiql.enabled', $graphiqlEnabled);
  555.         $container->setParameter('api_platform.graphql.graphql_playground.enabled', $graphqlPlayGroundEnabled);
  556.         $container->setParameter('api_platform.graphql.collection.pagination', $config['graphql']['collection']['pagination']);
  558.         if (!$enabled) {
  559.             return;
  560.         }
  562.         $container->setParameter('api_platform.graphql.default_ide', $config['graphql']['default_ide']);
  563.         $container->setParameter('api_platform.graphql.nesting_separator', $config['graphql']['nesting_separator']);
  565.         $loader->load('graphql.xml');
  567.         // @phpstan-ignore-next-line because PHPStan uses the container of the test env cache and in test the parameter kernel.bundles always contains the key TwigBundle
  568.         if (!class_exists(Environment::class) || !isset($container->getParameter('kernel.bundles')['TwigBundle'])) {
  569.             if ($graphiqlEnabled || $graphqlPlayGroundEnabled) {
  570.                 throw new RuntimeException(sprintf('GraphiQL and GraphQL Playground interfaces depend on Twig. Please activate TwigBundle for the %s environnement or disable GraphiQL and GraphQL Playground.', $container->getParameter('kernel.environment')));
  571.             }
  572.             $container->removeDefinition('api_platform.graphql.action.graphiql');
  573.             $container->removeDefinition('api_platform.graphql.action.graphql_playground');
  574.         }
  576.         $container->registerForAutoconfiguration(QueryItemResolverInterface::class)
  577.             ->addTag('api_platform.graphql.resolver');
  578.         $container->registerForAutoconfiguration(QueryCollectionResolverInterface::class)
  579.             ->addTag('api_platform.graphql.resolver');
  580.         $container->registerForAutoconfiguration(MutationResolverInterface::class)
  581.             ->addTag('api_platform.graphql.resolver');
  582.         $container->registerForAutoconfiguration(GraphQlTypeInterface::class)
  583.             ->addTag('api_platform.graphql.type');
  584.         $container->registerForAutoconfiguration(ErrorHandlerInterface::class)
  585.             ->addTag('api_platform.graphql.error_handler');
  587.         /* TODO: remove these in 4.x only one resolver factory is used and we're using providers/processors */
  588.         if ($config['event_listeners_backward_compatibility_layer'] ?? true) {
  589.             // @TODO: API Platform 3.3 trigger_deprecation('api-platform/core', '3.3', 'In API Platform 4 only one factory "api_platform.graphql.resolver.factory.item" will remain. Stages are deprecated in favor of using a provider/processor.');
  590.             // + deprecate every service from legacy/graphql.xml
  591.             $loader->load('legacy/graphql.xml');
  593.             if (!$container->getParameter('kernel.debug')) {
  594.                 return;
  595.             }
  597.             $requestStack = new Reference('request_stack', ContainerInterface::NULL_ON_INVALID_REFERENCE);
  598.             $collectionDataCollectorResolverFactory = (new Definition(DataCollectorResolverFactory::class))
  599.                 ->setDecoratedService('api_platform.graphql.resolver.factory.collection')
  600.                 ->setArguments([new Reference('api_platform.graphql.data_collector.resolver.factory.collection.inner'), $requestStack]);
  602.             $itemDataCollectorResolverFactory = (new Definition(DataCollectorResolverFactory::class))
  603.                 ->setDecoratedService('api_platform.graphql.resolver.factory.item')
  604.                 ->setArguments([new Reference('api_platform.graphql.data_collector.resolver.factory.item.inner'), $requestStack]);
  606.             $itemMutationDataCollectorResolverFactory = (new Definition(DataCollectorResolverFactory::class))
  607.                 ->setDecoratedService('api_platform.graphql.resolver.factory.item_mutation')
  608.                 ->setArguments([new Reference('api_platform.graphql.data_collector.resolver.factory.item_mutation.inner'), $requestStack]);
  610.             $itemSubscriptionDataCollectorResolverFactory = (new Definition(DataCollectorResolverFactory::class))
  611.                 ->setDecoratedService('api_platform.graphql.resolver.factory.item_subscription')
  612.                 ->setArguments([new Reference('api_platform.graphql.data_collector.resolver.factory.item_subscription.inner'), $requestStack]);
  614.             $container->addDefinitions([
  615.                 'api_platform.graphql.data_collector.resolver.factory.collection' => $collectionDataCollectorResolverFactory,
  616.                 'api_platform.graphql.data_collector.resolver.factory.item' => $itemDataCollectorResolverFactory,
  617.                 'api_platform.graphql.data_collector.resolver.factory.item_mutation' => $itemMutationDataCollectorResolverFactory,
  618.                 'api_platform.graphql.data_collector.resolver.factory.item_subscription' => $itemSubscriptionDataCollectorResolverFactory,
  619.             ]);
  620.         }
  621.     }
  623.     private function registerCacheConfiguration(ContainerBuilder $container): void
  624.     {
  625.         if (!$container->hasParameter('kernel.debug') || !$container->getParameter('kernel.debug')) {
  626.             $container->removeDefinition('api_platform.cache_warmer.cache_pool_clearer');
  627.         }
  628.     }
  630.     private function registerDoctrineOrmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  631.     {
  632.         if (!$this->isConfigEnabled($container, $config['doctrine'])) {
  633.             return;
  634.         }
  636.         // For older versions of doctrine bridge this allows autoconfiguration for filters
  637.         if (!$container->has(ManagerRegistry::class)) {
  638.             $container->setAlias(ManagerRegistry::class, 'doctrine');
  639.         }
  641.         $container->registerForAutoconfiguration(QueryItemExtensionInterface::class)
  642.             ->addTag('api_platform.doctrine.orm.query_extension.item');
  643.         $container->registerForAutoconfiguration(DoctrineQueryCollectionExtensionInterface::class)
  644.             ->addTag('api_platform.doctrine.orm.query_extension.collection');
  645.         $container->registerForAutoconfiguration(DoctrineOrmAbstractFilter::class);
  647.         $container->registerForAutoconfiguration(OrmLinksHandlerInterface::class)
  648.             ->addTag('api_platform.doctrine.orm.links_handler');
  650.         $loader->load('doctrine_orm.xml');
  652.         if ($this->isConfigEnabled($container, $config['eager_loading'])) {
  653.             return;
  654.         }
  656.         $container->removeAlias(EagerLoadingExtension::class);
  657.         $container->removeDefinition('api_platform.doctrine.orm.query_extension.eager_loading');
  658.         $container->removeAlias(FilterEagerLoadingExtension::class);
  659.         $container->removeDefinition('api_platform.doctrine.orm.query_extension.filter_eager_loading');
  660.     }
  662.     private function registerDoctrineMongoDbOdmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  663.     {
  664.         if (!$this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
  665.             return;
  666.         }
  668.         $container->registerForAutoconfiguration(AggregationItemExtensionInterface::class)
  669.             ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.item');
  670.         $container->registerForAutoconfiguration(AggregationCollectionExtensionInterface::class)
  671.             ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.collection');
  672.         $container->registerForAutoconfiguration(DoctrineMongoDbOdmAbstractFilter::class)
  673.             ->setBindings(['$managerRegistry' => new Reference('doctrine_mongodb')]);
  674.         $container->registerForAutoconfiguration(OdmLinksHandlerInterface::class)
  675.             ->addTag('api_platform.doctrine.odm.links_handler');
  677.         $loader->load('doctrine_mongodb_odm.xml');
  678.     }
  680.     private function registerHttpCacheConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  681.     {
  682.         $loader->load('http_cache.xml');
  683.         $loader->load('legacy/http_cache.xml');
  685.         if (!$this->isConfigEnabled($container, $config['http_cache']['invalidation'])) {
  686.             return;
  687.         }
  689.         if ($this->isConfigEnabled($container, $config['doctrine'])) {
  690.             $loader->load('doctrine_orm_http_cache_purger.xml');
  691.         }
  693.         $loader->load('http_cache_purger.xml');
  694.         $loader->load('legacy/http_cache_purger.xml');
  696.         foreach ($config['http_cache']['invalidation']['scoped_clients'] as $client) {
  697.             $definition = $container->getDefinition($client);
  698.             $definition->addTag('api_platform.http_cache.http_client');
  699.         }
  701.         if (!($urls = $config['http_cache']['invalidation']['urls'])) {
  702.             $urls = $config['http_cache']['invalidation']['varnish_urls'];
  703.         }
  705.         foreach ($urls as $key => $url) {
  706.             $definition = new Definition(ScopingHttpClient::class, [new Reference('http_client'), $url, ['base_uri' => $url] + $config['http_cache']['invalidation']['request_options']]);
  707.             $definition->setFactory([ScopingHttpClient::class, 'forBaseUri']);
  708.             $definition->addTag('api_platform.http_cache.http_client');
  709.             $container->setDefinition('api_platform.invalidation_http_client.'.$key, $definition);
  710.         }
  712.         $serviceName = $config['http_cache']['invalidation']['purger'];
  714.         if (!$container->hasDefinition('api_platform.http_cache.purger')) {
  715.             $container->setAlias('api_platform.http_cache.purger', $serviceName);
  716.         }
  717.     }
  719.     /**
  720.      * Normalizes the format from config to the one accepted by Symfony HttpFoundation.
  721.      */
  722.     private function getFormats(array $configFormats): array
  723.     {
  724.         $formats = [];
  725.         foreach ($configFormats as $format => $value) {
  726.             foreach ($value['mime_types'] as $mimeType) {
  727.                 $formats[$format][] = $mimeType;
  728.             }
  729.         }
  731.         return $formats;
  732.     }
  734.     private function registerValidatorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  735.     {
  736.         if (interface_exists(ValidatorInterface::class)) {
  737.             $loader->load('metadata/validator.xml');
  738.             $loader->load('symfony/validator.xml');
  740.             if ($this->isConfigEnabled($container, $config['graphql'])) {
  741.                 $loader->load('graphql/validator.xml');
  742.             }
  744.             $container->registerForAutoconfiguration(ValidationGroupsGeneratorInterface::class)
  745.                 ->addTag('api_platform.validation_groups_generator');
  746.             $container->registerForAutoconfiguration(PropertySchemaRestrictionMetadataInterface::class)
  747.                 ->addTag('api_platform.metadata.property_schema_restriction');
  749.             $loader->load('legacy/validator.xml');
  750.         }
  752.         if (!$config['validator']) {
  753.             return;
  754.         }
  756.         $container->setParameter('api_platform.validator.serialize_payload_fields', $config['validator']['serialize_payload_fields']);
  757.         $container->setParameter('api_platform.validator.query_parameter_validation', $config['validator']['query_parameter_validation']);
  759.         if (!$config['validator']['query_parameter_validation']) {
  760.             $container->removeDefinition('api_platform.listener.view.validate_query_parameters');
  761.             $container->removeDefinition('api_platform.validator.query_parameter_validator');
  762.         }
  763.     }
  765.     private function registerDataCollectorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  766.     {
  767.         if (!$config['enable_profiler']) {
  768.             return;
  769.         }
  771.         $loader->load('data_collector.xml');
  773.         if ($container->hasParameter('kernel.debug') && $container->getParameter('kernel.debug')) {
  774.             $loader->load('debug.xml');
  775.         }
  776.     }
  778.     private function registerMercureConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  779.     {
  780.         if (!$this->isConfigEnabled($container, $config['mercure'])) {
  781.             return;
  782.         }
  784.         $container->setParameter('api_platform.mercure.include_type', $config['mercure']['include_type']);
  786.         $loader->load('legacy/mercure.xml');
  787.         $loader->load('mercure.xml');
  789.         if ($this->isConfigEnabled($container, $config['doctrine'])) {
  790.             $loader->load('doctrine_orm_mercure_publisher.xml');
  791.         }
  792.         if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
  793.             $loader->load('doctrine_odm_mercure_publisher.xml');
  794.         }
  796.         if ($this->isConfigEnabled($container, $config['graphql'])) {
  797.             $loader->load('graphql_mercure.xml');
  798.         }
  799.     }
  801.     private function registerMessengerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  802.     {
  803.         if (!$this->isConfigEnabled($container, $config['messenger'])) {
  804.             return;
  805.         }
  807.         $loader->load('messenger.xml');
  808.     }
  810.     private function registerElasticsearchConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  811.     {
  812.         $enabled = $this->isConfigEnabled($container, $config['elasticsearch']);
  814.         $container->setParameter('api_platform.elasticsearch.enabled', $enabled);
  816.         if (!$enabled) {
  817.             return;
  818.         }
  820.         $clientClass = class_exists(\Elasticsearch\Client::class) ? \Elasticsearch\Client::class : \Elastic\Elasticsearch\Client::class;
  822.         $clientDefinition = new Definition($clientClass);
  823.         $container->setDefinition('api_platform.elasticsearch.client', $clientDefinition);
  824.         $container->registerForAutoconfiguration(RequestBodySearchCollectionExtensionInterface::class)
  825.             ->addTag('api_platform.elasticsearch.request_body_search_extension.collection');
  826.         $container->setParameter('api_platform.elasticsearch.hosts', $config['elasticsearch']['hosts']);
  827.         $loader->load('elasticsearch.xml');
  829.         // @phpstan-ignore-next-line
  830.         if (\Elasticsearch\Client::class === $clientClass) {
  831.             $loader->load('legacy/elasticsearch.xml');
  832.             $container->setParameter('api_platform.elasticsearch.mapping', $config['elasticsearch']['mapping']);
  833.             $container->setDefinition('api_platform.elasticsearch.client_for_metadata', $clientDefinition);
  834.         }
  835.     }
  837.     private function registerSecurityConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  838.     {
  839.         /** @var string[] $bundles */
  840.         $bundles = $container->getParameter('kernel.bundles');
  842.         if (!isset($bundles['SecurityBundle'])) {
  843.             return;
  844.         }
  846.         $loader->load('security.xml');
  847.         $loader->load('legacy/security.xml');
  849.         if (interface_exists(ValidatorInterface::class)) {
  850.             $loader->load('symfony/security_validator.xml');
  851.         }
  853.         if ($this->isConfigEnabled($container, $config['graphql'])) {
  854.             $loader->load('graphql/security.xml');
  855.         }
  856.     }
  858.     private function registerOpenApiConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  859.     {
  860.         $container->setParameter('api_platform.openapi.termsOfService', $config['openapi']['termsOfService']);
  861.         $container->setParameter('api_platform.openapi.contact.name', $config['openapi']['contact']['name']);
  862.         $container->setParameter('api_platform.openapi.contact.url', $config['openapi']['contact']['url']);
  863.         $container->setParameter('api_platform.openapi.contact.email', $config['openapi']['contact']['email']);
  864.         $container->setParameter('api_platform.openapi.license.name', $config['openapi']['license']['name']);
  865.         $container->setParameter('api_platform.openapi.license.url', $config['openapi']['license']['url']);
  867.         $loader->load('json_schema.xml');
  868.     }
  870.     private function registerMakerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
  871.     {
  872.         if (!$this->isConfigEnabled($container, $config['maker'])) {
  873.             return;
  874.         }
  876.         $loader->load('maker.xml');
  877.     }
  879.     private function registerArgumentResolverConfiguration(XmlFileLoader $loader): void
  880.     {
  881.         $loader->load('argument_resolver.xml');
  882.     }
  884.     private function registerInflectorConfiguration(array $config): void
  885.     {
  886.         if ($config['keep_legacy_inflector']) {
  887.             Inflector::keepLegacyInflector(true);
  888.             trigger_deprecation('api-platform/core', '3.2', 'Using doctrine/inflector is deprecated since API Platform 3.2 and will be removed in API Platform 4. Use symfony/string instead. Run "composer require symfony/string" and set "keep_legacy_inflector" to false in config.');
  889.         } else {
  890.             Inflector::keepLegacyInflector(false);
  891.         }
  892.     }
  893. }