annotate vendor/symfony/http-kernel/DependencyInjection/LazyLoadingFragmentHandler.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 129ea1e6d783
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /*
Chris@0 4 * This file is part of the Symfony package.
Chris@0 5 *
Chris@0 6 * (c) Fabien Potencier <fabien@symfony.com>
Chris@0 7 *
Chris@0 8 * For the full copyright and license information, please view the LICENSE
Chris@0 9 * file that was distributed with this source code.
Chris@0 10 */
Chris@0 11
Chris@0 12 namespace Symfony\Component\HttpKernel\DependencyInjection;
Chris@0 13
Chris@14 14 use Psr\Container\ContainerInterface;
Chris@0 15 use Symfony\Component\HttpFoundation\RequestStack;
Chris@0 16 use Symfony\Component\HttpKernel\Fragment\FragmentHandler;
Chris@0 17
Chris@0 18 /**
Chris@0 19 * Lazily loads fragment renderers from the dependency injection container.
Chris@0 20 *
Chris@0 21 * @author Fabien Potencier <fabien@symfony.com>
Chris@0 22 */
Chris@0 23 class LazyLoadingFragmentHandler extends FragmentHandler
Chris@0 24 {
Chris@0 25 private $container;
Chris@14 26 /**
Chris@14 27 * @deprecated since version 3.3, to be removed in 4.0
Chris@14 28 */
Chris@17 29 private $rendererIds = [];
Chris@17 30 private $initialized = [];
Chris@0 31
Chris@0 32 /**
Chris@0 33 * @param ContainerInterface $container A container
Chris@0 34 * @param RequestStack $requestStack The Request stack that controls the lifecycle of requests
Chris@0 35 * @param bool $debug Whether the debug mode is enabled or not
Chris@0 36 */
Chris@0 37 public function __construct(ContainerInterface $container, RequestStack $requestStack, $debug = false)
Chris@0 38 {
Chris@0 39 $this->container = $container;
Chris@0 40
Chris@17 41 parent::__construct($requestStack, [], $debug);
Chris@0 42 }
Chris@0 43
Chris@0 44 /**
Chris@0 45 * Adds a service as a fragment renderer.
Chris@0 46 *
Chris@0 47 * @param string $name The service name
Chris@0 48 * @param string $renderer The render service id
Chris@14 49 *
Chris@14 50 * @deprecated since version 3.3, to be removed in 4.0
Chris@0 51 */
Chris@0 52 public function addRendererService($name, $renderer)
Chris@0 53 {
Chris@14 54 @trigger_error(sprintf('The %s() method is deprecated since Symfony 3.3 and will be removed in 4.0.', __METHOD__), E_USER_DEPRECATED);
Chris@14 55
Chris@0 56 $this->rendererIds[$name] = $renderer;
Chris@0 57 }
Chris@0 58
Chris@0 59 /**
Chris@0 60 * {@inheritdoc}
Chris@0 61 */
Chris@17 62 public function render($uri, $renderer = 'inline', array $options = [])
Chris@0 63 {
Chris@14 64 // BC 3.x, to be removed in 4.0
Chris@0 65 if (isset($this->rendererIds[$renderer])) {
Chris@0 66 $this->addRenderer($this->container->get($this->rendererIds[$renderer]));
Chris@14 67 unset($this->rendererIds[$renderer]);
Chris@0 68
Chris@14 69 return parent::render($uri, $renderer, $options);
Chris@14 70 }
Chris@14 71
Chris@14 72 if (!isset($this->initialized[$renderer]) && $this->container->has($renderer)) {
Chris@14 73 $this->addRenderer($this->container->get($renderer));
Chris@14 74 $this->initialized[$renderer] = true;
Chris@0 75 }
Chris@0 76
Chris@0 77 return parent::render($uri, $renderer, $options);
Chris@0 78 }
Chris@0 79 }