class CheckProvider
Same name in other branches
- 9 core/lib/Drupal/Core/Access/CheckProvider.php \Drupal\Core\Access\CheckProvider
- 10 core/lib/Drupal/Core/Access/CheckProvider.php \Drupal\Core\Access\CheckProvider
- 11.x core/lib/Drupal/Core/Access/CheckProvider.php \Drupal\Core\Access\CheckProvider
Loads access checkers from the container.
Hierarchy
- class \Drupal\Core\Access\CheckProvider implements \Drupal\Core\Access\CheckProviderInterface, \Symfony\Component\DependencyInjection\ContainerAwareInterface uses \Symfony\Component\DependencyInjection\ContainerAwareTrait
Expanded class hierarchy of CheckProvider
1 file declares its use of CheckProvider
- AccessManagerTest.php in core/
tests/ Drupal/ Tests/ Core/ Access/ AccessManagerTest.php - Contains \Drupal\Tests\Core\Access\AccessManagerTest.
1 string reference to 'CheckProvider'
- core.services.yml in core/
core.services.yml - core/core.services.yml
1 service uses CheckProvider
File
-
core/
lib/ Drupal/ Core/ Access/ CheckProvider.php, line 14
Namespace
Drupal\Core\AccessView source
class CheckProvider implements CheckProviderInterface, ContainerAwareInterface {
use ContainerAwareTrait;
/**
* Array of registered access check service ids.
*
* @var array
*/
protected $checkIds = [];
/**
* Array of access check objects keyed by service id.
*
* @var \Drupal\Core\Routing\Access\AccessInterface[]
*/
protected $checks;
/**
* Array of access check method names keyed by service ID.
*
* @var array
*/
protected $checkMethods = [];
/**
* Array of access checks which only will be run on the incoming request.
*/
protected $checksNeedsRequest = [];
/**
* An array to map static requirement keys to service IDs.
*
* @var array
*/
protected $staticRequirementMap;
/**
* An array to map dynamic requirement keys to service IDs.
*
* @var array
*/
protected $dynamicRequirementMap;
/**
* {@inheritdoc}
*/
public function addCheckService($service_id, $service_method, array $applies_checks = [], $needs_incoming_request = FALSE) {
$this->checkIds[] = $service_id;
$this->checkMethods[$service_id] = $service_method;
if ($needs_incoming_request) {
$this->checksNeedsRequest[$service_id] = $service_id;
}
foreach ($applies_checks as $applies_check) {
$this->staticRequirementMap[$applies_check][] = $service_id;
}
}
/**
* {@inheritdoc}
*/
public function getChecksNeedRequest() {
return $this->checksNeedsRequest;
}
/**
* {@inheritdoc}
*/
public function setChecks(RouteCollection $routes) {
$this->loadDynamicRequirementMap();
foreach ($routes as $route) {
if ($checks = $this->applies($route)) {
$route->setOption('_access_checks', $checks);
}
}
}
/**
* {@inheritdoc}
*/
public function loadCheck($service_id) {
if (empty($this->checks[$service_id])) {
if (!in_array($service_id, $this->checkIds)) {
throw new \InvalidArgumentException(sprintf('No check has been registered for %s', $service_id));
}
$check = $this->container
->get($service_id);
if (!$check instanceof AccessInterface) {
throw new AccessException('All access checks must implement AccessInterface.');
}
if (!is_callable([
$check,
$this->checkMethods[$service_id],
])) {
throw new AccessException(sprintf('Access check method %s in service %s must be callable.', $this->checkMethods[$service_id], $service_id));
}
$this->checks[$service_id] = $check;
}
return [
$this->checks[$service_id],
$this->checkMethods[$service_id],
];
}
/**
* Determine which registered access checks apply to a route.
*
* @param \Symfony\Component\Routing\Route $route
* The route to get list of access checks for.
*
* @return array
* An array of service ids for the access checks that apply to passed
* route.
*/
protected function applies(Route $route) {
$checks = [];
// Iterate through map requirements from appliesTo() on access checkers.
// Only iterate through all checkIds if this is not used.
foreach ($route->getRequirements() as $key => $value) {
if (isset($this->staticRequirementMap[$key])) {
foreach ($this->staticRequirementMap[$key] as $service_id) {
$checks[] = $service_id;
}
}
}
// Finally, see if any dynamic access checkers apply.
foreach ($this->dynamicRequirementMap as $service_id) {
if ($this->checks[$service_id]
->applies($route)) {
$checks[] = $service_id;
}
}
return $checks;
}
/**
* Compiles a mapping of requirement keys to access checker service IDs.
*/
protected function loadDynamicRequirementMap() {
if (isset($this->dynamicRequirementMap)) {
return;
}
// Set them here, so we can use the isset() check above.
$this->dynamicRequirementMap = [];
foreach ($this->checkIds as $service_id) {
if (empty($this->checks[$service_id])) {
$this->loadCheck($service_id);
}
// Add the service ID to an array that will be iterated over.
if ($this->checks[$service_id] instanceof AccessCheckInterface) {
$this->dynamicRequirementMap[] = $service_id;
}
}
}
}
Members
Title Sort descending | Modifiers | Object type | Summary | Overriden Title |
---|---|---|---|---|
CheckProvider::$checkIds | protected | property | Array of registered access check service ids. | |
CheckProvider::$checkMethods | protected | property | Array of access check method names keyed by service ID. | |
CheckProvider::$checks | protected | property | Array of access check objects keyed by service id. | |
CheckProvider::$checksNeedsRequest | protected | property | Array of access checks which only will be run on the incoming request. | |
CheckProvider::$dynamicRequirementMap | protected | property | An array to map dynamic requirement keys to service IDs. | |
CheckProvider::$staticRequirementMap | protected | property | An array to map static requirement keys to service IDs. | |
CheckProvider::addCheckService | public | function | Registers a new AccessCheck by service ID. | Overrides CheckProviderInterface::addCheckService |
CheckProvider::applies | protected | function | Determine which registered access checks apply to a route. | |
CheckProvider::getChecksNeedRequest | public | function | A list of checks that needs the request. | Overrides CheckProviderInterface::getChecksNeedRequest |
CheckProvider::loadCheck | public | function | Lazy-loads access check services. | Overrides CheckProviderInterface::loadCheck |
CheckProvider::loadDynamicRequirementMap | protected | function | Compiles a mapping of requirement keys to access checker service IDs. | |
CheckProvider::setChecks | public | function | For each route, saves a list of applicable access checks to the route. | Overrides CheckProviderInterface::setChecks |
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.