vendor/symfony/framework-bundle/Kernel/MicroKernelTrait.php line 92

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Bundle\FrameworkBundle\Kernel;
  14. use Symfony\Component\Config\Loader\LoaderInterface;
  15. use Symfony\Component\DependencyInjection\ContainerBuilder;
  16. use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  17. use Symfony\Component\Routing\RouteCollectionBuilder;
  19. /**
  20.  * A Kernel that provides configuration hooks.
  21.  *
  22.  * @author Ryan Weaver <ryan@knpuniversity.com>
  23.  * @author Fabien Potencier <fabien@symfony.com>
  24.  */
  25. trait MicroKernelTrait
  26. {
  27.     /**
  28.      * Add or import routes into your application.
  29.      *
  30.      *     $routes->import('config/routing.yml');
  31.      *     $routes->add('/admin', 'App\Controller\AdminController::dashboard', 'admin_dashboard');
  32.      */
  33.     abstract protected function configureRoutes(RouteCollectionBuilder $routes);
  35.     /**
  36.      * Configures the container.
  37.      *
  38.      * You can register extensions:
  39.      *
  40.      *     $container->loadFromExtension('framework', [
  41.      *         'secret' => '%secret%'
  42.      *     ]);
  43.      *
  44.      * Or services:
  45.      *
  46.      *     $container->register('halloween', 'FooBundle\HalloweenProvider');
  47.      *
  48.      * Or parameters:
  49.      *
  50.      *     $container->setParameter('halloween', 'lot of fun');
  51.      */
  52.     abstract protected function configureContainer(ContainerBuilder $container, LoaderInterface $loader);
  54.     /**
  55.      * {@inheritdoc}
  56.      */
  57.     public function registerContainerConfiguration(LoaderInterface $loader)
  58.     {
  59.         $loader->load(function (ContainerBuilder $container) use ($loader) {
  60.             $container->loadFromExtension('framework', [
  61.                 'router' => [
  62.                     'resource' => 'kernel::loadRoutes',
  63.                     'type' => 'service',
  64.                 ],
  65.             ]);
  67.             if (!$container->hasDefinition('kernel')) {
  68.                 $container->register('kernel', static::class)
  69.                     ->setSynthetic(true)
  70.                     ->setPublic(true)
  71.                 ;
  72.             }
  74.             $kernelDefinition = $container->getDefinition('kernel');
  75.             $kernelDefinition->addTag('routing.route_loader');
  77.             if ($this instanceof EventSubscriberInterface) {
  78.                 $kernelDefinition->addTag('kernel.event_subscriber');
  79.             }
  81.             $this->configureContainer($container, $loader);
  83.             $container->addObjectResource($this);
  84.         });
  85.     }
  87.     /**
  88.      * @internal
  89.      */
  90.     public function loadRoutes(LoaderInterface $loader)
  91.     {
  92.         $routes = new RouteCollectionBuilder($loader);
  93.         $this->configureRoutes($routes);
  95.         return $routes->build();
  96.     }
  97. }