prependExtensionConfig('framework', ['property_info' => ['enabled' => true]]); // JMS Serializer support $bundles = $container->getParameter('kernel.bundles'); if (isset($bundles['JMSSerializerBundle'])) { $container->prependExtensionConfig('nelmio_api_doc', ['models' => ['use_jms' => true]]); } } /** * {@inheritdoc} */ public function load(array $configs, ContainerBuilder $container) { $config = $this->processConfiguration(new Configuration(), $configs); $loader = new XmlFileLoader($container, new FileLocator(__DIR__.'/../Resources/config')); $loader->load('services.xml'); // Filter routes $routesDefinition = (new Definition(RouteCollection::class)) ->setFactory([new Reference('router'), 'getRouteCollection']); $container->setParameter('nelmio_api_doc.areas', array_keys($config['areas'])); foreach ($config['areas'] as $area => $areaConfig) { $container->register(sprintf('nelmio_api_doc.generator.%s', $area), ApiDocGenerator::class) ->setPublic(false) ->setArguments([ new TaggedIteratorArgument(sprintf('nelmio_api_doc.describer.%s', $area)), new TaggedIteratorArgument('nelmio_api_doc.model_describer'), ]); if (0 === count($areaConfig['path_patterns'])) { $container->setDefinition(sprintf('nelmio_api_doc.routes.%s', $area), $routesDefinition) ->setPublic(false); } else { $container->register(sprintf('nelmio_api_doc.routes.%s', $area), RouteCollection::class) ->setPublic(false) ->setFactory([ (new Definition(FilteredRouteCollectionBuilder::class)) ->addArgument($areaConfig['path_patterns']), 'filter', ]) ->addArgument($routesDefinition); } $container->register(sprintf('nelmio_api_doc.describers.route.%s', $area), RouteDescriber::class) ->setPublic(false) ->setArguments([ new Reference(sprintf('nelmio_api_doc.routes.%s', $area)), new Reference('nelmio_api_doc.controller_reflector'), new TaggedIteratorArgument('nelmio_api_doc.route_describer'), ]) ->addTag(sprintf('nelmio_api_doc.describer.%s', $area), ['priority' => -400]); $container->register(sprintf('nelmio_api_doc.describers.swagger_php.%s', $area), SwaggerPhpDescriber::class) ->setPublic(false) ->setArguments([ new Reference(sprintf('nelmio_api_doc.routes.%s', $area)), new Reference('nelmio_api_doc.controller_reflector'), new Reference('annotation_reader'), ]) ->addTag(sprintf('nelmio_api_doc.describer.%s', $area), ['priority' => -200]); } $container->register('nelmio_api_doc.generator_locator') ->setPublic(false) ->addTag('container.service_locator') ->addArgument(array_combine( array_keys($config['areas']), array_map(function ($area) { return new Reference(sprintf('nelmio_api_doc.generator.%s', $area)); }, array_keys($config['areas'])) )); // Import services needed for each library if (class_exists(DocBlockFactory::class)) { $loader->load('php_doc.xml'); } if (interface_exists(ParamInterface::class)) { $loader->load('fos_rest.xml'); } // ApiPlatform support $bundles = $container->getParameter('kernel.bundles'); if (!isset($bundles['TwigBundle'])) { $container->removeDefinition('nelmio_api_doc.controller.swagger_ui'); } if (isset($bundles['ApiPlatformBundle']) && class_exists('ApiPlatform\Core\Documentation\Documentation')) { $loader->load('api_platform.xml'); } // JMS metadata support if ($config['models']['use_jms']) { $arguments = [ new Reference('jms_serializer.metadata_factory'), new Reference('jms_serializer.naming_strategy'), new Reference('nelmio_api_doc.model_describers.swagger_property_annotation_reader'), ]; // phpdocumentor is not a hard requirement, only use if available if (class_exists(DocBlockFactory::class)) { $arguments[] = new Reference('nelmio_api_doc.model_describers.phpdoc_property_annotation_reader'); } $container->register('nelmio_api_doc.model_describers.jms', JMSModelDescriber::class) ->setPublic(false) ->setArguments($arguments) ->addTag('nelmio_api_doc.model_describer', ['priority' => 50]); } // Import the base configuration $container->getDefinition('nelmio_api_doc.describers.config')->replaceArgument(0, $config['documentation']); } }