• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

api-platform / core / 15776163904

20 Jun 2025 09:46AM UTC coverage: 22.507% (+0.01%) from 22.493%
15776163904

push

github

soyuka
fix(symfony): missing GroupSequence type for validation groups

fixes #7228

11084 of 49246 relevant lines covered (22.51%)

11.07 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

79.0
/src/Symfony/Bundle/DependencyInjection/ApiPlatformExtension.php
1
<?php
2

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
 */
11

12
declare(strict_types=1);
13

14
namespace ApiPlatform\Symfony\Bundle\DependencyInjection;
15

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\Executor;
29
use ApiPlatform\GraphQl\Resolver\MutationResolverInterface;
30
use ApiPlatform\GraphQl\Resolver\QueryCollectionResolverInterface;
31
use ApiPlatform\GraphQl\Resolver\QueryItemResolverInterface;
32
use ApiPlatform\GraphQl\Type\Definition\TypeInterface as GraphQlTypeInterface;
33
use ApiPlatform\Metadata\ApiResource;
34
use ApiPlatform\Metadata\FilterInterface;
35
use ApiPlatform\Metadata\UriVariableTransformerInterface;
36
use ApiPlatform\Metadata\UrlGeneratorInterface;
37
use ApiPlatform\OpenApi\Model\Tag;
38
use ApiPlatform\RamseyUuid\Serializer\UuidDenormalizer;
39
use ApiPlatform\State\ApiResource\Error;
40
use ApiPlatform\State\ParameterProviderInterface;
41
use ApiPlatform\State\ProcessorInterface;
42
use ApiPlatform\State\ProviderInterface;
43
use ApiPlatform\Symfony\Validator\Metadata\Property\Restriction\PropertySchemaRestrictionMetadataInterface;
44
use ApiPlatform\Symfony\Validator\ValidationGroupsGeneratorInterface;
45
use ApiPlatform\Validator\Exception\ValidationException;
46
use Doctrine\Persistence\ManagerRegistry;
47
use phpDocumentor\Reflection\DocBlockFactoryInterface;
48
use PHPStan\PhpDocParser\Parser\PhpDocParser;
49
use Ramsey\Uuid\Uuid;
50
use Symfony\Component\Config\FileLocator;
51
use Symfony\Component\Config\Resource\DirectoryResource;
52
use Symfony\Component\DependencyInjection\ContainerBuilder;
53
use Symfony\Component\DependencyInjection\Definition;
54
use Symfony\Component\DependencyInjection\Exception\RuntimeException;
55
use Symfony\Component\DependencyInjection\Extension\Extension;
56
use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
57
use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
58
use Symfony\Component\DependencyInjection\Reference;
59
use Symfony\Component\Finder\Finder;
60
use Symfony\Component\HttpClient\ScopingHttpClient;
61
use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
62
use Symfony\Component\Uid\AbstractUid;
63
use Symfony\Component\Validator\Validator\ValidatorInterface;
64
use Symfony\Component\Yaml\Yaml;
65
use Twig\Environment;
66

67
/**
68
 * The extension of this bundle.
69
 *
70
 * @author Kévin Dunglas <dunglas@gmail.com>
71
 */
72
final class ApiPlatformExtension extends Extension implements PrependExtensionInterface
73
{
74
    /**
75
     * {@inheritdoc}
76
     */
77
    public function prepend(ContainerBuilder $container): void
78
    {
79
        if (isset($container->getExtensions()['framework'])) {
1✔
80
            $container->prependExtensionConfig('framework', [
1✔
81
                'serializer' => [
1✔
82
                    'enabled' => true,
1✔
83
                ],
1✔
84
            ]);
1✔
85
            $container->prependExtensionConfig('framework', [
1✔
86
                'property_info' => [
1✔
87
                    'enabled' => true,
1✔
88
                ],
1✔
89
            ]);
1✔
90
        }
91
        if (isset($container->getExtensions()['lexik_jwt_authentication'])) {
1✔
92
            $container->prependExtensionConfig('lexik_jwt_authentication', [
×
93
                'api_platform' => [
×
94
                    'enabled' => true,
×
95
                ],
×
96
            ]);
×
97
        }
98
    }
99

100
    /**
101
     * {@inheritdoc}
102
     */
103
    public function load(array $configs, ContainerBuilder $container): void
104
    {
105
        $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config'));
1✔
106

107
        $configuration = new Configuration();
1✔
108
        $config = $this->processConfiguration($configuration, $configs);
1✔
109
        $container->setParameter('api_platform.use_symfony_listeners', $config['use_symfony_listeners']);
1✔
110

111
        $formats = $this->getFormats($config['formats']);
1✔
112
        $patchFormats = $this->getFormats($config['patch_formats']);
1✔
113
        $errorFormats = $this->getFormats($config['error_formats']);
1✔
114
        $docsFormats = $this->getFormats($config['docs_formats']);
1✔
115
        if (!$config['enable_docs']) {
1✔
116
            // JSON-LD documentation format is mandatory, even if documentation is disabled.
117
            $docsFormats = isset($formats['jsonld']) ? ['jsonld' => ['application/ld+json']] : [];
×
118
            // If documentation is disabled, the Hydra documentation for all the resources is hidden by default.
119
            if (!isset($config['defaults']['hideHydraOperation']) && !isset($config['defaults']['hide_hydra_operation'])) {
×
120
                $config['defaults']['hideHydraOperation'] = true;
×
121
            }
122
        }
123
        $jsonSchemaFormats = $config['jsonschema_formats'];
1✔
124

125
        if (!$jsonSchemaFormats) {
1✔
126
            foreach (array_merge(array_keys($formats), array_keys($errorFormats)) as $f) {
1✔
127
                // Distinct JSON-based formats must have names that start with 'json'
128
                if (str_starts_with($f, 'json')) {
1✔
129
                    $jsonSchemaFormats[$f] = true;
1✔
130
                }
131
            }
132
        }
133

134
        if (!isset($errorFormats['json'])) {
1✔
135
            $errorFormats['json'] = ['application/problem+json', 'application/json'];
1✔
136
        }
137

138
        if (!isset($errorFormats['jsonproblem'])) {
1✔
139
            $errorFormats['jsonproblem'] = ['application/problem+json'];
×
140
        }
141

142
        if (isset($formats['jsonapi']) && !isset($patchFormats['jsonapi'])) {
1✔
143
            $patchFormats['jsonapi'] = ['application/vnd.api+json'];
1✔
144
        }
145

146
        $this->registerCommonConfiguration($container, $config, $loader, $formats, $patchFormats, $errorFormats, $docsFormats, $jsonSchemaFormats);
1✔
147
        $this->registerMetadataConfiguration($container, $config, $loader);
1✔
148
        $this->registerOAuthConfiguration($container, $config);
1✔
149
        $this->registerOpenApiConfiguration($container, $config, $loader);
1✔
150
        $this->registerSwaggerConfiguration($container, $config, $loader);
1✔
151
        $this->registerJsonApiConfiguration($formats, $loader, $config);
1✔
152
        $this->registerJsonLdHydraConfiguration($container, $formats, $loader, $config);
1✔
153
        $this->registerJsonHalConfiguration($formats, $loader);
1✔
154
        $this->registerJsonProblemConfiguration($errorFormats, $loader);
1✔
155
        $this->registerGraphQlConfiguration($container, $config, $loader);
1✔
156
        $this->registerCacheConfiguration($container);
1✔
157
        $this->registerDoctrineOrmConfiguration($container, $config, $loader);
1✔
158
        $this->registerDoctrineMongoDbOdmConfiguration($container, $config, $loader);
1✔
159
        $this->registerHttpCacheConfiguration($container, $config, $loader);
1✔
160
        $this->registerValidatorConfiguration($container, $config, $loader);
1✔
161
        $this->registerDataCollectorConfiguration($container, $config, $loader);
1✔
162
        $this->registerMercureConfiguration($container, $config, $loader);
1✔
163
        $this->registerMessengerConfiguration($container, $config, $loader);
1✔
164
        $this->registerElasticsearchConfiguration($container, $config, $loader);
1✔
165
        $this->registerSecurityConfiguration($container, $config, $loader);
1✔
166
        $this->registerMakerConfiguration($container, $config, $loader);
1✔
167
        $this->registerArgumentResolverConfiguration($loader);
1✔
168
        $this->registerLinkSecurityConfiguration($loader, $config);
1✔
169

170
        $container->registerForAutoconfiguration(FilterInterface::class)
1✔
171
            ->addTag('api_platform.filter');
1✔
172
        $container->registerForAutoconfiguration(ProviderInterface::class)
1✔
173
            ->addTag('api_platform.state_provider');
1✔
174
        $container->registerForAutoconfiguration(ProcessorInterface::class)
1✔
175
            ->addTag('api_platform.state_processor');
1✔
176
        $container->registerForAutoconfiguration(UriVariableTransformerInterface::class)
1✔
177
            ->addTag('api_platform.uri_variables.transformer');
1✔
178
        $container->registerForAutoconfiguration(ParameterProviderInterface::class)
1✔
179
            ->addTag('api_platform.parameter_provider');
1✔
180

181
        if (!$container->has('api_platform.state.item_provider')) {
1✔
182
            $container->setAlias('api_platform.state.item_provider', 'api_platform.state_provider.object');
×
183
        }
184
    }
185

186
    private function registerCommonConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader, array $formats, array $patchFormats, array $errorFormats, array $docsFormats, array $jsonSchemaFormats): void
187
    {
188
        $loader->load('state/state.xml');
1✔
189
        $loader->load('symfony/symfony.xml');
1✔
190
        $loader->load('api.xml');
1✔
191
        $loader->load('filter.xml');
1✔
192

193
        if (class_exists(UuidDenormalizer::class) && class_exists(Uuid::class)) {
1✔
194
            $loader->load('ramsey_uuid.xml');
1✔
195
        }
196

197
        if (class_exists(AbstractUid::class)) {
1✔
198
            $loader->load('symfony/uid.xml');
1✔
199
        }
200

201
        $defaultContext = ['hydra_prefix' => $config['serializer']['hydra_prefix']] + ($container->hasParameter('serializer.default_context') ? $container->getParameter('serializer.default_context') : []);
1✔
202

203
        $container->setParameter('api_platform.serializer.default_context', $defaultContext);
1✔
204
        if (!$container->hasParameter('serializer.default_context')) {
1✔
205
            $container->setParameter('serializer.default_context', $container->getParameter('api_platform.serializer.default_context'));
1✔
206
        }
207
        if ($config['use_symfony_listeners']) {
1✔
208
            $loader->load('symfony/events.xml');
1✔
209
        } else {
210
            $loader->load('symfony/controller.xml');
×
211
            $loader->load('state/provider.xml');
×
212
            $loader->load('state/processor.xml');
×
213
        }
214
        $loader->load('state/parameter_provider.xml');
1✔
215

216
        $container->setParameter('api_platform.enable_entrypoint', $config['enable_entrypoint']);
1✔
217
        $container->setParameter('api_platform.enable_docs', $config['enable_docs']);
1✔
218
        $container->setParameter('api_platform.title', $config['title']);
1✔
219
        $container->setParameter('api_platform.description', $config['description']);
1✔
220
        $container->setParameter('api_platform.version', $config['version']);
1✔
221
        $container->setParameter('api_platform.show_webby', $config['show_webby']);
1✔
222
        $container->setParameter('api_platform.url_generation_strategy', $config['defaults']['url_generation_strategy'] ?? UrlGeneratorInterface::ABS_PATH);
1✔
223
        $container->setParameter('api_platform.exception_to_status', $config['exception_to_status']);
1✔
224
        $container->setParameter('api_platform.formats', $formats);
1✔
225
        $container->setParameter('api_platform.patch_formats', $patchFormats);
1✔
226
        $container->setParameter('api_platform.error_formats', $errorFormats);
1✔
227
        $container->setParameter('api_platform.docs_formats', $docsFormats);
1✔
228
        $container->setParameter('api_platform.jsonschema_formats', $jsonSchemaFormats);
1✔
229
        $container->setParameter('api_platform.eager_loading.enabled', $this->isConfigEnabled($container, $config['eager_loading']));
1✔
230
        $container->setParameter('api_platform.eager_loading.max_joins', $config['eager_loading']['max_joins']);
1✔
231
        $container->setParameter('api_platform.eager_loading.fetch_partial', $config['eager_loading']['fetch_partial']);
1✔
232
        $container->setParameter('api_platform.eager_loading.force_eager', $config['eager_loading']['force_eager']);
1✔
233
        $container->setParameter('api_platform.collection.exists_parameter_name', $config['collection']['exists_parameter_name']);
1✔
234
        $container->setParameter('api_platform.collection.order', $config['collection']['order']);
1✔
235
        $container->setParameter('api_platform.collection.order_parameter_name', $config['collection']['order_parameter_name']);
1✔
236
        $container->setParameter('api_platform.collection.order_nulls_comparison', $config['collection']['order_nulls_comparison']);
1✔
237
        $container->setParameter('api_platform.collection.pagination.enabled', $config['defaults']['pagination_enabled'] ?? true);
1✔
238
        $container->setParameter('api_platform.collection.pagination.partial', $config['defaults']['pagination_partial'] ?? false);
1✔
239
        $container->setParameter('api_platform.collection.pagination.client_enabled', $config['defaults']['pagination_client_enabled'] ?? false);
1✔
240
        $container->setParameter('api_platform.collection.pagination.client_items_per_page', $config['defaults']['pagination_client_items_per_page'] ?? false);
1✔
241
        $container->setParameter('api_platform.collection.pagination.client_partial', $config['defaults']['pagination_client_partial'] ?? false);
1✔
242
        $container->setParameter('api_platform.collection.pagination.items_per_page', $config['defaults']['pagination_items_per_page'] ?? 30);
1✔
243
        $container->setParameter('api_platform.collection.pagination.maximum_items_per_page', $config['defaults']['pagination_maximum_items_per_page'] ?? null);
1✔
244
        $container->setParameter('api_platform.collection.pagination.page_parameter_name', $config['defaults']['pagination_page_parameter_name'] ?? $config['collection']['pagination']['page_parameter_name']);
1✔
245
        $container->setParameter('api_platform.collection.pagination.enabled_parameter_name', $config['defaults']['pagination_enabled_parameter_name'] ?? $config['collection']['pagination']['enabled_parameter_name']);
1✔
246
        $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']);
1✔
247
        $container->setParameter('api_platform.collection.pagination.partial_parameter_name', $config['defaults']['pagination_partial_parameter_name'] ?? $config['collection']['pagination']['partial_parameter_name']);
1✔
248
        $container->setParameter('api_platform.collection.pagination', $this->getPaginationDefaults($config['defaults'] ?? [], $config['collection']['pagination']));
1✔
249
        $container->setParameter('api_platform.handle_symfony_errors', $config['handle_symfony_errors'] ?? false);
1✔
250
        $container->setParameter('api_platform.http_cache.etag', $config['defaults']['cache_headers']['etag'] ?? true);
1✔
251
        $container->setParameter('api_platform.http_cache.max_age', $config['defaults']['cache_headers']['max_age'] ?? null);
1✔
252
        $container->setParameter('api_platform.http_cache.shared_max_age', $config['defaults']['cache_headers']['shared_max_age'] ?? null);
1✔
253
        $container->setParameter('api_platform.http_cache.vary', $config['defaults']['cache_headers']['vary'] ?? ['Accept']);
1✔
254
        $container->setParameter('api_platform.http_cache.public', $config['defaults']['cache_headers']['public'] ?? $config['http_cache']['public']);
1✔
255
        $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']);
1✔
256
        $container->setParameter('api_platform.http_cache.invalidation.xkey.glue', $config['defaults']['cache_headers']['invalidation']['xkey']['glue'] ?? $config['http_cache']['invalidation']['xkey']['glue']);
1✔
257

258
        $container->setAlias('api_platform.path_segment_name_generator', $config['path_segment_name_generator']);
1✔
259
        $container->setAlias('api_platform.inflector', $config['inflector']);
1✔
260

261
        if ($config['name_converter']) {
1✔
262
            $container->setAlias('api_platform.name_converter', $config['name_converter']);
1✔
263
        }
264
        $container->setParameter('api_platform.asset_package', $config['asset_package']);
1✔
265
        $container->setParameter('api_platform.defaults', $this->normalizeDefaults($config['defaults'] ?? []));
1✔
266

267
        if ($container->getParameter('kernel.debug')) {
1✔
268
            $container->removeDefinition('api_platform.serializer.mapping.cache_class_metadata_factory');
1✔
269
        }
270
    }
271

272
    /**
273
     * This method will be removed in 3.0 when "defaults" will be the regular configuration path for the pagination.
274
     */
275
    private function getPaginationDefaults(array $defaults, array $collectionPaginationConfiguration): array
276
    {
277
        $paginationOptions = [];
1✔
278

279
        foreach ($defaults as $key => $value) {
1✔
280
            if (!str_starts_with($key, 'pagination_')) {
1✔
281
                continue;
1✔
282
            }
283

284
            $paginationOptions[str_replace('pagination_', '', $key)] = $value;
1✔
285
        }
286

287
        return array_merge($collectionPaginationConfiguration, $paginationOptions);
1✔
288
    }
289

290
    private function normalizeDefaults(array $defaults): array
291
    {
292
        $normalizedDefaults = ['extra_properties' => $defaults['extra_properties'] ?? []];
1✔
293
        unset($defaults['extra_properties']);
1✔
294

295
        $rc = new \ReflectionClass(ApiResource::class);
1✔
296
        $publicProperties = [];
1✔
297
        foreach ($rc->getConstructor()->getParameters() as $param) {
1✔
298
            $publicProperties[$param->getName()] = true;
1✔
299
        }
300

301
        $nameConverter = new CamelCaseToSnakeCaseNameConverter();
1✔
302
        foreach ($defaults as $option => $value) {
1✔
303
            if (isset($publicProperties[$nameConverter->denormalize($option)])) {
1✔
304
                $normalizedDefaults[$option] = $value;
1✔
305

306
                continue;
1✔
307
            }
308

309
            $normalizedDefaults['extra_properties'][$option] = $value;
×
310
        }
311

312
        return $normalizedDefaults;
1✔
313
    }
314

315
    private function registerMetadataConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
316
    {
317
        [$xmlResources, $yamlResources] = $this->getResourcesToWatch($container, $config);
1✔
318

319
        $container->setParameter('api_platform.class_name_resources', $this->getClassNameResources());
1✔
320

321
        $loader->load('metadata/resource_name.xml');
1✔
322
        $loader->load('metadata/property_name.xml');
1✔
323

324
        if (!empty($config['resource_class_directories'])) {
1✔
325
            $container->setParameter('api_platform.resource_class_directories', array_merge(
×
326
                $config['resource_class_directories'],
×
327
                $container->getParameter('api_platform.resource_class_directories')
×
328
            ));
×
329
        }
330

331
        // V3 metadata
332
        $loader->load('metadata/xml.xml');
1✔
333
        $loader->load('metadata/links.xml');
1✔
334
        $loader->load('metadata/property.xml');
1✔
335
        $loader->load('metadata/resource.xml');
1✔
336
        $loader->load('metadata/operation.xml');
1✔
337

338
        $container->getDefinition('api_platform.metadata.resource_extractor.xml')->replaceArgument(0, $xmlResources);
1✔
339
        $container->getDefinition('api_platform.metadata.property_extractor.xml')->replaceArgument(0, $xmlResources);
1✔
340

341
        if (class_exists(PhpDocParser::class) || interface_exists(DocBlockFactoryInterface::class)) {
1✔
342
            $loader->load('metadata/php_doc.xml');
1✔
343
        }
344

345
        if (class_exists(Yaml::class)) {
1✔
346
            $loader->load('metadata/yaml.xml');
1✔
347
            $container->getDefinition('api_platform.metadata.resource_extractor.yaml')->replaceArgument(0, $yamlResources);
1✔
348
            $container->getDefinition('api_platform.metadata.property_extractor.yaml')->replaceArgument(0, $yamlResources);
1✔
349
        }
350
    }
351

352
    private function getClassNameResources(): array
353
    {
354
        return [
1✔
355
            Error::class,
1✔
356
            ValidationException::class,
1✔
357
        ];
1✔
358
    }
359

360
    private function getBundlesResourcesPaths(ContainerBuilder $container, array $config): array
361
    {
362
        $bundlesResourcesPaths = [];
1✔
363

364
        foreach ($container->getParameter('kernel.bundles_metadata') as $bundle) {
1✔
365
            $dirname = $bundle['path'];
1✔
366
            $paths = [
1✔
367
                "$dirname/ApiResource",
1✔
368
                "$dirname/src/ApiResource",
1✔
369
            ];
1✔
370
            foreach (['.yaml', '.yml', '.xml', ''] as $extension) {
1✔
371
                $paths[] = "$dirname/Resources/config/api_resources$extension";
1✔
372
                $paths[] = "$dirname/config/api_resources$extension";
1✔
373
            }
374
            if ($this->isConfigEnabled($container, $config['doctrine'])) {
1✔
375
                $paths[] = "$dirname/Entity";
1✔
376
                $paths[] = "$dirname/src/Entity";
1✔
377
            }
378
            if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
1✔
379
                $paths[] = "$dirname/Document";
×
380
                $paths[] = "$dirname/src/Document";
×
381
            }
382

383
            foreach ($paths as $path) {
1✔
384
                if ($container->fileExists($path, false)) {
1✔
385
                    $bundlesResourcesPaths[] = $path;
1✔
386
                }
387
            }
388
        }
389

390
        return $bundlesResourcesPaths;
1✔
391
    }
392

393
    private function getResourcesToWatch(ContainerBuilder $container, array $config): array
394
    {
395
        $paths = array_unique(array_merge($this->getBundlesResourcesPaths($container, $config), $config['mapping']['paths']));
1✔
396

397
        if (!$config['mapping']['paths']) {
1✔
398
            $projectDir = $container->getParameter('kernel.project_dir');
×
399
            foreach (["$projectDir/config/api_platform", "$projectDir/src/ApiResource"] as $dir) {
×
400
                if (is_dir($dir)) {
×
401
                    $paths[] = $dir;
×
402
                }
403
            }
404

405
            if ($this->isConfigEnabled($container, $config['doctrine']) && is_dir($doctrinePath = "$projectDir/src/Entity")) {
×
406
                $paths[] = $doctrinePath;
×
407
            }
408

409
            if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm']) && is_dir($documentPath = "$projectDir/src/Document")) {
×
410
                $paths[] = $documentPath;
×
411
            }
412
        }
413

414
        $resources = ['yml' => [], 'xml' => [], 'dir' => []];
1✔
415

416
        foreach ($paths as $path) {
1✔
417
            if (is_dir($path)) {
1✔
418
                foreach (Finder::create()->followLinks()->files()->in($path)->name('/\.(xml|ya?ml)$/')->sortByName() as $file) {
1✔
419
                    $resources['yaml' === ($extension = $file->getExtension()) ? 'yml' : $extension][] = $file->getRealPath();
1✔
420
                }
421

422
                $resources['dir'][] = $path;
1✔
423
                $container->addResource(new DirectoryResource($path, '/\.(xml|ya?ml|php)$/'));
1✔
424

425
                continue;
1✔
426
            }
427

428
            if ($container->fileExists($path, false)) {
×
429
                if (!preg_match('/\.(xml|ya?ml)$/', (string) $path, $matches)) {
×
430
                    throw new RuntimeException(\sprintf('Unsupported mapping type in "%s", supported types are XML & YAML.', $path));
×
431
                }
432

433
                $resources['yaml' === $matches[1] ? 'yml' : $matches[1]][] = $path;
×
434

435
                continue;
×
436
            }
437

438
            throw new RuntimeException(\sprintf('Could not open file or directory "%s".', $path));
×
439
        }
440

441
        $container->setParameter('api_platform.resource_class_directories', $resources['dir']);
1✔
442

443
        return [$resources['xml'], $resources['yml']];
1✔
444
    }
445

446
    private function registerOAuthConfiguration(ContainerBuilder $container, array $config): void
447
    {
448
        if (!$config['oauth']) {
1✔
449
            return;
×
450
        }
451

452
        $container->setParameter('api_platform.oauth.enabled', $this->isConfigEnabled($container, $config['oauth']));
1✔
453
        $container->setParameter('api_platform.oauth.clientId', $config['oauth']['clientId']);
1✔
454
        $container->setParameter('api_platform.oauth.clientSecret', $config['oauth']['clientSecret']);
1✔
455
        $container->setParameter('api_platform.oauth.type', $config['oauth']['type']);
1✔
456
        $container->setParameter('api_platform.oauth.flow', $config['oauth']['flow']);
1✔
457
        $container->setParameter('api_platform.oauth.tokenUrl', $config['oauth']['tokenUrl']);
1✔
458
        $container->setParameter('api_platform.oauth.authorizationUrl', $config['oauth']['authorizationUrl']);
1✔
459
        $container->setParameter('api_platform.oauth.refreshUrl', $config['oauth']['refreshUrl']);
1✔
460
        $container->setParameter('api_platform.oauth.scopes', $config['oauth']['scopes']);
1✔
461
        $container->setParameter('api_platform.oauth.pkce', $config['oauth']['pkce']);
1✔
462
    }
463

464
    /**
465
     * Registers the Swagger, ReDoc and Swagger UI configuration.
466
     */
467
    private function registerSwaggerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
468
    {
469
        foreach (array_keys($config['swagger']['api_keys']) as $keyName) {
1✔
470
            if (!preg_match('/^[a-zA-Z0-9._-]+$/', $keyName)) {
1✔
471
                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));
×
472
            }
473
        }
474

475
        $container->setParameter('api_platform.swagger.versions', $config['swagger']['versions']);
1✔
476

477
        if (!$config['enable_swagger'] && $config['enable_swagger_ui']) {
1✔
478
            throw new RuntimeException('You can not enable the Swagger UI without enabling Swagger, fix this by enabling swagger via the configuration "enable_swagger: true".');
×
479
        }
480

481
        if (!$config['enable_swagger']) {
1✔
482
            return;
×
483
        }
484

485
        $loader->load('openapi.xml');
1✔
486

487
        if (class_exists(Yaml::class)) {
1✔
488
            $loader->load('openapi/yaml.xml');
1✔
489
        }
490

491
        $loader->load('swagger_ui.xml');
1✔
492

493
        if ($config['use_symfony_listeners']) {
1✔
494
            $loader->load('symfony/swagger_ui.xml');
1✔
495
        }
496

497
        if ($config['enable_swagger_ui']) {
1✔
498
            $loader->load('state/swagger_ui.xml');
1✔
499
        }
500

501
        if (!$config['enable_swagger_ui'] && !$config['enable_re_doc']) {
1✔
502
            // Remove the listener but keep the controller to allow customizing the path of the UI
503
            $container->removeDefinition('api_platform.swagger.listener.ui');
×
504
        }
505

506
        $container->setParameter('api_platform.enable_swagger_ui', $config['enable_swagger_ui']);
1✔
507
        $container->setParameter('api_platform.enable_re_doc', $config['enable_re_doc']);
1✔
508
        $container->setParameter('api_platform.swagger.api_keys', $config['swagger']['api_keys']);
1✔
509
        $container->setParameter('api_platform.swagger.persist_authorization', $config['swagger']['persist_authorization']);
1✔
510
        $container->setParameter('api_platform.swagger.http_auth', $config['swagger']['http_auth']);
1✔
511
        if ($config['openapi']['swagger_ui_extra_configuration'] && $config['swagger']['swagger_ui_extra_configuration']) {
1✔
512
            throw new RuntimeException('You can not set "swagger_ui_extra_configuration" twice - in "openapi" and "swagger" section.');
×
513
        }
514
        $container->setParameter('api_platform.swagger_ui.extra_configuration', $config['openapi']['swagger_ui_extra_configuration'] ?: $config['swagger']['swagger_ui_extra_configuration']);
1✔
515
    }
516

517
    private function registerJsonApiConfiguration(array $formats, XmlFileLoader $loader, array $config): void
518
    {
519
        if (!isset($formats['jsonapi'])) {
1✔
520
            return;
×
521
        }
522

523
        $loader->load('jsonapi.xml');
1✔
524
        $loader->load('state/jsonapi.xml');
1✔
525
    }
526

527
    private function registerJsonLdHydraConfiguration(ContainerBuilder $container, array $formats, XmlFileLoader $loader, array $config): void
528
    {
529
        if (!isset($formats['jsonld'])) {
1✔
530
            return;
×
531
        }
532

533
        if ($config['use_symfony_listeners']) {
1✔
534
            $loader->load('symfony/jsonld.xml');
1✔
535
        } else {
536
            $loader->load('state/jsonld.xml');
×
537
        }
538

539
        $loader->load('state/hydra.xml');
1✔
540
        $loader->load('jsonld.xml');
1✔
541
        $loader->load('hydra.xml');
1✔
542

543
        if (!$container->has('api_platform.json_schema.schema_factory')) {
1✔
544
            $container->removeDefinition('api_platform.hydra.json_schema.schema_factory');
×
545
        }
546
    }
547

548
    private function registerJsonHalConfiguration(array $formats, XmlFileLoader $loader): void
549
    {
550
        if (!isset($formats['jsonhal'])) {
1✔
551
            return;
×
552
        }
553

554
        $loader->load('hal.xml');
1✔
555
    }
556

557
    private function registerJsonProblemConfiguration(array $errorFormats, XmlFileLoader $loader): void
558
    {
559
        if (!isset($errorFormats['jsonproblem'])) {
1✔
560
            return;
×
561
        }
562

563
        $loader->load('problem.xml');
1✔
564
    }
565

566
    private function registerGraphQlConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
567
    {
568
        $enabled = $this->isConfigEnabled($container, $config['graphql']);
1✔
569
        $graphqlIntrospectionEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['introspection']);
1✔
570
        $graphiqlEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphiql']);
1✔
571
        $graphqlPlayGroundEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphql_playground']);
1✔
572
        $maxQueryDepth = (int) $config['graphql']['max_query_depth'];
1✔
573
        $maxQueryComplexity = (int) $config['graphql']['max_query_complexity'];
1✔
574
        if ($graphqlPlayGroundEnabled) {
1✔
575
            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.');
×
576
        }
577

578
        $container->setParameter('api_platform.graphql.enabled', $enabled);
1✔
579
        $container->setParameter('api_platform.graphql.max_query_depth', $maxQueryDepth);
1✔
580
        $container->setParameter('api_platform.graphql.max_query_complexity', $maxQueryComplexity);
1✔
581
        $container->setParameter('api_platform.graphql.introspection.enabled', $graphqlIntrospectionEnabled);
1✔
582
        $container->setParameter('api_platform.graphql.graphiql.enabled', $graphiqlEnabled);
1✔
583
        $container->setParameter('api_platform.graphql.graphql_playground.enabled', $graphqlPlayGroundEnabled);
1✔
584
        $container->setParameter('api_platform.graphql.collection.pagination', $config['graphql']['collection']['pagination']);
1✔
585

586
        if (!$enabled) {
1✔
587
            return;
×
588
        }
589

590
        if (!class_exists(Executor::class)) {
1✔
591
            throw new \RuntimeException('Graphql is enabled but not installed, run: composer require "api-platform/graphql".');
×
592
        }
593

594
        $container->setParameter('api_platform.graphql.default_ide', $config['graphql']['default_ide']);
1✔
595
        $container->setParameter('api_platform.graphql.nesting_separator', $config['graphql']['nesting_separator']);
1✔
596

597
        $loader->load('graphql.xml');
1✔
598

599
        // @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
600
        if (!class_exists(Environment::class) || !isset($container->getParameter('kernel.bundles')['TwigBundle'])) {
1✔
601
            if ($graphiqlEnabled || $graphqlPlayGroundEnabled) {
×
602
                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')));
×
603
            }
604
            $container->removeDefinition('api_platform.graphql.action.graphiql');
×
605
            $container->removeDefinition('api_platform.graphql.action.graphql_playground');
×
606
        }
607

608
        $container->registerForAutoconfiguration(QueryItemResolverInterface::class)
1✔
609
            ->addTag('api_platform.graphql.resolver');
1✔
610
        $container->registerForAutoconfiguration(QueryCollectionResolverInterface::class)
1✔
611
            ->addTag('api_platform.graphql.resolver');
1✔
612
        $container->registerForAutoconfiguration(MutationResolverInterface::class)
1✔
613
            ->addTag('api_platform.graphql.resolver');
1✔
614
        $container->registerForAutoconfiguration(GraphQlTypeInterface::class)
1✔
615
            ->addTag('api_platform.graphql.type');
1✔
616
        $container->registerForAutoconfiguration(ErrorHandlerInterface::class)
1✔
617
            ->addTag('api_platform.graphql.error_handler');
1✔
618
    }
619

620
    private function registerCacheConfiguration(ContainerBuilder $container): void
621
    {
622
        if (!$container->hasParameter('kernel.debug') || !$container->getParameter('kernel.debug')) {
1✔
623
            $container->removeDefinition('api_platform.cache_warmer.cache_pool_clearer');
×
624
        }
625
    }
626

627
    private function registerDoctrineOrmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
628
    {
629
        if (!$this->isConfigEnabled($container, $config['doctrine'])) {
1✔
630
            return;
×
631
        }
632

633
        // For older versions of doctrine bridge this allows autoconfiguration for filters
634
        if (!$container->has(ManagerRegistry::class)) {
1✔
635
            $container->setAlias(ManagerRegistry::class, 'doctrine');
1✔
636
        }
637

638
        $container->registerForAutoconfiguration(QueryItemExtensionInterface::class)
1✔
639
            ->addTag('api_platform.doctrine.orm.query_extension.item');
1✔
640
        $container->registerForAutoconfiguration(DoctrineQueryCollectionExtensionInterface::class)
1✔
641
            ->addTag('api_platform.doctrine.orm.query_extension.collection');
1✔
642
        $container->registerForAutoconfiguration(DoctrineOrmAbstractFilter::class);
1✔
643

644
        $container->registerForAutoconfiguration(OrmLinksHandlerInterface::class)
1✔
645
            ->addTag('api_platform.doctrine.orm.links_handler');
1✔
646

647
        $loader->load('doctrine_orm.xml');
1✔
648

649
        if ($this->isConfigEnabled($container, $config['eager_loading'])) {
1✔
650
            return;
1✔
651
        }
652

653
        $container->removeAlias(EagerLoadingExtension::class);
×
654
        $container->removeDefinition('api_platform.doctrine.orm.query_extension.eager_loading');
×
655
        $container->removeAlias(FilterEagerLoadingExtension::class);
×
656
        $container->removeDefinition('api_platform.doctrine.orm.query_extension.filter_eager_loading');
×
657
    }
658

659
    private function registerDoctrineMongoDbOdmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
660
    {
661
        if (!$this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
1✔
662
            return;
1✔
663
        }
664

665
        $container->registerForAutoconfiguration(AggregationItemExtensionInterface::class)
×
666
            ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.item');
×
667
        $container->registerForAutoconfiguration(AggregationCollectionExtensionInterface::class)
×
668
            ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.collection');
×
669
        $container->registerForAutoconfiguration(DoctrineMongoDbOdmAbstractFilter::class)
×
670
            ->setBindings(['$managerRegistry' => new Reference('doctrine_mongodb')]);
×
671
        $container->registerForAutoconfiguration(OdmLinksHandlerInterface::class)
×
672
            ->addTag('api_platform.doctrine.odm.links_handler');
×
673

674
        $loader->load('doctrine_mongodb_odm.xml');
×
675
    }
676

677
    private function registerHttpCacheConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
678
    {
679
        $loader->load('http_cache.xml');
1✔
680

681
        if (!$this->isConfigEnabled($container, $config['http_cache']['invalidation'])) {
1✔
682
            return;
×
683
        }
684

685
        if ($this->isConfigEnabled($container, $config['doctrine'])) {
1✔
686
            $loader->load('doctrine_orm_http_cache_purger.xml');
1✔
687
        }
688

689
        $loader->load('state/http_cache_purger.xml');
1✔
690
        $loader->load('http_cache_purger.xml');
1✔
691

692
        foreach ($config['http_cache']['invalidation']['scoped_clients'] as $client) {
1✔
693
            $definition = $container->getDefinition($client);
×
694
            $definition->addTag('api_platform.http_cache.http_client');
×
695
        }
696

697
        if (!($urls = $config['http_cache']['invalidation']['urls'])) {
1✔
698
            $urls = $config['http_cache']['invalidation']['varnish_urls'];
1✔
699
        }
700

701
        foreach ($urls as $key => $url) {
1✔
702
            $definition = new Definition(ScopingHttpClient::class, [new Reference('http_client'), $url, ['base_uri' => $url] + $config['http_cache']['invalidation']['request_options']]);
×
703
            $definition->setFactory([ScopingHttpClient::class, 'forBaseUri']);
×
704
            $definition->addTag('api_platform.http_cache.http_client');
×
705
            $container->setDefinition('api_platform.invalidation_http_client.'.$key, $definition);
×
706
        }
707

708
        $serviceName = $config['http_cache']['invalidation']['purger'];
1✔
709

710
        if (!$container->hasDefinition('api_platform.http_cache.purger')) {
1✔
711
            $container->setAlias('api_platform.http_cache.purger', $serviceName);
1✔
712
        }
713
    }
714

715
    /**
716
     * Normalizes the format from config to the one accepted by Symfony HttpFoundation.
717
     */
718
    private function getFormats(array $configFormats): array
719
    {
720
        $formats = [];
1✔
721
        foreach ($configFormats as $format => $value) {
1✔
722
            foreach ($value['mime_types'] as $mimeType) {
1✔
723
                $formats[$format][] = $mimeType;
1✔
724
            }
725
        }
726

727
        return $formats;
1✔
728
    }
729

730
    private function registerValidatorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
731
    {
732
        if (interface_exists(ValidatorInterface::class)) {
1✔
733
            $loader->load('metadata/validator.xml');
1✔
734
            $loader->load('validator/validator.xml');
1✔
735

736
            if ($this->isConfigEnabled($container, $config['graphql'])) {
1✔
737
                $loader->load('graphql/validator.xml');
1✔
738
            }
739

740
            $loader->load($config['use_symfony_listeners'] ? 'validator/events.xml' : 'validator/state.xml');
1✔
741

742
            $container->registerForAutoconfiguration(ValidationGroupsGeneratorInterface::class)
1✔
743
                ->addTag('api_platform.validation_groups_generator');
1✔
744
            $container->registerForAutoconfiguration(PropertySchemaRestrictionMetadataInterface::class)
1✔
745
                ->addTag('api_platform.metadata.property_schema_restriction');
1✔
746
        }
747

748
        if (!$config['validator']) {
1✔
749
            return;
×
750
        }
751

752
        $container->setParameter('api_platform.validator.serialize_payload_fields', $config['validator']['serialize_payload_fields']);
1✔
753
        $container->setParameter('api_platform.validator.query_parameter_validation', $config['validator']['query_parameter_validation']);
1✔
754

755
        if (!$config['validator']['query_parameter_validation']) {
1✔
756
            $container->removeDefinition('api_platform.listener.view.validate_query_parameters');
×
757
            $container->removeDefinition('api_platform.validator.query_parameter_validator');
×
758
            $container->removeDefinition('api_platform.symfony.parameter_validator');
×
759
        }
760
    }
761

762
    private function registerDataCollectorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
763
    {
764
        if (!$config['enable_profiler']) {
1✔
765
            return;
×
766
        }
767

768
        $loader->load('data_collector.xml');
1✔
769

770
        if ($container->hasParameter('kernel.debug') && $container->getParameter('kernel.debug')) {
1✔
771
            $loader->load('debug.xml');
1✔
772
        }
773
    }
774

775
    private function registerMercureConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
776
    {
777
        if (!$this->isConfigEnabled($container, $config['mercure'])) {
1✔
778
            return;
×
779
        }
780

781
        $container->setParameter('api_platform.mercure.include_type', $config['mercure']['include_type']);
1✔
782
        $loader->load('state/mercure.xml');
1✔
783

784
        if ($this->isConfigEnabled($container, $config['doctrine'])) {
1✔
785
            $loader->load('doctrine_orm_mercure_publisher.xml');
1✔
786
        }
787
        if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
1✔
788
            $loader->load('doctrine_odm_mercure_publisher.xml');
×
789
        }
790

791
        if ($this->isConfigEnabled($container, $config['graphql'])) {
1✔
792
            $loader->load('graphql_mercure.xml');
1✔
793
        }
794
    }
795

796
    private function registerMessengerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
797
    {
798
        if (!$this->isConfigEnabled($container, $config['messenger'])) {
1✔
799
            return;
×
800
        }
801

802
        $loader->load('messenger.xml');
1✔
803
    }
804

805
    private function registerElasticsearchConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
806
    {
807
        $enabled = $this->isConfigEnabled($container, $config['elasticsearch']);
1✔
808

809
        $container->setParameter('api_platform.elasticsearch.enabled', $enabled);
1✔
810

811
        if (!$enabled) {
1✔
812
            return;
1✔
813
        }
814

815
        $clientClass = !class_exists(\Elasticsearch\Client::class)
×
816
            // ES v7
×
817
            ? \Elastic\Elasticsearch\Client::class
×
818
            // ES v8 and up
×
819
            : \Elasticsearch\Client::class;
×
820

821
        $clientDefinition = new Definition($clientClass);
×
822
        $container->setDefinition('api_platform.elasticsearch.client', $clientDefinition);
×
823
        $container->registerForAutoconfiguration(RequestBodySearchCollectionExtensionInterface::class)
×
824
            ->addTag('api_platform.elasticsearch.request_body_search_extension.collection');
×
825
        $container->setParameter('api_platform.elasticsearch.hosts', $config['elasticsearch']['hosts']);
×
826
        $loader->load('elasticsearch.xml');
×
827
    }
828

829
    private function registerSecurityConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
830
    {
831
        /** @var string[] $bundles */
832
        $bundles = $container->getParameter('kernel.bundles');
1✔
833

834
        if (!isset($bundles['SecurityBundle'])) {
1✔
835
            return;
×
836
        }
837

838
        $loader->load('security.xml');
1✔
839

840
        $loader->load('state/security.xml');
1✔
841

842
        if (interface_exists(ValidatorInterface::class)) {
1✔
843
            $loader->load('state/security_validator.xml');
1✔
844
        }
845

846
        if ($this->isConfigEnabled($container, $config['graphql'])) {
1✔
847
            $loader->load('graphql/security.xml');
1✔
848
        }
849
    }
850

851
    private function registerOpenApiConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
852
    {
853
        $container->setParameter('api_platform.openapi.termsOfService', $config['openapi']['termsOfService']);
1✔
854
        $container->setParameter('api_platform.openapi.contact.name', $config['openapi']['contact']['name']);
1✔
855
        $container->setParameter('api_platform.openapi.contact.url', $config['openapi']['contact']['url']);
1✔
856
        $container->setParameter('api_platform.openapi.contact.email', $config['openapi']['contact']['email']);
1✔
857
        $container->setParameter('api_platform.openapi.license.name', $config['openapi']['license']['name']);
1✔
858
        $container->setParameter('api_platform.openapi.license.url', $config['openapi']['license']['url']);
1✔
859
        $container->setParameter('api_platform.openapi.overrideResponses', $config['openapi']['overrideResponses']);
1✔
860

861
        $tags = [];
1✔
862
        foreach ($config['openapi']['tags'] as $tag) {
1✔
863
            $tags[] = new Tag($tag['name'], $tag['description'] ?? null);
×
864
        }
865

866
        $container->setParameter('api_platform.openapi.tags', $tags);
1✔
867

868
        $loader->load('json_schema.xml');
1✔
869
    }
870

871
    private function registerMakerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
872
    {
873
        if (!$this->isConfigEnabled($container, $config['maker'])) {
1✔
874
            return;
×
875
        }
876

877
        $loader->load('maker.xml');
1✔
878
    }
879

880
    private function registerArgumentResolverConfiguration(XmlFileLoader $loader): void
881
    {
882
        $loader->load('argument_resolver.xml');
1✔
883
    }
884

885
    private function registerLinkSecurityConfiguration(XmlFileLoader $loader, array $config): void
886
    {
887
        if ($config['enable_link_security']) {
1✔
888
            $loader->load('link_security.xml');
1✔
889
        }
890
    }
891
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc