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

api-platform / core / 14249627505

03 Apr 2025 05:58PM UTC coverage: 7.308%. Remained the same
14249627505

push

github

soyuka
docs: changelog 4.0.22

12514 of 171232 relevant lines covered (7.31%)

12.07 hits per line

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

80.36
/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\RamseyUuid\Serializer\UuidDenormalizer;
38
use ApiPlatform\State\ApiResource\Error;
39
use ApiPlatform\State\ParameterProviderInterface;
40
use ApiPlatform\State\ProcessorInterface;
41
use ApiPlatform\State\ProviderInterface;
42
use ApiPlatform\Symfony\Validator\Metadata\Property\Restriction\PropertySchemaRestrictionMetadataInterface;
43
use ApiPlatform\Symfony\Validator\ValidationGroupsGeneratorInterface;
44
use ApiPlatform\Validator\Exception\ValidationException;
45
use Doctrine\Persistence\ManagerRegistry;
46
use phpDocumentor\Reflection\DocBlockFactoryInterface;
47
use PHPStan\PhpDocParser\Parser\PhpDocParser;
48
use Ramsey\Uuid\Uuid;
49
use Symfony\Component\Config\FileLocator;
50
use Symfony\Component\Config\Resource\DirectoryResource;
51
use Symfony\Component\DependencyInjection\ContainerBuilder;
52
use Symfony\Component\DependencyInjection\Definition;
53
use Symfony\Component\DependencyInjection\Exception\RuntimeException;
54
use Symfony\Component\DependencyInjection\Extension\Extension;
55
use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
56
use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
57
use Symfony\Component\DependencyInjection\Reference;
58
use Symfony\Component\Finder\Finder;
59
use Symfony\Component\HttpClient\ScopingHttpClient;
60
use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
61
use Symfony\Component\Uid\AbstractUid;
62
use Symfony\Component\Validator\Validator\ValidatorInterface;
63
use Symfony\Component\Yaml\Yaml;
64
use Twig\Environment;
65

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

277
        return array_merge($collectionPaginationConfiguration, $paginationOptions);
3✔
278
    }
279

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

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

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

296
                continue;
3✔
297
            }
298

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

302
        return $normalizedDefaults;
3✔
303
    }
304

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

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

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

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

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

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

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

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

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

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

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

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

380
        return $bundlesResourcesPaths;
3✔
381
    }
382

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

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

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

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

404
        $resources = ['yml' => [], 'xml' => [], 'dir' => []];
3✔
405

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

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

415
                continue;
3✔
416
            }
417

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

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

425
                continue;
×
426
            }
427

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

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

433
        return [$resources['xml'], $resources['yml']];
3✔
434
    }
435

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

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

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

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

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

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

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

479
        $loader->load('openapi.xml');
3✔
480

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

485
        $loader->load('swagger_ui.xml');
3✔
486

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

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

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

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

509
    private function registerJsonApiConfiguration(array $formats, XmlFileLoader $loader, array $config): void
510
    {
511
        if (!isset($formats['jsonapi'])) {
3✔
512
            return;
×
513
        }
514

515
        $loader->load('jsonapi.xml');
3✔
516
        $loader->load('state/jsonapi.xml');
3✔
517
    }
518

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

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

531
        $loader->load('state/hydra.xml');
3✔
532
        $loader->load('jsonld.xml');
3✔
533
        $loader->load('hydra.xml');
3✔
534

535
        if (!$container->has('api_platform.json_schema.schema_factory')) {
3✔
536
            $container->removeDefinition('api_platform.hydra.json_schema.schema_factory');
×
537
        }
538

539
        if (!$config['enable_docs']) {
3✔
540
            $container->removeDefinition('api_platform.hydra.listener.response.add_link_header');
×
541
            $container->removeDefinition('api_platform.hydra.processor.link');
×
542
        }
543
    }
544

545
    private function registerJsonHalConfiguration(array $formats, XmlFileLoader $loader): void
546
    {
547
        if (!isset($formats['jsonhal'])) {
3✔
548
            return;
×
549
        }
550

551
        $loader->load('hal.xml');
3✔
552
    }
553

554
    private function registerJsonProblemConfiguration(array $errorFormats, XmlFileLoader $loader): void
555
    {
556
        if (!isset($errorFormats['jsonproblem'])) {
3✔
557
            return;
×
558
        }
559

560
        $loader->load('problem.xml');
3✔
561
    }
562

563
    private function registerGraphQlConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
564
    {
565
        $enabled = $this->isConfigEnabled($container, $config['graphql']);
3✔
566
        $graphqlIntrospectionEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['introspection']);
3✔
567

568
        $graphiqlEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphiql']);
3✔
569
        $graphqlPlayGroundEnabled = $enabled && $this->isConfigEnabled($container, $config['graphql']['graphql_playground']);
3✔
570
        if ($graphqlPlayGroundEnabled) {
3✔
571
            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.');
×
572
        }
573

574
        $container->setParameter('api_platform.graphql.enabled', $enabled);
3✔
575
        $container->setParameter('api_platform.graphql.introspection.enabled', $graphqlIntrospectionEnabled);
3✔
576
        $container->setParameter('api_platform.graphql.graphiql.enabled', $graphiqlEnabled);
3✔
577
        $container->setParameter('api_platform.graphql.graphql_playground.enabled', $graphqlPlayGroundEnabled);
3✔
578
        $container->setParameter('api_platform.graphql.collection.pagination', $config['graphql']['collection']['pagination']);
3✔
579

580
        if (!$enabled) {
3✔
581
            return;
×
582
        }
583

584
        if (!class_exists(Executor::class)) {
3✔
585
            throw new \RuntimeException('Graphql is enabled but not installed, run: composer require "api-platform/graphql".');
×
586
        }
587

588
        $container->setParameter('api_platform.graphql.default_ide', $config['graphql']['default_ide']);
3✔
589
        $container->setParameter('api_platform.graphql.nesting_separator', $config['graphql']['nesting_separator']);
3✔
590

591
        $loader->load('graphql.xml');
3✔
592

593
        // @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
594
        if (!class_exists(Environment::class) || !isset($container->getParameter('kernel.bundles')['TwigBundle'])) {
3✔
595
            if ($graphiqlEnabled || $graphqlPlayGroundEnabled) {
×
596
                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')));
×
597
            }
598
            $container->removeDefinition('api_platform.graphql.action.graphiql');
×
599
            $container->removeDefinition('api_platform.graphql.action.graphql_playground');
×
600
        }
601

602
        $container->registerForAutoconfiguration(QueryItemResolverInterface::class)
3✔
603
            ->addTag('api_platform.graphql.resolver');
3✔
604
        $container->registerForAutoconfiguration(QueryCollectionResolverInterface::class)
3✔
605
            ->addTag('api_platform.graphql.resolver');
3✔
606
        $container->registerForAutoconfiguration(MutationResolverInterface::class)
3✔
607
            ->addTag('api_platform.graphql.resolver');
3✔
608
        $container->registerForAutoconfiguration(GraphQlTypeInterface::class)
3✔
609
            ->addTag('api_platform.graphql.type');
3✔
610
        $container->registerForAutoconfiguration(ErrorHandlerInterface::class)
3✔
611
            ->addTag('api_platform.graphql.error_handler');
3✔
612
    }
613

614
    private function registerCacheConfiguration(ContainerBuilder $container): void
615
    {
616
        if (!$container->hasParameter('kernel.debug') || !$container->getParameter('kernel.debug')) {
3✔
617
            $container->removeDefinition('api_platform.cache_warmer.cache_pool_clearer');
×
618
        }
619
    }
620

621
    private function registerDoctrineOrmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
622
    {
623
        if (!$this->isConfigEnabled($container, $config['doctrine'])) {
3✔
624
            return;
×
625
        }
626

627
        // For older versions of doctrine bridge this allows autoconfiguration for filters
628
        if (!$container->has(ManagerRegistry::class)) {
3✔
629
            $container->setAlias(ManagerRegistry::class, 'doctrine');
3✔
630
        }
631

632
        $container->registerForAutoconfiguration(QueryItemExtensionInterface::class)
3✔
633
            ->addTag('api_platform.doctrine.orm.query_extension.item');
3✔
634
        $container->registerForAutoconfiguration(DoctrineQueryCollectionExtensionInterface::class)
3✔
635
            ->addTag('api_platform.doctrine.orm.query_extension.collection');
3✔
636
        $container->registerForAutoconfiguration(DoctrineOrmAbstractFilter::class);
3✔
637

638
        $container->registerForAutoconfiguration(OrmLinksHandlerInterface::class)
3✔
639
            ->addTag('api_platform.doctrine.orm.links_handler');
3✔
640

641
        $loader->load('doctrine_orm.xml');
3✔
642

643
        if ($this->isConfigEnabled($container, $config['eager_loading'])) {
3✔
644
            return;
3✔
645
        }
646

647
        $container->removeAlias(EagerLoadingExtension::class);
×
648
        $container->removeDefinition('api_platform.doctrine.orm.query_extension.eager_loading');
×
649
        $container->removeAlias(FilterEagerLoadingExtension::class);
×
650
        $container->removeDefinition('api_platform.doctrine.orm.query_extension.filter_eager_loading');
×
651
    }
652

653
    private function registerDoctrineMongoDbOdmConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
654
    {
655
        if (!$this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
3✔
656
            return;
3✔
657
        }
658

659
        $container->registerForAutoconfiguration(AggregationItemExtensionInterface::class)
×
660
            ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.item');
×
661
        $container->registerForAutoconfiguration(AggregationCollectionExtensionInterface::class)
×
662
            ->addTag('api_platform.doctrine_mongodb.odm.aggregation_extension.collection');
×
663
        $container->registerForAutoconfiguration(DoctrineMongoDbOdmAbstractFilter::class)
×
664
            ->setBindings(['$managerRegistry' => new Reference('doctrine_mongodb')]);
×
665
        $container->registerForAutoconfiguration(OdmLinksHandlerInterface::class)
×
666
            ->addTag('api_platform.doctrine.odm.links_handler');
×
667

668
        $loader->load('doctrine_mongodb_odm.xml');
×
669
    }
670

671
    private function registerHttpCacheConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
672
    {
673
        $loader->load('http_cache.xml');
3✔
674

675
        if (!$this->isConfigEnabled($container, $config['http_cache']['invalidation'])) {
3✔
676
            return;
×
677
        }
678

679
        if ($this->isConfigEnabled($container, $config['doctrine'])) {
3✔
680
            $loader->load('doctrine_orm_http_cache_purger.xml');
3✔
681
        }
682

683
        $loader->load('state/http_cache_purger.xml');
3✔
684
        $loader->load('http_cache_purger.xml');
3✔
685

686
        foreach ($config['http_cache']['invalidation']['scoped_clients'] as $client) {
3✔
687
            $definition = $container->getDefinition($client);
×
688
            $definition->addTag('api_platform.http_cache.http_client');
×
689
        }
690

691
        if (!($urls = $config['http_cache']['invalidation']['urls'])) {
3✔
692
            $urls = $config['http_cache']['invalidation']['varnish_urls'];
3✔
693
        }
694

695
        foreach ($urls as $key => $url) {
3✔
696
            $definition = new Definition(ScopingHttpClient::class, [new Reference('http_client'), $url, ['base_uri' => $url] + $config['http_cache']['invalidation']['request_options']]);
×
697
            $definition->setFactory([ScopingHttpClient::class, 'forBaseUri']);
×
698
            $definition->addTag('api_platform.http_cache.http_client');
×
699
            $container->setDefinition('api_platform.invalidation_http_client.'.$key, $definition);
×
700
        }
701

702
        $serviceName = $config['http_cache']['invalidation']['purger'];
3✔
703

704
        if (!$container->hasDefinition('api_platform.http_cache.purger')) {
3✔
705
            $container->setAlias('api_platform.http_cache.purger', $serviceName);
3✔
706
        }
707
    }
708

709
    /**
710
     * Normalizes the format from config to the one accepted by Symfony HttpFoundation.
711
     */
712
    private function getFormats(array $configFormats): array
713
    {
714
        $formats = [];
3✔
715
        foreach ($configFormats as $format => $value) {
3✔
716
            foreach ($value['mime_types'] as $mimeType) {
3✔
717
                $formats[$format][] = $mimeType;
3✔
718
            }
719
        }
720

721
        return $formats;
3✔
722
    }
723

724
    private function registerValidatorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
725
    {
726
        if (interface_exists(ValidatorInterface::class)) {
3✔
727
            $loader->load('metadata/validator.xml');
3✔
728
            $loader->load('validator/validator.xml');
3✔
729

730
            if ($this->isConfigEnabled($container, $config['graphql'])) {
3✔
731
                $loader->load('graphql/validator.xml');
3✔
732
            }
733

734
            $loader->load($config['use_symfony_listeners'] ? 'validator/events.xml' : 'validator/state.xml');
3✔
735

736
            $container->registerForAutoconfiguration(ValidationGroupsGeneratorInterface::class)
3✔
737
                ->addTag('api_platform.validation_groups_generator');
3✔
738
            $container->registerForAutoconfiguration(PropertySchemaRestrictionMetadataInterface::class)
3✔
739
                ->addTag('api_platform.metadata.property_schema_restriction');
3✔
740
        }
741

742
        if (!$config['validator']) {
3✔
743
            return;
×
744
        }
745

746
        $container->setParameter('api_platform.validator.serialize_payload_fields', $config['validator']['serialize_payload_fields']);
3✔
747
        $container->setParameter('api_platform.validator.query_parameter_validation', $config['validator']['query_parameter_validation']);
3✔
748

749
        if (!$config['validator']['query_parameter_validation']) {
3✔
750
            $container->removeDefinition('api_platform.listener.view.validate_query_parameters');
×
751
            $container->removeDefinition('api_platform.validator.query_parameter_validator');
×
752
            $container->removeDefinition('api_platform.symfony.parameter_validator');
×
753
        }
754
    }
755

756
    private function registerDataCollectorConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
757
    {
758
        if (!$config['enable_profiler']) {
3✔
759
            return;
×
760
        }
761

762
        $loader->load('data_collector.xml');
3✔
763

764
        if ($container->hasParameter('kernel.debug') && $container->getParameter('kernel.debug')) {
3✔
765
            $loader->load('debug.xml');
3✔
766
        }
767
    }
768

769
    private function registerMercureConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
770
    {
771
        if (!$this->isConfigEnabled($container, $config['mercure'])) {
3✔
772
            return;
×
773
        }
774

775
        $container->setParameter('api_platform.mercure.include_type', $config['mercure']['include_type']);
3✔
776
        $loader->load('state/mercure.xml');
3✔
777

778
        if ($this->isConfigEnabled($container, $config['doctrine'])) {
3✔
779
            $loader->load('doctrine_orm_mercure_publisher.xml');
3✔
780
        }
781
        if ($this->isConfigEnabled($container, $config['doctrine_mongodb_odm'])) {
3✔
782
            $loader->load('doctrine_odm_mercure_publisher.xml');
×
783
        }
784

785
        if ($this->isConfigEnabled($container, $config['graphql'])) {
3✔
786
            $loader->load('graphql_mercure.xml');
3✔
787
        }
788
    }
789

790
    private function registerMessengerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
791
    {
792
        if (!$this->isConfigEnabled($container, $config['messenger'])) {
3✔
793
            return;
×
794
        }
795

796
        $loader->load('messenger.xml');
3✔
797
    }
798

799
    private function registerElasticsearchConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
800
    {
801
        $enabled = $this->isConfigEnabled($container, $config['elasticsearch']);
3✔
802

803
        $container->setParameter('api_platform.elasticsearch.enabled', $enabled);
3✔
804

805
        if (!$enabled) {
3✔
806
            return;
3✔
807
        }
808

809
        $clientClass = class_exists(\Elasticsearch\Client::class) ? \Elasticsearch\Client::class : \Elastic\Elasticsearch\Client::class;
×
810

811
        $clientDefinition = new Definition($clientClass);
×
812
        $container->setDefinition('api_platform.elasticsearch.client', $clientDefinition);
×
813
        $container->registerForAutoconfiguration(RequestBodySearchCollectionExtensionInterface::class)
×
814
            ->addTag('api_platform.elasticsearch.request_body_search_extension.collection');
×
815
        $container->setParameter('api_platform.elasticsearch.hosts', $config['elasticsearch']['hosts']);
×
816
        $loader->load('elasticsearch.xml');
×
817
    }
818

819
    private function registerSecurityConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
820
    {
821
        /** @var string[] $bundles */
822
        $bundles = $container->getParameter('kernel.bundles');
3✔
823

824
        if (!isset($bundles['SecurityBundle'])) {
3✔
825
            return;
×
826
        }
827

828
        $loader->load('security.xml');
3✔
829

830
        $loader->load('state/security.xml');
3✔
831

832
        if (interface_exists(ValidatorInterface::class)) {
3✔
833
            $loader->load('state/security_validator.xml');
3✔
834
        }
835

836
        if ($this->isConfigEnabled($container, $config['graphql'])) {
3✔
837
            $loader->load('graphql/security.xml');
3✔
838
        }
839
    }
840

841
    private function registerOpenApiConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
842
    {
843
        $container->setParameter('api_platform.openapi.termsOfService', $config['openapi']['termsOfService']);
3✔
844
        $container->setParameter('api_platform.openapi.contact.name', $config['openapi']['contact']['name']);
3✔
845
        $container->setParameter('api_platform.openapi.contact.url', $config['openapi']['contact']['url']);
3✔
846
        $container->setParameter('api_platform.openapi.contact.email', $config['openapi']['contact']['email']);
3✔
847
        $container->setParameter('api_platform.openapi.license.name', $config['openapi']['license']['name']);
3✔
848
        $container->setParameter('api_platform.openapi.license.url', $config['openapi']['license']['url']);
3✔
849
        $container->setParameter('api_platform.openapi.overrideResponses', $config['openapi']['overrideResponses']);
3✔
850

851
        $loader->load('json_schema.xml');
3✔
852
    }
853

854
    private function registerMakerConfiguration(ContainerBuilder $container, array $config, XmlFileLoader $loader): void
855
    {
856
        if (!$this->isConfigEnabled($container, $config['maker'])) {
3✔
857
            return;
×
858
        }
859

860
        $loader->load('maker.xml');
3✔
861
    }
862

863
    private function registerArgumentResolverConfiguration(XmlFileLoader $loader): void
864
    {
865
        $loader->load('argument_resolver.xml');
3✔
866
    }
867

868
    private function registerLinkSecurityConfiguration(XmlFileLoader $loader, array $config): void
869
    {
870
        if ($config['enable_link_security']) {
3✔
871
            $loader->load('link_security.xml');
3✔
872
        }
873
    }
874
}
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