AccessAwareRouter.php

Same filename in other branches
  1. 9 core/lib/Drupal/Core/Routing/AccessAwareRouter.php
  2. 8.9.x core/lib/Drupal/Core/Routing/AccessAwareRouter.php
  3. 11.x core/lib/Drupal/Core/Routing/AccessAwareRouter.php

Namespace

Drupal\Core\Routing

File

core/lib/Drupal/Core/Routing/AccessAwareRouter.php

View source
<?php

namespace Drupal\Core\Routing;

use Drupal\Core\Access\AccessManagerInterface;
use Drupal\Core\Access\AccessResultReasonInterface;
use Drupal\Core\Cache\CacheableDependencyInterface;
use Drupal\Core\Http\Exception\CacheableAccessDeniedHttpException;
use Drupal\Core\Session\AccountInterface;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\RequestContext as SymfonyRequestContext;
use Symfony\Component\Routing\RouterInterface;

/**
 * A router class for Drupal with access check and upcasting.
 */
class AccessAwareRouter implements AccessAwareRouterInterface {
    
    /**
     * The router doing the actual routing.
     *
     * @var \Symfony\Component\Routing\RouterInterface
     */
    protected $router;
    
    /**
     * The access manager.
     *
     * @var \Drupal\Core\Access\AccessManagerInterface
     */
    protected $accessManager;
    
    /**
     * The account to use in access checks.
     *
     * @var \Drupal\Core\Session\AccountInterface
     */
    protected $account;
    
    /**
     * Constructs a router for Drupal with access check and upcasting.
     *
     * @param \Symfony\Component\Routing\RouterInterface $router
     *   The router doing the actual routing.
     * @param \Drupal\Core\Access\AccessManagerInterface $access_manager
     *   The access manager.
     * @param \Drupal\Core\Session\AccountInterface $account
     *   The account to use in access checks.
     */
    public function __construct(RouterInterface $router, AccessManagerInterface $access_manager, AccountInterface $account) {
        $this->router = $router;
        $this->accessManager = $access_manager;
        $this->account = $account;
    }
    
    /**
     * {@inheritdoc}
     */
    public function __call($name, $arguments) {
        // Ensure to call every other function to the router.
        return call_user_func_array([
            $this->router,
            $name,
        ], $arguments);
    }
    
    /**
     * {@inheritdoc}
     *
     * phpcs:ignore Drupal.Commenting.FunctionComment.VoidReturn
     * @return void
     */
    public function setContext(SymfonyRequestContext $context) {
        $this->router
            ->setContext($context);
    }
    
    /**
     * {@inheritdoc}
     */
    public function getContext() : SymfonyRequestContext {
        return $this->router
            ->getContext();
    }
    
    /**
     * {@inheritdoc}
     *
     * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
     *   Thrown when access checking failed.
     */
    public function matchRequest(Request $request) : array {
        $parameters = $this->router
            ->matchRequest($request);
        $request->attributes
            ->add($parameters);
        $this->checkAccess($request);
        // We can not return $parameters because the access check can change the
        // request attributes.
        return $request->attributes
            ->all();
    }
    
    /**
     * Apply access check service to the route and parameters in the request.
     *
     * @param \Symfony\Component\HttpFoundation\Request $request
     *   The request to access check.
     */
    protected function checkAccess(Request $request) {
        // The cacheability (if any) of this request's access check result must be
        // applied to the response.
        $access_result = $this->accessManager
            ->checkRequest($request, $this->account, TRUE);
        // Allow a master request to set the access result for a subrequest: if an
        // access result attribute is already set, don't overwrite it.
        if (!$request->attributes
            ->has(AccessAwareRouterInterface::ACCESS_RESULT)) {
            $request->attributes
                ->set(AccessAwareRouterInterface::ACCESS_RESULT, $access_result);
        }
        if (!$access_result->isAllowed()) {
            if ($access_result instanceof CacheableDependencyInterface && $request->isMethodCacheable()) {
                throw new CacheableAccessDeniedHttpException($access_result, $access_result instanceof AccessResultReasonInterface ? $access_result->getReason() : '');
            }
            else {
                throw new AccessDeniedHttpException($access_result instanceof AccessResultReasonInterface ? $access_result->getReason() : '');
            }
        }
    }
    
    /**
     * {@inheritdoc}
     */
    public function getRouteCollection() : RouteCollection {
        return $this->router
            ->getRouteCollection();
    }
    
    /**
     * {@inheritdoc}
     */
    public function generate($name, $parameters = [], $referenceType = self::ABSOLUTE_PATH) : string {
        return $this->router
            ->generate($name, $parameters, $referenceType);
    }
    
    /**
     * {@inheritdoc}
     *
     * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
     *   Thrown when access checking failed.
     */
    public function match($pathinfo) : array {
        return $this->matchRequest(Request::create($pathinfo));
    }

}

Classes

Title Deprecated Summary
AccessAwareRouter A router class for Drupal with access check and upcasting.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.