interface CheckProviderInterface

Same name in other branches
  1. 9 core/lib/Drupal/Core/Access/CheckProviderInterface.php \Drupal\Core\Access\CheckProviderInterface
  2. 8.9.x core/lib/Drupal/Core/Access/CheckProviderInterface.php \Drupal\Core\Access\CheckProviderInterface
  3. 11.x core/lib/Drupal/Core/Access/CheckProviderInterface.php \Drupal\Core\Access\CheckProviderInterface

Provides the available access checkers by service IDs.

Access checker services are added by ::addCheckService calls and are loaded by ::loadCheck.

The checker provider service and the actual checking is separated in order to not require the full access manager on route build time.

Hierarchy

Expanded class hierarchy of CheckProviderInterface

All classes that implement CheckProviderInterface

1 file declares its use of CheckProviderInterface
RouteBuilder.php in core/lib/Drupal/Core/Routing/RouteBuilder.php

File

core/lib/Drupal/Core/Access/CheckProviderInterface.php, line 16

Namespace

Drupal\Core\Access
View source
interface CheckProviderInterface {
    
    /**
     * For each route, saves a list of applicable access checks to the route.
     *
     * @param \Symfony\Component\Routing\RouteCollection $routes
     *   A collection of routes to apply checks to.
     */
    public function setChecks(RouteCollection $routes);
    
    /**
     * Registers a new AccessCheck by service ID.
     *
     * @param string $service_id
     *   The ID of the service in the Container that provides a check.
     * @param string $service_method
     *   The method to invoke on the service object for performing the check.
     * @param array $applies_checks
     *   (optional) An array of route requirement keys the checker service applies
     *   to.
     * @param bool $needs_incoming_request
     *   (optional) True if access-check method only acts on an incoming request.
     */
    public function addCheckService($service_id, $service_method, array $applies_checks = [], $needs_incoming_request = FALSE);
    
    /**
     * Lazy-loads access check services.
     *
     * @param string $service_id
     *   The service id of the access check service to load.
     *
     * @return callable
     *   A callable access check.
     *
     * @throws \InvalidArgumentException
     *   Thrown when the service hasn't been registered in addCheckService().
     * @throws \Drupal\Core\Access\AccessException
     *   Thrown when the service doesn't implement the required interface.
     */
    public function loadCheck($service_id);
    
    /**
     * A list of checks that needs the request.
     *
     * @return array
     */
    public function getChecksNeedRequest();

}

Members

Title Sort descending Modifiers Object type Summary
CheckProviderInterface::addCheckService public function Registers a new AccessCheck by service ID.
CheckProviderInterface::getChecksNeedRequest public function A list of checks that needs the request.
CheckProviderInterface::loadCheck public function Lazy-loads access check services.
CheckProviderInterface::setChecks public function For each route, saves a list of applicable access checks to the route.

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