vendor/symfony/framework-bundle/Routing/DelegatingLoader.php line 69

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\Routing;
  14. use Symfony\Component\Config\Exception\LoaderLoadException;
  15. use Symfony\Component\Config\Loader\DelegatingLoader as BaseDelegatingLoader;
  16. use Symfony\Component\Config\Loader\LoaderResolverInterface;
  18. /**
  19.  * DelegatingLoader delegates route loading to other loaders using a loader resolver.
  20.  *
  21.  * This implementation resolves the _controller attribute from the short notation
  22.  * to the fully-qualified form (from a:b:c to class::method).
  23.  *
  24.  * @author Fabien Potencier <fabien@symfony.com>
  25.  *
  26.  * @final
  27.  */
  28. class DelegatingLoader extends BaseDelegatingLoader
  29. {
  30.     private $loading = false;
  31.     private $defaultOptions;
  32.     private $defaultRequirements;
  34.     public function __construct(LoaderResolverInterface $resolver, array $defaultOptions = [], array $defaultRequirements = [])
  35.     {
  36.         $this->defaultOptions = $defaultOptions;
  37.         $this->defaultRequirements = $defaultRequirements;
  39.         parent::__construct($resolver);
  40.     }
  42.     /**
  43.      * {@inheritdoc}
  44.      */
  45.     public function load($resource, string $type = null)
  46.     {
  47.         if ($this->loading) {
  48.             // This can happen if a fatal error occurs in parent::load().
  49.             // Here is the scenario:
  50.             // - while routes are being loaded by parent::load() below, a fatal error
  51.             //   occurs (e.g. parse error in a controller while loading annotations);
  52.             // - PHP abruptly empties the stack trace, bypassing all catch/finally blocks;
  53.             //   it then calls the registered shutdown functions;
  54.             // - the ErrorHandler catches the fatal error and re-injects it for rendering
  55.             //   thanks to HttpKernel->terminateWithException() (that calls handleException());
  56.             // - at this stage, if we try to load the routes again, we must prevent
  57.             //   the fatal error from occurring a second time,
  58.             //   otherwise the PHP process would be killed immediately;
  59.             // - while rendering the exception page, the router can be required
  60.             //   (by e.g. the web profiler that needs to generate an URL);
  61.             // - this handles the case and prevents the second fatal error
  62.             //   by triggering an exception beforehand.
  64.             throw new LoaderLoadException($resource, null, 0, null, $type);
  65.         }
  66.         $this->loading = true;
  68.         try {
  69.             $collection = parent::load($resource, $type);
  70.         } finally {
  71.             $this->loading = false;
  72.         }
  74.         foreach ($collection->all() as $route) {
  75.             if ($this->defaultOptions) {
  76.                 $route->setOptions($route->getOptions() + $this->defaultOptions);
  77.             }
  78.             if ($this->defaultRequirements) {
  79.                 $route->setRequirements($route->getRequirements() + $this->defaultRequirements);
  80.             }
  81.             if (!\is_string($controller = $route->getDefault('_controller'))) {
  82.                 continue;
  83.             }
  85.             if (str_contains($controller, '::')) {
  86.                 continue;
  87.             }
  89.             $route->setDefault('_controller', $controller);
  90.         }
  92.         return $collection;
  93.     }
  94. }