vendor/easycorp/easyadmin-bundle/src/EventListener/AdminRouterSubscriber.php line 76

Open in your IDE?
  1. <?php
  3. namespace EasyCorp\Bundle\EasyAdminBundle\EventListener;
  5. use EasyCorp\Bundle\EasyAdminBundle\Config\Option\EA;
  6. use EasyCorp\Bundle\EasyAdminBundle\Contracts\Controller\CrudControllerInterface;
  7. use EasyCorp\Bundle\EasyAdminBundle\Contracts\Controller\DashboardControllerInterface;
  8. use EasyCorp\Bundle\EasyAdminBundle\Factory\AdminContextFactory;
  9. use EasyCorp\Bundle\EasyAdminBundle\Factory\ControllerFactory;
  10. use EasyCorp\Bundle\EasyAdminBundle\Registry\CrudControllerRegistry;
  11. use EasyCorp\Bundle\EasyAdminBundle\Registry\DashboardControllerRegistry;
  12. use EasyCorp\Bundle\EasyAdminBundle\Router\UrlSigner;
  13. use Symfony\Component\EventDispatcher\EventSubscriberInterface;
  14. use Symfony\Component\HttpFoundation\Request;
  15. use Symfony\Component\HttpKernel\Controller\ControllerResolverInterface;
  16. use Symfony\Component\HttpKernel\Event\ControllerEvent;
  17. use Symfony\Component\HttpKernel\Event\RequestEvent;
  18. use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
  19. use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
  20. use Symfony\Component\Routing\Matcher\RequestMatcherInterface;
  21. use Twig\Environment;
  23. /**
  24.  * This subscriber acts as a "proxy" of all backend requests. First, if the
  25.  * request is related to EasyAdmin, it creates the AdminContext variable and
  26.  * stores it in the Request as an attribute.
  27.  *
  28.  * Second, it uses Symfony events to serve all backend requests using a single
  29.  * route. The trick is to change dynamically the controller to execute when
  30.  * the request is related to a CRUD action or a normal Symfony route/action.
  31.  *
  32.  * @author Javier Eguiluz <javier.eguiluz@gmail.com>
  33.  * @author Maxime Steinhausser <maxime.steinhausser@gmail.com>
  34.  * @author Yonel Ceruto <yonelceruto@gmail.com>
  35.  */
  36. class AdminRouterSubscriber implements EventSubscriberInterface
  37. {
  38.     private AdminContextFactory $adminContextFactory;
  39.     private DashboardControllerRegistry $dashboardControllerRegistry;
  40.     private CrudControllerRegistry $crudControllerRegistry;
  41.     private ControllerFactory $controllerFactory;
  42.     private ControllerResolverInterface $controllerResolver;
  43.     private UrlGeneratorInterface $urlGenerator;
  44.     private RequestMatcherInterface $requestMatcher;
  45.     private Environment $twig;
  46.     private UrlSigner $urlSigner;
  48.     public function __construct(AdminContextFactory $adminContextFactory, DashboardControllerRegistry $dashboardControllerRegistry, CrudControllerRegistry $crudControllerRegistry, ControllerFactory $controllerFactory, ControllerResolverInterface $controllerResolver, UrlGeneratorInterface $urlGenerator, RequestMatcherInterface $requestMatcher, Environment $twig, UrlSigner $urlSigner)
  49.     {
  50.         $this->adminContextFactory = $adminContextFactory;
  51.         $this->dashboardControllerRegistry = $dashboardControllerRegistry;
  52.         $this->crudControllerRegistry = $crudControllerRegistry;
  53.         $this->controllerFactory = $controllerFactory;
  54.         $this->controllerResolver = $controllerResolver;
  55.         $this->urlGenerator = $urlGenerator;
  56.         $this->requestMatcher = $requestMatcher;
  57.         $this->twig = $twig;
  58.         $this->urlSigner = $urlSigner;
  59.     }
  61.     public static function getSubscribedEvents(): array
  62.     {
  63.         return [
  64.             RequestEvent::class => [
  65.                 ['onKernelRequest', 0],
  66.             ],
  67.             // the priority must be higher than 0 to run it before ParamConverterListener
  68.             ControllerEvent::class => ['onKernelController', 128],
  69.         ];
  70.     }
  72.     /**
  73.      * If this is an EasyAdmin request, it creates the AdminContext variable, stores it
  74.      * in the Request as an attribute and injects it as a global Twig variable.
  75.      */
  76.     public function onKernelRequest(RequestEvent $event): void
  77.     {
  78.         $request = $event->getRequest();
  79.         if (null === $dashboardControllerFqcn = $this->getDashboardControllerFqcn($request)) {
  80.             return;
  81.         }
  83.         if (null === $dashboardControllerInstance = $this->getDashboardControllerInstance($dashboardControllerFqcn, $request)) {
  84.             return;
  85.         }
  87.         // creating the context is expensive, so it's created once and stored in the request
  88.         // if the current request already has an AdminContext object, do nothing
  89.         if (null === $adminContext = $request->attributes->get(EA::CONTEXT_REQUEST_ATTRIBUTE)) {
  90.             $crudControllerInstance = $this->getCrudControllerInstance($request);
  91.             $adminContext = $this->adminContextFactory->create($request, $dashboardControllerInstance, $crudControllerInstance);
  92.         }
  94.         $request->attributes->set(EA::CONTEXT_REQUEST_ATTRIBUTE, $adminContext);
  96.         // this makes the AdminContext available in all templates as a short named variable
  97.         $this->twig->addGlobal('ea', $adminContext);
  99.         if ($adminContext->getSignedUrls() && false === $this->urlSigner->check($request->getUri())) {
  100.             throw new AccessDeniedHttpException('The signature of the URL is not valid.');
  101.         }
  102.     }
  104.     /**
  105.      * In EasyAdmin all backend requests are served via the same route (that allows to
  106.      * detect under which dashboard you want to process the request). This method handles
  107.      * the requests related to "CRUD controller actions" and "custom Symfony actions".
  108.      * The trick used is to change dynamically the controller executed by Symfony.
  109.      */
  110.     public function onKernelController(ControllerEvent $event): void
  111.     {
  112.         $request = $event->getRequest();
  113.         if (null === $request->attributes->get(EA::CONTEXT_REQUEST_ATTRIBUTE)) {
  114.             return;
  115.         }
  117.         // if the request is related to a CRUD controller, change the controller to be executed
  118.         if (null !== $crudControllerInstance = $this->getCrudControllerInstance($request)) {
  119.             $symfonyControllerFqcnCallable = [$crudControllerInstance, $request->query->get(EA::CRUD_ACTION)];
  120.             $symfonyControllerStringCallable = [\get_class($crudControllerInstance), $request->query->get(EA::CRUD_ACTION)];
  122.             // this makes Symfony believe that another controller is being executed
  123.             // (e.g. this is needed for the autowiring of controller action arguments)
  124.             // VERY IMPORTANT: here the Symfony controller must be passed as a string (['App\Controller\Foo', 'index'])
  125.             // Otherwise, the param converter of the controller method doesn't work
  126.             $event->getRequest()->attributes->set('_controller', $symfonyControllerStringCallable);
  128.             // this actually makes Symfony to execute the other controller
  129.             $event->setController($symfonyControllerFqcnCallable);
  130.         }
  132.         // if the request is related to a custom action, change the controller to be executed
  133.         if (null !== $request->query->get(EA::ROUTE_NAME)) {
  134.             $symfonyControllerAsString = $this->getSymfonyControllerFqcn($request);
  135.             $symfonyControllerCallable = $this->getSymfonyControllerInstance($symfonyControllerAsString, $request->query->all()[EA::ROUTE_PARAMS] ?? []);
  136.             if (false !== $symfonyControllerCallable) {
  137.                 // this makes Symfony believe that another controller is being executed
  138.                 // (e.g. this is needed for the autowiring of controller action arguments)
  139.                 // VERY IMPORTANT: here the Symfony controller must be passed as a string ('App\Controller\Foo::index')
  140.                 // Otherwise, the param converter of the controller method doesn't work
  141.                 $event->getRequest()->attributes->set('_controller', $symfonyControllerAsString);
  142.                 // route params must be added as route attribute; otherwise, param converters don't work
  143.                 $event->getRequest()->attributes->replace(array_merge(
  144.                     $request->query->all()[EA::ROUTE_PARAMS] ?? [],
  145.                     $event->getRequest()->attributes->all()
  146.                 ));
  148.                 // this actually makes Symfony to execute the other controller
  149.                 $event->setController($symfonyControllerCallable);
  150.             }
  151.         }
  152.     }
  154.     /**
  155.      * It returns the FQCN of the EasyAdmin Dashboard controller used to serve this
  156.      * request or null if this is not an EasyAdmin request.
  157.      * Because of how EasyAdmin works, all backend requests are handled via the
  158.      * Dashboard controller, so its enough to check if the request controller implements
  159.      * the DashboardControllerInterface.
  160.      */
  161.     private function getDashboardControllerFqcn(Request $request): ?string
  162.     {
  163.         $controller = $request->attributes->get('_controller');
  164.         $controllerFqcn = null;
  166.         if (\is_string($controller)) {
  167.             [$controllerFqcn, ] = explode('::', $controller);
  168.         }
  170.         if (\is_array($controller)) {
  171.             $controllerFqcn = $controller[0];
  172.         }
  174.         if (\is_object($controller)) {
  175.             $controllerFqcn = \get_class($controller);
  176.         }
  178.         return is_subclass_of($controllerFqcn, DashboardControllerInterface::class) ? $controllerFqcn : null;
  179.     }
  181.     private function getDashboardControllerInstance(string $dashboardControllerFqcn, Request $request): ?DashboardControllerInterface
  182.     {
  183.         return $this->controllerFactory->getDashboardControllerInstance($dashboardControllerFqcn, $request);
  184.     }
  186.     private function getCrudControllerInstance(Request $request): ?CrudControllerInterface
  187.     {
  188.         if (null !== $crudId = $request->query->get(EA::CRUD_ID)) {
  189.             $crudControllerFqcn = $this->crudControllerRegistry->findCrudFqcnByCrudId($crudId);
  190.         } else {
  191.             $crudControllerFqcn = $request->query->get(EA::CRUD_CONTROLLER_FQCN);
  192.         }
  194.         $crudAction = $request->query->get(EA::CRUD_ACTION);
  196.         return $this->controllerFactory->getCrudControllerInstance($crudControllerFqcn, $crudAction, $request);
  197.     }
  199.     private function getSymfonyControllerFqcn(Request $request): ?string
  200.     {
  201.         $routeName = $request->query->get(EA::ROUTE_NAME);
  202.         $routeParams = $request->query->all()[EA::ROUTE_PARAMS] ?? [];
  203.         $url = $this->urlGenerator->generate($routeName, $routeParams);
  205.         $newRequest = $request->duplicate();
  206.         $newRequest->attributes->remove('_controller');
  207.         $newRequest->attributes->set('_route', $routeName);
  208.         $newRequest->attributes->add($routeParams);
  209.         $newRequest->server->set('REQUEST_URI', $url);
  211.         $parameters = $this->requestMatcher->matchRequest($newRequest);
  213.         return $parameters['_controller'] ?? null;
  214.     }
  216.     private function getSymfonyControllerInstance(string $controllerFqcn, array $routeParams): callable|false
  217.     {
  218.         $newRequest = new Request([], [], ['_controller' => $controllerFqcn, '_route_params' => $routeParams], [], [], []);
  220.         return $this->controllerResolver->getController($newRequest);
  221.     }
  222. }