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

api-platform / core / 14127941726

28 Mar 2025 11:27AM UTC coverage: 8.515% (+0.3%) from 8.172%
14127941726

Pull #7057

github

web-flow
Merge e09ceb08d into 1eb9da13a
Pull Request #7057: chore(laravel): missing iterable type

13386 of 157197 relevant lines covered (8.52%)

22.91 hits per line

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

79.87
/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'])) {
2✔
80
            $container->prependExtensionConfig('framework', [
2✔
81
                'serializer' => [
2✔
82
                    'enabled' => true,
2✔
83
                ],
2✔
84
            ]);
2✔
85
            $container->prependExtensionConfig('framework', [
2✔
86
                'property_info' => [
2✔
87
                    'enabled' => true,
2✔
88
                ],
2✔
89
            ]);
2✔
90
        }
91
        if (isset($container->getExtensions()['lexik_jwt_authentication'])) {
2✔
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'));
2✔
106

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

111
        $formats = $this->getFormats($config['formats']);
2✔
112
        $patchFormats = $this->getFormats($config['patch_formats']);
2✔
113
        $errorFormats = $this->getFormats($config['error_formats']);
2✔
114
        $docsFormats = $this->getFormats($config['docs_formats']);
2✔
115
        $jsonSchemaFormats = $config['jsonschema_formats'];
2✔
116

117
        if (!$jsonSchemaFormats) {
2✔
118
            foreach (array_merge(array_keys($formats), array_keys($errorFormats)) as $f) {
2✔
119
                // Distinct JSON-based formats must have names that start with 'json'
120
                if (str_starts_with($f, 'json')) {
2✔
121
                    $jsonSchemaFormats[$f] = true;
2✔
122
                }
123
            }
124
        }
125

126
        if (!isset($errorFormats['json'])) {
2✔
127
            $errorFormats['json'] = ['application/problem+json', 'application/json'];
2✔
128
        }
129

130
        if (!isset($errorFormats['jsonproblem'])) {
2✔
131
            $errorFormats['jsonproblem'] = ['application/problem+json'];
×
132
        }
133

134
        if (isset($formats['jsonapi']) && !isset($patchFormats['jsonapi'])) {
2✔
135
            $patchFormats['jsonapi'] = ['application/vnd.api+json'];
2✔
136
        }
137

138
        $this->registerCommonConfiguration($container, $config, $loader, $formats, $patchFormats, $errorFormats, $docsFormats, $jsonSchemaFormats);
2✔
139
        $this->registerMetadataConfiguration($container, $config, $loader);
2✔
140
        $this->registerOAuthConfiguration($container, $config);
2✔
141
        $this->registerOpenApiConfiguration($container, $config, $loader);
2✔
142
        $this->registerSwaggerConfiguration($container, $config, $loader);
2✔
143
        $this->registerJsonApiConfiguration($formats, $loader, $config);
2✔
144
        $this->registerJsonLdHydraConfiguration($container, $formats, $loader, $config);
2✔
145
        $this->registerJsonHalConfiguration($formats, $loader);
2✔
146
        $this->registerJsonProblemConfiguration($errorFormats, $loader);
2✔
147
        $this->registerGraphQlConfiguration($container, $config, $loader);
2✔
148
        $this->registerCacheConfiguration($container);
2✔
149
        $this->registerDoctrineOrmConfiguration($container, $config, $loader);
2✔
150
        $this->registerDoctrineMongoDbOdmConfiguration($container, $config, $loader);
2✔
151
        $this->registerHttpCacheConfiguration($container, $config, $loader);
2✔
152
        $this->registerValidatorConfiguration($container, $config, $loader);
2✔
153
        $this->registerDataCollectorConfiguration($container, $config, $loader);
2✔
154
        $this->registerMercureConfiguration($container, $config, $loader);
2✔
155
        $this->registerMessengerConfiguration($container, $config, $loader);
2✔
156
        $this->registerElasticsearchConfiguration($container, $config, $loader);
2✔
157
        $this->registerSecurityConfiguration($container, $config, $loader);
2✔
158
        $this->registerMakerConfiguration($container, $config, $loader);
2✔
159
        $this->registerArgumentResolverConfiguration($loader);
2✔
160
        $this->registerLinkSecurityConfiguration($loader, $config);
2✔
161

162
        $container->registerForAutoconfiguration(FilterInterface::class)
2✔
163
            ->addTag('api_platform.filter');
2✔
164
        $container->registerForAutoconfiguration(ProviderInterface::class)
2✔
165
            ->addTag('api_platform.state_provider');
2✔
166
        $container->registerForAutoconfiguration(ProcessorInterface::class)
2✔
167
            ->addTag('api_platform.state_processor');
2✔
168
        $container->registerForAutoconfiguration(UriVariableTransformerInterface::class)
2✔
169
            ->addTag('api_platform.uri_variables.transformer');
2✔
170
        $container->registerForAutoconfiguration(ParameterProviderInterface::class)
2✔
171
            ->addTag('api_platform.parameter_provider');
2✔
172

173
        if (!$container->has('api_platform.state.item_provider')) {
2✔
174
            $container->setAlias('api_platform.state.item_provider', 'api_platform.state_provider.object');
×
175
        }
176
    }
177

178
    private function registerCommonConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader, array $formats, array $patchFormats, array $errorFormats, array $docsFormats, array $jsonSchemaFormats): void
179
    {
180
        $loader->load('state/state.xml');
2✔
181
        $loader->load('symfony/symfony.xml');
2✔
182
        $loader->load('api.xml');
2✔
183
        $loader->load('filter.xml');
2✔
184

185
        if (class_exists(UuidDenormalizer::class) && class_exists(Uuid::class)) {
2✔
186
            $loader->load('ramsey_uuid.xml');
2✔
187
        }
188

189
        if (class_exists(AbstractUid::class)) {
2✔
190
            $loader->load('symfony/uid.xml');
2✔
191
        }
192

193
        $defaultContext = ['hydra_prefix' => $config['serializer']['hydra_prefix']] + ($container->hasParameter('serializer.default_context') ? $container->getParameter('serializer.default_context') : []);
2✔
194

195
        $container->setParameter('api_platform.serializer.default_context', $defaultContext);
2✔
196
        if (!$container->hasParameter('serializer.default_context')) {
2✔
197
            $container->setParameter('serializer.default_context', $container->getParameter('api_platform.serializer.default_context'));
2✔
198
        }
199
        if ($config['use_symfony_listeners']) {
2✔
200
            $loader->load('symfony/events.xml');
1✔
201
        } else {
202
            $loader->load('symfony/controller.xml');
1✔
203
            $loader->load('state/provider.xml');
1✔
204
            $loader->load('state/processor.xml');
1✔
205
        }
206

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

249
        $container->setAlias('api_platform.path_segment_name_generator', $config['path_segment_name_generator']);
2✔
250
        $container->setAlias('api_platform.inflector', $config['inflector']);
2✔
251

252
        if ($config['name_converter']) {
2✔
253
            $container->setAlias('api_platform.name_converter', $config['name_converter']);
2✔
254
        }
255
        $container->setParameter('api_platform.asset_package', $config['asset_package']);
2✔
256
        $container->setParameter('api_platform.defaults', $this->normalizeDefaults($config['defaults'] ?? []));
2✔
257

258
        if ($container->getParameter('kernel.debug')) {
2✔
259
            $container->removeDefinition('api_platform.serializer.mapping.cache_class_metadata_factory');
2✔
260
        }
261
    }
262

263
    /**
264
     * This method will be removed in 3.0 when "defaults" will be the regular configuration path for the pagination.
265
     */
266
    private function getPaginationDefaults(array $defaults, array $collectionPaginationConfiguration): array
267
    {
268
        $paginationOptions = [];
2✔
269

270
        foreach ($defaults as $key => $value) {
2✔
271
            if (!str_starts_with($key, 'pagination_')) {
2✔
272
                continue;
2✔
273
            }
274

275
            $paginationOptions[str_replace('pagination_', '', $key)] = $value;
2✔
276
        }
277

278
        return array_merge($collectionPaginationConfiguration, $paginationOptions);
2✔
279
    }
280

281
    private function normalizeDefaults(array $defaults): array
282
    {
283
        $normalizedDefaults = ['extra_properties' => $defaults['extra_properties'] ?? []];
2✔
284
        unset($defaults['extra_properties']);
2✔
285

286
        $rc = new \ReflectionClass(ApiResource::class);
2✔
287
        $publicProperties = [];
2✔
288
        foreach ($rc->getConstructor()->getParameters() as $param) {
2✔
289
            $publicProperties[$param->getName()] = true;
2✔
290
        }
291

292
        $nameConverter = new CamelCaseToSnakeCaseNameConverter();
2✔
293
        foreach ($defaults as $option => $value) {
2✔
294
            if (isset($publicProperties[$nameConverter->denormalize($option)])) {
2✔
295
                $normalizedDefaults[$option] = $value;
2✔
296

297
                continue;
2✔
298
            }
299

300
            $normalizedDefaults['extra_properties'][$option] = $value;
×
301
        }
302

303
        return $normalizedDefaults;
2✔
304
    }
305

306
    private function registerMetadataConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
307
    {
308
        [$xmlResources, $yamlResources] = $this->getResourcesToWatch($container, $config);
2✔
309

310
        $container->setParameter('api_platform.class_name_resources', $this->getClassNameResources());
2✔
311

312
        $loader->load('metadata/resource_name.xml');
2✔
313
        $loader->load('metadata/property_name.xml');
2✔
314

315
        if (!empty($config['resource_class_directories'])) {
2✔
316
            $container->setParameter('api_platform.resource_class_directories', array_merge(
×
317
                $config['resource_class_directories'],
×
318
                $container->getParameter('api_platform.resource_class_directories')
×
319
            ));
×
320
        }
321

322
        // V3 metadata
323
        $loader->load('metadata/xml.xml');
2✔
324
        $loader->load('metadata/links.xml');
2✔
325
        $loader->load('metadata/property.xml');
2✔
326
        $loader->load('metadata/resource.xml');
2✔
327
        $loader->load('metadata/operation.xml');
2✔
328

329
        $container->getDefinition('api_platform.metadata.resource_extractor.xml')->replaceArgument(0, $xmlResources);
2✔
330
        $container->getDefinition('api_platform.metadata.property_extractor.xml')->replaceArgument(0, $xmlResources);
2✔
331

332
        if (class_exists(PhpDocParser::class) || interface_exists(DocBlockFactoryInterface::class)) {
2✔
333
            $loader->load('metadata/php_doc.xml');
2✔
334
        }
335

336
        if (class_exists(Yaml::class)) {
2✔
337
            $loader->load('metadata/yaml.xml');
2✔
338
            $container->getDefinition('api_platform.metadata.resource_extractor.yaml')->replaceArgument(0, $yamlResources);
2✔
339
            $container->getDefinition('api_platform.metadata.property_extractor.yaml')->replaceArgument(0, $yamlResources);
2✔
340
        }
341
    }
342

343
    private function getClassNameResources(): array
344
    {
345
        return [
2✔
346
            Error::class,
2✔
347
            ValidationException::class,
2✔
348
        ];
2✔
349
    }
350

351
    private function getBundlesResourcesPaths(ContainerBuilder $container, array $config): array
352
    {
353
        $bundlesResourcesPaths = [];
2✔
354

355
        foreach ($container->getParameter('kernel.bundles_metadata') as $bundle) {
2✔
356
            $dirname = $bundle['path'];
2✔
357
            $paths = [
2✔
358
                "$dirname/ApiResource",
2✔
359
                "$dirname/src/ApiResource",
2✔
360
            ];
2✔
361
            foreach (['.yaml', '.yml', '.xml', ''] as $extension) {
2✔
362
                $paths[] = "$dirname/Resources/config/api_resources$extension";
2✔
363
                $paths[] = "$dirname/config/api_resources$extension";
2✔
364
            }
365
            if ($this->isConfigEnabled($container, $config['doctrine'])) {
2✔
366
                $paths[] = "$dirname/Entity";
2✔
367
                $paths[] = "$dirname/src/Entity";
2✔
368
            }
369
            if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
2✔
370
                $paths[] = "$dirname/Document";
×
371
                $paths[] = "$dirname/src/Document";
×
372
            }
373

374
            foreach ($paths as $path) {
2✔
375
                if ($container->fileExists($path, false)) {
2✔
376
                    $bundlesResourcesPaths[] = $path;
2✔
377
                }
378
            }
379
        }
380

381
        return $bundlesResourcesPaths;
2✔
382
    }
383

384
    private function getResourcesToWatch(ContainerBuilder $container, array $config): array
385
    {
386
        $paths = array_unique(array_merge($this->getBundlesResourcesPaths($container, $config), $config['mapping']['paths']));
2✔
387

388
        if (!$config['mapping']['paths']) {
2✔
389
            $projectDir = $container->getParameter('kernel.project_dir');
×
390
            foreach (["$projectDir/config/api_platform", "$projectDir/src/ApiResource"] as $dir) {
×
391
                if (is_dir($dir)) {
×
392
                    $paths[] = $dir;
×
393
                }
394
            }
395

396
            if ($this->isConfigEnabled($container, $config['doctrine']) && is_dir($doctrinePath = "$projectDir/src/Entity")) {
×
397
                $paths[] = $doctrinePath;
×
398
            }
399

400
            if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm']) && is_dir($documentPath = "$projectDir/src/Document")) {
×
401
                $paths[] = $documentPath;
×
402
            }
403
        }
404

405
        $resources = ['yml' => [], 'xml' => [], 'dir' => []];
2✔
406

407
        foreach ($paths as $path) {
2✔
408
            if (is_dir($path)) {
2✔
409
                foreach (Finder::create()->followLinks()->files()->in($path)->name('/\.(xml|ya?ml)$/')->sortByName() as $file) {
2✔
410
                    $resources['yaml' === ($extension = $file->getExtension()) ? 'yml' : $extension][] = $file->getRealPath();
2✔
411
                }
412

413
                $resources['dir'][] = $path;
2✔
414
                $container->addResource(new DirectoryResource($path, '/\.(xml|ya?ml|php)$/'));
2✔
415

416
                continue;
2✔
417
            }
418

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

424
                $resources['yaml' === $matches[1] ? 'yml' : $matches[1]][] = $path;
×
425

426
                continue;
×
427
            }
428

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

432
        $container->setParameter('api_platform.resource_class_directories', $resources['dir']);
2✔
433

434
        return [$resources['xml'], $resources['yml']];
2✔
435
    }
436

437
    private function registerOAuthConfiguration(ContainerBuilder $container, array $config): void
438
    {
439
        if (!$config['oauth']) {
2✔
440
            return;
×
441
        }
442

443
        $container->setParameter('api_platform.oauth.enabled', $this->isConfigEnabled($container, $config['oauth']));
2✔
444
        $container->setParameter('api_platform.oauth.clientId', $config['oauth']['clientId']);
2✔
445
        $container->setParameter('api_platform.oauth.clientSecret', $config['oauth']['clientSecret']);
2✔
446
        $container->setParameter('api_platform.oauth.type', $config['oauth']['type']);
2✔
447
        $container->setParameter('api_platform.oauth.flow', $config['oauth']['flow']);
2✔
448
        $container->setParameter('api_platform.oauth.tokenUrl', $config['oauth']['tokenUrl']);
2✔
449
        $container->setParameter('api_platform.oauth.authorizationUrl', $config['oauth']['authorizationUrl']);
2✔
450
        $container->setParameter('api_platform.oauth.refreshUrl', $config['oauth']['refreshUrl']);
2✔
451
        $container->setParameter('api_platform.oauth.scopes', $config['oauth']['scopes']);
2✔
452
        $container->setParameter('api_platform.oauth.pkce', $config['oauth']['pkce']);
2✔
453

454
        if ($container->hasDefinition('api_platform.swagger_ui.action')) {
2✔
455
            $container->getDefinition('api_platform.swagger_ui.action')->setArgument(10, $config['oauth']['pkce']);
×
456
        }
457
    }
458

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

470
        $container->setParameter('api_platform.swagger.versions', $config['swagger']['versions']);
2✔
471

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

476
        if (!$config['enable_swagger']) {
2✔
477
            return;
×
478
        }
479

480
        $loader->load('openapi.xml');
2✔
481

482
        if (class_exists(Yaml::class)) {
2✔
483
            $loader->load('openapi/yaml.xml');
2✔
484
        }
485

486
        $loader->load('swagger_ui.xml');
2✔
487

488
        if ($config['use_symfony_listeners']) {
2✔
489
            $loader->load('symfony/swagger_ui.xml');
1✔
490
        }
491

492
        if ($config['enable_swagger_ui']) {
2✔
493
            $loader->load('state/swagger_ui.xml');
2✔
494
        }
495

496
        if (!$config['enable_swagger_ui'] && !$config['enable_re_doc']) {
2✔
497
            // Remove the listener but keep the controller to allow customizing the path of the UI
498
            $container->removeDefinition('api_platform.swagger.listener.ui');
×
499
        }
500

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

512
    private function registerJsonApiConfiguration(array $formats, XmlFileLoader $loader, array $config): void
513
    {
514
        if (!isset($formats['jsonapi'])) {
2✔
515
            return;
×
516
        }
517

518
        $loader->load('jsonapi.xml');
2✔
519
        $loader->load('state/jsonapi.xml');
2✔
520
    }
521

522
    private function registerJsonLdHydraConfiguration(ContainerBuilder $container, array $formats, XmlFileLoader $loader, array $config): void
523
    {
524
        if (!isset($formats['jsonld'])) {
2✔
525
            return;
×
526
        }
527

528
        if ($config['use_symfony_listeners']) {
2✔
529
            $loader->load('symfony/jsonld.xml');
1✔
530
        } else {
531
            $loader->load('state/jsonld.xml');
1✔
532
        }
533

534
        $loader->load('state/hydra.xml');
2✔
535
        $loader->load('jsonld.xml');
2✔
536
        $loader->load('hydra.xml');
2✔
537

538
        if (!$container->has('api_platform.json_schema.schema_factory')) {
2✔
539
            $container->removeDefinition('api_platform.hydra.json_schema.schema_factory');
×
540
        }
541

542
        if (!$config['enable_docs']) {
2✔
543
            $container->removeDefinition('api_platform.hydra.listener.response.add_link_header');
×
544
            $container->removeDefinition('api_platform.hydra.processor.link');
×
545
        }
546
    }
547

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

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

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

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

566
    private function registerGraphQlConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
567
    {
568
        $enabled = $this->isConfigEnabled($container, $config['graphql']);
2✔
569
        $graphqlIntrospectionEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['introspection']);
2✔
570
        $graphiqlEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphiql']);
2✔
571
        $graphqlPlayGroundEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphql_playground']);
2✔
572
        $maxQueryDepth = (int) $config['graphql']['max_query_depth'];
2✔
573
        $maxQueryComplexity = (int) $config['graphql']['max_query_complexity'];
2✔
574
        if ($graphqlPlayGroundEnabled) {
2✔
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);
2✔
579
        $container->setParameter('api_platform.graphql.max_query_depth', $maxQueryDepth);
2✔
580
        $container->setParameter('api_platform.graphql.max_query_complexity', $maxQueryComplexity);
2✔
581
        $container->setParameter('api_platform.graphql.introspection.enabled', $graphqlIntrospectionEnabled);
2✔
582
        $container->setParameter('api_platform.graphql.graphiql.enabled', $graphiqlEnabled);
2✔
583
        $container->setParameter('api_platform.graphql.graphql_playground.enabled', $graphqlPlayGroundEnabled);
2✔
584
        $container->setParameter('api_platform.graphql.collection.pagination', $config['graphql']['collection']['pagination']);
2✔
585

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

590
        if (!class_exists(Executor::class)) {
2✔
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']);
2✔
595
        $container->setParameter('api_platform.graphql.nesting_separator', $config['graphql']['nesting_separator']);
2✔
596

597
        $loader->load('graphql.xml');
2✔
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'])) {
2✔
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)
2✔
609
            ->addTag('api_platform.graphql.resolver');
2✔
610
        $container->registerForAutoconfiguration(QueryCollectionResolverInterface::class)
2✔
611
            ->addTag('api_platform.graphql.resolver');
2✔
612
        $container->registerForAutoconfiguration(MutationResolverInterface::class)
2✔
613
            ->addTag('api_platform.graphql.resolver');
2✔
614
        $container->registerForAutoconfiguration(GraphQlTypeInterface::class)
2✔
615
            ->addTag('api_platform.graphql.type');
2✔
616
        $container->registerForAutoconfiguration(ErrorHandlerInterface::class)
2✔
617
            ->addTag('api_platform.graphql.error_handler');
2✔
618
    }
619

620
    private function registerCacheConfiguration(ContainerBuilder $container): void
621
    {
622
        if (!$container->hasParameter('kernel.debug') || !$container->getParameter('kernel.debug')) {
2✔
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'])) {
2✔
630
            return;
×
631
        }
632

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

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

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

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

649
        if ($this->isConfigEnabled($container, $config['eager_loading'])) {
2✔
650
            return;
2✔
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'])) {
2✔
662
            return;
2✔
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');
2✔
680

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

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

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

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

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

701
        foreach ($urls as $key => $url) {
2✔
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'];
2✔
709

710
        if (!$container->hasDefinition('api_platform.http_cache.purger')) {
2✔
711
            $container->setAlias('api_platform.http_cache.purger', $serviceName);
2✔
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 = [];
2✔
721
        foreach ($configFormats as $format => $value) {
2✔
722
            foreach ($value['mime_types'] as $mimeType) {
2✔
723
                $formats[$format][] = $mimeType;
2✔
724
            }
725
        }
726

727
        return $formats;
2✔
728
    }
729

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

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

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

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

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

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

755
        if (!$config['validator']['query_parameter_validation']) {
2✔
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']) {
2✔
765
            return;
×
766
        }
767

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

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

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

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

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

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

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

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

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

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

811
        if (!$enabled) {
2✔
812
            return;
2✔
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');
2✔
833

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

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

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

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

846
        if ($this->isConfigEnabled($container, $config['graphql'])) {
2✔
847
            $loader->load('graphql/security.xml');
2✔
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']);
2✔
854
        $container->setParameter('api_platform.openapi.contact.name', $config['openapi']['contact']['name']);
2✔
855
        $container->setParameter('api_platform.openapi.contact.url', $config['openapi']['contact']['url']);
2✔
856
        $container->setParameter('api_platform.openapi.contact.email', $config['openapi']['contact']['email']);
2✔
857
        $container->setParameter('api_platform.openapi.license.name', $config['openapi']['license']['name']);
2✔
858
        $container->setParameter('api_platform.openapi.license.url', $config['openapi']['license']['url']);
2✔
859
        $container->setParameter('api_platform.openapi.overrideResponses', $config['openapi']['overrideResponses']);
2✔
860

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

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

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

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

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

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

885
    private function registerLinkSecurityConfiguration(XmlFileLoader $loader, array $config): void
886
    {
887
        if ($config['enable_link_security']) {
2✔
888
            $loader->load('link_security.xml');
2✔
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

© 2025 Coveralls, Inc