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

api-platform / core / 10944992322

19 Sep 2024 04:21PM UTC coverage: 7.678% (+0.2%) from 7.518%
10944992322

push

github

soyuka
doc: changelog 4.0.1

12681 of 165161 relevant lines covered (7.68%)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

295
                continue;
3✔
296
            }
297

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

301
        return $normalizedDefaults;
3✔
302
    }
303

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

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

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

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

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

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

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

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

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

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

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

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

379
        return $bundlesResourcesPaths;
3✔
380
    }
381

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

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

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

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

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

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

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

414
                continue;
3✔
415
            }
416

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

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

424
                continue;
×
425
            }
426

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

720
        return $formats;
3✔
721
    }
722

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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